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

Axis 3D Labels - TextFormatting & LabelProvider API

Axes in SciChart 3D shares the same SCIAxisCore base class with SciChart 2D Axes. Many of the AxisCore features are shared. For your convenience, some of the documentation has been duplicated here, with some referring to other sections of the user manual.

Axis 3D TextFormatting

All the axis classes obey standard Cocoa formatting strings, calling methods of the NSFormatter APIs internally. Thus, standard Date Formatters and Number Formatters strings patterns can be applied to format axis labels. There are the ISCIAxisCore.textFormatting and ISCIAxisCore.cursorTextFormatting properties for this purpose.

NOTE: NSDateFormatter and NSNumberFormatter relies on Unicode Technical Standard #35

See possible string patterns provided by UTS#35

NOTE: The TextFormatting is a shared API between SciChart 2D and SciChart 3D. For a full walk-through including code-samples, please see the Axis Labels - TextFormatting and CursorTextFormatting article.

Axis 3D LabelProvider API

The LabelProvider API allows full control over the formatting of SCIAxisCore text labels, over and above what you can achieve using TextFormatting.

Use a LabelProvider when you want to:

  • Have fine grained control over Axis Text or Cursor Labels, depending on numeric (or date) values.
  • Display strings on the XAxis, e.g. “Bananas”, “Oranges”, “Apples” and not “1”, “2”, “3”.
  • Dynamically change the ISCIAxisCore.textFormatting as you zoom in or out.
  • Dynamically change the ISCIAxisCore.textFormatting depending on Data-value.

NOTE: The LabelProvider API is a shared API between SciChart 2D and SciChart 3D. For a full walk-through of the AxisCore LabelProvider API, including code-samples, please see Axis Labels - LabelProvider API article.