// Android Chart Examples

SciChart Android ships with ~90 Android Chart Examples which you can browse, play with, view the source-code and even export each SciChart Android Chart Example to a stand-alone Android Studio project. All of this is possible with the new and improved SciChart Android Examples Suite, which ships as part of our Android Charts SDK.

DOWNLOAD SCICHART ANDROID

// Android 3D Modify Camera3D Properties

This example presents how Camera 3D work in SciChart for Android. It shows how different properties define the view port as seen by the camera.

Read more in our documentation article about SciChart Android 3D SciChartSurface Camera.

// Source Code

The full source code for the Android 3D Modify Camera3D Properties example is included below (Scroll down!).

Did you know you can also view the source code from one of the following sources as well?

Clone the SciChart.Android.Examples from Github.
Or, view source and export each example to an Android Studio project from the Java version of the SciChart Android Examples app.
Also the SciChart Android Trial contains the full source for the examples (link below).

DOWNLOAD THE ANDROID CHART EXAMPLES

Android 3D Modify Camera3D Properties - View Source Code for this example

The SciChart Examples source code is available on Github and viewable in-app for some platforms

// Kotlin: ModifyCamera3DPropertiesFragment.kt

//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2021. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales:   sales@scichart.com
//
// ModifyCamera3DPropertiesFragment.kt is part of SCICHART®, High Performance Scientific Charts
// For full terms and conditions of the license, see http://www.scichart.com/scichart-eula/
//
// This source code is protected by international copyright law. Unauthorized
// reproduction, reverse-engineering, or distribution of all or any portion of
// this source code is strictly prohibited.
//
// This source code contains confidential and proprietary trade secrets of
// SciChart Ltd., and should at no time be copied, transferred, sold,
// distributed or made available without express written permission.
//******************************************************************************

package com.scichart.examples.fragments.examples3d.zoomAndPan3DChart.kt

import android.view.LayoutInflater
import android.view.View
import android.widget.SeekBar
import com.scichart.charting3d.visuals.SciChartSurface3D
import com.scichart.charting3d.visuals.camera.Camera3D
import com.scichart.charting3d.visuals.camera.ICameraController
import com.scichart.charting3d.visuals.camera.ICameraUpdateListener
import com.scichart.core.utility.Dispatcher
import com.scichart.examples.databinding.ExampleChart3dCameraPropertiesFragmentBinding
import com.scichart.examples.fragments.base.ExampleBaseFragment
import com.scichart.examples.utils.SeekBarChangeListenerBase
import com.scichart.examples.utils.scichartExtensions.chartModifiers
import com.scichart.examples.utils.scichartExtensions.defaultModifiers3D
import com.scichart.examples.utils.scichartExtensions.numericAxis3D
import com.scichart.examples.utils.scichartExtensions.suspendUpdates
import java.text.DecimalFormat
import kotlin.math.roundToInt

class ModifyCamera3DPropertiesFragment : ExampleBaseFragment<ExampleChart3dCameraPropertiesFragmentBinding>(), ICameraUpdateListener {
    override fun inflateBinding(inflater: LayoutInflater): ExampleChart3dCameraPropertiesFragmentBinding {
        return ExampleChart3dCameraPropertiesFragmentBinding.inflate(inflater)
    }

    override fun initExample(binding: ExampleChart3dCameraPropertiesFragmentBinding) {
        val camera = Camera3D().apply { setCameraUpdateListener(this@ModifyCamera3DPropertiesFragment) }
        binding.surface3d.suspendUpdates {
            this.camera = camera

            xAxis = numericAxis3D()
            yAxis = numericAxis3D()
            zAxis = numericAxis3D()

            chartModifiers { defaultModifiers3D() }

            setUpSeekBarListeners(binding, this)
            binding.lhsRadioButton.setOnClickListener { this.isLeftHandedCoordinateSystem = true }
            binding.rhsRadioButton.setOnClickListener { this.isLeftHandedCoordinateSystem = false }
        }

        binding.perspectiveRadioButton.setOnClickListener {
            camera.toPerspective()

            binding.perspectiveProperties.visibility = View.VISIBLE
            binding.orthogonalProperties.visibility = View.GONE
        }

        binding.orthogonalRadioButton.setOnClickListener {
            camera.toOrthogonal()

            binding.perspectiveProperties.visibility = View.GONE
            binding.orthogonalProperties.visibility = View.VISIBLE
        }
    }

