Chapter Contents

Previous

Next
The GSLIDE Procedure

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:


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: The Annotate Data Set
Featured in: Displaying Annotate Graphics

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: Drawing Frames and Borders
Featured in: Producing Text Slides

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.

Note:   CFRAME= does not color the background of the slide.  [cautionend]
See also: Drawing Frames and Borders
Featured in: Producing Text Slides

DESCRIPTION='entry-description'
DES='entry-description'
specifies the description of the catalog entry for the chart. The maximum length for entry-description is 40 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.
See also: Drawing Frames and Borders

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

IMAGEMAP=output-data-set
creates a SAS data set that contains information about the graph and about areas in the graph. This information includes the shape and coordinates of the areas, and is used to build an HTML file that links the graph areas to other files or images. This linking provides drill-down functionality on the graph. The Imagemap data set also contains the information that is stored in the HTML variable in the Annotate data set. Therefore, in order to use IMAGEMAP= to create an HTML file, you must also use the HTML variable in the Annotate data set.
See also: Customizing Web Pages for Drill-down Graphs and HTML Variable

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 Line Types. 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: Drawing Frames and Borders
Featured in: Producing Text Slides


Drawing Frames and Borders

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


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 The GANNO Procedure 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 for details.


Chapter Contents

Previous

Next

Top of Page

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