// 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 Surface Mesh Palette Provider

This example demonstrates how to use the PaletteProvider API to color SurfaceMesh cells individually.

Please read more about applying Palettes to a Surface Mesh in SciChart Android 3D Charting Documentation.

// Source Code

The full source code for the Android 3D Surface Mesh Palette Provider 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 Surface Mesh Palette Provider - View Source Code for this example

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

// Kotlin: SurfaceMeshWithMetadataProvider3DChartFragment.kt

//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2021. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales:   sales@scichart.com
//
// SurfaceMeshWithMetadataProvider3DChartFragment.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.createSurfaceMeshChart.kt

import com.scichart.charting3d.visuals.SciChartSurface3D
import com.scichart.charting3d.visuals.axes.NumericAxis3D
import com.scichart.charting3d.visuals.renderableSeries.data.DrawMeshAs.SolidMesh
import com.scichart.charting3d.visuals.renderableSeries.data.GradientColorPalette
import com.scichart.charting3d.visuals.renderableSeries.metadataProviders.ISurfaceMeshMetadataProvider3D
import com.scichart.charting3d.visuals.renderableSeries.metadataProviders.MetadataProvider3DBase
import com.scichart.charting3d.visuals.renderableSeries.surfaceMesh.SurfaceMeshRenderPassData3D
import com.scichart.charting3d.visuals.renderableSeries.surfaceMesh.SurfaceMeshRenderableSeries3D
import com.scichart.core.framework.UpdateSuspender
import com.scichart.core.model.IntegerValues
import com.scichart.drawing.utility.ColorUtil.*
import com.scichart.examples.data.DataManager
import com.scichart.examples.fragments.base.ExampleSingleChart3DBaseFragment
import com.scichart.examples.utils.scichartExtensions.*
import java.util.concurrent.Executors
import java.util.concurrent.ScheduledFuture
import java.util.concurrent.TimeUnit
import kotlin.math.pow

class SurfaceMeshWithMetadataProvider3DChartFragment : ExampleSingleChart3DBaseFragment() {
    private val scheduledExecutorService = Executors.newSingleThreadScheduledExecutor()
    private lateinit var schedule: ScheduledFuture<*>

    override fun initExample(surface3d: SciChartSurface3D) {
        val meshDataSeries0 = UniformGridDataSeries3D<Double, Double, Double>(X_SIZE, Z_SIZE)
        val meshDataSeries1 = UniformGridDataSeries3D<Double, Double, Double>(X_SIZE, Z_SIZE)
        for (x in 48 downTo 24) {
            val y = (x - 23.7).pow(0.3)
            val y2 = (49.5 - x).pow(0.3)

            meshDataSeries0.updateYAt(x, 24, y)
            meshDataSeries1.updateYAt(x, 24, y2 + 1.505)
        }

        for (x in 24 downTo 0) {
            for (z in 49 downTo 26) {
                val y = (z - 23.7).pow(0.3)
                val y2 = (50.5 - z).pow(0.3) + 1.505

                meshDataSeries0.updateYAt(x + 24, 49 - z, y)
                meshDataSeries0.updateYAt(z - 1, 24 - x, y)

                meshDataSeries1.updateYAt(x + 24, 49 - z, y2)
                meshDataSeries1.updateYAt(z - 1, 24 - x, y2)

                meshDataSeries0.updateYAt(24 - x, 49 - z, y)
                meshDataSeries0.updateYAt(49 - z, 24 - x, y)

                meshDataSeries1.updateYAt(24 - x, 49 - z, y2)
                meshDataSeries1.updateYAt(49 - z, 24 - x, y2)

                meshDataSeries0.updateYAt(x + 24, z - 1, y)
                meshDataSeries0.updateYAt(z - 1, x + 24, y)

                meshDataSeries1.updateYAt(x + 24, z - 1, y2)
                meshDataSeries1.updateYAt(z - 1, x + 24, y2)

                meshDataSeries0.updateYAt(24 - x, z - 1, y)
                meshDataSeries0.updateYAt(49 - z, x + 24, y)

                meshDataSeries1.updateYAt(24 - x, z - 1, y2)
                meshDataSeries1.updateYAt(49 - z, x + 24, y2)
            }
        }
        val palette = GradientColorPalette(
            intArrayOf(DarkBlue, Blue, CadetBlue, Cyan, LimeGreen, GreenYellow, Yellow, Tomato, IndianRed, Red, DarkRed),
            floatArrayOf(0f, .1f, .2f, .3f, .4f, .5f, .6f, .7f, .8f, .9f, 1f)
        )

        val rSeries0 = SurfaceMeshRenderableSeries3D().apply {
            dataSeries = meshDataSeries0
            drawMeshAs = SolidMesh
            drawSkirt = false
            meshColorPalette = palette
            metadataProvider = SurfaceMeshMetadataProvider3D()
        }
        val rSeries1 = SurfaceMeshRenderableSeries3D().apply {
            dataSeries = meshDataSeries1
            drawMeshAs = SolidMesh
            drawSkirt = false
            meshColorPalette = palette
            metadataProvider = SurfaceMeshMetadataProvider3D()
        }

        surface3d.suspendUpdates {
            xAxis = createNumericAxis3D()
            yAxis = createNumericAxis3D()
            zAxis = createNumericAxis3D()

            renderableSeries {
                rSeries(rSeries0)
                rSeries(rSeries1)
            }
            chartModifiers { defaultModifiers3D() }
        }

        schedule = scheduledExecutorService.scheduleWithFixedDelay({
            UpdateSuspender.using(surface3d) {
                rSeries0.invalidateMetadata()
                rSeries1.invalidateMetadata()
            }
        }, 0, 10, TimeUnit.MILLISECONDS)
    }

