graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPPXL2 - Pixel 2

GPPXL2 (point, pack, numrow, numcol, startrow, startcol, nrow, ncol, array)

Purpose

Use GPPXL2 to insert a Pixel 2 element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Pixel 2 structure element depending on the current edit mode.

This structure element defines a two-dimensional rectangular array of pixels that the application writes into the frame buffer of a workstation. The pixel values specify indexes into the workstation's display color table. Only the low order byte of the pixel array is used and preserved by this primitive. The graPHIGS API assumes the primitive exists in the z=0 plane.

GPPXL2 is identified as GDP 1002.

Note:

Not all GDPs are supported on all workstations. Use the Inquire List of Generalized Drawing Primitives (GPQGD) subroutine to determine the GDPs supported by an opened workstation. See also the workstation description in The graPHIGS Programming Interface: Technical Reference

Parameters

point -- specified by user, 2 short floating-point numbers (MC)

x and y coordinates of the upper left corner for start of pixel rectangle.

pack -- specified by user, fullword integer

Specifies the packing factor of the pixel color indexes in the input array (8 BITS/PIXEL, 16 BITS/PIXEL, 32 BITS/PIXEL ) The interpretation of the following parameters depends on this value. The graPHIGS API uses the least significant 8 bits only.

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)

startrow -- specified by user, fullword integer

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

startcol -- specified by user, fullword integer

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

nrow -- specified by user, fullword integer

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

ncol -- specified by user, fullword integer

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

array -- specified by user, array of integers (as defined by the packing factor)

A grid of numrow by numcol color indexes. The array must be in row order.

Error Codes

5: FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)
91: STARTING POINT OR DIMENSION < ONE
537: PATTERN OR PIXEL ARRAY EXCEEDS INPUT ARRAY SIZE
549: INVALID PIXEL PACK FACTOR

Related Subroutines

None

RCP code

201328143 (X'0C00060F')