GREPLAY Procedure

TREPLAY Statement

Replays graphics entries into template panels. TREPLAY copies one or more entries from the graphics input catalog into a template-entry in the graphics output catalog, using positioning information provided by the template.
Alias: TPLAY
Requirement: Before issuing the TREPLAY statement, specify a graphics input catalog with the GREPLAY IGOUT statement, assign a template entry catalog with the GREPLAY TC statement, and choose a template with the GREPLAY TEMPLATE statement.
Notes: When you replay your graphs, use the same device that you used when you generated the original graphs. If you use a different device, your replayed graphs might be distorted.

For a graph with a border, or a graph that includes titles and footnotes, if the border, titles, and footnotes are rendered outside of the GRSEG, they are not included in the replayed graph. See Considerations for Replaying a Graph.

See: IGOUT Statement

TC Statement

TEMPLATE Statement

Replaying GSLIDE Procedure Output in a Template

Syntax

TREPLAY select-pairs<DES="description" NAME="entry-name">;
select-pairs follow this form:
template-panel-number1:entry-id1 <...template-panel-numberN:entry-idN>

Required Argument

template-panel-number:entry-id
specifies the template panel number and the name of the template entry.
template-panel-number
specifies the number of the panel in the template into which you want to replay the entry. This number determines the position of the graph in the new entry in the graphics output catalog.
entry-id
specifies the name or number of the entry in the graphics input catalog that is to be added to the new entry in the graphics output catalog.

Optional Arguments

DES="description"
specifies a description of the output. The maximum length for description is 256 characters. The description does not appear in the output. The descriptive text is shown in each of the following:
  • the chart description for Web output (depending on the device driver that you are using). See Chart Descriptions for Web Presentations for more information.
  • the Table of Contents that is generated when you use CONTENTS= on an ODS HTML statement, assuming that the output is generated while the contents page is open.
  • the description and the properties for the output in the Results window.
  • the description and properties for the catalog entry in the Explorer.
  • the Description field of the PROC GREPLAY window.
Default:Graphics Replay
NAME="entry-name"
specifies the name of the GRSEG entry in the output catalog and the name of the graphics output file, if one is created.. The name must begin with a letter, and the remainder can include letters, numbers, or underscores. Uppercase letters are converted to lowercase, and periods are converted to underscores. The NAME= option can be up to 256 characters long, but the GRSEG name is truncated to eight characters. If the name duplicates an existing GRSEG entry name in the output catalog, to make the name unique, SAS/GRAPH appends a number to the GRSEG name while maintaining the eight-character limit. See Duplicate Entry Names.
Default:TEMPLATE

Details

When you replay GRSEG entries in a template, the GREPLAY procedure creates and stores graphics output in the designated output catalog.
You can replay multiple entries in one TREPLAY statement as shown here:
treplay 1:plot1 2:plot2 3:chart1;
PLOT1 is placed in panel 1 of the current template. PLOT2 is placed in panel 2. CHART1 is placed in panel 3. Specify the entry name or entry number.