    private fun setUpSeekBarListeners(binding: ExampleChart3dCameraPropertiesFragmentBinding, surface3d: SciChartSurface3D) {
        val camera = surface3d.camera
        updateUIWithValuesFrom(camera)

        binding.pitchSeekBar.setOnSeekBarChangeListener(object : SeekBarChangeListenerBase() {
            override fun onProgressChanged(seekBar: SeekBar, progress: Int, fromUser: Boolean) {
                camera.orbitalPitch = progress.toFloat()
            }
        })
        binding.yawSeekBar.setOnSeekBarChangeListener(object : SeekBarChangeListenerBase() {
            override fun onProgressChanged(seekBar: SeekBar, progress: Int, fromUser: Boolean) {
                camera.orbitalYaw = progress.toFloat()
            }
        })
        binding.radiusSeekBar.setOnSeekBarChangeListener(object : SeekBarChangeListenerBase() {
            override fun onProgressChanged(seekBar: SeekBar, progress: Int, fromUser: Boolean) {
                camera.radius = progress.toFloat()
            }
        })
        binding.fovSeekBar.setOnSeekBarChangeListener(object : SeekBarChangeListenerBase() {
            override fun onProgressChanged(seekBar: SeekBar, progress: Int, fromUser: Boolean) {
                camera.fieldOfView = progress.toFloat()
            }
        })
        binding.orthoWidthSeekBar.setOnSeekBarChangeListener(object : SeekBarChangeListenerBase() {
            override fun onProgressChanged(seekBar: SeekBar, progress: Int, fromUser: Boolean) {
                camera.orthoWidth = progress.toFloat()
            }
        })
        binding.orthoHeightSeekBar.setOnSeekBarChangeListener(object : SeekBarChangeListenerBase() {
            override fun onProgressChanged(seekBar: SeekBar, progress: Int, fromUser: Boolean) {
                camera.orthoHeight = progress.toFloat()
            }
        })

        binding.orthogonalProperties.visibility = View.GONE
    }

    override fun onCameraUpdated(camera: ICameraController) {
        camera.orbitalPitch = constrainAngle(camera.orbitalPitch)
        camera.orbitalYaw = constrainAngle(camera.orbitalYaw)

        Dispatcher.postOnUiThread { updateUIWithValuesFrom(camera) }
    }

    private fun constrainAngle(angle: Float): Float {
        return if (angle < 0) angle + 360 else if (angle > 360) angle - 360 else angle
    }

    private fun updateUIWithValuesFrom(camera: ICameraController) {
        val format = DecimalFormat("0.0")
        val position = camera.position

        val positionTextBuilder = StringBuilder()
        positionTextBuilder.append("Position: ")
            .append("X=").append(format.format(position.x.toDouble()))
            .append(", Y=").append(format.format(position.y.toDouble()))
            .append(", Z=").append(format.format(position.z.toDouble()))

        binding.positionText.text = positionTextBuilder

        trySetSeekBarProgress(binding.pitchSeekBar, camera.orbitalPitch)
        trySetSeekBarProgress(binding.yawSeekBar, camera.orbitalYaw)
        trySetSeekBarProgress(binding.radiusSeekBar, camera.radius)
        trySetSeekBarProgress(binding.fovSeekBar, camera.fieldOfView)
        trySetSeekBarProgress(binding.orthoWidthSeekBar, camera.orthoWidth)
        trySetSeekBarProgress(binding.orthoHeightSeekBar, camera.orthoHeight)
    }

    private fun trySetSeekBarProgress(seekBar: SeekBar, value: Float) {
        val newProgress = value.roundToInt()
        if (seekBar.progress != newProgress) {
            seekBar.progress = newProgress
        }
    }
}

// Java: ModifyCamera3DPropertiesFragment.java

