Previous Page | Next Page

The GREPLAY Procedure

TDEF Statement


Defines or modifies templates in the template catalog.
Requirements: Assign a template catalog before using the TDEF statement.
See also: TC statement
Featured in: 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

Required Arguments

template-entry

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.


Options

CLIP

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. If you do not specify a border color, then no border is displayed around the panel when you replay graphics output in the panel. A template that contains a panel without a border color is assigned a color when previewed. The GREPLAY procedure creates output with borders.

COPY=panel-number

specifies the panel number definition to be copied to this panel.

DEF

specifies a default panel with these coordinates:

Panel Corner Coordinates
lower left (0,0)
upper left (0,100)
upper right (100,100)
lower right (100,0)

DELETE

deletes the panel.

Alias: DEL
DES="description"

specifies the template entry description. The maximum length for the template entry description is 256 characters. By default, the procedure uses *** new template *** for the description.

LLX=x

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. 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. 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. Units for y are a percentage of the graphics output area.

PANEL-NUMBER=

identifies the panel number being defined or modified.

ROTATE=degrees

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. 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. 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. Units for x are a percentage of the graphics output area.

ULY=y

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-rignt corner of the panel. Units for x are a percentage of the graphics output area.

URY=y

specifies the Y coordinate upper-rignt 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. Units for distance are a percentage of the graphics output area.

XLATEY=distance

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 percent.

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.

Previous Page | Next Page | Top of Page