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 "SCDButtonsTopPanel.h"
#import "SCDToolbarButton.h"
#import "SCDDataManager.h"
#import "SCDToolbarButtonsGroup.h"

@implementation UsingChartModifiers3DView

- (Class)associatedType { return SCIChartSurface3D.class; }

- (NSArray<id<ISCDToolbarItemModel>> *)panelItems {
    __weak typeof(self) wSelf = self;
    return @[
        [[SCDToolbarButton alloc] initWithTitle:@"Rotate Horizontal" image:nil andAction:^{ [wSelf rotateHorizontal]; }],
        [[SCDToolbarButton alloc] initWithTitle:@"Rotate Vertical" image:nil andAction:^{ [wSelf rotateVertical]; }],
    ];
}

#if TARGET_OS_OSX
- (NSArray<id<ISCDToolbarItem>> *)provideExampleSpecificToolbarItems {
    return @[[[SCDToolbarButtonsGroup alloc] initWithToolbarItems:self.panelItems]];
}
#elif TARGET_OS_IOS
- (SCIView *)providePanel {
    return [[SCDButtonsTopPanel alloc] initWithToolbarItems:self.panelItems];
}
#endif

- (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 dataSeriesCount = 25;
    for (int i = 0; i < dataSeriesCount; ++i) {
        const unsigned int color = [SCDDataManager randomColor];
        
        for (double j = 1; j < dataSeriesCount; ++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 *rSeries = [SCIScatterRenderableSeries3D new];
    rSeries.dataSeries = ds;
    rSeries.pointMarker = pointMarker;
    rSeries.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:rSeries];
        [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)rotateHorizontal {
    id<ISCICameraController> camera = self.surface.camera;
    float orbitalYaw = camera.orbitalYaw;
    
    if (orbitalYaw < 360) {
        camera.orbitalYaw = orbitalYaw + 90;
    } else {
        camera.orbitalYaw = 360 - orbitalYaw;
    }
}

- (void)rotateVertical {
    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: SCDSingleChartWithTopPanelViewController<SCIChartSurface3D> {
    
    override var associatedType: AnyClass { return SCIChartSurface3D.self }
    
    private var panelItems: [ISCDToolbarItemModel] {
        return [
            SCDToolbarButton(title: "Rotate Horizontal", image: nil, andAction: { [weak self] in self?.onRotateHorizontal() }),
            SCDToolbarButton(title: "Rotate Vertical", image: nil, andAction: { [weak self] in self?.onRotateVertical() }),
        ]
    }
    
#if os(OSX)
    override func provideExampleSpecificToolbarItems() -> [ISCDToolbarItem] {
        return [SCDToolbarButtonsGroup(toolbarItems: panelItems)]
    }
#elseif os(iOS)
    override func providePanel() -> SCIView {
        return SCDButtonsTopPanel(toolbarItems: self.panelItems)
    }
#endif
    
    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()
        
        let dataSeriesCount = 25
        
        for i in 0 ..< dataSeriesCount {
            let color = SCDDataManager.randomColor()
            for j in 1 ..< dataSeriesCount {
                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 rSeries = SCIScatterRenderableSeries3D()
        rSeries.dataSeries = ds
        rSeries.pointMarker = pointMarker
        rSeries.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(rSeries)
            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 & MACOS CHARTS CHART EXAMPLES