Chapter Contents

Previous

Next
The GREPLAY Procedure

TDEF Statement


Defines or modifies templates in the current template catalog.

Requirements: Assign a template catalog before using the TDEF statement.
See also: TC statement
Featured in: Creating a Template



Syntax

TDEFtemplate-entry
<panel-definition(s)>
<DES='entry-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
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 a new template. If the template is not in the template catalog, the procedure creates it. If the template is already in the template catalog, the procedure modifies or makes additions to that template.

Only template-entry is required, but if you specify only the template name without any options, no changes are made to an existing template and no new template is created.


Options

CLIP
specifies that any panels behind this panel should be clipped. If clipping is in effect for a panel, only the graphics output that is to be placed in that panel can appear in the space that the panel occupies, unless a previous panel occupies all or part of that space.

COLOR=border-color
specifies the color of the panel border. If you omit border-color, then no border is displayed around the panel when you replay graphics output in the panel. If you preview a template that contains a panel without a border color, the GREPLAY procedure uses the first color in the colors list as the outline for the border.

COPY=panel-number
specifies the number of the panel definition that is to be copied to this panel.

DEF
specifies a default panel. A default panel has the following characteristics:

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

DELETE
DEL
deletes the panel.

DES='entry-description'
specifies the description of the catalog entry for the template. The maximum length for entry-description is 40 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 percentage of the graphics output area.

LLY=y
specifies the Y coordinate of the lower-left corner of the panel. Units for y are percentage of the graphics output area.

LRX=x
specifies the X coordinate of the lower-right corner of the panel. Units for x are percentage of the graphics output area.

LRY=y
specifies the Y coordinate of the lower-right corner of the panel. Units for y are percentage of the graphics output area.

panel-number
identifies the number of the panel that is being defined or modified.

ROTATE=degrees
specifies the rotation angle for the panel. The coordinates of the panel corners are automatically adjusted.

SCALEX=factor
specifies the scale factor for the X coordinates in the panel. You can use this scale factor to increase or decrease the size of the panel 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. You can use this scale factor to increase or decrease the size of the panel in the Y direction or to reverse the Y coordinates for the panel.

ULX=x
specifies the X coordinate of the upper-left corner of the panel. Units for x are percentage of the graphics output area.

ULY=y
specifies the Y coordinate of the upper-left corner of the panel. Units for y are percentage of the graphics output area.

URX=x
specifies the X coordinate of the upper-right corner of the panel. Units for x are percentage of the graphics output area.

URY=y
specifies the Y coordinate of the upper-right corner of the panel. Units for y are percentage of the graphics output area.

XLATEX=distance
specifies the distance to move the X coordinates of the panel. Units for distance are percentage of the graphics output area.

XLATEY=distance
specifies the distance to move the Y coordinates of the panel. Units for distance are percentage of the graphics output area.


Details

Use coordinate values that are less than 0 and greater than 100 in the LLX=, LLY=, LRX=, LRY=, ULX=, ULY=, URX=, and URY= options to zoom in on the graphics output. That is, you can see only that part of the replayed graphics output in the range from 0 to 100 percent of the graphics output area.

The values that you supply for the SCALEX= and SCALEY= options are used to change the size and orientation of the panel. The scale factors are used for the corresponding X and Y coordinates of the panel. For example, if you specify

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 decreased and hence the size of the panel decreases. If you use a negative scale factor, the coordinates are reversed and hence the panel (and any graphics output replayed in the panel) is reversed.


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.