5. Display Page Tables

The display page database is made up of several record types.

PgKeys contains the master records for a display page. There is one record in PgKeys for each page in the system.

The rest of the records define display entities. There is one record for each entity on the screen. An entity can be an alphanumeric field or an icon.

5.1. PgKeys Table

This table associates a display page name with a page number.

PgNme

Page name.

PgVal

Page number.

Dflag

Display flag. The value of this field is either 'Y' or 'N'. If the value is 'Y', all of the records associated with the page are displayed unless their individual Dflags are set to 'N'. If the value is 'N', the entire page is inhibited from being displayed.

PgDesc

Comments field.

5.2. CrtText Table

This table defines static text strings in a display page. These strings can be used for comments and other permanent text.

Together PgNme and RecId form the key for this table.

PgNme

Name of the page.

Validated by PgKeys.PgNme.

RecId

A serial number used to identify the record.

CurX

X coordinate on display page.

CurY

Y coordinate on display page.

Dflag

Display flag. The value of this field is either 'Y' or 'N'. If the value is 'Y', this record is displayed. If the value is changed while the page is displayed, the field is erased.

Width

Width (in characters) of the string.

FontType

Font setting to display the text.

Valid values are: default, big, and user1 through user8.

Text

The string to be displayed.

5.3. CrtFixed Table

This table defines database fields for display.

PgNme

Name of the page.

Validated by PgKeys.PgNme.

DFnme

Type of field to display.

Validated by DFkeys.DFnme.

RecId

A serial number used to identify the record.

CurX

X coordinate on display page.

CurY

Y coordinate on display page.

Dflag

Display flag. The value of this field is either 'Y' or 'N'. If the value is 'Y', this record is displayed. If the value is changed while the page is displayed, the field is erased.

Width

Width (in characters) of the string.

FontType

Font setting to display the text.

Valid values are: default, big, and user1 through user8.

Label, RefName

Name of the parameter to display. If DFnme is set to Label or Name, only the Label must be set. The RefName field may be NULL.

5.4. CrtDCpnt Table

This table defines Display/Control parameter sets for a display page. The first display parameter (DCdisp1_Label, DCdisp1_DrefNme) is the one displayed on the screen at the given coordinates. The DCdisp and DCctl fields work in sets. For example, when a DCpnt is selected on the screen, DCdisp1 will be displayed as the readback parameter and DCctl1 will be displayed as the control parameter. The # in DCdisp# and DCctl# identify the layer number. The first time an item is clicked, the first layer will appear. Subsequent clicks will increment the layer.

PgNme

Name of the page this record is associated with.

Validated by PgKeys.PgNme.

RecId

A serial number used to identify the record.

CurX

X coordinate on display page.

CurY

Y coordinate on display page.

Dflag

Display flag. The value of this field is either 'Y' or 'N'. If the value is 'Y', this record is displayed. If the value is changed while the page is displayed, the field is erased. However, the field may still be selected by the mouse until a new page is loaded or the same page is reloaded.

Width

Width (in characters) of the string.

FontType

Font setting to display the text.

Valid values are: default, big, and user1 through user8.

DCdisp1_Label, DCdisp1_DrefNme

First read back parameter.

DCdisp2_Label, DCdisp2_DrefNme

Second read back parameter.

DCdisp3_Label, DCdisp3_DrefNme

Third read back parameter.

DCdisp4_Label, DCdisp4_DrefNme

Fourth read back parameter.

DCctl1_Label, DCctl1_DrefNme

First control parameter.

DCctl2_Label, DCctl2_DrefNme

Second control parameter.

DCctl3_Label, DCctl3_DrefNme

Third control parameter.

DCctl4_Label, DCctl4_DrefNme

Fourth control parameter.

5.5. CrtBut Table

Deprecated (part of button tables).

5.6. CrtICpnt Table

Icon display definition table. ICdisp and ICctl fields are treated in the same way as in the CrtDCpnt table.

PgNme

Name of the page this record is associated with.

Validated by PgKeys.PgNme.

ICtype

Type of icon to display.

Validated by IconKeys.IconNme.

RecId

A serial number used to identify the record.

GrpNme

Name of the beamline region associated with this record.

Validated by GrpKeys.GrpNme.

CurX

X coordinate on display page.

CurY

Y coordinate on display page.

CurX2

Second X coordinate on display page. This field is used to stretch/modify the geometry of the icon. A value of "0" will result in the default geometry for the given plane.

CurY2

Second Y coordinate on display page. This field is used to stretch/modify the geometry of the icon. A value of "0" will result in the default geometry for the given plane.

ICrot

Amount (in degrees) to rotate the icon from its base orientation (right hand coordinates). A value of "0" will result in the no rotation.

ICscale

Amount to scale the icon size. The default (and most common) size is 1.0.

Dflag

Display flag. If the value is 'Y', this record is displayed. If the value is changed while the page is displayed, the field is erased. However, the field may still be selected by the mouse until a new page is loaded or the same page is reloaded.

ICicon_Label, ICicon_DrefNme

Data point from which to get the icon color.

ICdisp1_Label, ICdisp1_DrefNme

First Display parameter.

ICdisp2_Label, ICdisp2_DrefNme

Second Display parameter.

ICdisp3_Label, ICdisp3_DrefNme

Third Display parameter.

ICdisp4_Label, ICdisp4_DrefNme

Fourth Display parameter.

ICctl1_Label, ICctl1_DrefNme

First Control parameter.

ICctl2_Label, ICctl2_DrefNme

Second Control parameter.

ICctl3_Label, ICctl3_DrefNme

Third Control parameter.

ICctl4_Label, ICctl4_DrefNme

Fourth Control parameter.

Comments

Comments field.