Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

alpha

向坐标区中的对象添加透明度

说明

示例

alpha value 为当前坐标区中支持透明度的对象设置面透明度。将 value 指定为 'clear''opaque',或指定为 [0, 1] 范围内的数字。值 0 使对象透明,值 1 使对象完全不透明。

示例

alpha alphadata 对坐标区中的所有图像、补片、曲面和散点图对象使用不同的透明度。此选项可为对象设置相应的 alpha 数据属性。

alpha facealpha 控制坐标区中补片、曲面和散点图对象的面的透明度。此选项对补片和曲面对象设置 FaceAlpha。对于散点图对象,它设置 MarkerFaceAlphaMarkerEdgeAlpha 属性。

示例

alpha alphadatamapping 控制坐标区中所有图像、补片、曲面和散点图对象的 alpha 数据值的解释。此选项用于设置对象的 AlphaDataMapping 属性。

示例

alpha(obj,___) 用于为 obj 指定的对象设置透明度。选项 obj 可以位于上述语法中的任何输入参数之前。将字符数组形式的输入参数用单引号引起来,例如 alpha(obj,'opaque')

alpha(ax,___) 设置 ax 指定的坐标区(而非当前坐标区)中对象的透明度。指定 ax 作为第一个输入参数。您不能同时指定 axobj 输入。

示例

全部折叠

创建条形图和散点图。将条形序列和散点序列对象的面透明度都设置为 0.5

bar(1:10)
hold on
scatter(10*rand(10,1),10*rand(10,1),'filled','SizeData',200)
hold off
alpha(.5)

创建条形图和散点图。将散点序列对象的透明度设置为 0.5 而不影响条形序列对象。

b = bar(1:10);
hold on
s = scatter(10*rand(10,1),10*rand(10,1),'filled','SizeData',200);
hold off
alpha(s,.5)

创建一个曲面图。使曲面上的透明度根据 z 值而变化。

s = surf(peaks);
alpha(s,'z')

创建一个图像。使图像上的透明度根据颜色值而变化。默认情况下,图像的透明度值固定在 0 与 1 之间。小于 0 的值表示完全透明,大于 1 的值表示完全不透明。应使用 alpha scaled 命令转换透明度值以涵盖 alphamap 的范围。

imagesc(peaks)
alpha color
alpha scaled

输入参数

全部折叠

面透明度值,指定为下列值之一:

  • 范围 [0, 1] 内的数字 - 将面透明度设置为指定值。值 0 表示透明。值 1 表示不透明。介于 0 和 1 之间的值表示部分透明。

  • 'clear' - 将面透明度设置为 0(透明)。

  • 'opaque' - 将面透明度设置为 1(不透明)。

如果对象没有面或面没有颜色,则 alpha 函数不会对该对象产生视觉效果。例如,对于使用未填充标记或使用不带面的标记('*''+''.''x')的散点图对象,alpha 不会产生视觉效果。

下表列出了支持透明度的图形对象和更新为指定值的关联的面透明度属性。

图形对象 面透明度属性
区域对象FaceAlpha
条形对象FaceAlpha
散点图对象MarkerFaceAlphaMarkerEdgeAlpha
直方图对象和二元直方图对象FaceAlpha
图像对象AlphaData
图曲面和基本曲面对象FaceAlpha
补片对象FaceAlpha

用于改变整个对象范围内的透明度的选项,指定为下表中的值之一。表中的列指示每个选项如何影响不同类型的对象,具体取决于坐标区中包含什么样的对象。

选项曲面对象散点图对象补片对象图像对象
'x'AlphaData 属性设置为与 XData 属性相同,并将 FaceAlpha 属性设置为 'flat'AlphaData 属性设置为与 XData 属性相同,并将 MarkerFaceAlphaMarkerEdgeAlpha 属性设置为 'flat'FaceVertexAlphaData 属性设置为与 XData 属性相同,并将 FaceAlpha 属性设置为 'flat'无效果。
'y'AlphaData 属性设置为与 YData 属性相同,并将 FaceAlpha 属性设置为 'flat'AlphaData 属性设置为与 YData 属性相同,并将 MarkerFaceAlphaMarkerEdgeAlpha 属性设置为 'flat'FaceVertexAlphaData 属性设置为与 YData 属性相同,并将 FaceAlpha 属性设置为 'flat'无效果。
'z'AlphaData 属性设置为与 ZData 属性相同,并将 FaceAlpha 属性设置为 'flat'AlphaData 属性设置为与 ZData 属性相同,并将 MarkerFaceAlphaMarkerEdgeAlpha 属性设置为 'flat'FaceVertexAlphaData 属性设置为与 ZData 属性相同,并将 FaceAlpha 属性设置为 'flat'无效果。
'color'AlphaData 属性设置为与 CData 属性相同,并将 FaceAlpha 属性设置为 'flat'AlphaData 属性设置为与 CData 属性相同,并将 MarkerFaceAlphaMarkerEdgeAlpha 属性设置为 'flat'FaceVertexAlphaData 属性设置为与 FaceVertexCData 属性相同,并将 FaceAlpha 属性设置为 'flat'AlphaData 数据属性设置为与 CData 属性相同。
'rand'AlphaData 属性设置为大小与 ZData 属性相同的随机数矩阵,并将 FaceAlpha 属性设置为 'flat'AlphaData 属性设置为大小与 XData 属性相同的随机数矩阵,并将 MarkerFaceAlphaMarkerEdgeAlpha 属性设置为 'flat'FaceVertexAlphaData 属性设置为大小与 ZData 属性相同的随机数矩阵,并将 FaceAlpha 属性设置为 'flat'AlphaData 数据属性设置为大小与 CData 属性相同的随机数矩阵。

