AreaSeries.FillColorizer Property

Gets or sets a colorizer that specifies how to paint area segments.

Namespace: DevExpress.Maui.Charts

Assembly: DevExpress.Maui.Charts.dll

NuGet Package: DevExpress.Maui.Charts

Declaration

public IFillColorizer FillColorizer { get; set; }

Property Value

Type	Description
IFillColorizer	A SegmentBasedFillColorizer object.

Remarks

The ChartView supports the point-based segment colorizer that paints line/area segments with colors of point markers, and uses color gradients for segments between different color points.

To colorize area segments of a series, follow the steps below:

1. Assign a SegmentBasedFillColorizer object to the FillColorizer property of the series.
2. Assign a GradientPointBasedSegmentColorizer object to the fill colorizer’s SegmentColorizer property.

3. Assign one of the following objects to the segment colorizer’s PointColorizer property:

   • a ColorEachPointColorizer object - to use colors from the default or custom palette.
   • a ValueBandPointColorizer object - to specify colors for point value ranges.
   • an object that implements the ICustomPointColorizer or IIndexBasedCustomPointColorizer interface - to specify point colors according to a custom algorithm based on point arguments/values and values of the chart’s bound data source.

Example

In this example, the area chart visualizes the visible light spectrum.

1. Create a data source - a list of objects that define data points with numeric arguments (wavelength) and values (intensity).

2. Create a colorizer class (LightSpectorColorizer, in this example) that implements the ICustomPointColorizer interface.
   Implement the GetColor method to return a data point’s color based on a ColoredPointInfo object passed to the method as a parameter. Use the ColoredPointInfo.NumericArgument property to obtain the data point’s argument value.
   This class should also implement the ICustomPointColorizer.GetLegendItemProvider method and the ILegendItemProvider interface to specify legend items that show wavelength colors.

   C#

   using System;
   using System.Collections.Generic;
   using System.Globalization;
   using System.IO;
   using DevExpress.Maui.Charts;
   using Microsoft.Maui.Controls;
   using Microsoft.Maui.Graphics;
   
   namespace SegmentColorizerExample {
       public class ViewModel {
           LightSpectorData data = new LightSpectorData();
           public IList<NumericData> LightSpectorData => this.data.LightSpectors;
       }
   
       public class LightSpectorData {
           public IList<NumericData> LightSpectors { get; }
   
           public LightSpectorData() {
               LightSpectors = new List<NumericData>();
               using (Stream stream = 
                   GetType().Assembly.GetManifestResourceStream("SegmentColorizerExample.LightSpector.dat")) {
                   StreamReader reader = new StreamReader(stream);
                   string data = reader.ReadToEnd();
                   String[] dataItems = data.Split(new String[] { "\n" }, 
                                        StringSplitOptions.RemoveEmptyEntries);
                   for (int i = 0; i < dataItems.Length; i++) {
                       String[] row = dataItems[i].Split(new String[] { " " }, 
                                      StringSplitOptions.RemoveEmptyEntries);
                       double argument = Convert.ToDouble(row[0], CultureInfo.InvariantCulture);
                       double value = Convert.ToDouble(row[1], CultureInfo.InvariantCulture);
                       LightSpectors.Add(new NumericData(argument, value));
                   }
               }
           }
       }
   
       public class LightSpectorColorizer : ICustomPointColorizer, ILegendItemProvider {
           Color waveLengthToColor(double waveLength) {
               double gamma = 0.8;
               double red = 0.0;
               double green = 0.0;
               double blue = 0.0;
               if (waveLength <= 440) {
                   double attenuation = 0.3 + 0.7 * (waveLength - 380) / (440 - 380);
                   red = Math.Pow((-(waveLength - 440) / (440 - 380)) * attenuation, gamma);
                   green = 0.0;
                   blue = Math.Pow(1.0 * attenuation, gamma);
               }
               else if (waveLength <= 490) {
                   red = 0.0;
                   green = Math.Pow((waveLength - 440) / (490 - 440), gamma);
                   blue = 1.0;
               }
               else if (waveLength <= 510) {
                   red = 0.0;
                   green = 1.0;
                   blue = Math.Pow(-(waveLength - 510) / (510 - 490), gamma);
               }
               else if (waveLength <= 580) {
                   red = Math.Pow((waveLength - 510) / (580 - 510), gamma);
                   green = 1.0;
                   blue = 0.0;
               }
               else if (waveLength <= 645) {
                   red = 1.0;
                   green = Math.Pow(-(waveLength - 645) / (645 - 580), gamma);
                   blue = 0.0;
               }
               else if (waveLength <= 750) {
                   double attenuation = 0.3 + 0.7 * (750 - waveLength) / (750 - 645);
                   red = Math.Pow(1.0 * attenuation, gamma);
                   green = 0.0;
                   blue = 0.0;
               }
               return Color.FromRgb(red, green, blue);
           }
   
           protected virtual double[] GetWavesForLegend() {
               return new double[] { 400, 440, 480, 540, 580, 610, 650 };
           }
   
           Color ICustomPointColorizer.GetColor(ColoredPointInfo info) {
               return waveLengthToColor(info.NumericArgument);
           }
           ILegendItemProvider ICustomPointColorizer.GetLegendItemProvider() {
               return this;
           }
   
           CustomLegendItem ILegendItemProvider.GetLegendItem(int index) {
               double waveLength = GetWavesForLegend()[index];
               Color color = waveLengthToColor(waveLength);
               return new CustomLegendItem($"{waveLength} nm", color);
           }
           int ILegendItemProvider.GetLegendItemCount() {
               return GetWavesForLegend().Length;
           }
       }
   
       public class NumericData {
           public double Argument { get; private set; }
           public double Value { get; private set; }
           public NumericData(double argument, double value) {
               Argument = argument;
               Value = value;
           }
       }
   }
   

