GSET Functions

GSET functions allow you to set attributes for the graphics elements. Some GSET functions set the attributes for a subset of graphics primitives. For example, attributes prefixed by FIL control the appearance of the graphics primitives GDRAW (BAR , ), GDRAW(ELLIPSE , ), GDRAW(FILL , ), and GDRAW(PIE , ). SeeTable 49.2 on page 1364 for a complete list of the attributes that control the appearance of the graphics primitives.

Some GSET functions affect the appearance of the entire graphics output. For example, GSET(HPOS , ) and GSET(VPOS , ) set the number of columns and rows for the output. See each GSET function for the aspect of the graphics output that it controls.

When using GSET functions, remember the following:

All arguments must be specified.
All arguments are specified as variables or constants. If you express an argument as a variable, the variable must be initialized .
All character arguments that are expressed as character strings must be enclosed in quotation marks.
All character variable names used as arguments must be declared in a LENGTH statement.
All character constants must be enclosed in single or double quotation marks.

GSET functions:

ASF
ASPECT
CATALOG
CBACK
CLIP
COLREP
DEVICE
FILCOLOR
FILINDEX
FILREP
FILSTYLE
FILTYPE
HPOS
HSIZE
HTML
LINCOLOR
LININDEX
LINREP
LINTYPE
LINWIDTH
MARCOLOR
MARINDEX
MARREP
MARSIZE
MARTYPE
MESSAGE
PATREP
TEXALIGN
TEXCOLOR
TEXFONT
TEXHEIGHT
TEXINDEX
TEXPATH
TEXREP
TEXUP
TRANSNO
VIEWPORT
VPOS
VSIZE
WINDOW

ASF

Specifies an aspect source flag to bundle or separate attributes

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8

Default Value: INDIVIDUAL

Syntax

return-code-variable =GSET(ASF , attribute, status );

Description

The GSET(ASF , ) function sets an attribute s aspect source flag (ASF) so that it can be used in a bundle (BUNDLED) or individually (INDIVIDUAL).

If an attribute s ASF is set to BUNDLED , it cannot be used outside of a bundle. It must be defined in a GSET( xxx REP , ) function and activated with a GSET( xxx INDEX , ) function, where xxx can have one of the following values: FIL, LIN, MAR, TEX.

If an attribute s ASF is set to INDIVIDUAL , it cannot be used with a bundle. In this case, the attribute is set with a GSET( attribute , ). The values of attribute are listed in Argument Definitions.

Argument Definitions

attribute	character string enclosed in quotes or character variable name with one of the following values:
attribute	FILCOLOR FILSTYLE FILTYPE LINCOLOR LINTYPE LINWIDTH MARCOLOR MARSIZE MARTYPE TEXCOLOR TEXFONT.
status	character string enclosed in quotation marks or character variable name; accepts either the value BUNDLED or INDIVIDUAL.

ASPECT

Specifies the aspect ratio

Operating States: GKCL

Return Codes: 0, 1, 90, 307

Default Value: 0.0

Syntax

return-code-variable =GSET(ASPECT , aspect );

Description

The GSET(ASPECT , ) function sets the aspect ratio used to draw graphics output. GSET(ASPECT , ) affects only pies, arcs, and software text.

Argument Definitions

aspect

numeric constant or numeric variable name; specifies the aspect ratio and cannot be less than 0.

CATALOG

Specifies the catalog for the graphs

Operating States: GKCL

Return Codes: 0, 1

Default Values: libref = WORK, catalog-name = GSEG

Syntax

return-code-variable =GSET(CATALOG , libref, catalog-name );

Description

The GSET(CATALOG , ) function makes the specified catalog the current catalog in which to store graphs generated with DSGI. GSET(CATALOG , ) creates the catalog if it does not exist.

The values of libref and catalog-name cannot exceed eight characters. The number of characters allowed for a catalog name varies across operating environments; see the SAS companion for your operating system. Libref should have been defined through the LIBNAME statement.

Argument Definitions

libref	character string enclosed in quotation marks or character variable name; points to the library that contains the catalog.
catalog-name	character string enclosed in quotation marks or character variable name; specifies the catalog name to be used.

CBACK

Specifies the background color

Operating States: GKCL

Return Codes: 0, 1

Default Value: 1. CBACK= graphics option, if specified; 2. device s default background color.

Syntax

return-code-variable =GSET(CBACK , cback );

Description