创建向量或矩阵 A,并使用命令的函数形式。例如:

A = [.1 .2; .3 .4]
alpha(A)

A 指定为大小与曲面的 CData 属性相同的矩阵。alpha 函数将 AlphaData 属性设置为 A,并将 FaceAlpha 属性设置为 'flat'A 指定为大小与散点图对象的 XData 属性相同的向量。alpha 函数将 AlphaData 属性设置为 A,并将 MarkerFaceAlphaMarkerEdgeAlpha 属性设置为 'flat'A 指定为大小与补片的 FaceVertexCData 属性相同的矩阵。alpha 函数将 FaceVertexAlphaData 属性设置为 A,并将 FaceAlpha 属性设置为 'flat'A 指定为大小与图像的 CData 属性相同的矩阵。alpha 函数将 AlphaData 数据属性设置为 A

用于平面或插值面透明度的选项,指定为下表中的值之一。表中的列指示每个选项如何影响不同类型的对象,具体取决于坐标区中包含什么样的对象。

选项曲面对象散点图对象补片对象
'flat'FaceAlpha 属性设置为 'flat'AlphaData 属性必须为数组且大小与 CData 属性相同。FaceColor 属性必须设置为 'flat'MarkerFaceAlphaMarkerEdgeAlpha 属性设置为 'flat'AlphaData 属性必须为大小与 XData 属性相同的向量。MarkerFaceColor 属性必须设置为 'flat'FaceAlpha 属性设置为 'flat'FaceVertexAlphaData 属性必须为列向量且长度等于 Faces 属性中的面数。
'interp'FaceAlpha 属性设置为 'interp'AlphaData 属性必须为数组且大小与 CData 属性相同。FaceColor 属性必须设置为 'interp'无效果。FaceAlpha 属性设置为 'interp'FaceVertexAlphaData 属性必须为列向量且长度等于 Vertices 属性中的顶点数。
'texture'FaceAlpha 属性设置为 'texturemap'FaceColor 属性必须设置为 'texturemap'无效果。无效果。

Alpha 数据值的解释,指定为 'none''direct''scaled'。此选项用于设置坐标区中的图像、补片、曲面和散点图对象的 AlphaDataMapping 属性。

  • 'none' - 将 alpha 数据值解释为透明度值。小于或等于 0 的值表示完全透明。大于或等于 1 的值表示不透明。介于 0 和 1 之间的值表示半透明。

  • 'direct' - 将值解释为图窗的 alphamap 的索引。将带小数部分的值固定为向下最接近的整数。图窗的 Alphamap 属性包含 alphamap。

  • 'scaled' - 转换 alpha 数据值,使其覆盖由坐标区的 ALim 属性指示的图窗的 alphamap 对应的部分。以线性方式将数据值映射到 alpha 值。

支持透明度的图形对象,指定为标量或向量。如果您要控制 alpha 影响哪些对象,请使用此选项。否则,alpha 会影响坐标区中支持透明度的所有对象。

指定一个或多个下列类型的对象:

  • 区域对象

  • 条形序列对象

  • 散点序列对象

  • 直方图或二元直方图对象

  • 图像对象

  • 补片对象

  • 图曲面或基本曲面对象

注意

并非所有对象都支持 alphadatafacealphaalphadatamapping 输入参数。请参阅每个选项支持的对象列表的语法说明。

坐标区对象。如果您不指定坐标区,则 alpha 将设置当前坐标区中图形对象的透明度。

兼容性考虑

全部展开

R2020b 中的行为有变化

在 R2006a 之前推出