SciChart iOS Chart Modifiers API allows you to add panning, zooming and rotating functionality to your 3D iOS Charts. This allows you to view the data at the charts in your iOS applications clearly. We support intuitive gesture recognition for this functionality; moreover, you may adjust it right to your needs.

The Modifiers API include Orbit Modifier 3D, Pinch Zoom Modifier 3D, Zoom to Extents Modifier 3D and Free Look Modifier 3D.

You may achieve different views with Camera in iOS charts, that can be modified programmatically as well.

Learn more about Zoom, Pan and Rotate functionality in our SciChart 3D iOS Chart documentation.

// UsingChartModifiers3DView.m

//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2019. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales:   sales@scichart.com
//
// UsingChartModifiers3DView.m is part of the SCICHART® Examples. Permission is hereby granted
// to modify, create derivative works, distribute and publish any part of this source
// code whether for commercial, private or personal use.
//
// The SCICHART® examples are distributed in the hope that they will be useful, but
// without any warranty. It is provided "AS IS" without warranty of any kind, either
// expressed or implied.
//******************************************************************************

#import "UsingChartModifiers3DView.h"
#import "TwoButtonsPanel.h"
#import "SCDDataManager.h"

@implementation UsingChartModifiers3DView

- (void)commonInit {
    TwoButtonsPanel *panel = [[TwoButtonsPanel alloc] initWithFrame:CGRectZero];
    [panel.leftButton setTitle:@"Rotate Horizontal" forState:UIControlStateNormal];
    [panel.rightButton setTitle:@"Rotate Vertical" forState:UIControlStateNormal];
    [panel.leftButton addTarget:self action:@selector(onRotateHorizontal) forControlEvents:UIControlEventTouchUpInside];
    [panel.rightButton addTarget:self action:@selector(onRotateVertical) forControlEvents:UIControlEventTouchUpInside];
    
    self.panel = panel;
}

- (void)initExample {
    SCINumericAxis3D *xAxis = [SCINumericAxis3D new];
    xAxis.growBy = [[SCIDoubleRange alloc] initWithMin:0.1 max:0.1];
    SCINumericAxis3D *yAxis = [SCINumericAxis3D new];
    yAxis.growBy = [[SCIDoubleRange alloc] initWithMin:0.1 max:0.1];
    SCINumericAxis3D *zAxis = [SCINumericAxis3D new];
    zAxis.growBy = [[SCIDoubleRange alloc] initWithMin:0.1 max:0.1];
    
    SCIXyzDataSeries3D *ds = [[SCIXyzDataSeries3D alloc] initWithXType:SCIDataType_Double yType:SCIDataType_Double zType:SCIDataType_Double];
    SCIPointMetadataProvider3D *metadataProvider = [SCIPointMetadataProvider3D new];
    
    const int Count = 25;
    for (int i = 0; i < Count; ++i) {
        const unsigned int color = [SCDDataManager randomColor];
        
        for (double j = 1; j < Count; ++j) {
            const double y = pow(j, 0.3);
            [ds appendX:@(i) y:@(y) z:@(j)];
            
            SCIPointMetadata3D *metadata = [[SCIPointMetadata3D alloc] initWithVertexColor:color andScale:2.0];
            [metadataProvider.metadata addObject:metadata];
        }
    }
    
    SCISpherePointMarker3D *pointMarker = [SCISpherePointMarker3D new];
    pointMarker.size = 2.f;
    
    SCIScatterRenderableSeries3D *rs = [SCIScatterRenderableSeries3D new];
    rs.dataSeries = ds;
    rs.pointMarker = pointMarker;
    rs.metadataProvider = metadataProvider;
    
    SCIZoomExtentsModifier3D *zoomExtentsModifier3D = [SCIZoomExtentsModifier3D new];
    zoomExtentsModifier3D.animationDuration = 0.8;
    zoomExtentsModifier3D.resetPosition = [[SCIVector3 alloc] initWithX:200 y:200 z:200];
    zoomExtentsModifier3D.resetTarget = [[SCIVector3 alloc] initWithX:0 y:0 z:0];
    
    [SCIUpdateSuspender usingWithSuspendable:self.surface withBlock:^{
        self.surface.xAxis = xAxis;
        self.surface.yAxis = yAxis;
        self.surface.zAxis = zAxis;
        [self.surface.renderableSeries add:rs];
        [self.surface.chartModifiers add:[SCIPinchZoomModifier3D new]];
        [self.surface.chartModifiers add:[[SCIOrbitModifier3D alloc] initWithDefaultNumberOfTouches:1]];
        [self.surface.chartModifiers add:[[SCIFreeLookModifier3D alloc] initWithDefaultNumberOfTouches:2]];
        [self.surface.chartModifiers add:zoomExtentsModifier3D];
    }];
}

