class TMtxGridSeries : public TChartSeries;
2D grid series used for drawing matrix values.
2D grid series used for drawing matrix values. The series is derived from TColorGridSeries (copyright David Berneda).
TMtxGridSeries supports two different ways to represent matrix values:
- Define color for minimum value, color for maximum value and number of levels in between. The algorithm will then automatically create palette entries with correcponding color for each level. In this case you have to set BottomColor, TopColor and PaletteSteps properties and set PaletteStyle to palAuto. The number of steps in the palette will not affect the fill-in speed of the bitmap and you can be very generous, if needed by specifying large PaletteSteps count.
- Define each level and it's color manually. Using this approach you can easily plot values using nonlinear color scale. In this case use ColorPalette.Add function to add new palette entries/levels. This method has the slowest fill-in speed of the bitmap and its speed linearly depends upon the number of palette entries.
The series supports many different color scales and combinations.
Constructors
| Name | Description |
|---|---|
| TMtxGridSeries |
Destructors
| Name | Description |
|---|---|
| ~TMtxGridSeries |
Properties
| Name | Type | Description |
|---|---|---|
| ColorPalette | TColorPalette* | Specifies color palette parameters. |
| LegendItemsCount | int | Defines the maximum number of items to display in the legend. |
| Matrix | TMtx* | Matrix to be displayed. |
| PixelResample | bool | Reduce the bitmap before drawing. |
| PixelResampleMethod | TPixelDownSample | Specifies the method used for size reduction. |
| XOffset | double | Defines horizontal (columns) axis offset. |
| xStep | double | Defines horizontal (columns) axis step size. |
| YOffset | double | Defines vertical (rows) axis offset. |
| YStep | double | Defines vertical (columns) axis step size. |
Methods
| Name | Description |
|---|---|
| BitmapPointerBreakdown | |
| BitmapPointerSetup | |
| BitmapScanline | |
| ChangeBitmapSize | |
| Clicked | |
| ComputeRangePallete | |
| CountLegendItems | |
| DoBeforeDrawChart | |
| DoUpdateColor | |
| DrawAllValues | |
| DrawBitmap | |
| DrawingRegion | |
| FillBitmap | |
| FillIndexes | |
| GetBytesPerPixel | |
| GetColorPalette | |
| GetEditorClass | |
| GetLegendItemsCount | |
| GetMatrix | |
| GetPixelResample | |
| GetPixelResampleMethod | |
| GetXOffset | |
| GetxStep | |
| GetYOffset | |
| GetYStep | |
| LegendItemColor | |
| LegendString | |
| MapToPaletteColors | |
| MaxValue | Returns maximum Z (depth) value drawn, after the chart has been repainted. |
| MaxXValue | |
| MaxYValue | |
| MinValue | Returns minimum Z (depth) value drawn, after the chart has been repainted. |
| MinXValue | |
| MinYValue | |
| SeriesToLegend | Configure the series as color scale legend for the Src series. |
| Update | Call update after filling Matrix with data to trigger chart repaint. |
| UpdateColor | Called internally, when a color parameter changes. |
Fields
| Name | Type | Description |
|---|---|---|
| bmpBoundsStored | TMtxRect | |
| BmpMtx | TMtx * | |
| ColorChanged | bool | |
| FBitmap | TBitmap * | |
| mtxBoundsStored | TMtxRect | |
| RowArray | DewArray<unsigned char> |