CELL ARRAY 3

PCA3

CALL SEQUENCE

CALL PCA3 (CPXA, CPYA, CPZA, DIMX, DIMY, ISC, ISR, DX, DY, COLIA)

INPUT PARAMETERS

REAL CPXA, CPYA, CPZA

Three points P, Q, R. Definition parallelogram (MC).

INTEGER DIMX, DIMY

Array dimension.

INTEGER ISC, ISR

Column-line coordinates of the bottom left corner of the sub-array.

INTEGER DX, DY

Sub-array dimension.

INTEGER COLIA

Color array.

PHIGS STATE

EFFECT

This function specifies the 3D characteristics of the cell array primitive .

The CELL ARRAY 3 element is inserted in the open structure after element pointer or replaces the element indicated by element pointer, depending on the edit mode value. Element pointer is updated and points to the CELL ARRAY 3 structure element. The values specified in the function are associated with the element.

When a function of this type is interpreted, a cell array defined by the parallelogram cells, of which the colour is specified by the index of its associated cell in the array, must be displayed on the screen. GPHIGS simulates this function, making best use of the capabilities of the peripheral device used.

EXTENSION TO THE PHIGS STANDARD

If used in NRS mode, the effect of this function is different from the effect described in the standard.

In NRS mode, (see OPEN PIPE), the element is not stored in a structure. It is sent to the workstation on which the pipe is opened.

ERRORS

5

Ignoring function, function requires state (PHOP,*, STOP,*)

117

Ignoring function, one of the dimensions of the colour index array is less than zero

113

Ignoring function, the colour index value is less than zero

SEE ALSO

open structure, open pipe (ext), cell array, inquire current element content, inquire current element type and size