- (void)onRotateHorizontal {
    id<ISCICameraController> camera = self.surface.camera;
    float orbitalYaw = camera.orbitalYaw;
    
    if (orbitalYaw < 360) {
        camera.orbitalYaw = orbitalYaw + 90;
    } else {
        camera.orbitalYaw = 360 - orbitalYaw;
    }
}

- (void)onRotateVertical {
    id<ISCICameraController> camera = self.surface.camera;
    float orbitalPitch = camera.orbitalPitch;
    
    if (orbitalPitch < 89) {
        camera.orbitalPitch = orbitalPitch + 90;
    } else {
        camera.orbitalPitch = -90;
    }
}

@end

// UsingChartModifiers3DView.swift

//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2019. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales:   sales@scichart.com
//
// UsingChartModifiers3DView.swift is part of the SCICHART® Examples. Permission is hereby granted
// to modify, create derivative works, distribute and publish any part of this source
// code whether for commercial, private or personal use.
//
// The SCICHART® examples are distributed in the hope that they will be useful, but
// without any warranty. It is provided "AS IS" without warranty of any kind, either
// expressed or implied.
//******************************************************************************

class UsingChartModifiers3DView: TopPanel3DChartLayout {
    
    let Count = 25
    
    override func commonInit() {
        let panel = TwoButtonsPanel()
        panel.leftButton?.setTitle("Rotate Horizontal", for: .normal)
        panel.rightButton?.setTitle("Rotate Vertical", for: .normal)
        panel.leftButton?.addTarget(self, action: #selector(UsingChartModifiers3DView.onRotateHorizontal), for: .touchUpInside)
        panel.rightButton?.addTarget(self, action: #selector(UsingChartModifiers3DView.onRotateVertical), for: .touchUpInside)
        
        self.panel = panel
    }
    
    override func initExample() {
        let xAxis = SCINumericAxis3D()
        xAxis.growBy = SCIDoubleRange(min: 0.1, max: 0.1)
        let yAxis = SCINumericAxis3D()
        yAxis.growBy = SCIDoubleRange(min: 0.1, max: 0.1)
        let zAxis = SCINumericAxis3D()
        zAxis.growBy = SCIDoubleRange(min: 0.1, max: 0.1)
        
        let ds = SCIXyzDataSeries3D(xType: .double, yType: .double, zType: .double)
        let metadataProvider = SCIPointMetadataProvider3D()
        
        for i in 0 ..< Count {
            let color = SCDDataManager.randomColor()
            for j in 1 ..< Count {
                let y = pow(Double(j), 0.3)
                ds.append(x: i, y: y, z: j)
                
                let metadata = SCIPointMetadata3D(vertexColor: color, andScale: 2.0)
                metadataProvider.metadata.add(metadata)
            }
        }
        
        let pointMarker = SCISpherePointMarker3D()
        pointMarker.size = 2.0
        
        let rs = SCIScatterRenderableSeries3D()
        rs.dataSeries = ds
        rs.pointMarker = pointMarker
        rs.metadataProvider = metadataProvider
        
        let zoomExtentsModifier = SCIZoomExtentsModifier3D()
        zoomExtentsModifier.animationDuration = 0.8
        zoomExtentsModifier.resetPosition = SCIVector3(x: 200.0, y: 200.0, z: 200.0);
        zoomExtentsModifier.resetTarget = SCIVector3(x: 0.0, y: 0.0, z: 0.0);
        
        SCIUpdateSuspender.usingWith(surface) {
            self.surface.xAxis = xAxis
            self.surface.yAxis = yAxis
            self.surface.zAxis = zAxis
            self.surface.renderableSeries.add(rs)
            self.surface.chartModifiers.add(items: SCIPinchZoomModifier3D(), SCIOrbitModifier3D(defaultNumberOfTouches: 1), SCIFreeLookModifier3D(defaultNumberOfTouches: 2), zoomExtentsModifier)
        }
    }
    
    @objc func onRotateHorizontal() {
        let camera: ISCICameraController? = surface.camera
        let orbitalYaw = camera?.orbitalYaw
        
        if (orbitalYaw ?? 0.0) < 360 {
            camera?.orbitalYaw = (orbitalYaw ?? 0.0) + 90
        } else {
            camera?.orbitalYaw = 360 - (orbitalYaw ?? 0.0)
        }
    }
    
    @objc func onRotateVertical() {
        let camera: ISCICameraController? = surface.camera
        let orbitalPitch = camera?.orbitalPitch
        
        if (orbitalPitch ?? 0.0) < 89 {
            camera?.orbitalPitch = (orbitalPitch ?? 0.0) + 90
        } else {
            camera?.orbitalPitch = -90
        }
    }
}

< BACK TO ALL IOS CHART CHART EXAMPLES