CellArray Object Class

Overview

A ChartObject creates a Plot object of type CellArray when the chart type resource is set to XintCHART_TYPE_CELL_ARRAY. The CellArray object displays data as an array of colored cells. The colors for the cells can be specified as a list of color pixels using Chart resource XmNzValueColorRecord. If this resource is NULL, the colors specified using Chart resource XmNcolorList are used. Colors are assigned to each cell according to the cell value, using a linear interpolation scheme based on the data minimum and maximum values.

Data

The CellArray class handles data objects of type DataGrid or DataSampled. It first searches for a DataGrid object, if none is found, it searches for DataSampled objects. All the DataSampled objects should have the same increment, but can have different starting values (see resource XmNsampledRange to specify a non default start and increment). Missing and undefined values in the data are represented as a hole.

Inherited Resources and Behavior

The CellArray object class inherits behavior and resources from the Xt Object, Graphic, Group and Plot2D object classes.
The following resources are defined by the CellArray object class:
NameTypeDefaultAccess
XmNdisplayPatternsBooleanTrueCSG
XmNlegendAnnotationFormatchar *"%.0f"CSG
XmNpatternListPixmap *NULLCSG

XmNdisplayPatterns

Specifies whether or not to display the patterns defined with resource XmNpatternList.

XmNlegendAnnotationFormat

Specifies the format used to print the data values in the legend. Use any C format descriptor suitable for displaying floating point data.

XmNpatternList

Specifies a list of bitmaps (pixmaps of depth 1) that are used as patterns when drawing each cell content. The list should be terminated using constant XmUNSPECIFIED_PIXMAP. Each pattern is assigned to a color in the colormap used by the CellArray in the order specified (first pattern is associated with first color, etc.). If you want each cell to have a pattern you should specify as many patterns as there are colors in the colormap.

Plot2D Object Class Inherited Resources

See Plot2D Object Class for a complete listing of the inherited resources for the CellArray object class.

Macro

The XintIsCellArray macro returns True if the specified object is a CellArray object. It returns False otherwise. 

     Boolean XintIsCellArray (Object object)