本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

alpha

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

说明

示例

alpha value 为当前坐标区中支持透明度的图形对象设置面透明度。将 value 指定为介于 0(透明)和 1(不透明)之间的标量值(两者分别表示为 'clear''opaque')。

示例

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

alpha facealpha 指定对坐标区中的所有补片的面、图曲面和基本曲面对象使用单一透明度还是插补透明度。此选项用于设置对象的 FaceAlpha 属性。

示例

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
散点对象MarkerFaceAlpha
直方图对象和二元直方图对象FaceAlpha
图像对象AlphaData
图曲面和基本曲面对象FaceAlpha
补片对象FaceAlpha

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

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

矩 阵
使用函数形式的命令,例如 alpha([.1 .2; .3 .4])

AlphaData 属性设置为矩阵并将 FaceAlpha 属性设置为 'flat'。矩阵的大小必须与曲面的 CData 属性相同。 FaceVertexAlphaData 属性设置为矩阵并将 FaceAlpha 属性设置为 'flat'。矩阵的大小必须与补片的 FaceVertexCData 属性相同。 AlphaData 数据属性设置为矩阵。矩阵的大小必须与图像的 CData 属性相同。

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

选项图曲面或基本曲面对象补片对象
'flat'FaceAlpha 属性设置为 'flat'AlphaData 属性必须为数组且大小与 CData 属性相同。FaceColor 属性必须设置为 '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 将设置当前坐标区中图形对象的透明度。

在 R2006a 之前推出