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

ISCIAxisCore

Defines the base protocol for all axes types used throughout the SciChart SDK.

  • Gets or sets the VisibleRange of the Axis.

    Note

    Setting the VisibleRange will cause the axis to redraw.

    Declaration

    Objective-C

    @property (nonatomic, strong) id<ISCIRange> _Nonnull visibleRange;
  • Gets or sets the GrowBy Factor. e.g. GrowBy [0.1, 0.2] will increase the axis extents by 10% (min) and 20% (max) outside of the data range.

    Declaration

    Objective-C

    @property (nonatomic, strong) id<ISCIRange> _Nonnull growBy;
  • Gets or sets the string Id of this axis. Used to associated ISCIRenderableSeries.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSString *_Nonnull axisId;
  • Gets or sets the visibleRangeLimit of the Axis.

    Note

    This will be used to clip the axis during ZoomExtents and AutoRange operations.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) id<ISCIRange> visibleRangeLimit;
  • Gets or ses the VisibleRangeLimitMode of the Axis.

    Note

    This property defines which parts of visibleRangeLimit will be used by axis.

    Declaration

    Objective-C

    @property (nonatomic) SCIRangeClipMode visibleRangeLimitMode;
  • Gets or sets the minimal zoom constrain of the axis.

    Note

    Used to set the minimum distance between Min and Max of the VisibleRange.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) id<ISCIComparable> minimalZoomConstrain;
  • Gets or sets the maximum zoom constrain of the axis.

    Note

    Used to set the maximum distance between Min and Max of the VisibleRange.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) id<ISCIComparable> maximumZoomConstrain;
  • Gets or sets the minor delta value.

    Note

    Used for axis minor ticks spacing.

    Declaration

    Objective-C

    @property (nonatomic, strong) id<ISCIComparable> _Nonnull minorDelta;
  • Gets or sets the major delta value.

    Note

    Used for axis major ticks spacing.

    Declaration

    Objective-C

    @property (nonatomic, strong) id<ISCIComparable> _Nonnull majorDelta;
  • Definies the value that indicates whether to calculate ticks automatically. Default is YES.

    Declaration

    Objective-C

    @property (nonatomic) BOOL autoTicks;
  • Definies the max auto ticks amount.

    Declaration

    Objective-C

    @property (nonatomic) unsigned int maxAutoTicks;
  • Definies the number of minor delta ticks per major tick.

    Declaration

    Objective-C

    @property (nonatomic) unsigned int minorsPerMajor;
  • Gets or sets a flag indicating whether to flip the tick and pixel coordinate generation for this axis, causing the axis ticks to decrement and chart to be flipped in the axis direction.

    Note

    If YES - reverses the ticks and coordinates for the axis.

    Declaration

    Objective-C

    @property (nonatomic) BOOL flipCoordinates;
  • Definies a flag indicating whether to draw major ticks or not.

    Declaration

    Objective-C

    @property (nonatomic) BOOL drawMajorTicks;
  • Definies a flag indicating whether to draw major grid lines or not.

    Declaration

    Objective-C

    @property (nonatomic) BOOL drawMajorGridLines;
  • Definies a flag indicating whether to draw major bands or not.

    Declaration

    Objective-C

    @property (nonatomic) BOOL drawMajorBands;
  • Definies a flag indicating whether to draw minor ticks or not.

    Declaration

    Objective-C

    @property (nonatomic) BOOL drawMinorTicks;
  • Definies a flag indicating whether to draw minor grid lines or not.

    Declaration

    Objective-C

    @property (nonatomic) BOOL drawMinorGridLines;
  • Definies a flag indicating whether to draw tick labels or not.

    Declaration

    Objective-C

    @property (nonatomic) BOOL drawLabels;
  • Defines the string with value for this axis title.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSString *_Nonnull axisTitle;
  • Defines the attributed string with value for this axis title.

    Warning

    If set - current annotation instance will ignore the axisTitle property.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSAttributedString *_Nonnull attributedAxisTitle;
  • Gets or sets auto range mode for current axis. Default is SCIAutoRange.SCIAutoRange_Once.

    Possible values:

    Declaration

    Objective-C

    @property (nonatomic) SCIAutoRange autoRange;
  • Gets or sets a ISCITickProvider instance on current axis.

    Note

    Used to compute the data-values of Axis Grid Lines, Ticks and Labels.

    Declaration

    Objective-C

    @property (nonatomic, strong) id<ISCITickProvider> _Nonnull tickProvider;
  • Gets or sets a ISCITickCoordinatesProvider instance on current axis.

    Note

    Used to transform the data-values received from ISCITickProvider instance to the coordinates for Axis gridlines, ticks and labels drawing

    Declaration

    Objective-C

    @property (nonatomic, strong) id<ISCITickCoordinatesProvider> _Nonnull tickCoordinatesProvider;
  • Gets or sets a ISCILabelProvider instance.

    Note

    May be used to programmatically override the formatting of text and cursor labels.

    Declaration

    Objective-C

    @property (nonatomic, strong) id<ISCILabelProvider> _Nonnull labelProvider;
  • Defines the TextFormatting string for tick labels on this axis.

    Note

    The format string uses the format patterns from the Unicode Technical Standard #35.

    Declaration

    Objective-C

    @property (nonatomic, copy, nullable) NSString *textFormatting;
  • Defines the text formatting string for labels on this cursor.

    Note

    The format string uses the format patterns from the Unicode Technical Standard #35.

    Declaration

    Objective-C

    @property (nonatomic, copy, nullable) NSString *cursorTextFormatting;
  • Defines the style which is used to draw all major grid lines on this axis.

    Declaration

    Objective-C

    @property (nonatomic, strong) SCIPenStyle *_Nonnull majorGridLineStyle;
  • Defines the style which is used to draw all minor grid lines on this axis.

    Declaration

    Objective-C

    @property (nonatomic, strong) SCIPenStyle *_Nonnull minorGridLineStyle;
  • Defines the style for Axis Bands.

    Declaration

    Objective-C

    @property (nonatomic, strong) SCIBrushStyle *_Nonnull axisBandsStyle;
  • Defines the style which is used to draw all major ticks on this axis.

    Declaration

    Objective-C

    @property (nonatomic, strong) SCIPenStyle *_Nonnull majorTickLineStyle;
  • Gets or sets the style which is used to draw all minor ticks on this axis.

    Declaration

    Objective-C

    @property (nonatomic, strong) SCIPenStyle *_Nonnull minorTickLineStyle;
  • Gets or sets the the length of all major ticks on this axis in pixels.

    Declaration

    Objective-C

    @property (nonatomic) float majorTickLineLength;
  • Gets or sets the the length of all minor ticks on this axis in pixels.

    Declaration

    Objective-C

    @property (nonatomic) float minorTickLineLength;
  • Defines the style which is used to draw axis title.

    Declaration

    Objective-C

    @property (nonatomic, strong) SCIFontStyle *_Nonnull titleStyle;
  • Defines the style which is used to draw all tick labels on this axis.

    Declaration

    Objective-C

    @property (nonatomic, strong) SCIFontStyle *_Nonnull tickLabelStyle;
  • Gets the current ISCICoordinateCalculator for this axis, based on visible range and axis type.

    Declaration

    Objective-C

    @property (nonatomic, strong, readonly) id<ISCICoordinateCalculator> _Nonnull currentCoordinateCalculator;
  • Creates a coordinate calculator from specified visible range.

    Declaration

    Objective-C

    - (nonnull id<ISCICoordinateCalculator>)createCoordinateCalculatorFromRange:
        (nonnull id<ISCIRange>)visibleRange;

    Parameters

    visibleRange

    The visible range to create coordinate calculator from.

    Return Value

    The coordinate calculator instance.

  • Animates the visible range of the axis to the destination visible range, over the specified duration.

    Declaration

    Objective-C

    - (void)animateVisibleRangeTo:(nonnull id<ISCIRange>)range
                     withDuration:(float)duration;

    Parameters

    range

    The end range.

    duration

    The duration of the animation.

  • Gets whether the passed range is valid.

    Declaration

    Objective-C

    - (BOOL)isValidRange:(nonnull id<ISCIRange>)range;

    Parameters

    range

    Passed range, that should be validated.

  • Gets whether visibleRange is valid, e.g. is not nil, the difference between Max and Min is positive.

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL hasValidVisibleRange;
  • Gets whether the visibleRange has default value.

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL hasDefaultVisibleRange;
  • Gets the default non zero ISCIRange, called internally by SciChart to reset the visibleRange of an axis to an default state.

    Declaration

    Objective-C

    @property (nonatomic, strong, readonly) id<ISCIRange> _Nonnull defaultNonZeroRange;
  • Used internally for notification of axis when data range changes.

    Declaration

    Objective-C

    - (void)onDataRangeChanged;
  • Converts given the x or y pixel coordinate to the data value at this coordinate.

    Declaration

    Objective-C

    - (nonnull id<ISCIComparable>)getDataValueFrom:(float)pixelCoordinate;

    Parameters

    pixelCoordinate

    The coordinate in pixels to convert.

    Return Value

    The data value.

  • Converts given data value to the x or y pixel coordinate on this axis.

    Declaration

    Objective-C

    - (float)getCoordinateFrom:(nonnull id<ISCIComparable>)value;

    Parameters

    value

    The data value to convert.

    Return Value

    The coordinate in pixels.

  • Gets or sets the visibility of the Axis.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isVisible;
  • Gets the axis viewport dimension, which is used by ISCICoordinateCalculator of the Axis.

    Declaration

    Objective-C

    @property (nonatomic, readonly) CGFloat axisViewportDimension;
  • String formats the text.

    Declaration

    Objective-C

    - (nonnull id<ISCIString>)formatText:(nonnull id<ISCIComparable>)value;

    Parameters

    value

    The data value to format.

    Return Value

    The string formatted data value.

  • String formats text for the cursor.

    Declaration

    Objective-C

    - (nonnull id<ISCIString>)formatCursorText:(nonnull id<ISCIComparable>)value;

    Parameters

    value

    The data value to format.

    Return Value

    The string formatted data value.

  • Gets the maximum range of the axis, based on the data-range of all series.

    Note

    Computed property, which is calculated via -getMaximumRange: without force cache updating.

    Declaration

    Objective-C

    @property (nonatomic, readonly) id<ISCIRange> _Nonnull maximumRange;
  • Gets the maximum range of the axis, based on the data-range of all series.

    Declaration

    Objective-C

    - (nonnull id<ISCIRange>)getMaximumRange:(BOOL)forceCacheUpdate;

    Parameters

    forceCacheUpdate

    Flag indicating whether the cached results should be updated.

    Return Value

    The maximum range for this axis.

  • Gets the data range (full extents of the data) of the Axis.

    Note

    Computed property, which is calculated via -getDataRange: without force cache updating.

    Declaration

    Objective-C

    @property (nonatomic, readonly) id<ISCIRange> _Nonnull dataRange;
  • Gets the data range (full extents of the data) of the Axis.

    Declaration

    Objective-C

    - (nonnull id<ISCIRange>)getDataRange:(BOOL)forceCacheUpdate;

    Parameters

    forceCacheUpdate

    Flag indicating whether the cached results should be updated.

    Return Value

    The data range for this axis.

  • Defines the SCIVisibleRangeChangeListener for this axis instance.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) SCIVisibleRangeChangeListener visibleRangeChangeListener;
  • Defines the SCIDataRangeChangeListener for this axis instance.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) SCIDataRangeChangeListener dataRangeChangeListener;
  • Gets the lock for current axis params. Used internally for synchronization of axis updated during render pass

    Declaration

    Objective-C

    @property (nonatomic, readonly) id<ISCIReadWriteLock> _Nonnull axisParamsLock;