
iOS & macOS Charting Documentation - SciChart iOS & macOS Charts SDK v4.x
Zoom Extents Modifier 3D
SciChart iOS 3D provides the ability to zoom-to-fit the entire 3D chart by double-tapping it via the SCIZoomExtentsModifier3D
, available out of the box.
Besides common features which are inherited from the SCIChartModifier3DBase
class,
the SCIZoomExtentsModifier3D
allows to control its specific features via the following properties:
SCIZoomExtentsModifier3D.resetTarget
- defines theSCIVector3D
target where theISCICameraController.target
is moved on reset.SCIZoomExtentsModifier3D.resetPosition
- defines theSCIVector3D
target where theISCICameraController.position
is moved on reset.SCIZoomExtentsModifier3D.executeOn
- allows to specify the trigger action for the modifier via theSCIExecuteOn
enumeration.SCIZoomExtentsModifier3D.autoFitRadius
- WhenYES
, attempts to auto-fit the camera radius to fit the scene. WhenNO
- uses theresetPosition
andresetTarget
instead.SCIZoomExtentsModifier3D.animationDuration
- defines the animation duration inNSTimeInterval
for any zoom operations.
NOTE: There are several modes defined by the
SCIExecuteOn
enumeration, such as Single Tap, Double Tap, Long Press, and Fling.
There are two modes of operation for the SCIZoomExtentsModifier3D
- AutoFit and Manual:
Operation Mode | Description |
---|---|
autoFitRadius = YES |
Tries to automatically fit the 3D scene into the viewport. ISCICameraController.target and ISCICameraController.position properties are ignored. |
autoFitRadius = NO |
You should specify the precise coordinates for the ISCICameraController.target and ISCICameraController.position properties. |
Adding a SCIZoomExtentsModifier to a Chart
Any Chart Modifier 3D can be added to a SCIChartSurface3D
via the ISCIChartSurface3D.chartModifiers
property and SCIZoomExtentsModifier3D
with no difference:
NOTE: To learn more about features available, please read on the Chart Modifier 3D APIs article.
Programmatically Zoom to Extents
You can also run Zoom to Extents functionality programmatically without adding SCIZoomExtentsModifier3D
.
The SCICamera3D
object which is associated with SCIChartSurface3D
provides the following methods which you can call whenever you need to zoom the chart to fit: