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

ISCIAxis

Defines the base interface to an Axis used throughout SciChart 2D.

  • Gets or sets whether current Axis is the main one in axis collection.

    Note

    This is the axis which is responsible for drawing grid lines.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isPrimaryAxis;
  • Gets or sets whether this axis is an X-Axis or not.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isXAxis;
  • Gets or sets whether current Axis should be placed in the center of the chart or not.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isCenterAxis;
  • Deprecated

    Please use currentCoordinateCalculator ICoordinateCalculator.isCategoryAxisCalculator

    Gets a value indicating whether this instance is a category axis.

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL isCategoryAxis;
  • Gets whether this axis is horizontal or not.

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL isHorizontalAxis;
  • Gets whether this axis is flipped (e.g Y-Axis on the bottom or top, or X-Axis on the left or right).

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL isAxisFlipped;
  • Gets or sets the SCIAxisAlignment for this Axis.

    Declaration

    Objective-C

    @property (nonatomic) SCIAxisAlignment axisAlignment;
  • Gets or sets the Axis Orientation, e.g. Horizontal (XAxis) or Vertical (YAxis).

    Declaration

    Objective-C

    @property (nonatomic) SCIOrientation orientation;
  • Gets or sets a value indicating whether label culling is enabled (when labels overlap) on this axis instance.

    Declaration

    Objective-C

    @property (nonatomic) BOOL isLabelCullingEnabled;
  • Gets a value indicating whether marginal labels get shifted to fit inside an axis when too long.

    Declaration

    Objective-C

    @property (nonatomic) BOOL autoFitMarginalLabels;
  • Gets or sets axis title placement.

    Declaration

    Objective-C

    @property (nonatomic) SCIAxisTitlePlacement axisTitlePlacement;
  • Gets or sets axis title orientation.

    Declaration

    Objective-C

    @property (nonatomic) SCIAxisTitleOrientation axisTitleOrientation;
  • Gets or sets axis title alignment.

    Declaration

    Objective-C

    @property (nonatomic) SCIAlignment axisTitleAlignment;
  • Defines axis title margins.

    Note

    Defines spacing to use when laying out content in the view.

    Declaration

    Objective-C

    @property (nonatomic) UIEdgeInsets axisTitleMargins;
  • Defines style for axis tick labels.

    Declaration

    Objective-C

    @property (nonatomic, strong) SCIAxisTickLabelStyle *_Nonnull axisTickLabelStyle;
  • Gets the current ISCIAxisInteractivityHelper for this Axis.

    Declaration

    Objective-C

    @property (strong, readonly) id<ISCIAxisInteractivityHelper> _Nonnull currentInteractivityHelper;
  • Called by the SCIChartSurface internally.

    Note

    Returns the max range only for that axis(by the data-series on it)

    Declaration

    Objective-C

    - (nonnull id<ISCIRange>)getWindowedYRangeWithXRanges:
        (nullable NSDictionary<NSString *, id<ISCICoordinateCalculator>> *)
            xCoordCalcs;

    Parameters

    xCoordCalcs

    Calculates the max range based on corresponding x coordinate calculators.

    Return Value

    The calculated windowed YRange.

  • Scrolls current ISCIAxisCore.visibleRange by specified number of pixels.

    Note

    e.g. SCIClipMode_ClipAtExtents prevents panning outside of the Axis, SCIClipMode_None allows panning outside.

    Declaration

    Objective-C

    - (void)scrollByPixels:(CGFloat)pixelsToScroll clipMode:(SCIClipMode)clipMode;

    Parameters

    pixelsToScroll

    Scroll N pixles from the current visible range.

    clipMode

    Defines how scrolling behaves when you reach the edge of the Axis extents.

  • Scrolls current ISCIAxisCore.visibleRange by the specified number of pixels with the specified animation duration.

    Note

    e.g. SCIClipMode_ClipAtExtents prevents panning outside of the Axis, SCIClipMode_None allows panning outside.

    Declaration

    Objective-C

    - (void)scrollByPixels:(CGFloat)pixelsToScroll
                  clipMode:(SCIClipMode)clipMode
                  duration:(NSTimeInterval)duration;

    Parameters

    pixelsToScroll

    Scroll N pixels from the current visible range

    clipMode

    Defines how scrolling behaves when you reach the edge of the Axis extents.

    duration

    The duration of animation when zooming to extents.

  • Scrolls current ISCIAxisCore.visibleRange by the specified number of pixels with the specified animation duration.

    Declaration

    Objective-C

    - (void)scrollByPixels:(CGFloat)pixelsToScroll
                  clipMode:(SCIClipMode)clipMode
                clipTarget:(SCIClipModeTarget)clipTarget;

    Parameters

    pixelsToScroll

    Scroll N pixels from the current visible range.

    clipMode

    Defines how scrolling behaves when you reach the edge of the Axis extents.

    clipTarget

    Defines target which is used for clipping.

  • Scrolls current ISCIAxisCore.visibleRange by the specified number of pixels with the specified animation duration.

    Declaration

    Objective-C

    - (void)scrollByPixels:(CGFloat)pixelsToScroll
                  clipMode:(SCIClipMode)clipMode
                clipTarget:(SCIClipModeTarget)clipTarget
                  duration:(NSTimeInterval)duration;

    Parameters

    pixelsToScroll

    Scroll N pixels from the current visible range.

    clipMode

    Defines how scrolling behaves when you reach the edge of the Axis extents.

    clipTarget

    Defines target which is used for clipping.

    duration

    The duration of animation when zooming to extents.

  • Performs zoom on current Axis, using fromCoord as a coordinate of new range start and toCoord as a coordinate of new range end.

    Declaration

    Objective-C

    - (void)zoomFrom:(CGFloat)fromCoord to:(CGFloat)toCoord;

    Parameters

    fromCoord

    The coordinate of new range start in pixels.

    toCoord

    The coordinate of new range end in pixels.

  • Performs zoom on current Axis, using fromCoord as a coordinate of new range start and toCoord as a coordinate of new range end.

    Declaration

    Objective-C

    - (void)zoomFrom:(CGFloat)fromCoord
                  to:(CGFloat)toCoord
            duration:(NSTimeInterval)duration;

    Parameters

    fromCoord

    The coordinate of new range start in pixels.

    toCoord

    The coordinate of new range end in pixels.

    duration

    The duration of animation when zooming to extents.

  • Performs zoom on current Axis, using minFraction as a multuplier of range start and maxFraction as a multiplier of range end.

    Declaration

    Objective-C

    - (void)zoomByFractionMin:(CGFloat)minFraction max:(CGFloat)maxFraction;

    Parameters

    minFraction

    The miltiplier of range start.

    maxFraction

    The miltiplier of range end.

  • Performs zoom on current Axis, using minFraction as a multuplier of range start and maxFraction as a multiplier of range end.

    Declaration

    Objective-C

    - (void)zoomByFractionMin:(CGFloat)minFraction
                          max:(CGFloat)maxFraction
                     duration:(NSTimeInterval)duration;

    Parameters

    minFraction

    The miltiplier of range start.

    maxFraction

    The miltiplier of range end.

    duration

    The duration of animation when zooming to extents.

  • Perform a HitTest on this Axis at specified data point.

    Declaration

    Objective-C

    - (nonnull SCIAxisInfo *)hitTestValue:(nonnull id<ISCIComparable>)value;

    Parameters

    value

    data value for hit test.

    Return Value

    The SCIAxisInfo which contains the HitTest results.

  • Gets or sets the ISCIAxisInfoProvider instance associated with this axis.

    Declaration

    Objective-C

    @property (nonatomic, strong) id<ISCIAxisInfoProvider> _Nonnull axisInfoProvider;
  • Gets or sets the ISCIAxisInfoProvider instance associated with this axis.

    Declaration

    Objective-C

    @property (nonatomic, strong, readonly) id<ISCIAxisModifierSurface> _Nonnull axisModifierSurface;
  • Updates measurements of axis for proper layout of its content.

    Declaration

    Objective-C

    - (void)updateAxisMeasurements;
  • Gets current SCIAxisLayoutState for this axis instance.

    Declaration

    Objective-C

    @property (nonatomic, strong, readonly) SCIAxisLayoutState *_Nonnull axisLayoutState;
  • Gets offset, which is used by ISCICoordinateCalculator of this Axis.

    Declaration

    Objective-C

    @property (nonatomic, readonly) CGFloat axisOffset;
  • Performs core update of axis.

    Declaration

    Objective-C

    - (void)updateCore:(nonnull SCIRenderPassState *)renderPassState;

    Parameters

    renderPassState

    The SCIRenderPassState instance for current render pass.