GPHIGS C FUNCTIONS - SET TEXT COLOUR

SET TEXT COLOUR

PSET_TEXT_COLR

CALL SEQUENCE

void pset_text_colr(

const Pgcolr 	*colr	/* text 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 TEXT 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 TEXT COLOUR element. The value specified by the parameter is associated with the element.

When an element of this type is interpreted, the current text colour entry in the PHIGS traversal state list is set to the parameter. This value is used to display the text primitives which follow when the current text colour ASF entry in the PHIGS 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,*)