    private fun createNumericAxis3D(): NumericAxis3D {
        return numericAxis3D {
            drawMajorBands = false
            drawLabels = false
            drawMajorGridLines = false
            drawMajorTicks = false
            drawMinorGridLines = false
            drawMinorTicks = false
            planeBorderThickness = 0f
        }
    }

    override fun onDestroyView() {
        super.onDestroyView()

        schedule.cancel(true)
    }

    private class SurfaceMeshMetadataProvider3D : MetadataProvider3DBase<SurfaceMeshRenderableSeries3D>(SurfaceMeshRenderableSeries3D::class.java), ISurfaceMeshMetadataProvider3D {
        override fun updateMeshColors(cellColors: IntegerValues) {
            val currentRenderPassData = renderableSeries!!.currentRenderPassData as SurfaceMeshRenderPassData3D
            val dataManager = DataManager.getInstance()

            val countX = currentRenderPassData.countX - 1
            val countZ = currentRenderPassData.countZ - 1
            cellColors.setSize(currentRenderPassData.pointsCount)

            val items = cellColors.itemsArray
            for (x in 0 until countX) {
                for (z in 0 until countZ) {
                    val index = x * countZ + z

                    val color: Int = if (x in 20..26 && z > 0 && z < 47 || z in 20..26 && x > 0 && x < 47) {
                        // need to use special transparent color definition for MetadataProvider3D for it to work
                        TRANSPARENT
                    } else {
                        dataManager.randomColor
                    }
                    items[index] = color
                }
            }
        }
    }

    companion object {
        const val X_SIZE = 49
        const val Z_SIZE = 49
    }
}

// Java: SurfaceMeshWithMetadataProvider3DChartFragment.java

//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2021. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales:   sales@scichart.com
//
// SurfaceMeshWithMetadataProvider3DChartFragment.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.createSurfaceMeshChart;

import static com.scichart.drawing.utility.ColorUtil.Blue;
import static com.scichart.drawing.utility.ColorUtil.CadetBlue;
import static com.scichart.drawing.utility.ColorUtil.Cyan;
import static com.scichart.drawing.utility.ColorUtil.DarkBlue;
import static com.scichart.drawing.utility.ColorUtil.DarkRed;
import static com.scichart.drawing.utility.ColorUtil.GreenYellow;
import static com.scichart.drawing.utility.ColorUtil.IndianRed;
import static com.scichart.drawing.utility.ColorUtil.LimeGreen;
import static com.scichart.drawing.utility.ColorUtil.Red;
import static com.scichart.drawing.utility.ColorUtil.Tomato;
import static com.scichart.drawing.utility.ColorUtil.Yellow;