The GSET(CBACK , ) function sets the background color. GSET(CBACK , ) has the same effect as the CBACK= graphics option.

Argument Definitions

cback

character string enclosed in quotation marks or character variable name; can contain any predefined SAS color name. See SAS Color Names and RGB Values on page 99 for a list of predefined SAS color names.

CLIP

Specifies whether clipping is on or off

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes:

Default Value: OFF

Syntax

return-code-variable =GSET(CLIP , status );

Description

The GSET(CLIP , ) function activates or suppresses clipping around the current viewport.

Argument Definitions

status

character string enclosed in quotation marks or character variable name; valid values are ON and OFF. When ON is used, the graphics elements outside of the specified viewport are not displayed. If you turn clipping OFF, the graphics elements outside of the defined viewport are displayed.

COLREP

Associates a color name with a certain color index

Operating States: SGOP

Return Codes: 0, 4, 86

Default Values: 1. colors list of COLORS= graphics option; 2. device s default colors list

Syntax

return-code-variable =GSET(COLREP , color-index, color );

Description

The GSET(COLREP , ) function associates a predefined SAS color name with a color index. Many of the GASK routines and GSET functions use color-index as an argument.

If this function is not used, DSGI searches for a color specification in the following order:

the n th color in the colors list of the COLORS= graphics option
the n th color in the device s default colors list.

Argument Definitions

color-index	numeric constant or numeric variable name; a number from 1 to 256 that identifies a color.
color	character string enclosed in quotation marks or character variable name; a predefined SAS color name. See SAS Color Names and RGB Values on page 99 for a list of predefined SAS color names.

DEVICE

Specifies the output graphics device

Operating States: GKCL

Return Codes: 0, 1

Default Value: 1. DEVICE= graphics option, if specified; 2. value entered in DEVICE prompt window; 3. value entered in OPTIONS window

Syntax

return-code-variable =GSET(DEVICE , device );

Description

The GSET(DEVICE , ) function selects the device driver.

Argument Definitions

device

character string enclosed in quotation marks or character variable name; the name of the driver you will be using. Device must match one of the device entries in the SASHELP.DEVICES catalog or one of your personal device catalogs, GDEVICE0.DEVICES through GDEVICE9.DEVICES. Refer to About Device Catalogs on page 916 for more information about catalogs that store device entries.

FILCOLOR

Specifies the color index of the color used to draw fill areas

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 85

Default Value: 1

Syntax

return-code-variable =GSET(FILCOLOR , color-index );

Description

The GSET(FILCOLOR , ) function selects the color index of the color used to draw fill areas. The aspect source flag (ASF) of FILCOLOR must be set to INDIVIDUAL for this attribute to be used outside of a fill bundle.

DSGI searches for a color to assign to the index in the following order:

the color specified for the index in a GSET(COLREP , ) function
the n th color in the colors list of the COLORS= graphics option
the n th color in the device s default colors list found in the device entry.

Argument Definitions

color-index

numeric constant or numeric variable name; indicates the index of the color to be used. Valid values are 1 to 256, inclusive.

FILINDEX

Specifies the index of the bundle of fill area attributes

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 75

Default Value: 1

Syntax

return-code-variable =GSET(FILINDEX , index );

Description

The GSET(FILINDEX , ) function activates a particular fill bundle. The aspect source flag (ASF) for FILCOLOR, FILSTYLE, and FILTYPE must be set to BUNDLED before the associated GDRAW function is executed if you want the bundled values to be used when the affected graphics element is drawn.

Argument Definitions

index

numeric constant or numeric variable name; specifies the index number of the fill bundle. Valid values are 1 to 20, inclusive.

FILREP

Associates a bundle of fill attributes with an index

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 75, 78, 85

Default Value: none

Syntax

return-code-variable=GSET (FILREP , index, color-index, interior, style-index );

Description

The GSET(FILREP , ) function assigns a color, type of interior, and style of the interior to a specific fill bundle. The aspect source flags for FILCOLOR, FILTYPE, and FILSTYLE must be set to BUNDLED before the associated GDRAW function is executed if you want the bundled values to be used when the affected graphics element is drawn.

Argument Definitions

