RangeColorizer3D Class

Colorizer that colors all points by values.

Namespace: DevExpress.Xpf.Charts

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

Declaration

C#

public class RangeColorizer3D :
    PaletteColorizer3DBase

VB.NET

Public Class RangeColorizer3D
    Inherits PaletteColorizer3DBase

Remarks

The following image demonstrates 3D bars colored using this colorizer.

Example

This example demonstrates how to colorize series point markers based on range values. To do this, assign a RangeColorizer3D object to the Series3DViewBase.Colorizer property. Then, configure range stops using the RangeColorizer3D.RangeStops property and optionally, configure required colors using the PaletteColorizer3DBase.Palette property. Finally, specify which values should be measured - you can do this using the RangeColorizer3D.ValueProvider property.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-colorize-series-point-markers-based-on-range-values-t466516.

MainWindow.xaml

<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:view="clr-namespace:RangeColorizer3DExample"
        xmlns:viewModel="clr-namespace:RangeColorizer3DExample.ViewModel"
        xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts"
        x:Class="RangeColorizer3DExample.MainWindow"
        mc:Ignorable="d"
        Title="MainWindow"
        Height="309"
        Width="496">
    <Window.DataContext>
        <viewModel:GdpViewModel />
    </Window.DataContext>
    <Grid>

        <dxc:Chart3DControl AspectRatio="5,3,3"
                            Padding="0">
            <dxc:Chart3DControl.Legends>
                <dxc:Legend HorizontalPosition="Right"
                            VerticalPosition="Top"
                            Orientation="Horizontal"/>
            </dxc:Chart3DControl.Legends>
            <dxc:Series3DStorage>
                <!--region #Series-->
                <dxc:Series3D DisplayName="Gdps"
                              YArgumentScaleType="Qualitative">
                    <dxc:Series3D.View>
                        <dxc:Bar3DSeriesView>
                            <dxc:Bar3DSeriesView.Colorizer>
                                <dxc:RangeColorizer3D ApproximateColors="True"
                                                      RangeStops="2000 4000 8000 16000 32000">
                                    <dxc:RangeColorizer3D.Palette>
                                        <dxc:CustomPalette>
                                            <dxc:CustomPalette.Colors>
                                                <Color>#FD5915</Color>
                                                <Color>#F09D25</Color>
                                                <Color>#E2E232</Color>
                                                <Color>#A5D648</Color>
                                                <Color>#6EC95C</Color>
                                            </dxc:CustomPalette.Colors>
                                        </dxc:CustomPalette>
                                    </dxc:RangeColorizer3D.Palette>
                                </dxc:RangeColorizer3D>
                            </dxc:Bar3DSeriesView.Colorizer>
                            <dxc:Bar3DSeriesView.BarModel>
                                <dxc:Bar3DBoxPointModel ShowFacets="False" />
                            </dxc:Bar3DSeriesView.BarModel>
                        </dxc:Bar3DSeriesView>
                    </dxc:Series3D.View>
                    <dxc:SeriesPoint3DDataSourceAdapter DataSource="{Binding Path=Gdps}"
                                                        XArgumentDataMember="Country"
                                                        YArgumentDataMember="Year"
                                                        ValueDataMember="Value"
                                                        ColorDataMember="Region" />
                </dxc:Series3D>
                <!--endregion #Series-->
            </dxc:Series3DStorage>
        </dxc:Chart3DControl>

    </Grid>
</Window>

GdpViewModel.cs

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Windows;
using System.Windows.Resources;
using System.Xml.Linq;

namespace RangeColorizer3DExample.ViewModel {
    public class Gdp {
        public string Country { get; private set; }
        public int Year { get; private set; }
        public double Value { get; private set; }
        public string Region { get; private set; }

        public Gdp(string country, int year, double value, string region) {
            Country = country;
            Year = year;
            Value = value;
            Region = region;
        }
    }

    public class GdpViewModel {
        public IEnumerable<Gdp> Gdps { get; private set; }

        public GdpViewModel() {
            Gdps = new GdpResourceLoader("Data/GdpStatistics.xml").Load();
        }
    }

    public class GdpResourceLoader {
        string Filepath { get; set; }

        public GdpResourceLoader(string filepath) {
            Filepath = filepath;
        }

