LINREP

Associates a bundle of line attributes with an index
Operating state: GKOP, SGOP, WSAC, WSOP
Default: none

Syntax

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

Required Arguments

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:
  • a color index assigned with the GSET('COLREP', . . . ) function
  • the nth color in the color list of the COLORS= graphics option
  • the nth color in the device's default color 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 Line Types for representations of the different line types.

Return Codes

This function returns:
0, 4, 61, or 860, 8, 60, 62, 85, or 90. See Return Codes for DSGI Routines and Functions.

Details

The GSET('LINREP', . . . ) function assigns a color, width, and line type to a specific line bundle. To use the bundled values when the affected graphics element is drawn; the aspect source flag (ASF) for LINCOLOR, LINWIDTH, and LINTYPE must be set to 'BUNDLED'.