MARREP

MARREP

Finds the bundle of marker attributes associated with an index

Operating States: GKOP, SGOP, WSAC, WSOP

Return Codes: 0, 8, 64, 65

Syntax
Description
Argument Definitions
See Also

Syntax

CALL GASK('MARREP', index, color-index, size, type, return-code-variable);

Description

The GASK('MARREP' . . . ) routine returns the color, size, and type of marker associated with a specific marker bundle. If the bundle indicated by index has not been previously defined with the GSET('MARREP', . . . ) function, DSGI issues the following error message:

ERROR: A representation for the specified marker index has
   not been defined on this workstation.

Argument Definitions

index numeric constant or numeric variable name; indicates the index of the fill bundle to check. 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 variable name; returns the color index of the fill color associated with the bundle. The color index returned corresponds to a color specification in the following order:

a color index assigned with the GSET('COLREP', . . . ) function

the nth color in the colors list of the COLORS= graphics option

the nth color in the device's default colors list.

size numeric variable name; returns the marker size in units of the current window system.

type numeric variable name; the index of the marker type associated with the bundle. See the GSET('MARTYPE', . . . ) function for an explanation of the marker indexes.

return-code-variable numeric variable name; returns the return code of the routine call.

See Also

COLORS= graphics option (see COLORS)

GASK('COLREP', . . . ) routine

GSET('COLREP', . . . ) function

GSET('MARINDEX', . . . ) function

GSET('MARREP', . . . ) function

GSET('MARTYPE', . . . ) function

Chapter Contents
Previous
Next
Top of Page

Operating States:	GKOP, SGOP, WSAC, WSOP
Return Codes:	0, 8, 64, 65

index	numeric constant or numeric variable name; indicates the index of the fill bundle to check. 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 variable name; returns the color index of the fill color associated with the bundle. The color index returned corresponds to a color specification in the following order: a color index assigned with the GSET('COLREP', . . . ) function the nth color in the colors list of the COLORS= graphics option the nth color in the device's default colors list.
size	numeric variable name; returns the marker size in units of the current window system.
type	numeric variable name; the index of the marker type associated with the bundle. See the GSET('MARTYPE', . . . ) function for an explanation of the marker indexes.
return-code-variable	numeric variable name; returns the return code of the routine call.

	COLORS= graphics option (see COLORS)
	GASK('COLREP', . . . ) routine
	GSET('COLREP', . . . ) function
	GSET('MARINDEX', . . . ) function
	GSET('MARREP', . . . ) function
	GSET('MARTYPE', . . . ) function