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

ISCIRenderableSeries

@protocol
    ISCIRenderableSeries <ISCIRenderableSeriesCore, ISCIDrawable, ISCIUpdatable,
                          ISCIThemeable, ISCIRenderSurfaceChangedListener>

Defines the protocol for all RenderableSeries within SciChart.

Note

Renderable series is charts visual part. For it to be displayed you have to attach renderable series to SCIChartSurface, setup axes ID and provide data series.

See

SCIRenderableSeriesBase.

See

ISCIDataSeries.

See

ISCIPointMarker.

See

SCIFastLineRenderableSeries.

See

SCIFastMountainRenderableSeries.

See

SCIFastColumnRenderableSeries.

See

SCIFastCandlestickRenderableSeries.

See

SCIFastImpulseRenderableSeries.

See

SCIXyScatterRenderableSeries.

  • Provides the color which represents this ISCIRenderableSeries instance.

    Declaration

    Objective-C

    @property (nonatomic, strong, readonly) UIColor *_Nonnull seriesColor;

    Swift

    var seriesColor: UIColor { get }

  • Gets or sets the stroke style of this renderable series instance.

    Declaration

    Objective-C

    @property (nonatomic, strong) SCIPenStyle *_Nonnull strokeStyle;

    Swift

    var strokeStyle: SCIPenStyle { get set }

  • Gets or sets the id of XAxis that this ISCIRenderableSeries is associated with.

    Warning

    Make sure that axis with given ID attached to SCIChartSurface.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSString *_Nonnull xAxisId;

    Swift

    var xAxisId: String { get set }

  • Gets or sets the id of YAxis that this ISCIRenderableSeries is associated with.

    Warning

    Make sure that axis with given ID attached to SCIChartSurface.

    Declaration

    Objective-C

    @property (nonatomic, copy) NSString *_Nonnull yAxisId;

    Swift

    var yAxisId: String { get set }

  • Gets the X-Axis that this ISCIRenderableSeries is associated with.

    Declaration

    Objective-C

    @property (nonatomic, weak, readonly, nullable) id<ISCIAxis> xAxis;

    Swift

    weak var xAxis: (any ISCIAxis)? { get }

  • Gets the Y-Axis that this ISCIRenderableSeries is associated with.

    Declaration

    Objective-C

    @property (nonatomic, weak, readonly, nullable) id<ISCIAxis> yAxis;

    Swift

    weak var yAxis: (any ISCIAxis)? { get }

  • Defines the SCIResamplingMode used when drawing this series.

    Declaration

    Objective-C

    @property (nonatomic) SCIResamplingMode resamplingMode;

    Swift

    var resamplingMode: SCIResamplingMode { get set }

  • Provides the current ISCISeriesRenderPassData instance which is used for render pass.

    Declaration

    Objective-C

    @property (nonatomic, strong, readonly) id<ISCISeriesRenderPassData> _Nonnull currentRenderPassData;

    Swift

    var currentRenderPassData: any ISCISeriesRenderPassData { get }

  • Defines the ISCIPointMarker for this renderable series.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) id<ISCIPointMarker> pointMarker;

    Swift

    var pointMarker: (any ISCIPointMarker)? { get set }

  • Defines the ISCISeriesInfoProvider instance associated with this series.

    Declaration

    Objective-C

    @property (nonatomic, strong) id<ISCISeriesInfoProvider> _Nonnull seriesInfoProvider;

    Swift

    var seriesInfoProvider: any ISCISeriesInfoProvider { get set }

  • Defines the ISCIRenderPassDataTransformation instance associated with this series.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) id<ISCIRenderPassDataTransformation> renderPassDataTransformation;

    Swift

    var renderPassDataTransformation: (any ISCIRenderPassDataTransformation)? { get set }

  • Defines the ISCIPaletteProvider instance associated with this series.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) id<ISCIPaletteProvider> paletteProvider;

    Swift

    var paletteProvider: (any ISCIPaletteProvider)? { get set }

  • Defines the ISCIDataSeries associated with this series.

    Warning

    Make sure that data series type is suitable for specific given renderable series. Check in documentation for specific renderable series.

    Declaration

    Objective-C

    @property (nonatomic, strong, nullable) id<ISCIDataSeries> dataSeries;

    Swift

    var dataSeries: (any ISCIDataSeries)? { get set }

  • Gets whether this renderable series has data series to draw. YES - if has data series to draw.

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL hasDataSeries;

    Swift

    var hasDataSeries: Bool { get }

  • Gets the ISCIReadWriteLock instance to lock render pass data

    Declaration

    Objective-C

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

    Swift

    var renderPassDataLock: any ISCIReadWriteLock { get }

  • Gets the ISCIReadWriteLock instance to lock data series

    Declaration

    Objective-C

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

    Swift

    var dataSeriesLock: any ISCIReadWriteLock { get }

  • Returns the data range of the ISCIRenderableSeries on X direction by querying the associated data series. Individual RenderableSeries implementations may override this method to provide custom ranging on per-series basis.

    Declaration

    Objective-C

    - (nonnull id<ISCIRange>)getXRange;

    Swift

    func getXRange() -> any ISCIRange

    Return Value

    The XRange of this series.

  • Sets the category data range (range of indices used by SCICategoryAxisBase of the ISCIRenderableSeries) on X direction by querying the associated data series. Individual RenderableSeries implementations may override this method to provide custom ranging on per-series basis.

    Declaration

    Objective-C

    - (void)getCategoryXRange:(nonnull id<ISCIRange>)categoryXRange;

    Swift

    func getCategoryXRange(_ categoryXRange: any ISCIRange)

    Parameters

    categoryXRange

    The category XRange instance to set based on value of this series

  • Returns the data range of the ISCIRenderableSeries on Y direction by querying the associated data series. Individual RenderableSeries implementations may override this method to provide custom ranging on per-series basis.

    Declaration

    Objective-C

    - (nonnull id<ISCIRange>)getYRange;

    Swift

    func getYRange() -> any ISCIRange

    Return Value

    The Y-Range of this series.

  • Returns the data range of the ISCIRenderableSeries on Y direction by querying the associated data series.

    Declaration

    Objective-C

    - (nonnull id<ISCIRange>)getYRange:
                             (nonnull id<ISCICoordinateCalculator>)xCoordCalc
                          positive:(BOOL)getPositiveRange;

    Swift

    func getYRange(_ xCoordCalc: any ISCICoordinateCalculator, positive getPositiveRange: Bool) -> any ISCIRange

    Parameters

    xCoordCalc

    The XAxis coordinate calculator currently used.
    getPositiveRange

    Indicates whether to return positive YRange only.

    Return Value

    The YRange of this series.

  • Performs a hit-test at the specific point (x,y coordinate) on the parent renderableSeries area.

    Declaration

    Objective-C

    - (void)hitTest:(nonnull SCIHitTestInfo *)hitTestResult at:(CGPoint)point;

    Swift

    func hitTest(_ hitTestResult: SCIHitTestInfo, at point: CGPoint)

    Parameters

    hitTestResult

    The SCIHitTestInfo instance where result of hit-test should be stored.
    point

    The x-y coordinates in pixels relative to parent renderableSeries area.

  • Performs a hit-test at the specific point (x,y coordinate) on the parent renderableSeries area.

    Declaration

    Objective-C

    - (void)hitTest:(nonnull SCIHitTestInfo *)hitTestResult
                   at:(CGPoint)point
    withHitTestRadius:(float)hitTestRadius;

    Swift

    func hitTest(_ hitTestResult: SCIHitTestInfo, at point: CGPoint, withHitTestRadius hitTestRadius: Float)

    Parameters

    hitTestResult

    The SCIHitTestInfo instance where result of hit-test should be stored.
    point

    The x-y coordinates in pixels relative to parent renderableSeries area.
    hitTestRadius

    The radius in pixels to determine whether hit point is over a data point.

  • Performs a hit-test at the specific point with zero hit-test radius. Method consider only X values and returns the closes X value.

    Declaration

    Objective-C

    - (void)verticalSliceHitTest:(nonnull SCIHitTestInfo *)hitTestResult
                          at:(CGPoint)point;

    Swift

    func verticalSliceHitTest(_ hitTestResult: SCIHitTestInfo, at point: CGPoint)

    Parameters

    hitTestResult

    The SCIHitTestInfo instance where result of hit-test should be stored.
    point

    The x-y coordinates in pixels relative to parent renderableSeries area.

  • Called during render pass and updates current render pass data.

    Declaration

    Objective-C

    - (void)updateRenderPassDataWithXAxis:(nonnull id<ISCIAxis>)xAxis
                                yAxis:(nonnull id<ISCIAxis>)yAxis
                      renderPassState:
                          (nonnull SCIRenderPassState *)renderPassState;

    Swift

    func updateRenderPassData(withXAxis xAxis: any ISCIAxis, yAxis: any ISCIAxis, renderPassState: SCIRenderPassState)

    Parameters

    xAxis

    The X-Axis instance that this ISCIRenderableSeries is associated with.
    yAxis

    The Y-Axis instance that this ISCIRenderableSeries is associated with.
    renderPassState

    The current render pass state.

  • Asynchronously requests invalidate of renderPassData provided by ISCISeriesRenderPassData and then invalidates this renderable series.

    Declaration

    Objective-C

    - (void)invalidateRenderPassData;

    Swift

    func invalidateRenderPassData()

© 2025 SciChart. All rights reserved. (Last updated: 2025-12-23)

Generated by jazzy ♪♫ v0.14.4, a Realm project.