GPHIGS C FUNCTIONS - SET BACK DATA MAPPING METHOD

SET BACK DATA MAPPING METHOD

PSET_BACK_DATA_MAP_METHOD

CALL SEQUENCE

void pset_back_data_map_method(

const  Pdata_map_rep	*rep	/* data mapping representation	*/

TYPES

typedef struct {
	Pint	method;	/* data mapping method	*/
	Psource_select_list	selectors;	/* list of source selectors	*/
	union Pdata_map_rep_data {
		struct Pdata_map_rep_single_uniform {
		Pint	ind;
		Pfloat	lower_limit;
		Pfloat	upper_limit;
		Pint	colr_type;
		Pcolrv_list	colr_values;
		} single_uniform;
	
		struct Pdata_map_rep_single_non_uniform {
		Pint	ind;
		Pfloat_list	range;
		Pint	colr_type;
		Pcolrv_list	colr_values;
		} single_non_uniform;
	
		struct Pdata_map_rep_bi_uniform {
			Pint	inds[2];
			Pfloat	lower_limit_a;
			Pfloat	upper_limit_a;
			Pfloat	lower_limit_b;
			Pfloat	upper_limit_b;
			Pint	colr_type;
			Pcolrv_set	colr_values;
		} bi_uniform;

		struct Pdata_map_rep_bi_non_uniform {
			Pint	inds[2];
			Pfloat_list	range_a;
			Pfloat_list	range_b;
			Pint	colr_type;
			Pcolrv_set	colr_values;
		} bi_non_uniform;
	} data;
} Pdata_map_rep;

typedef struct {
	Pint	num_selectors;	/* input buffer size	*/
	Psource_select	*selectors;	/* initial editing position	*/
} Psource_select_list;
typedef enum {
	PSOURCE_SELECT_COLR_ASPECT,
	PSOURCE_SELECT_VERT_COLR,
	PSOURCE_SELECT_VERT_DATA,
	PSOURCE_SELECT_FACET_COLR,
	PSOURCE_SELECT_FACET_DATA
} Psource_select;

typedef struct {
	Pint	num_lists;	/* number of colour value lists	*/
	Pcolrv_list	*colrs;	/* list of colour value lists	*/
} Pcolrv_set;

typedef struct {
	Pint	num_colrs;	/* number of colours	*/
	Pcolrv_ptr	colrs;	/* list of colour values	*/
} Pcolrv_list;

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

A SET BACK DATA MAPPING METHOD 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 DATA MAPPING METHOD element. The value specified by the parameter is associated with the element.

When an element of this type is interpreted, the current back data mapping method entry in the traversal state list is set to the values associated with the element. These values are used when displaying back-facing portions of subsequent area defining output primitives when the current back data mapping method ASF in the traversal state list is INDIVIDUAL.

The data mapping methods are as follows:

PDATA_MAP_METHOD_COLR

PDATA_MAP_METHOD_SINGLE_UNIFORM

PDATA_MAP_METHOD_SINGLE_NON_UNIFORM

PDATA_MAP_METHOD_BI_UNIFORM

PDATA_MAP_METHOD_BI_NON_UNIFORM

When an element of this type is interpreted, if the specified data mapping method is not available on a workstation, data mapping method PDATA_MAP_METHOD_COLR is used. If the specified data mapping method or data record is inconsistent with any of the data lists associated with a primitive, data mapping method PDATA_MAP_METHOD_COLR is used for that primitive.

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,*)
138: Ignoring function, one or more of the fields in the specified data record is inconsistent with the specified type