GREPLAY Procedure

TDEF Statement

Defines or modifies templates in the template catalog.
Requirement: Assign a template catalog before using the TDEF statement.
See: TC statement

Creating a Template

Syntax

TDEF template-entry
<panel-definition(s)>
<DES="description">;
panel-definition has the following form:
panel-number / <panel-option(s)>
panel-option(s) can be one or more of the following:
CLIP
COLOR=border-color
COPY=panel-number
DEF
DELETE
LLX=x
LLY=y
LRX=x
LRY=y
PANEL NUMBER=
ROTATE=degrees
SCALEX=factor
SCALEY=factor
ULX=x
ULY=y
URX=x
URY=y
XLATEX=distance
XLATEY=distance

Summary of Optional Arguments

Appearance options
specifies that any panel behind this panel should be clipped.
specifies the panel border color.
Catalog entry description options
specifies the template entry description.
Panel coordinate options
specifies the X coordinate of the lower left corner of the panel.
specifies the Y coordinate of the lower right corner of the panel.
specifies the X coordinate of the lower right corner of the panel.
specifies the Y coordinate of the lower right corner of the panel.
specifies the X coordinate upper left corner of the panel.
specifies the Y coordinate upper left corner of the panel.
specifies the X coordinate upper right corner of the panel.
specifies the Y coordinate upper right corner of the panel.
specifies the distance to move the X coordinates of the panel.
specifies the distance to move the Y coordinates of the panel.
Panel management options
specifies the panel number definition to be copied to this panel.
specifies a default panel with specific coordinates.
deletes a panel.
identifies the panel number being defined or modified.
Panel rotation options
specifies the rotation angle for the panel.
Panel scaling options
specifies the scale factor for the X coordinates in the panel.
specifies the scale factor for Y coordinates in the panel.

Required Argument

template-entry
identifies an existing or new template. identifies an existing or new template. If the template is not in the template catalog, it is created by the GREPLAY procedure. If the template-entry is in the template catalog, it is modified by the procedure.
Only one template entry is required, but if you specify only the template name without any option, modifications are not made, and a template is not created.

Optional Arguments

CLIP
specifies that any panel behind this panel should be clipped. specifies that any panel behind this panel should be clipped. Only the graphics output to be placed in the CLIP panel can appear in the space that the panel occupies. If a previous panel occupies all or part of that space, CLIP is ignored.
COLOR=border-color
specifies the panel border color. specifies the panel border color. If you do not specify a border color, then the GREPLAY procedure does not draw a border around the output panel when you replay graphics output to the output panel. In that case, unless the original graphic output contains a border around the graphic, the output panel will not have a border. See Considerations for Replaying a Graph.
Note: A template that contains a panel without a border color is assigned a color when it is previewed with the PREVIEW statement.
COPY=panel-number
specifies the panel number definition to be copied to this panel. specifies the panel number definition to be copied to this panel.
DEF
specifies a default panel with specific coordinates. specifies a default panel with these coordinates:
Default Panel Characteristics
Panel Corner
Coordinates
lower left
(0,0)
upper left
(0,100)
upper right
(100,100)
lower right
(100,0)
DELETE
deletes a panel. deletes the panel.
Alias:DEL
DES="description"
specifies the template entry description. The maximum length for the template entry description is 256 characters.
Default:*** new template ***
LLX=x
specifies the X coordinate of the lower left corner of the panel. specifies the X coordinate of the lower left corner of the panel. Units for x are a percentage of the graphics output area.
LLY=y
specifies the Y coordinate of the lower right corner of the panel. specifies the Y coordinate of the lower right corner of the panel. Units for y are a percentage of the graphics output area.
LRX=x
specifies the X coordinate of the lower right corner of the panel. specifies the X coordinate of the lower right corner of the panel. Units for x are a percentage of the graphics output area.
LRY=y
specifies the Y coordinate of the lower right corner of the panel. specifies the Y coordinate of the lower right corner of the panel. Units for y are a percentage of the graphics output area.
PANEL-NUMBER=
identifies the panel number being defined or modified. identifies the panel number being defined or modified.
ROTATE=degrees
specifies the rotation angle for the panel. specifies the rotation angle for the panel. Panel corner coordinates are automatically adjusted.
SCALEX=factor
specifies the scale factor for the X coordinates in the panel. specifies the scale factor for the X coordinates in the panel. Use this scale factor to increase or decrease the panel size in the X direction, or to reverse the X coordinates for the panel.
SCALEY=factor
specifies the scale factor for Y coordinates in the panel. specifies the scale factor for Y coordinates in the panel. Use this scale factor to increase or decrease the panel size in the Y direction, or to reverse the Y coordinates for the panel.
ULX=x
specifies the X coordinate upper left corner of the panel. specifies the X coordinate upper left corner of the panel. Units for x are a percentage of the graphics output area.
ULY=y
specifies the Y coordinate upper left corner of the panel. specifies the Y coordinate upper left corner of the panel. Units for y are a percentage of the graphics output area.
URX=x
specifies the X coordinate upper right corner of the panel. specifies the X coordinate upper right corner of the panel. Units for x are a percentage of the graphics output area.
URY=y
specifies the Y coordinate upper right corner of the panel. specifies the Y coordinate upper right corner of the panel. Units for y are a percentage of the graphics output area.
XLATEX=distance
specifies the distance to move the X coordinates of the panel. specifies the distance to move the X coordinates of the panel. Units for distance are a percentage of the graphics output area.
XLATEY=distance
specifies the distance to move the Y coordinates of the panel. specifies the distance to move the Y coordinates of the panel. Units for distance are a percentage of the graphics output area.

Details

To zoom in on the graphics output, use coordinate values less than 0 and greater than 100. These values can be used with the LLX= option, LLY= option, LRX= option, LRY= option, ULX= option, ULY= option, URX= option, and the URY= option. You can see the replayed graphics output portion in the graphics output area in the range from 0 to 100%.
The values that you specify for the SCALEX= option, and the SCALEY= option are used to change the size and panel orientation. The scale factors are used for the corresponding X and Y panel coordinates. If you submit:
scalex=.5
scaley=2
the X coordinates are scaled to half the original size, and the Y coordinates are scaled to twice the original size.
If you supply a scale factor of 0, all of the coordinates are set to the same value. If you use a scale factor of 1, nothing happens. If you use a scale factor greater than 1, the values of the coordinates are increased and hence the size of the panel increases. If you use a scale factor less than 1 but greater than 0, the values of the coordinates are reversed, and the panel (and any graphics output replayed in the panel) is reversed.