GPHIGS C FUNCTIONS - CELL ARRAY 3

CELL ARRAY 3

PCELL_ARRAY3

CALL SEQUENCE

void pcell_array3(

const Pparal	*paral	/* cell parallelogram	*/
const Ppat_rep	*colr_array	/* colour array	*/

TYPES

typedef struct {
	Ppoint3	p;	/* point p 	*/
	Ppoint3	q;	/* point q	*/
	Ppoint3	r;	/* point r 	*/
} Pparal;

typedef struct {
	Pint_size	dims;	/* pattern dimensions	*/
	Pint	*colr_array;	/* colour index array	*/
} Ppat_rep;

typedef struct {
	Pfloat 	x;	/* x coordinate	*/
	Pfloat 	y;	/* y coordinate	*/
	Pfloat 	z;	/* z coordinate	*/
} Ppoint3;

typedef struct {
	Pint	size_x;	/* dimension (number of divisions) along x	*/
	Pint	size_y;	/* dimension (number of divisions) along y	*/
} Pint_size;

PHIGS STATE

(PHOP, *, STOP, *).

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 one of the two GPHIGS specific modes NRS or NDDS, 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.

In NDDS mode, (see BEGIN NON DUPLICATE DATA STORE), the element is stored in the structure but its content is not copied into the CSS. GPHIGS stores only the pointer to the user's data.

See GPHIGS user guide for more details on NRS and NDDS modes.

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