3. Assign a SegmentBasedFillColorizer object to the AreaSeries.FillColorizer property.

4. Set the SegmentBasedFillColorizer.SegmentColorizer property to a GradientPointBasedSegmentColorizer object, and assign a LightSpectorColorizer object to the GradientPointBasedSegmentColorizer.PointColorizer property.

   XAML

   <ContentPage
       xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
       xmlns:dxc="clr-namespace:DevExpress.Maui.Charts;assembly=DevExpress.Maui.Charts"
       x:Class="SegmentColorizerExample.MainPage"
       xmlns:local="clr-namespace:SegmentColorizerExample">
       <ContentPage.BindingContext>
           <local:ViewModel/>
       </ContentPage.BindingContext>
       <dxc:ChartView>
           <dxc:ChartView.Series>
               <dxc:AreaSeries>
                   <!-- Bind the series to the data source. -->
                   <dxc:AreaSeries.Data>
                       <dxc:SeriesDataAdapter DataSource="{Binding LightSpectorData}" 
                                              ArgumentDataMember="Argument">
                           <dxc:ValueDataMember Type="Value" Member="Value"/>
                       </dxc:SeriesDataAdapter>
                   </dxc:AreaSeries.Data>
   
                   <dxc:AreaSeries.FillColorizer>
                       <dxc:SegmentBasedFillColorizer>
                           <dxc:SegmentBasedFillColorizer.SegmentColorizer>
                               <dxc:GradientPointBasedSegmentColorizer 
                                   PointColorizer="{local:LightSpectorColorizer}"/>
                           </dxc:SegmentBasedFillColorizer.SegmentColorizer>
                       </dxc:SegmentBasedFillColorizer>
                   </dxc:AreaSeries.FillColorizer>
   
               </dxc:AreaSeries>
           </dxc:ChartView.Series>
   
           <!-- Specify axis and legend settings here. -->
       </dxc:ChartView>
   </ContentPage>