index	numeric constant or numeric variable name; indicates the index to be used with the bundle. Valid values are 1 to 20, inclusive. If index is expressed as a variable, the variable name must be initialized to a value between 1 and 20.
color-index	numeric constant or numeric variable name; indicates the index of the color to be used. Valid values are 1 to 256, inclusive. The color index should represent one of the following:
color-index	a color index assigned with the GSET(COLREP , ) function the n th color in the colors list of the COLORS= graphics option the n th color in the device s default colors list.
interior	character string enclosed in quotation marks or character variable name; indicates the type of interior. Valid values are
interior	HATCH HOLLOW PATTERN SOLID.
style-index	numeric constant or numeric variable name; indicates the index of the style to be used. Valid values are 1 to 15, inclusive, when FILTYPE is PATTERN, or 1 to 60, inclusive, when FILTYPE is HATCH. See the GSET(FILSTYLE , ) function FILSTYLE on page 1471 for a table of the patterns used for each style index. If interior is HOLLOW or SOLID, style-index is ignored.

FILSTYLE

Specifies the style of the interior of the fill area when the FILTYPE is PATTERN or HATCH

Operating State: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 78

Default Value: 1

Syntax

return-code-variable =GSET(FILSTYLE , style-index );

Description

The GSET(FILSTYLE , ) function activates a particular fill pattern when FILTYPE is specified as either PATTERN or HATCH. The aspect source flag (ASF) must be set to INDIVIDUAL for this attribute to be used outside of a fill bundle.

Table 50.1: Style Index Table
Value	PATTERN	HATCH	Value	HATCH
1	X1	M1X	31	M3N045
2	X2	M1X030	32	M3N060
3	X3	M1X045	33	M3N090
4	X4	M1X060	34	M3N120
5	X5	M1N	35	M3N135
6	L1	M1N030	36	M3N150
7	L2	M1N045	37	M4X
8	L3	M1N060	38	M4X030
9	L4	M1N090	39	M4X045
10	L5	M1N120	40	M4X060
11	R1	M1N135	41	M4N
12	R2	M1N150	42	M4N030
13	R3	M2X	43	M4N045
14	R4	M2X030	44	M4N060
15	R5	M2X045	45	M4N090
16		M2X060	46	M4N120
17		M2N	47	M4N135
18		M2N030	48	M4N150
19		M2N045	49	M5X
20		M2N060	50	M5X030
21		M2N090	51	M5X045
22		M2N120	52	M5X060
23		M2N135	53	M5N
24		M2N150	54	M5N030
25		M3X	55	M5N045
26		M3X030	56	M5N060
27		M3X045	57	M5N090
28		M3X060	58	M5N120
29		M3N	59	M5N135
30		M3N030	60	M5N150

Argument Definitions

style-index

numeric constant or numeric variable name. Valid values are 1 to 15, inclusive, when FILTYPE is PATTERN, or 1 to 60, inclusive, when FILTYPE is HATCH. See Table 49.1 on page 1360 for value specifications.

FILTYPE

Specifies the type of the interior of the fill area

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 78

Default Value: HOLLOW

Syntax

return-code-variable =GSET(FILTYPE , interior );

Description

The GSET(FILTYPE , ) function selects a particular type of interior fill. If FILTYPE is set to HATCH or PATTERN, the GSET(FILSTYLE , ) function determines the type of hatch or pattern fill used. The aspect source flag (ASF) for FILTYPE must be set to INDIVIDUAL for this attribute to be used outside of a fill bundle.

Argument Definitions

interior	character string or character variable name; indicates the type of interior fill. Valid values are
	HATCH HOLLOW PATTERN SOLID.

HPOS

Specifies the number of columns

Operating States: GKCL

Return Codes: 0, 1, 90, 307

Default Value: 1. HPOS= graphics option, if specified; 2. device s default HPOS setting

Syntax

return-code-variable =GSET(HPOS , hpos );

Description

The GSET(HPOS , ) function sets the number of columns in the graphics output area. GSET(HPOS , ) has the same effect as the HPOS= graphics option. See HPOS on page 315 for more information. You can reset the HPOS value by submitting one of the following statements:

 goptions reset=goptions;  goptions reset=all;  goptions hpos=0;

Argument Definitions

hpos

numeric constant or numeric variable name; specifies the number of horizontal columns; must be greater than 0.

HSIZE

Specifies the horizontal dimension of the graphics output area

Operating States: GKCL

Return Codes: 0, 1, 90, 307

Default Value: 1. HSIZE= graphics option, if specified; 2. HSIZE device parameter

Syntax

return-code-variable =GSET(HSIZE , hsize );

