GPHIGS C FUNCTIONS - SET BACK INTERIOR COLOUR

SET BACK INTERIOR COLOUR

PSET_BACK_INT_COLR

CALL SEQUENCE

void pset_back_int_colr(

const Pgcolr	*colr	/* back interior colour	*/

TYPES

typedef struct {
	Pint	colr_type;	/* colour type	*/
	Pcolrv	colr_value;	/* colour value	*/
} Pgcolr;

typedef union {
	Pint	colr_ind;	/* colour index	*/
	Pcolr_rep	colr_rep;	/* colour representation	*/
} Pcolrv;

typedef union {
	Prgb	rgb;	/* red green blue colour specification	*/
	Pcieluv	cieluv;	/* CIE L*u*v* colour specification	*/
	Phls	hls;	/* hue lightness saturation colour specification	*/
	Phsv	hsv;	/* hue saturation value colour specification	*/
} Pcolr_rep;

PHIGS STATE

(PHOP,*,STOP,*)

EFFECT

A SET BACK INTERIOR COLOUR element is inserted in the open structure after element pointer or replaces the element indicated by element pointer, depending on edit mode. Element pointer then points to the SET BACK INTERIOR COLOUR element. The value specified by the parameter is associated with the element.

When an element of this type is interpreted, the current back interior colour entry in the traversal state list is set to the value associated with the element. This value is used when displaying subsequent back-facing portions of area defining output primitives when the face distinguish mode is set to YES and the current back interior colour ASF in the traversal state list is INDIVIDUAL.

EXTENSION TO THE PHIGS STANDARD

If GPHIGS is 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,*)