TColorGridSeries

TColorGridSeries
Hierarchy     Properties     Methods     Events     

Grid of colored cells.




Unit
TeeSurfa

Description
The TColorGridSeries component controls access to the properties and methods of the ColorGrid Series.

It displays a grid of color cells.

Every cell is determined by a pair of XZ coordinates.
The "Y" value of the cell is used to calculate the cell's color from a color palette.

Inherits all properties from the ancestor component.
Supports series Marks, zoom and scroll as any other series.

The CenteredPoints property controls how are "X" and "Z" values considered.

What you can do with a ColorGridSeries

The TColorGridSeries is principally designed to work on a 1 incremented integer indexed grid, each value of the grid, X and Z (where Z takes on the appearance of a Y Axis when seen on the left of the flat planed Chart). Non-1 unit stepped grids are supported by the ColorGrid Series but non unit Grids are subject to some limitations.
What you can do:
- use a 1 stepped Grid where X, and Z may be incremented starting from 0 or greater values.
- use a non 1 stepped Grid adding non 1 divisible increments. These increments may be a fraction, multiple or fraction and multiple of 1. Enable viewing of such a Grid by setting the IrregularGrid property to True.
- When using IrregularGrids, steps may be all equal (eg. all at 0.5 or all at 3) or may be different (eg. an X sequence may look like 0.5, 0.7, 1.2, 0.5, etc) but all values on the same plane should be the same. Meaning that at each Z depth location a given X value should be the same as for a lower depth Z value at the same grid (viewed as a matrix) location.
- For ColorGrids whose steps are all equal TeeChart will plot the last cell, meaning that for a grid of x 0 to 4 and z 0 to 4 TeeChart will plot a minimum value of 0 and a maximum value of 5 on each Axis. The last cell will be spaced at the same Axis increment as its predecesors. Where X or Z data steps are not regular, an occurence that can happen for an Irregular Grid with varied steps, then the last cell is not plotted as TeeChart has no clear information as to what cell step size it should plot (having a variety of different cell sizes to choose from). In that case TeeChart will colour the last cell values off the scale to the width of the immediate predecesor point. You may choose whether or not to extend the Axis scale via the Axis.Maximum property to show a part of the last value.
- The ColorGrid Series supports Grid centered Labels for integer stepped data only.
- For highly irregular data we recommend that you rationalise it to an integer stepped Grid and modify labels to desired values by adding AxisLabel Items or by using the GetAxisLabel event.

- The ColorGrid Series may be zoomed and scrolled
- The Series responds to click events