graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPPAR - Set Pattern Representation

GPPAR (wsid, index, numrow, numcol, strrow, strcol, nrow, ncol, array)

Purpose

Use GPPAR to set a given pattern definition in the specified entry in the workstation's pattern table.

The pattern is a grid of color indexes of dimension nrow ncol within the array of dimension numrow numcol starting at the position defined by strrow, strcol

Some workstations required that the pattern fill is a fixed size. For these workstations, the graPHIGS API replicates the specified pattern to the fixed size.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

index -- specified by user, fullword integer

Pattern index (>=1) Index of pattern table entry to be loaded.

numrow -- specified by user, fullword integer

Number of rows in the input array (>=1)

numcol -- specified by user, fullword integer

Number of columns in the input array (>=1)

strrow -- specified by user, fullword integer

Row within array that is the start of the pattern (>=1)

strcol -- specified by user, fullword integer

Column within array that is the start of the pattern (>=1)

nrow -- specified by user, fullword integer

Number of rows within array to be used for pattern beginning at the starting position (>=1)

ncol -- specified by user, fullword integer

Number of columns within array to be used for pattern beginning at the starting position (>=1)

array -- specified by user, array of fullword integers

A grid of numrow numcol color indexes. The array must be in row order. The pattern within this array begins at position strrow, strcol, and is of dimension nrow ncol

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
48: PATTERN INDEX EXCEEDS WORKSTATION TABLE CAPACITY
85: PATTERN INDEX VALUE < ONE
91: STARTING POINT OR DIMENSION < ONE
92: COLOR INDEX < ZERO
93: COLOR INDEX VALUE(S) EXCEED WORKSTATION TABLE CAPACITY
537: PATTERN OR PIXEL ARRAY EXCEEDS INPUT ARRAY SIZE

Related Subroutines

GPQPAR: Inquire Pattern Representation

RCP code

201329413 (X'0C000B05')