Description

The GSET(HSIZE , ) function sets the horizontal dimension, in inches, of the graphics output area. GSET(HSIZE , ) affects the dimensions of the default window. You can reset the HSIZE value by submitting one of the following statements:

 goptions reset=goptions;  goptions reset=all;  goptions hsize=0;

Argument Definitions

hsize

numeric constant or numeric variable name; specifies the horizontal dimension, in inches, of the graphics output area; must be greater than 0.

HTML

Specifies the HTML string to invoke when an affected DSGI graphic element in a web page is clicked

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8

Default Value: null

Syntax

return-code-variable =GSET(HTML , string );

Description

The GSET(HTML , ) function sets the HTML string to invoke when an affected DSGI graphic element in a web page is clicked. The HTML string is used with ODS processing to create a drill-down graph. The string value is used as the value for the HREF= attribute in the image map that implements the drill-down capability.

The value for string must be HREF= followed by a valid URL that is specified in double quotation marks, as in

 rc = GSET('HTML', 'HREF="http://www.sas.com/"');

The HTML string can be used by any of the following graphic element types drawn in the code: BAR, ELLIPSE, FILL, MARK, PIE, and TEXT. The string applies to all of these element types that are drawn after the string is set. To change the HTML string, set a new value. To turn off the HTML string, specify a null string:

 rc = GSET('HTML', '');

For more information on drill-down graphs, see Adding Drill-Down Links to Web Presentations on page 571. For an example of how to use DSGI to generate a drill-down graph, see Generating a Drill-down Graph Using DSGI on page 1395.

Argument Definitions

string

the HTML string. The string must be enclosed in single quotation marks and must begin with HREF= followed by a URL that is enclosed in double quotation marks.

LINCOLOR

Specifies the color index of the color used to draw lines

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 85

Default Value: 1

Syntax

return-code-variable =GSET(LINCOLOR , color-index );

Description

The GSET(LINCOLOR , ) function selects the index of the color used to draw lines. The aspect source flag (ASF) for LINCOLOR must be set to INDIVIDUAL for this attribute to be used outside of a line bundle.

DSGI searches for a color specification in the following order:

the color specified for the index in a GSET(COLREP , ) function
the n th color in the colors list of the COLORS= graphics option
the n th color in the device s default colors list found in the device entry.

Argument Definitions

color-index

numeric constant or numeric variable name; indicates the index of the color to use. Valid values are 1 to 256, inclusive.

LININDEX

Specifies the index of the bundle of line attributes

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 60

Default Value: 1

Syntax

return-code-variable =GSET(LININDEX , index );

Description

The GSET(LININDEX , ) function activates a particular line bundle. The aspect source flags (ASF) of LINCOLOR, LINTYPE, and LINWIDTH must be set to BUNDLED before the associated GDRAW function is executed if you want the bundled values to be used when the affected graphics element is drawn.

Argument Definitions

index

numeric constant or numeric variable name; indicates the index of the bundle to activate. Valid values are 1 to 20, inclusive.

LINREP

Associates a bundle of line attributes with an index

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 60, 62, 85, 90

Default Value: none

Syntax

return-code-variable =GSET(LINREP , index, color-index, width, type );

Description

The GSET(LINREP , ) function assigns a color, width, and line type to a specific line bundle. The aspect source flags (ASF) for LINCOLOR, LINWIDTH, and LINTYPE must be set to BUNDLED before the associated GDRAW function is executed if you want the bundled values to be used when the affected graphics element is drawn.

Argument Definitions

index	numeric constant or numeric variable name; indicates the number for the bundle to use as an index. Valid values are 1 and 20, inclusive. If index is expressed as a variable, the variable must be initialized to a value between 1 and 20.
color-index	numeric constant or numeric variable name; specifies the index of the color to use. Valid values are 1 to 256, inclusive. The color index should represent one of the following:
color-index	a color index assigned with the GSET(COLREP , ) function the n th color in the colors list of the COLORS= graphics option the n th color in the device s default colors list.
width	numeric constant or numeric variable name; indicates the width of the line; must be greater than 0.
type	numeric constant or numeric variable name; indicates the type of line. Valid values are 1 to 46, inclusive. See Figure 7.22 on page 208 for representations of the different line types.

LINTYPE

Specifies the line type

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 62

Default Value: 1

Syntax

return-code-variable =GSET(LINTYPE , type );

Description

