RangeColorizer3D.ValueProvider Property

Gets or sets the provider that specifies a point value the colorizer should use to define the point color.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v19.2.dll

Declaration

C#

public IColorizer3DValueProvider ValueProvider { get; set; }

VB.NET

Public Property ValueProvider As IColorizer3DValueProvider

Property Value

Type	Description
IColorizer3DValueProvider	The value provider.

Remarks

Example 1

This example shows how to use the ColorObjectValueProvider3D class to make the colorizer utilize values that the ColorDataMember property provides.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/chart3d-getting-started-lesson-2-t465331.

XAML

<dxc:Series3D DisplayName="Series 1">
    <dxc:Series3D.View>
        <dxc:Point3DSeriesView>
            <dxc:Point3DSeriesView.MarkerModel>
                <dxc:Marker3DSpherePointModel SphereDetalizationLevel="Low"/>
            </dxc:Point3DSeriesView.MarkerModel>
            <dxc:Point3DSeriesView.Colorizer>
                <dxc:RangeColorizer3D RangeStops="-0.4 0.4 1.8 2" 
                                      ApproximateColors="True">
                    <dxc:RangeColorizer3D.ValueProvider>
                        <dxc:ColorObjectValueProvider3D/>
                    </dxc:RangeColorizer3D.ValueProvider>
                    <dxc:RangeColorizer3D.Palette>
                        <dxc:YellowPalette/>
                    </dxc:RangeColorizer3D.Palette>
                </dxc:RangeColorizer3D>
            </dxc:Point3DSeriesView.Colorizer>
        </dxc:Point3DSeriesView>
    </dxc:Series3D.View>
    <dxc:SeriesPoint3DDataSourceAdapter DataSource="{Binding Stars}" 
                                        XArgumentDataMember="X" 
                                        YArgumentDataMember="Y"
                                        ValueDataMember="Z" 
                                        ColorDataMember="ColorIndex"/>
</dxc:Series3D>

Example 2

The following example shows how to calculate point colors based on point x-arguments.

• Create a class that implements the IColorizer3DValueProvider interface.
• Implement its IColorizer3DValueProvider.GetValue method.
• Assign the class instance to the RangeColorizer3D.ValueProvider property.

Markup

XAML

<dxc:Series3D DisplayName="Series 1">
    <dxc:Series3D.View>
        <dxc:Point3DSeriesView>
            <dxc:Point3DSeriesView.MarkerModel>
                <dxc:Marker3DSpherePointModel SphereDetalizationLevel="Low"/>
            </dxc:Point3DSeriesView.MarkerModel>
            <dxc:Point3DSeriesView.Colorizer>
                <dxc:RangeColorizer3D RangeStops="-90000 -60000 -30000 0 30000 60000 90000"
                                      ApproximateColors="True">
                    <dxc:RangeColorizer3D.ValueProvider>
                        <local:ColorizerValueProvider/>
                    </dxc:RangeColorizer3D.ValueProvider>
                    <dxc:RangeColorizer3D.Palette>
                        <dxc:YellowPalette/>
                    </dxc:RangeColorizer3D.Palette>
                </dxc:RangeColorizer3D>
            </dxc:Point3DSeriesView.Colorizer>
        </dxc:Point3DSeriesView>
    </dxc:Series3D.View>
    <dxc:SeriesPoint3DDataSourceAdapter DataSource="{Binding Stars}" 
                                        XArgumentDataMember="X" 
                                        YArgumentDataMember="Y"
                                        ValueDataMember="Z"/>
</dxc:Series3D>

Code-Behind

C#

using DevExpress.Xpf.Charts;
using System;
using System.Windows;

namespace GettingStarted2 {
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();
        }
    }
    public class ColorizerValueProvider : IColorizer3DValueProvider {
        public double GetValue(object argumentX, object argumentY, double[] values, object color) {
            return Convert.ToDouble(argumentX);
        }
    }
}

VB.NET

Imports DevExpress.Xpf.Charts
Imports System
Imports System.Windows

Namespace GettingStarted2
    Public Partial Class MainWindow
        Inherits Window

        Public Sub New()
            InitializeComponent()
        End Sub
    End Class

    Public Class ColorizerValueProvider
        Inherits IColorizer3DValueProvider

        Public Function GetValue(ByVal argumentX As Object, ByVal argumentY As Object, ByVal values As Double(), ByVal color As Object) As Double
            Return Convert.ToDouble(argumentX)
        End Function
    End Class
End Namespace

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ValueProvider property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

chart3d-getting-started-lesson-2-t465331/VB/GettingStarted2/MainWindow.xaml#L28

                  ApproximateColors="True">
<dxc:RangeColorizer3D.ValueProvider>
    <dxc:ColorObjectValueProvider3D/>