iOS & macOS Charting Documentation - SciChart iOS & macOS Charts SDK v4.x

Axis 3D Labels - Labels Configuration

In SciChart 3D you can configure showing the Axis Labels differently on the Axis Cube Planes. Possible options are defined by the SCIAxisPlaneDrawLabelsMode enumeration.

But first, let’s explain Axis Cube planes properly.

Axis Cube Planes

Axis Cube Planes

As you might guess, there are three possible planes in axis cube, and those are defined as follows:

AxisCube Plane Description
XY Plane perpendicular to the Z-Axis (Left by default).
ZY Plane perpendicular to the X-Axis (Right by default).
ZX Plane perpendicular to the Y-Axis (up).

Let’s see the ZY Plane on the image below:

ZY Plane Explanation

Axis Cube Labels Configuration

As mentioned above, drawing labels are controlled by the SCIAxisPlaneDrawLabelsMode enumeration, which has the following options:

SCIAxisPlaneDrawLabelsMode Description
Both axis labels are drawn on both sides of the axis cube. This is the default mode.
Hidden hides the axis labels for this plane, for example, when applied to the XyAxisPlane, the labels drawn by this plane will be hidden.
LocalX draws the labels on one side - the local X - of the plane.
LocalY draws the labels on the other side - the local Y - of the plane.

The above modes can be applied to one of the AxisCube’s planes which are accessible through the following properties on the SCIChartSurface3D:

See how it works in the code snippet below:

self.surface.xyAxisPlaneDrawLabelsMode = SCIAxisPlaneDrawLabelsMode_Both; self.surface.zyAxisPlaneDrawLabelsMode = SCIAxisPlaneDrawLabelsMode_LocalX; self.surface.zxAxisPlaneDrawLabelsMode = SCIAxisPlaneDrawLabelsMode_Hidden;
surface.xyAxisPlaneDrawLabelsMode = .both surface.zyAxisPlaneDrawLabelsMode = .localX surface.zxAxisPlaneDrawLabelsMode = .hidden
Surface.XyAxisPlaneDrawLabelsMode = SCIAxisPlaneDrawLabelsMode.Both; Surface.ZyAxisPlaneDrawLabelsMode = SCIAxisPlaneDrawLabelsMode.LocalX; Surface.ZxAxisPlaneDrawLabelsMode = SCIAxisPlaneDrawLabelsMode.Hidden;

Which results with the following:

Axis Plane Draw Labels Mode