Documentation Center

  • Trial Software
  • Product Updates

Automatic-Mode Properties

While object creation routines that create axes children do not explicitly change axes properties, some axes properties are under automatic control when their associated mode property is set to auto (which is the default). The following table lists the automatic-mode properties.

Mode Property

What It Controls

CameraPositionMode

Positioning of the viewpoint

CameraTargetMode

Positioning of the camera target in the axes

CameraUpVectorMode

The direction of "up" in 2-D and 3-D views

CameraViewAngleMode

The size of the projected scene and stretch-to-fit behavior

CLimMode

Mapping of data values to colors

DataAspectRatioMode

Relative scaling of data units along x-, y-, and z-axes and stretch-to-fit behavior

PlotBoxAspectRatioMode

Relative scaling of plot box along x-, y-, and z-axes and stretch-to-fit behavior

TickDirMode

Direction of axis tick marks (in for 2-D, out for 3-D)

XLimMode

YLimMode

ZLimMode

Limits of the respective x, y, and z axes

XTickMode

YTickMode

ZTickMode

Tick mark spacing along the respective x-, y-, and z-axes

XTickLabelMode

ZTickLabelMode

YTickLabelMode

Tick mark labels along the respective x-, y-, and z-axes

For example, if all property values are set to their defaults and you enter these statements,

line(1:10,1:10)
line(1:10,[1:10].^2)

the second line statement causes the YLim property to change from [0 10] to [0 100].

This is because YLimMode is auto, which always causes the MATLAB® software to recompute the axis limits.

If you set the value controlled by an automatic-mode property, MATLAB sets the mode to manual and does not automatically recompute the value.

For example, in the statements

line(1:10,1:10)
set(gca,'XLim',[1 10],'YLim',[1 20])
line(1:10,[1:10].^2)

the set statement sets the x- and y-axis limits and changes the XLimMode and YLimMode properties to manual. The second line statement now draws a line that is clipped to the axis limits [1 12] instead of causing the axes to recompute its limits.

Was this topic helpful?