The GSET(LINTYPE , ) function selects a line type. See Figure 7.22 on page 208 for representations of the different line types. The aspect source flag (ASF) for LINTYPE must be set to INDIVIDUAL for this attribute to be used outside of a line bundle.

Argument Definitions

type

numeric constant or numeric variable name; indicates the type of line to use. Valid values are 1 to 46, inclusive.

LINWIDTH

Specifies the thickness of the line

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 90

Default Value: 1

Syntax

return-code-variable =GSET(LINWIDTH , width );

Description

The GSET(LINWIDTH , ) function selects a line width in units of pixels. The aspect source flag (ASF) for LINWIDTH must be set to INDIVIDUAL for this attribute to be used outside of a line bundle.

Argument Definitions

width

numeric constant or numeric variable name; specifies the width of the line in pixels; must be greater than 0.

MARCOLOR

Specifies the color index of the color used to draw markers

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 85

Default Value: 1

Syntax

return-code-variable =GSET(MARCOLOR , color-index );

Description

The GSET(MARCOLOR , ) function selects the color index of the color used to draw markers. The aspect source flag (ASF) of MARCOLOR must be set to INDIVIDUAL for this attribute to be used outside of a marker bundle.

DSGI searches for a color specification in the following order:

the color specified for the index in a GSET(COLREP , ) function
the n th color in the colors list of the COLORS= graphics option
the n th color in the device s default colors list found in the device entry.

Argument Definitions

color-index

TEXALIGN

Specifies the horizontal and vertical alignment of the text string

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8

Default values: halign =NORMAL, valign =NORMAL

Syntax

return-code-variable =GSET(TEXALIGN , halign, valign );

Description

The GSET(TEXALIGN , ) function sets a particular type of horizontal and vertical alignment for text strings. Figure 50.5 on page 1487 illustrates halign .

Figure 50.5: Halign Values

Figure 50.6 on page 1487 illustrates valign .

Figure 50.6: Valign Values

Argument Definitions

halign	character string enclosed in quotation marks or character variable name. Valid values are
	CENTER LEFT NORMAL (the natural alignment based on the text path ); alignment is chosen according to the following logic: If TEXPATH is RIGHT , then NORMAL is LEFT . Otherwise, if TEXPATH is LEFT , then NORMAL is RIGHT . Otherwise, the text string is centered. RIGHT.
valign	character string enclosed in quotation marks or character variable name. Valid values are
	BASE (alignment based on the baseline of the text string) BOTTOM (alignment based on the bottom of the text string) HALF (alignment based on the vertical midpoint of the string) NORMAL (natural alignment based on the text path); alignment is chosen according to the following logic: If TEXPATH is RIGHT or TEXPATH is LEFT , then NORMAL is BASE . Otherwise, if TEXPATH is UP , then NORMAL is BOTTOM . Otherwise, if TEXPATH is DOWN , then NORMAL is TOP . TOP (alignment based on the top of the string).

TEXCOLOR

Specifies the color index of the color used to draw text strings

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 85

Default Value: 1

Syntax

return-code-variable =GSET(TEXCOLOR , color-index );

Description

The GSET(TEXCOLOR , ) function selects the color for text. The aspect source flag (ASF) of TEXCOLOR must be set to INDIVIDUAL for this attribute to be used outside of a text bundle.

The value of GSET(TEXCOLOR , ) can be used in a text bundle. See the TEXREP on page 1492 for information on how to define a text bundle.

DSGI searches for a color specification in the following order:

the color specified for the index in a GSET(COLREP , ) function
the n th color from the colors list of the COLORS= graphics option
the n th color in the device s default colors list found in the device entry.

Figure 50.7: TEXPATH Values

Argument Definitions

path

character string enclosed in quotation marks or character variable name; specifies the direction in which the text will read. Valid values are

DOWN
LEFT
RIGHT
UP.

TEXREP

Associates a bundle of text attributes with an index

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 68, 85

Default Value: none

Syntax

return-code-variable =GSET (TEXREP , index, color-index, font );

Description

The GSET(TEXREP , ) function assigns a color and font to a particular text bundle. The aspect source flags (ASF) of TEXCOLOR and TEXFONT must be set to BUNDLED before the GDRAW(TEXT , ) function is executed if you want the bundled values to be used when the text is drawn.

Argument Definitions

index

