ztickangle

Rotate z-axis tick labels

Syntax

ztickangle(angle)

ztickangle(ax,angle)

ang = ztickangle

ang = ztickangle(ax)

Description

ztickangle(angle) rotates the z-axis tick labels for the current axes to the specified angle in degrees, where 0 is horizontal. Specify a positive value for counterclockwise rotation or a negative value for clockwise rotation.

ztickangle(ax,angle) rotates the tick labels for the axes specified by ax instead of the current axes.

ang = ztickangle returns the rotation angle for the z-axis tick labels of the current axes as a scalar value in degrees. Positive values indicate counterclockwise rotation. Negative values indicate clockwise rotation.

ang = ztickangle(ax) uses the axes specified by ax instead of the current axes.

Examples

Rotate z-Axis Tick Labels

Create a surface chart and rotate the z-axis tick labels 45 degrees clockwise.

[x,y,z] = peaks;
surf(x,y,z)
ztickangle(-45)

Rotate z-Axis Tick Labels for Specific Axes

Starting in R2019b, you can display a tiling of plots using the tiledlayout and nexttile functions. Call the tiledlayout function to create a 2-by-1 tiled chart layout. Call the nexttile function to create the axes objects ax1 and ax2. Plot into each of the axes. Then rotate the z-axis tick labels for the lower plot by specifying ax2 as the first input argument to ztickangle.

tiledlayout(2,1)
ax1 = nexttile;
stem3(ax1,2*rand(5))

ax2 = nexttile;
stem3(ax2,2*rand(5))
ztickangle(ax2,-45)

Query Current Angle for z-Axis Tick Labels

Create a surface chart. Then, query the rotation angle for the z-axis tick labels. By default, the labels are not rotated.

[x,y,z] = peaks;
surf(peaks)

ang = ztickangle

ang = 
0

Input Arguments

angle — Rotation of tick labels

0 (default) | scalar value in degrees

Rotation of tick labels, specified as a scalar value in degrees, where 0 is horizontal.

Example: ztickangle(90)

ax — Target axes

Axes object | array of Axes objects

Target axes, specified as an Axes object or an array of Axes objects.

If you do not specify this argument, then ztickangle modifies the current axes.

Algorithms

The ztickangle function sets and queries the ZTickLabelRotation property of the Axes object.

Version History

Introduced in R2016b