GPHIGS C FUNCTIONS - SET REFLECTANCE REPRESENTATION

SET REFLECTANCE REPRESENTATION

PSET_REFL_REP

CALL SEQUENCE

void pset_refl_rep(

Pint	ws_id,	/* workstation identifier	*/
Pint	index,	/* reflectance index	*/
const Prefl_rep	*rep	/* reflectance representation	*/

TYPES

typedef struct {
	Pint	refl_model;	/* reflectance models	*/
	Prefl_prop	refl_prop;	/* reflectance properties	*/
} Prefl_rep;

typedef struct {
	Pint		type;		/* reflectance property type	*/
	union Prefl_prop_data {
		struct Prefl_prop_simple_refl {
			Pfloat	amb_coeff;	/* ambient reflection coefficient	*/
			Pfloat	diff_coeff;	/* diffuse reflection coefficient	*/
			Pfloat	spec_coeff;	/* specular reflection coefficient	*/
			Pgcolr	spec_colr;	/* specular colour	*/
			Pfloat	spec_exp;	/* specular exponent	*/
		} simple_refl;
	} data;
} Prefl_prop;


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, WSOP,*,*)

EFFECT

The rep values are placed in the reflectance bundle table at index in the workstation state list.

The reflectance bundle table is initialized from the ws_id workstation description table

The defined values for reflectance model are:

PREFL_MODEL_NO_REFL no reflectance calculation performed

PREFL_MODEL_AMB_REFL ambient reflectance effects produced

PREFL_MODEL_AMB_DIFF_REFL ambient and diffuse reflectance effects produced

PREFL_MODEL_AMB_DIFF_SPEC_REFL ambient, diffuse, and specular reflectance effects produced

During structure traversal, the current reflectance index and current back reflectance index in the traversal state list are used to select entries in the reflectance bundle table of a workstation. Depending on the current facet distinguishing mode , the front and back reflectance index attributes are used when displaying respective portions of area defining output primitives. If the entry corresponding to either of these indices is not defined, the entry corresponding to an index of 1 is used.

ERRORS

3: Ignoring function, function requires state (PHOP, WSOP,*,*)
54: Ignoring function, the specified workstation is not open
59: Ignoring function, the specified workstation does not have output capability (i.e. the workstation category is neither OUTPUT, OUTIN, nor MO)
100: Ignoring function, the bundle index value is less than one
103: Ignoring function, setting this bundle table entry would exceed the maximum number of entries allowed in the workstation
110: Ignoring function, the specified colour model is not available on the workstation
113: Ignoring function, the colour index value is less than zero
124: Ignoring function, the specified reflectance model value is not available on the workstation
136: Ignoring function, one of the components of the colour specification is out of range
138: Ignoring function, one or more of the fields in the specified data record is inconsistent with the specified type
139: Ignoring function, the specified reflectance property type is not available on the specified workstation