numeric constant or numeric variable name; specifies the number to use as an index for the bundle; valid values are 1 to 20, inclusive. If index is expressed as a variable, the variable must be initialized to a value between 1 and 20.

color-index

numeric constant or numeric variable name; indicates the color to use; valid values are 1 to 256, inclusive. The color index should represent one of the following:

a color index assigned with the GSET(COLREP , ) function
the n th color in the colors list of the COLORS= graphics option
the n th color in the device s default colors list.

font

character string enclosed in quotation marks or character variable name; names the font to use with the bundle. See Font Lists on page 82 for a list of valid SAS/GRAPH fonts. You may also use fonts you have created using the GFONT procedure.

TEXUP

Specifies the orientation (angle) of the text string

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 74

Default Values: upx =0, upy =1

Syntax

return-code-variable =GSET(TEXUP , upx, upy );

Description

The GSET(TEXUP , ) function sets the angle of the text string. DSGI uses the values of character up vectors to determine the angle of a text string. The character up vector has two components , upx and upy , that describe the angle at which the text string is placed. The angle is calculated with the following formula:

 angle=atan(upx/upy)

Effectively, when DSGI is calculating the angle for the text, it uses upx and upy as forces that are pushing the string toward an angle. The natural angle of text in the upx direction is toward the 6 o clock position. In the upy direction, text naturally angles at the 3 o clock position. If upx is greater than upy , the text is angled toward 6 o clock. If upy is greater than upx , the text is angled toward 3 o clock. Figure 50.8 on page 1494 shows the angle of text when the values for upx and upy are (0.0, 1.0) and (1.0, 0.0).

Figure 50.8: Natural Angle of Text

As you change the values of upx and upy , the coordinate that has the highest value is taken as the angle, and the lowest value as the offset. Figure 50.9 on page 1495 shows the angle of text when the character up vector values (+1.0, +0.5) are used.

Figure 50.9: Varying the Angle of Text