//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2021. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales:   sales@scichart.com
//
// ModifyCamera3DPropertiesFragment.java is part of SCICHART®, High Performance Scientific Charts
// For full terms and conditions of the license, see http://www.scichart.com/scichart-eula/
//
// This source code is protected by international copyright law. Unauthorized
// reproduction, reverse-engineering, or distribution of all or any portion of
// this source code is strictly prohibited.
//
// This source code contains confidential and proprietary trade secrets of
// SciChart Ltd., and should at no time be copied, transferred, sold,
// distributed or made available without express written permission.
//******************************************************************************

package com.scichart.examples.fragments.examples3d.zoomAndPan3DChart;

import android.view.LayoutInflater;
import android.view.View;
import android.widget.SeekBar;

import androidx.annotation.NonNull;

import com.scichart.charting3d.common.math.Vector3;
import com.scichart.charting3d.visuals.SciChartSurface3D;
import com.scichart.charting3d.visuals.axes.NumericAxis3D;
import com.scichart.charting3d.visuals.camera.Camera3D;
import com.scichart.charting3d.visuals.camera.ICameraController;
import com.scichart.charting3d.visuals.camera.ICameraUpdateListener;
import com.scichart.core.framework.UpdateSuspender;
import com.scichart.core.utility.Dispatcher;
import com.scichart.examples.databinding.ExampleChart3dCameraPropertiesFragmentBinding;
import com.scichart.examples.fragments.base.ExampleBaseFragment;
import com.scichart.examples.utils.SeekBarChangeListenerBase;

import java.text.DecimalFormat;

public class ModifyCamera3DPropertiesFragment extends ExampleBaseFragment<ExampleChart3dCameraPropertiesFragmentBinding> implements ICameraUpdateListener {

    @NonNull
    @Override
    protected ExampleChart3dCameraPropertiesFragmentBinding inflateBinding(@NonNull LayoutInflater inflater) {
        return ExampleChart3dCameraPropertiesFragmentBinding.inflate(inflater);
    }

    @Override
    protected void initExample(ExampleChart3dCameraPropertiesFragmentBinding binding) {
        final Camera3D camera = sciChart3DBuilder.newCamera3D().build();
        camera.setCameraUpdateListener(this);

        final NumericAxis3D xAxis = sciChart3DBuilder.newNumericAxis3D().build();
        final NumericAxis3D yAxis = sciChart3DBuilder.newNumericAxis3D().build();
        final NumericAxis3D zAxis = sciChart3DBuilder.newNumericAxis3D().build();

        final SciChartSurface3D surface3d = binding.surface3d;
        UpdateSuspender.using(surface3d, () -> {
            surface3d.setCamera(camera);

            surface3d.setXAxis(xAxis);
            surface3d.setYAxis(yAxis);
            surface3d.setZAxis(zAxis);

            surface3d.getChartModifiers().add(sciChart3DBuilder.newModifierGroupWithDefaultModifiers().build());
        });

        setUpSeekBarListeners(binding, surface3d);

        binding.lhsRadioButton.setOnClickListener(v -> {
            surface3d.setIsLeftHandedCoordinateSystem(true);
        });

        binding.rhsRadioButton.setOnClickListener(v -> {
            surface3d.setIsLeftHandedCoordinateSystem(false);
        });

        binding.perspectiveRadioButton.setOnClickListener(v -> {
            surface3d.getCamera().toPerspective();

            binding.perspectiveProperties.setVisibility(View.VISIBLE);
            binding.orthogonalProperties.setVisibility(View.GONE);
        });

        binding.orthogonalRadioButton.setOnClickListener(v -> {
            surface3d.getCamera().toOrthogonal();

            binding.perspectiveProperties.setVisibility(View.GONE);
            binding.orthogonalProperties.setVisibility(View.VISIBLE);
        });
    }

