Version

Configuring Series Colors

Purpose

This topic explains how to apply a custom color palette to the XamScatterSurface3D™ control series as well as how to configure the colors interpolation.

Required background

The following topics are prerequisites to understanding this topic:

Topic Purpose

This topic provides detailed instructions to help you get up and running as soon as possible with the xamScatterSurface3D™ control.

This topic explains the features supported by the control from developer perspective.

This topic provides an overview of the visual elements of the control.

Applying Custom Color Palette to Series

Overview

Use the XamScatterSurface3D SeriesColors property to apply a custom color palette to the xamScatterSurface3D control series.

Note
Note

If the XamScatterSurface3D SeriesMaterial is set, the SeriesColors property value is ignored.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Apply a series color palette

Example

The screenshot below demonstrates how the xamScatterSurface3D control series look as a result of the following settings:

Property Value

Blue Green Red

Series Colors 1.png

Following is the code that implements this example.

In XAML:

<ig:XamScatterSurface3D Name="SurfaceChart2"
 ItemsSource="{Binding Path=DataCollection}"
 XMemberPath="X" YMemberPath="Y" ZMemberPath="Z"
 SeriesColors="Blue Green Red"/>

In C#:

var colorCollection = new ColorCollection();
colorCollection.Add(Colors.Blue);
colorCollection.Add(Colors.Green);
colorCollection.Add(Colors.Red);
SurfaceChart.SeriesColors = colorCollection;

In Visual Basic:

Dim colorCollection = New ColorCollection()
colorCollection.Add(Colors.Blue)
colorCollection.Add(Colors.Green)
colorCollection.Add(Colors.Red)
SurfaceChart.SeriesColors = colorCollection

Configuring Series Color Palette Interpolation

Overview

Use the XamScatterSurface3D SeriesColorInterpolation property to specify the series colors interpolation in the xamScatterSurface3D control.

By default, the initial value of the SeriesColorInterpolation is SeriesColorPaletteInterpolation.ARGB.

There are three available options for series palette colors interpolation:

Series Colors 2.png
Series Colors 3.png
Series Colors 4.png

AHSV

ARGB

None

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to: Use this property: And set it to:

Specify the series colors interpolation

Example

The screenshot below demonstrates how the xamScatterSurface3D control series colors looks as a result of the following settings:

Property Value

AHSV

Series Colors 5.png

Following is the code that implements this example.

In XAML:

<ig:XamScatterSurface3D Name="SurfaceChart"
 ItemsSource="{Binding Path=DataCollection}"
 XMemberPath="X" YMemberPath="Y" ZMemberPath="Z"
 SeriesColorInterpolation="AHSV">
    <ig:XamScatterSurface3D.SeriesColors>
        <ig:ColorCollection>
            <Color>Blue</Color>
            <Color>Green</Color>
            <Color>Red</Color>
        </ig:ColorCollection>
    </ig:XamScatterSurface3D.SeriesColors>
</ig:XamScatterSurface3D>

In C#:

var colorCollection = new ColorCollection();
colorCollection.Add(Colors.Blue);
colorCollection.Add(Colors.Green);
colorCollection.Add(Colors.Red);
SurfaceChart.SeriesColors = colorCollection;
SurfaceChart.SeriesColorInterpolation = SeriesColorPaletteInterpolation.AHSV;

In Visual Basic:

Dim colorCollection = New ColorCollection()
colorCollection.Add(Colors.Blue)
colorCollection.Add(Colors.Green)
colorCollection.Add(Colors.Red)
SurfaceChart.SeriesColors = colorCollection
SurfaceChart.SeriesColorInterpolation = SeriesColorPaletteInterpolation.AHSV

Related Content

Topics

The following topics provide additional information related to this topic.

Topic Purpose

This topic explains how to configure the light settings in the xamScatterSurface3D control.

This topic explains how to configure the material of the series of the xamScatterSurface3D control.

This topic explains how to configure the material of the series wireframe of the xamScatterSurface3D control.

This topic summarizes the series mouse events in the xamScatterSurface3D control.