import androidx.annotation.NonNull;

import com.scichart.charting3d.model.dataSeries.grid.UniformGridDataSeries3D;
import com.scichart.charting3d.visuals.SciChartSurface3D;
import com.scichart.charting3d.visuals.axes.NumericAxis3D;
import com.scichart.charting3d.visuals.renderableSeries.data.DrawMeshAs;
import com.scichart.charting3d.visuals.renderableSeries.data.GradientColorPalette;
import com.scichart.charting3d.visuals.renderableSeries.metadataProviders.ISurfaceMeshMetadataProvider3D;
import com.scichart.charting3d.visuals.renderableSeries.metadataProviders.MetadataProvider3DBase;
import com.scichart.charting3d.visuals.renderableSeries.surfaceMesh.SurfaceMeshRenderPassData3D;
import com.scichart.charting3d.visuals.renderableSeries.surfaceMesh.SurfaceMeshRenderableSeries3D;
import com.scichart.core.framework.UpdateSuspender;
import com.scichart.core.model.IntegerValues;
import com.scichart.examples.data.DataManager;
import com.scichart.examples.fragments.base.ExampleSingleChart3DBaseFragment;

import java.util.Collections;
import java.util.concurrent.Executors;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.ScheduledFuture;
import java.util.concurrent.TimeUnit;

public class SurfaceMeshWithMetadataProvider3DChartFragment extends ExampleSingleChart3DBaseFragment {
    private static final int X_SIZE = 49, Z_SIZE = 49;

    private final ScheduledExecutorService scheduledExecutorService = Executors.newSingleThreadScheduledExecutor();
    private ScheduledFuture<?> schedule;

    @Override
    protected void initExample(@NonNull SciChartSurface3D surface3d) {
        final UniformGridDataSeries3D<Double, Double, Double> meshDataSeries0 = new UniformGridDataSeries3D<>(Double.class, Double.class, Double.class, X_SIZE, Z_SIZE);
        final UniformGridDataSeries3D<Double, Double, Double> meshDataSeries1 = new UniformGridDataSeries3D<>(Double.class, Double.class, Double.class, X_SIZE, Z_SIZE);
        for (int x = 48; x >= 24; x--) {
            final double y = Math.pow(x - 23.7, 0.3);
            final double y2 = Math.pow(49.5 - x, 0.3);

            meshDataSeries0.updateYAt(x, 24, y);
            meshDataSeries1.updateYAt(x, 24, y2 + 1.505);
        }

        for (int x = 24; x >= 0; x--) {
            for (int z = 49; z > 25; z--) {
                final double y = Math.pow(z - 23.7, 0.3);
                final double y2 = Math.pow(50.5 - z, 0.3) + 1.505;

                meshDataSeries0.updateYAt(x + 24, 49 - z, y);
                meshDataSeries0.updateYAt(z - 1, 24 - x, y);

                meshDataSeries1.updateYAt(x + 24, 49 - z, y2);
                meshDataSeries1.updateYAt(z - 1, 24 - x, y2);

                meshDataSeries0.updateYAt(24 - x, 49 - z, y);
                meshDataSeries0.updateYAt(49 - z, 24 - x, y);

                meshDataSeries1.updateYAt(24 - x, 49 - z, y2);
                meshDataSeries1.updateYAt(49 - z, 24 - x, y2);

                meshDataSeries0.updateYAt(x + 24, z - 1, y);
                meshDataSeries0.updateYAt(z - 1, x + 24, y);

                meshDataSeries1.updateYAt(x + 24, z - 1, y2);
                meshDataSeries1.updateYAt(z - 1, x + 24, y2);

                meshDataSeries0.updateYAt(24 - x, z - 1, y);
                meshDataSeries0.updateYAt(49 - z, x + 24, y);

                meshDataSeries1.updateYAt(24 - x, z - 1, y2);
                meshDataSeries1.updateYAt(49 - z, x + 24, y2);
            }
        }

        final GradientColorPalette palette = new GradientColorPalette(
                new int[]{DarkBlue, Blue, CadetBlue, Cyan, LimeGreen, GreenYellow, Yellow, Tomato, IndianRed, Red, DarkRed},
                new float[]{0f, .1f, .2f, .3f, .4f, .5f, .6f, .7f, .8f, .9f, 1f}
        );

        final SurfaceMeshRenderableSeries3D rs0 = sciChart3DBuilder.newSurfaceMeshSeries3D()
                .withDataSeries(meshDataSeries0)
                .withDrawMeshAs(DrawMeshAs.SolidMesh)
                .withDrawSkirt(false)
                .withMeshColorPalette(palette)
                .withMetadataProvider(new SurfaceMeshMetadataProvider3D())
                .build();

        final SurfaceMeshRenderableSeries3D rs1 = sciChart3DBuilder.newSurfaceMeshSeries3D()
                .withDataSeries(meshDataSeries1)
                .withDrawMeshAs(DrawMeshAs.SolidMesh)
                .withDrawSkirt(false)
                .withMeshColorPalette(palette)
                .withMetadataProvider(new SurfaceMeshMetadataProvider3D())
                .build();

        UpdateSuspender.using(surface3d, () -> {
            surface3d.setXAxis(createNumericAxis3D());
            surface3d.setYAxis(createNumericAxis3D());
            surface3d.setZAxis(createNumericAxis3D());
            Collections.addAll(surface3d.getRenderableSeries(), rs0, rs1);
            surface3d.getChartModifiers().add(sciChart3DBuilder.newModifierGroupWithDefaultModifiers().build());
        });

        schedule = scheduledExecutorService.scheduleWithFixedDelay(() -> UpdateSuspender.using(surface3d, () -> {
            rs0.invalidateMetadata();
            rs1.invalidateMetadata();
        }), 0, 10, TimeUnit.MILLISECONDS);
    }