You can use the following macro to convert angles measured in degrees to character up vectors:

 %macro angle(x);   if  mod(&x, 180)=90 then do;      if mod(&x, 270) = 0 then         xup = 1.0;      else         xup =   1.0;      rc = gset('texup', xup, 0.0);      end;   else do;      b = mod(&x, 360);      /* adjust y vector for 2nd and 3rd quadrants */      if b > 90 and b lt 270 then        yup =   1.0;      else        yup = 1.0;      a=&*1.7453292519943300e   002;      xup = tan(   a);      /* adjust x vector for 3rd quadrant */      if b > 180 and b le 270 then        xup =   xup;      rc = gset('texup', xup, yup);      end;  %mend angle;  data _null_;    rc = ginit();    rc = graph('clear', 'angle');    rc = gset('texalign', left', 'base');    rc = gset('texheight', 5);    rc = gset('texfont', 'swissl');    %angle(180);    rc = gdraw('text', 50, 50, '180');    %angle(80);    rc = gdraw('text', 50, 50, 80);    %angle(600);    rc = gdraw('text', 50, 50, 600);    rc = graph('update');    rc = gterm();    run;

Argument Definitions

upx	numeric constant or numeric variable name; if upy is 0, upx cannot be 0.
upy	numeric constant or numeric variable name; if upx is 0, upy cannot be 0.

TRANSNO

Specifies the number of the transformation to be used

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 50

Default Value:

Syntax

return-code-variable =GSET(TRANSNO , n );

Description

The GSET(TRANSNO , ) function activates the viewport and/or window you have defined for the specified transformation number. If you have not defined both a viewport and window for a transformation, the default is used for the one missing.

You can select 0 as the active transformation, but you cannot define a viewport or window for that transformation number. A transformation of 0 activates the default viewport, (0, 0) to (1, 1), and window, which is device dependent.

Argument Definitions

n	numeric constant or numeric variable name; indicates the viewport and/or window to activate; should correspond to the n used in the GSET(VIEWPORT , ) and/or GSET(WINDOW , ) functions. Valid values are 0 to 20, inclusive.

VIEWPORT

Associates a viewport with a transformation number

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 50, 51, 52

Default Values: llx =0, lly =0, urx =1, ury =1

Syntax

return-code-variable =GSET(VIEWPORT , n, llx, lly, urx, ury );

Description

The GSET(VIEWPORT , ) function defines a viewport and associates it with the transformation number, n . See the TRANSNO on page 1496 for information on how to activate the viewport. See the WINDOW on page 1500 for information on how to define a window to be used within the viewport.

Argument Definitions

n	numeric constant or numeric variable name; specifies the transformation number of the viewport. Valid values are 1 to 20, inclusive.
llx	numeric constant or numeric variable name; defines the x component of the lower-left corner of the viewport; must not exceed the value of urx ; cannot be less than 0. Units are based on percent of the graphics output area.
lly	numeric constant or numeric variable name; defines the y component of the lower-left corner of the viewport; must not exceed the value of ury ; cannot be less than 0. Units are based on percent of the graphics output area.
urx	numeric constant or numeric variable name; defines the x component of the upper-right corner of the viewport; cannot be greater than 1. Units are based on percent of the graphics output area.
ury	numeric constant or numeric variable name; defines the y component of the upper-right corner of the viewport; cannot be greater than 1. Units are based on percent of the graphics output area.

VPOS

Specifies the number of rows

Operating States: GKCL

Return Codes: 0, 1, 90, 307

Default Values: 1. VPOS=graphics option, if specified; 2. device s default VPOS value

Syntax

return-code-variable =GSET(VPOS , vpos );

Description

The GSET(VPOS , ) function sets the number of rows in the graphics output area. GSET(VPOS , ) has the same effect on graphics output as the VPOS= graphics option.

You can reset the VPOS value by submitting one of the following statements:

 goptions reset=goptions;  goptions reset=all;  goptions vpos=0;

Argument Definitions

vpos

numeric constant or numeric variable name; specifies the number of rows in the graphics output area; must be greater than 0.

VSIZE

Specifies the vertical dimension of the graphics output area

Operating States: GKCL

Return Codes: 0, 1, 90, 307

Default Values: 1. VSIZE= graphics option, if specified; 2. device s default VSIZE value

Syntax

return-code-variable =GSET(VSIZE , vsize );

Description

The GSET(VSIZE , ) function sets the vertical dimension, in inches, of the graphics output area. GSET(VSIZE , ) affects the dimensions of the default window.

You can reset the VSIZE value by submitting one of the following statements:

 goptions reset=goptions;  goptions reset=all;  goptions vsize=0;

Argument Definitions

vsize

numeric constant or numeric variable name; indicates the vertical dimension for the graph in inches; must be greater than 0.

WINDOW

Associates a window with a transformation number

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 50, 51

Default Values: llx =0, lly =0; urx and ury are device dependent

Syntax

return-code-variable =GSET (WINDOW , n, llx, lly, urx, ury );

Description

The GSET(WINDOW , ) function defines a window and associates it with a transformation number. See the TRANSNO on page 1496 for information on how to activate a window. See the VIEWPORT on page 1497 for information on how to define a viewport for a window.

Argument Definitions

n	numeric constant or numeric variable name; specifies the transformation number of the window. Valid values are 1 to 20, inclusive.
llx	numeric constant or numeric variable name; defines the x component of the lower-left corner of the window; must not exceed the value of urx . Units are based on percent of the active viewport.
lly	numeric constant or numeric variable name; defines the y component of the lower-left corner of the window; must not exceed the value of ury . Units are based on percent of the active viewport.
urx	numeric constant or numeric variable name; defines the x component of the upper-right corner of the window. Units are based on percent of the active viewport.
ury	numeric constant or numeric variable name; defines the y component of the upper-right corner of the window. Units are based on percent of the active viewport.

ASF

Syntax

Description

Argument Definitions

See Also

ASPECT

Syntax

Description

Argument Definitions

See Also

CATALOG

Syntax

Description

Argument Definitions

See Also

CBACK

Syntax

Description

Argument Definitions

See Also

CLIP

Syntax

Description

Argument Definitions

See Also

COLREP

Syntax

Description

Argument Definitions

See Also

DEVICE

Syntax

Description

Argument Definitions

See Also

FILCOLOR

Syntax

Description

Argument Definitions

See Also

FILINDEX

Syntax

Description

Argument Definitions

See Also

FILREP

Syntax

Description

Argument Definitions

See Also

FILSTYLE

Syntax

Description

Argument Definitions

See Also

FILTYPE

Syntax

Description

Argument Definitions

See Also

HPOS

Syntax

Description

Argument Definitions

See Also

HSIZE

Syntax

Description

Argument Definitions

See Also

HTML

Syntax

Description

Argument Definitions

See Also

LINCOLOR

Syntax

Description

Argument Definitions