13.3.5.2 Customizing the GridLogView Display

In addition to the general customization variables available on the GridLogView object, the GridViewSpec objects allow precise control over the positioning and display style of the data elements in the GridLogView.

Each of the columns of data in the PDPLog has an associated GridViewSpec in the GridLogView. Some of the columns of data have been grouped together by their generating statistics and will also have a DT_GridViewSpec for the entire group of data columns.

The GridViewSpec provides the following customizable variables:

TDGeometry pos
Indicates the absolute position in the grid in which this data column's values will appear (i.e., even if the GridLogViewSpec is part of an associated group of GridLogViewSpecs this variable will indicate the absolute position of this column's value). The Z component of the position is ignored. (0,0) is in the lower left corner of each line in the GridLogView.
DisplayStyle display_style
Controls the way in which the Log data values for this column are displayed. The choices are:
TEXT
Display the values as text only
BLOCK
Display the values as a colored block
TEXT_AND_BLOCK
Display the block overlaid with with text
bool scale_on
If set, and if the display style includes BLOCK, then this column of data will participate in setting the overall scaling of values.

For data columns organized into groups (e.g., the output of a MonitorStat on a layer's worth of activations), the DT_GridViewSpec provides the following variables:

TDGeometry pos
Indicate the position in the grid in which this group of data columns' values will appear. The Z component of the position is ignored. (0,0) is in the lower left corner of each line of the GridLogView.
TDGeometry geom
Controls the size of the region in which the GridViewSpecs of the this DT_GridViewSpec are positioned.
MatrixLayout layout
Controls how the individual elements within the group are positioned relative to each other, as follows (note this is also used in the UpdateLayout function):
LFT_RGT_BOT_TOP
Increment column first, then decrement row, start at bottom left:
 789
 456
 123
LFT_RGT_TOP_BOT
Increment column first, then increment row, start at top left:
 123
 456
 789
BOT_TOP_LFT_RGT
Decrement row first, then increment column, start at bottom left:
 369
 258
 147
TOP_BOT_LFT_RGT
Increment row first, then increment column, start at top left:
 147
 258
 369
Bool use_gp_name
When this variable is set to true a single label of the name of the group's DT_GridViewSpec is used instead of individual labels for all the GridViewSpecs of the group. This also determines whether the display_style used will be that of the group or the individual elements.
DisplayStyle display_style
Controls how the data is displayed, either TEXT, BLOCK, or both.

The DT_GridViewSpec provides the following functions:

UpdateLayout(MatrixLayout ml)
Repositions the GridViewSpecs according to the ml and the geom variable. See layout variable above, which is what is used if DEFAULT is selected for the ml, for descriptions of the layout options.