INQUIRE COLOUR MAPPING REPRESENTATION

PINQ_COLR_MAP_REP

CALL SEQUENCE

void pinq_colr_map_rep(

Pint	ws_id,	/* workstation identifier	*/
Pint	index,	/* colour mapping index	*/
Pinq_type	type,	/* type of returned values	*/
Pstore	store,	/* handle to store object	*/
Pint	*error_ind,	/* (out) error indicator	*/
Pcolr_map_rep	**rep	/* (out) colour mapping representation	*/

)

TYPES

typedef void * Pstore;

typedef enum {
	PINQ_SET,
	PINQ_REALIZED
} Pinq_type ;

typedef struct {
	Pint			method;	/* colour mapping method	*/
	union Pcolr_map_rep_data {

		struct Pcolr_map_rep_pseudo_pseudo_3 {
			Pint	model;	/* colour model	*/
			Pint	levels[3];	/* number of levels by component	*/
			Pint	first_colr_ind;	/* first colour index in colour table	*/
		}pseudo_pseudo_3;

		struct Pcolr_map_rep_pseudo {
			Pint	model;	/* colour model	*/
			Pfloat_list	weight_vector;	/* list of weight vector	*/
			Pcolrv_list	colrs;	/* list of colour values	*/
		}pseudo;

		struct Pcolr_map_rep_pseudo_N {
			Pint	model;	/* colour model	*/
			Pfloat_set	colrs;	/* list of list of colour coordinates	*/
		}pseudo_N;
	
	}data;
} Pcolr_map_rep;

PHIGS STATE

EFFECT

If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters. If the specified colour mapping index is not present in the colour mapping table, and the specified type of returned value is REALIZED, the representation for colour mapping index 1 is returned.

If the inquired information is not available, the values returned in the output parameters are implementation dependent and the error indicator is set to one of the following error numbers to indicate the reason for non-availability:

The memory referenced by *rep is managed by store

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)

101

Ignoring function, the specified representation has not been defined

121

Ignoring function, the colour mapping index is less than one

SEE ALSO