    private NumericAxis3D createNumericAxis3D() {
        return sciChart3DBuilder.newNumericAxis3D()
                .withDrawMajorBands(false)
                .withDrawLabels(false)
                .withDrawMajorGridLines(false)
                .withDrawMajorTicks(false)
                .withDrawMinorGridLines(false)
                .withDrawMinorTicks(false)
                .withPlaneBoderThickness(0f)
                .build();
    }

    @Override
    public void onDestroyView() {
        super.onDestroyView();

        if (schedule != null) {
            schedule.cancel(true);
        }
    }

    private static class SurfaceMeshMetadataProvider3D extends MetadataProvider3DBase<SurfaceMeshRenderableSeries3D> implements ISurfaceMeshMetadataProvider3D {
        SurfaceMeshMetadataProvider3D() {
            super(SurfaceMeshRenderableSeries3D.class);
        }

        @Override
        public void updateMeshColors(IntegerValues cellColors) {
            final SurfaceMeshRenderPassData3D currentRenderPassData = (SurfaceMeshRenderPassData3D) renderableSeries.getCurrentRenderPassData();
            final DataManager dataManager = DataManager.getInstance();

            final int countX = currentRenderPassData.countX - 1;
            final int countZ = currentRenderPassData.countZ - 1;
            cellColors.setSize(currentRenderPassData.getPointsCount());

            final int[] items = cellColors.getItemsArray();
            for (int x = 0; x < countX; x++) {
                for (int z = 0; z < countZ; z++) {
                    final int index = x * countZ + z;

                    final int color;
                    if ((x >= 20 && x <= 26 && z > 0 && z < 47) || (z >= 20 && z <= 26 && x > 0 && x < 47)) {
                        // need to use special transparent color definition for MetadataProvider3D for it to work
                        color = TRANSPARENT;
                    } else {
                        color = dataManager.getRandomColor();
                    }

                    items[index] = color;
                }
            }
        }
    }
}

< BACK TO ALL ANDROID CHART CHART EXAMPLES

Android 3D Surface Mesh Palette Provider

// Android Chart Examples

// Android 3D Surface Mesh Palette Provider

// Source Code

// Kotlin: SurfaceMeshWithMetadataProvider3DChartFragment.kt

// Java: SurfaceMeshWithMetadataProvider3DChartFragment.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