        public IEnumerable<Gdp> Load() {
            Collection<Gdp> result = new Collection<Gdp>();

            Uri resourceUri = new Uri(Filepath, UriKind.RelativeOrAbsolute);
            StreamResourceInfo resourceInfo = Application.GetResourceStream(resourceUri);
            XDocument xDoc = XDocument.Load(resourceInfo.Stream);
            foreach (var xGdp in xDoc.Element("Statistics").Elements("Gdp")) {
                result.Add(new Gdp(
                    country: xGdp.Attribute("Country").Value,
                    year: Convert.ToInt32(xGdp.Attribute("Year").Value),
                    value: Convert.ToDouble(xGdp.Attribute("Value").Value),
                    region: xGdp.Attribute("Region").Value
                ));
            }
            return result;
        }
    }
}

GdpViewModel.vb

Imports System
Imports System.Collections.Generic
Imports System.Collections.ObjectModel
Imports System.Windows
Imports System.Windows.Resources
Imports System.Xml.Linq

Namespace RangeColorizer3DExample.ViewModel
    Public Class Gdp
        Private privateCountry As String
        Public Property Country() As String
            Get
                Return privateCountry
            End Get
            Private Set(ByVal value As String)
                privateCountry = value
            End Set
        End Property
        Private privateYear As Integer
        Public Property Year() As Integer
            Get
                Return privateYear
            End Get
            Private Set(ByVal value As Integer)
                privateYear = value
            End Set
        End Property
        Private privateValue As Double
        Public Property Value() As Double
            Get
                Return privateValue
            End Get
            Private Set(ByVal value As Double)
                privateValue = value
            End Set
        End Property
        Private privateRegion As String
        Public Property Region() As String
            Get
                Return privateRegion
            End Get
            Private Set(ByVal value As String)
                privateRegion = value
            End Set
        End Property

        Public Sub New(ByVal country As String, ByVal year As Integer, ByVal value As Double, ByVal region As String)
            Me.Country = country
            Me.Year = year
            Me.Value = value
            Me.Region = region
        End Sub
    End Class

    Public Class GdpViewModel
        Private privateGdps As IEnumerable(Of Gdp)
        Public Property Gdps() As IEnumerable(Of Gdp)
            Get
                Return privateGdps
            End Get
            Private Set(ByVal value As IEnumerable(Of Gdp))
                privateGdps = value
            End Set
        End Property

        Public Sub New()
            Gdps = (New GdpResourceLoader("Data/GdpStatistics.xml")).Load()
        End Sub
    End Class

    Public Class GdpResourceLoader
        Private Property Filepath() As String

        Public Sub New(ByVal filepath As String)
            Me.Filepath = filepath
        End Sub

        Public Function Load() As IEnumerable(Of Gdp)
            Dim result As New Collection(Of Gdp)()

            Dim resourceUri As New Uri(Filepath, UriKind.RelativeOrAbsolute)
            Dim resourceInfo As StreamResourceInfo = Application.GetResourceStream(resourceUri)
            Dim xDoc As XDocument = XDocument.Load(resourceInfo.Stream)
            For Each xGdp In xDoc.Element("Statistics").Elements("Gdp")
                result.Add(New Gdp(country:= xGdp.Attribute("Country").Value, year:= Convert.ToInt32(xGdp.Attribute("Year").Value), value:= Convert.ToDouble(xGdp.Attribute("Value").Value), region:= xGdp.Attribute("Region").Value))
            Next xGdp
            Return result
        End Function
    End Class
End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the RangeColorizer3D class.

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#L26

<dxc:Point3DSeriesView.Colorizer>
    <dxc:RangeColorizer3D RangeStops="-0.4 0.4 1.8 2"
                          ApproximateColors="True">

chart3d-getting-started-lesson-1-t465540/VB/Chart3D_Lesson1/MainWindow.xaml#L26

<dxc:Bar3DSeriesView.Colorizer>
    <dxc:RangeColorizer3D RangeStops="0 80 150 300 600"
                          LegendTextPattern="{}{V1:F0} - {V2:F0} TWh/a">

how-to-colorize-series-point-markers-based-on-range-values-t466516/VB/RangeColorizer3DExample/MainWindow.xaml#L32

<dxc:Bar3DSeriesView.Colorizer>
    <dxc:RangeColorizer3D ApproximateColors="True"
                          RangeStops="2000 4000 8000 16000 32000">

Inheritance

Object

DispatcherObject

DependencyObject

Freezable

Chart3DDependencyObject

Colorizer3DBase

PaletteColorizer3DBase

RangeColorizer3D

Extension Methods

GetErrorOperationCommands(Position)

GetErrorOperationCommands(Int32)

GetErrorOperationCommands(Point)