Documentation Center

  • Trial Software
  • Product Updates

alpha

Set transparency properties for objects in current axes

Syntax

alpha
alpha(object_handle,value)
alpha(face_alpha)
alpha(alpha_data)
alpha(alpha_data)
alpha(alpha_data_mapping)

Description

alpha sets one of three transparency properties, depending on what arguments you specify with the call to this function. For available arguments, see Inputs.

alpha(object_handle,value) sets the transparency property only on the object identified by object_handle.

Input Arguments

Face Alpha

alpha(face_alpha) sets the FaceAlpha property of all image, patch, and surface objects in the current axes. You can set face_alpha to

scalarSet the FaceAlpha property to the specified value (for images, set the AlphaData property to the specified value).
'flat'Set the FaceAlpha property to flat.
'interp'Set the FaceAlpha property to interp.
'texture'Set the FaceAlpha property to texture.
'opaque'Set the FaceAlpha property to 1.
'clear'Set the FaceAlpha property to 0.

See Specifying Transparency for more information.

AlphaData (Surface Objects)

alpha(alpha_data) sets the AlphaData property of all surface objects in the current axes. You can set alpha_data to

matrix the same size as CDataSet the AlphaData property to the specified values.
'x'Set the AlphaData property to be the same as XData.
'y'Set the AlphaData property to be the same as YData.
'z'Set the AlphaData property to be the same as ZData.
'color'Set the AlphaData property to be the same as CData.
'rand'Set the AlphaData property to a matrix of random values equal in size to CData.

AlphaData (Image Objects)

alpha(alpha_data) sets the AlphaData property of all image objects in the current axes. You can set alpha_data to

matrix the same size as CDataSet the AlphaData property to the specified value.
'x'Ignored.
'y'Ignored.
'z'Ignored.
'color'Set the AlphaData property to be the same as CData.
'rand'Set the AlphaData property to a matrix of random values equal in size to CData.

AlphaDataMapping

alpha(alpha_data_mapping) sets the AlphaDataMapping property of all image, patch, and surface objects in the current axes. You can set alpha_data_mapping to

'scaled'Set the AlphaDataMapping property to scaled.
'direct'Set the AlphaDataMapping property to direct.
'none'Set the AlphaDataMapping property to none.

Examples

Create a surface plot and change its transparency using alpha:

surf(peaks);
alpha(0.5);

See Also

| | | | | | | | |

Tutorials

Was this topic helpful?