GPHIGS C FUNCTIONS - CELL ARRAY 3 PLUS

CELL ARRAY 3 PLUS

PCELL_ARRAY3_PLUS

CALL SEQUENCE

void pcell_array3_plus(

const Pparal	*paral,	/* parallelogram P,Q,R	*/
const Ppat_rep_plus	*pat	/* pattern colour array	*/

TYPES

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

typedef struct {
	Pint	colr_type;	/* colour type	*/
	Pcolrv_array	colrs;	/* colour array	*/
} Ppat_rep_plus;

typedef struct {
	Pint_size	dims;	/* colour value array dimensions	*/
	Pcolrv_ptr	colrs;	/* array of colour values	*/
} Pcolrv_array;

typedef struct {
	Pint	size_x;	/* x size	*/
	Pint	size_y;	/* y size	*/
} Pint_size;

typedef union {
	Pint	*color_inds;	/* pointer to colour indices	*/
	Pcolr_rep_ptr	colr_reps;	/* pointer to colour representations	*/
} Pcolrv_ptr;

typedef union {
	Prgb	*rgb;	/* pointer to RGB colour values	*/
	Pcieluv	*cieluv;	/* pointer to CIELUV colour values	*/
	Phls	*hls;	/* pointer to HLS colour values	*/
	Phsv	*hsv;	/* pointer to HSV colour values	*/
} Pcolr_rep_ptr;

PHIGS STATE

(PHOP,*,STOP,*)

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 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