




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.




