Procedure Syntax | SAS.GRAPH 9.1 Reference, Volumes I and II

Requirements: At least one of these is required: a TITLE, FOOTNOTE, or NOTE statement; an appearance option; the BORDER graphics option.

Global statements: FOOTNOTE, TITLE

Reminder: The procedure can include the SAS/GRAPH NOTE statement.

Supports: RUN- group processing Output Delivery System (ODS)

PROC GSLIDE < option(s) >;

PROC GSLIDE Statement

Creates a text slide. Optionally, it provides a border, specifies annotation, and assigns an output catalog. This is the only statement in the procedure.

Syntax

PROC GSLIDE < option(s) >;

option(s) can be one or more options from any or all of the following categories:
- appearance options:
  
  ANNOTATE= Annotate-data-set
  
  BORDER
  
  CFRAME= frame- color
  
  FRAME
  
  IFRAME= fileref external-file
  
  IMAGESTYLE=TILE FIT
  
  LFRAME= line-type
  
  WFRAME= n
- description options:
  
  DESCRIPTION= entry-description
  
  GOUT=< libref .> output-catalog
  
  NAME = entry-name
- HTML option:
  
  IMAGEMAP= output-data-set >

Options

You can specify as many options as you want and list them in any order.

ANNOTATE= Annotate-data-set

ANNO= Annotate-data-set

specifies a data set that includes Annotate variables that identify graphics commands and parameters.
See also: Chapter 24, Using Annotate Data Sets, on page 587.
Featured in: Example 2 on page 1283.

BORDER

draws a border around the graphics output area, which includes the title area, the footnote area, and the procedure output area. A color specification for the border is searched for in the following order:
1. the CTITLE= option in a GOPTIONS statement
2. the CTEXT= option in a GOPTIONS statement
3. the default, the first color in the colors list.

See also: Adding Frames, Borders, and Images on page 1281.
Featured in: Example 1 on page 1282.

CFRAME= frame-color

draws a frame around the procedure output area in the specified color. If you use both the CFRAME= and FRAME options, FRAME is ignored. If you use the IFRAME= option, the specified image fills the background of the slide.

Note: CFRAME= does not color the background of the slide.

See also: Adding Frames, Borders, and Images on page 1281.
Featured in: Example 1 on page 1282.

DESCRIPTION= entry-description

DES= entry-description

specifies the description of the catalog entry for the chart. The maximum length for entry-description is 256 characters . The description does not appear on the chart. By default, the GSLIDE procedure assigns the description OUTPUT FROM PROC GSLIDE.

FRAME

draws a frame around the procedure output area. By default, the frame color is the first color in the colors list. If you want to specify a different color for the frame, use the CFRAME= option instead. The FRAME option is overriden by the IFRAME= option, which fills the backplane frame with an image.
See also: Adding Frames, Borders, and Images on page 1281.

GOUT=< libref .> output-catalog

specifies the SAS catalog in which to save the graphics output produced by the GSLIDE procedure. If you omit the libref, SAS/GRAPH looks for the catalog in the temporary library called WORK and creates the catalog if it does not exist.
See also: Storing Graphics Output in SAS Catalogs on page 53.

IFRAME= fileref external-file

identifies the image file you wish to apply to the backplane of the plot. See also the IMAGESTYLE= option. The IFRAME= option is overidden by the NOIMAGEPRINT goption.

IMAGEMAP= output-data-set

creates a temporary SAS data set that is used to generate an image map in an HTML output file. The information in the image map data set includes the shape and coordinates of the elements in the graph and drill-down URLs that have been associated with those elements. The drill-down URLs are provided by one or two variables in the input data set. These variables are identified to the GSLIDE procedure with the HTML= and/or HTML_LEGEND= options.

The %IMAGEMAP macro generates the image map in the HTML output file. The macro takes two arguments, the name of the image map data set and the name or fileref of the HTML output file, as shown in the following example:
```
 %imagemap(imgmapds, myimgmap.html); 
```

See also: Adding Links with the HTML= and HTML_LEGEND= Options on page 574 and HTML Variable on page 651.

IMAGESTYLE=TILEFIT

specifies whether to tile the image to fill the backplane or to stretch the image to fit the backplane. The TILE value is the default. See also the IFRAME= option.

LFRAME= line-type

specifies the line type for a frame and draws a frame around the procedure output area. Values for line-type are 1 through 46. Line types are shown in Figure 7.22 on page 208. By default, LFRAME=1, which produces a solid line.

NAME= entry-name

specifies the name of the catalog entry for the graph. The maximum length for entry-name is eight characters. The default name is GSLIDE. If the specified name duplicates the name of an existing entry, SAS/GRAPH software adds a number to the duplicate name to create a unique entry, for example, GSLIDE1.

WFRAME= n

specifies the width of the frame where n is a number. The thickness of the frame increases directly with n , but the thickness of the line may vary from device to device. By default, WFRAME=1, which is the thinnest line. The WFRAME= option also draws the frame.
See also: Adding Frames, Borders, and Images on page 1281.
Featured in: Example 1 on page 1282.

Adding Frames, Borders, and Images

Like the BORDER option in a GOPTIONS statement, the BORDER option in the PROC GSLIDE statement draws a box around the graphics output area. However, the border generated by the GSLIDE procedure remains in effect only for the duration of the procedure.

Both BORDER options use the color specified by the CTITLE= or CTEXT= graphics option if either of these options is used; otherwise , the border color is the first color in the colors list.

While the BORDER option draws a box around the graphics output area, the FRAME option draws a box or frame around the procedure output area. In this case, titles and footnotes are outside of the frame. (See Procedure Output and the Graphics Output Area on page 34 for a description of the procedure output area.) Use FRAME to draw a frame in the default color, line type, and width. Otherwise, use one or more of the CFRAME=, LFRAME=, or WFRAME= options.

You can specify a colored frame with the CFRAME= option. Note that CFRAME= does not fill the procedure output area with color. However, you can use the CBACK= graphics option to provide a background color for the graphics output area. You can specify the type of line for the frame with the LFRAME= option and the width of the frame with the WFRAME= option.

You can also use the IFRAME= option to fill the background of your slide with an image. If an image is specified, it completely fills the background of the slide, obscuring any frame or border specifications.

Using Data-Dependent Coordinates

If you use the GSLIDE procedure with Annotate data sets that contain data-dependent coordinates, the resulting coordinate values may exceed the range of 0 to 100 used by the graphics output area, and some of the output may not be displayed. In this case, use the GANNO procedure, which can scale the output to fit the available space. See also Chapter 26, The GANNO Procedure, on page 707 for details .

Using RUN Groups

Although the GSLIDE procedure has no action statements, it can use RUN-group processing to display all currently defined titles, footnotes, and notes, as well as specified annotation, each time you submit a RUN statement. TITLE and FOOTNOTE statements that are defined while the GSLIDE procedure is active remain in effect after the procedure ends. NOTE definitions remain in effect until the GSLIDE procedure ends, at which time they are canceled . To cancel NOTE definitions while the procedure is active, specify RESET=NOTE in a GOPTIONS statement or submit a null NOTE statement. See RUN-Group Processing on page 33 for details.