    private void setUpSeekBarListeners(ExampleChart3dCameraPropertiesFragmentBinding binding, SciChartSurface3D surface3d) {
        final ICameraController camera = surface3d.getCamera();
        updateUIWithValuesFrom(camera);

        binding.pitchSeekBar.setOnSeekBarChangeListener(new SeekBarChangeListenerBase() {
            @Override
            public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
                camera.setOrbitalPitch(progress);
            }
        });
        binding.yawSeekBar.setOnSeekBarChangeListener(new SeekBarChangeListenerBase() {
            @Override
            public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
                camera.setOrbitalYaw(progress);
            }
        });
        binding.radiusSeekBar.setOnSeekBarChangeListener(new SeekBarChangeListenerBase() {
            @Override
            public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
                camera.setRadius(progress);
            }
        });
        binding.fovSeekBar.setOnSeekBarChangeListener(new SeekBarChangeListenerBase() {
            @Override
            public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
                camera.setFieldOfView(progress);
            }
        });

        binding.orthoWidthSeekBar.setOnSeekBarChangeListener(new SeekBarChangeListenerBase() {
            @Override
            public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
                camera.setOrthoWidth(progress);
            }
        });
        binding.orthoHeightSeekBar.setOnSeekBarChangeListener(new SeekBarChangeListenerBase() {
            @Override
            public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) {
                camera.setOrthoHeight(progress);
            }
        });

        binding.orthogonalProperties.setVisibility(View.GONE);
    }

    @Override
    public void onCameraUpdated(final ICameraController camera) {
        camera.setOrbitalPitch(constrainAngle(camera.getOrbitalPitch()));
        camera.setOrbitalYaw(constrainAngle(camera.getOrbitalYaw()));

        Dispatcher.postOnUiThread(() -> updateUIWithValuesFrom(camera));
    }

    private float constrainAngle(float angle) {
        if (angle < 0) {
            angle += 360;
        } else if (angle > 360) {
            angle -= 360;
        }

        return angle;
    }

    private void updateUIWithValuesFrom(ICameraController camera) {
        final DecimalFormat format = new DecimalFormat("0.0");
        final Vector3 position = camera.getPosition();

        final StringBuilder positionTextBuilder = new StringBuilder();
        positionTextBuilder.append("Position: ")
                .append("X=").append(format.format(position.getX()))
                .append(", Y=").append(format.format(position.getY()))
                .append(", Z=").append(format.format(position.getZ()));

        binding.positionText.setText(positionTextBuilder);

        trySetSeekBarProgress(binding.pitchSeekBar, camera.getOrbitalPitch());
        trySetSeekBarProgress(binding.yawSeekBar, camera.getOrbitalYaw());
        trySetSeekBarProgress(binding.radiusSeekBar, camera.getRadius());
        trySetSeekBarProgress(binding.fovSeekBar, camera.getFieldOfView());
        trySetSeekBarProgress(binding.orthoWidthSeekBar, camera.getOrthoWidth());
        trySetSeekBarProgress(binding.orthoHeightSeekBar, camera.getOrthoHeight());
    }

    private void trySetSeekBarProgress(SeekBar seekBar, float value) {
        final int newProgress = Math.round(value);
        if (seekBar.getProgress() != newProgress) {
            seekBar.setProgress(newProgress);
        }
    }
}

< BACK TO ALL ANDROID CHART CHART EXAMPLES

Android 3D Modify Camera3D Properties

// Android Chart Examples

// Android 3D Modify Camera3D Properties

// Source Code

// Kotlin: ModifyCamera3DPropertiesFragment.kt

// Java: ModifyCamera3DPropertiesFragment.java

ANDROID CHART EXAMPLES

2D Charts

Basic Chart Types

Chart Annotations

Create a Multiseries Chart

Create Custom Animations

Create Custom Charts

Create Realtime Charts

Create Stock Charts

Legends

Link Multiple Charts

Manipulate Series

Modify Axis Behavior

Styling and Theming

Tooltips and Hit Test

Zoom and Pan a Chart

3D Charts

Axis3D

Basic Chart Types

Create Custom Charts

Create Surface Mesh Chart

Manipulate series

Realtime 3D Charts

Style 3D Chart

Tooltips and Hit Test 3D Charts

Zoom and Pan 3D Chart

Featured Apps

Medical Charts

Performance Demos

Scientific Charts