
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 toattach
renderable series to SCIChartSurface
, setup axes ID
and provide data series
.
See
ISCIDataSeries
.
See
ISCIPointMarker
.
-
Provides the color which represents this
ISCIRenderableSeries
instance.Declaration
Objective-C
@property (nonatomic, strong, readonly) UIColor *_Nonnull seriesColor;
-
Gets or sets the stroke style of this renderable series instance.
Declaration
Objective-C
@property (nonatomic, strong) SCIPenStyle *_Nonnull strokeStyle;
-
Gets or sets the id of XAxis that this
ISCIRenderableSeries
is associated with.Warning
Make sure that axis with given ID attached toSCIChartSurface
.Declaration
Objective-C
@property (nonatomic, copy) NSString *_Nonnull xAxisId;
-
Gets or sets the id of YAxis that this
ISCIRenderableSeries
is associated with.Warning
Make sure that axis with given ID attached toSCIChartSurface
.Declaration
Objective-C
@property (nonatomic, copy) NSString *_Nonnull yAxisId;
-
Gets the
X-Axis
that thisISCIRenderableSeries
is associated with.Declaration
Objective-C
@property (nonatomic, weak, readonly, nullable) id<ISCIAxis> xAxis;
-
Gets the
Y-Axis
that thisISCIRenderableSeries
is associated with.Declaration
Objective-C
@property (nonatomic, weak, readonly, nullable) id<ISCIAxis> yAxis;
-
Defines the
SCIResamplingMode
used when drawing this series.Declaration
Objective-C
@property (nonatomic) SCIResamplingMode resamplingMode;
-
Provides the current
ISCISeriesRenderPassData
instance which is used for render pass.Declaration
Objective-C
@property (nonatomic, strong, readonly) id<ISCISeriesRenderPassData> _Nonnull currentRenderPassData;
-
Defines the
ISCIPointMarker
for this renderable series.Declaration
Objective-C
@property (nonatomic, strong, nullable) id<ISCIPointMarker> pointMarker;
-
Defines the
ISCISeriesInfoProvider
instance associated with this series.Declaration
Objective-C
@property (nonatomic, strong) id<ISCISeriesInfoProvider> _Nonnull seriesInfoProvider;
-
Defines the
ISCIRenderPassDataTransformation
instance associated with this series.Declaration
Objective-C
@property (nonatomic, strong, nullable) id<ISCIRenderPassDataTransformation> renderPassDataTransformation;
-
Defines the
ISCIPaletteProvider
instance associated with this series.Declaration
Objective-C
@property (nonatomic, strong, nullable) id<ISCIPaletteProvider> paletteProvider;
-
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;
-
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;
-
Gets the
ISCIReadWriteLock
instance to lock render pass dataDeclaration
Objective-C
@property (nonatomic, readonly) id<ISCIReadWriteLock> _Nonnull renderPassDataLock;
-
Gets the
ISCIReadWriteLock
instance to lock data seriesDeclaration
Objective-C
@property (nonatomic, readonly) id<ISCIReadWriteLock> _Nonnull dataSeriesLock;
-
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;
Return Value
The XRange of this series.
-
Sets the category data range (range of indices used by
SCICategoryAxisBase
of theISCIRenderableSeries
) 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;
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;
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;
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;
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;
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;
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;
Parameters
xAxis
The
X-Axis
instance that thisISCIRenderableSeries
is associated with.yAxis
The
Y-Axis
instance that thisISCIRenderableSeries
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;