iOS & macOS charts - Examples
Please note! These examples are new to SciChart iOS v4 release! SciChart’s OpenGL ES and Metal iOS and Metal macOS Chart library ships with hundred of Objective-C and Swift iOS & macOS Chart Examples which you can browse, play with and view the source-code. All of this is possible with the new and improved SciChart iOS Examples Suite and demo application for Mac, which ships as part of the SciChart SDK.
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.
The Swift and Objective-C source code for the iOS and macOS Use Chart Modifiers 3D example is included below (Scroll down!).
Did you know that we have the source code for all our example available for free on Github?
Clone the SciChart.iOS.Examples from Github.
Also the SciChart iOS and Scichart macOS Trials contain the full source for the examples (link below).
UsingChartModifiers3DView.m
View source code//******************************************************************************
// 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
View source code//******************************************************************************
// 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
}
}
}
