Previous Page | Next Page

The GSLIDE Procedure

PROC GSLIDE Statement

Creates a text slide. Can also provide a border, specify annotation, and assign 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

specifies a data set that includes Annotate variables that identify graphics commands and parameters.

See also: Using Annotate Data Sets
Alias: ANNO=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 color of the current style. If the NOGSTYLE option is specified, then the color is the first color in the device's color list

See also: Adding Frames, Borders, and Images
Featured in:
CFRAME=frame-color

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

Note:   The CFRAME= option does not color the background of the slide.  [cautionend]

See also: Adding Frames, Borders, and Images.
Featured in: Producing Text Slides.
DESCRIPTION='entry-description'

specifies the description of the catalog entry for the slide . The maximum length for entry-description is 256 characters. By default, the GSLIDE procedure assigns the description GRAPHICS TEXT SLIDE.

The descriptive text is shown in each of the following:

  • the "description" portion of the Results window

  • the catalog-entry properties that you can view from the Explorer window

  • the Description field of the PROC GREPLAY window

Alias: DES='entry-description'
FRAME

draws a frame around the procedure output area. By default, the frame color is the color of the current style; if the NOGSTYLE option is specified, then the color is the first color in the device's color list. If you want to specify a different color for the frame, use the CFRAME= option instead. The FRAME option is overridden by the IFRAME= option, which fills the backplane frame with an image.

See also: Adding Frames, Borders, and Images
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: Specifying the Catalog Name and Entry Name for Your GRSEGs
IFRAME=fileref | 'external-file'

identifies the image file you want to apply to the backplane of the plot. See also the IMAGESTYLE= option. The IFRAME= option is overridden 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= or HTML_LEGEND= options or both.

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 and HTML Variable
IMAGESTYLE=TILE | FIT

specifies whether to tile the image specified with the IFRAME= option 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 Line Types. By default, the line type is specified by the current style. LFRAME=1, which produces a solid line, is the default.

NAME='entry-name'

specifies the name of the GRSEG catalog entry and the name of the graphics output file, if one is created. The name can be up to 256 characters long, but the GRSEG name is truncated to eight characters. Uppercase characters are converted to lowercase, and periods are converted to underscores. The default GRSEG name is GSLIDE. If the name duplicates an existing name, then SAS/GRAPH adds a number to the name to create a unique name--for example, GSLIDE1.

See also: About Filename Indexing
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 can vary from device to device. By default, the line width is specified by the current style. WFRAME=1, which is the thinnest line, is the default. The WFRAME= option also draws the frame.

See also: Adding Frames, Borders, and Images
Featured in: Producing Text Slides
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 color specified by the current style. If the NOGSTYLE option is specified, then the color is the first color in the device's color 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 Overview for a description of the procedure output area.) Use the FRAME option 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 the CFRAME= option 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 can exceed the range of the graphics output area. The range is 0 to 100. Some of the output might 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. This displays all currently defined titles, footnotes, notes, and 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.

Previous Page | Next Page | Top of Page

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