CELL ARRAY 3 PLUS

PCA3P

CALL SEQUENCE

CALL PCA3P	(CPXA, CPYA, CPZA, DIMX, DIMY, CVSC, CVSR, DX, DY, CTYPE, NCC, COLIA, COLRA)

INPUT PARAMETERS

REAL CPXA(3),CPYA(3),CPZA(3)

Cell parallelogram(P,Q,R)(MC)

INTEGER DIMX,DIMY

The number of columns and number of rows in COLIA or COLRA

INTEGER CVSC,CVSR

Indices of start column, start row

INTEGER DX,DY

Number of columns, number of rows

INTEGER CTYPE

Colour type

INTEGER NCC

Number of components of colour value

INTEGER COLIA(DIMX,DIMY)

Colour index array

REAL COLRA (NCC*DIMX*DIMY)

Colour component array

PHIGS STATE

EFFECT

This function specifies the 3D characteristics of the cell array plus primitive. This form of the cell array primitive is based on the general colour type and allows direct specification of cell colours.

The CELL ARRAY 3 PLUS 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 PLUS 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 general colour 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.

A cell array 3 plus element containing an empty array of colours will be placed in the open structure. When such an element is encountered it will have no visual effect.

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

SEE ALSO

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