GPHIGS C FUNCTIONS - INQUIRE COLOUR MAPPING METHOD FACILITIES

INQUIRE COLOUR MAPPING METHOD FACILITIES

PINQ_COLR_MAP_METHOD_FACS

CALL SEQUENCE

void pinq_colr_map_method_facs(

Pint	ws_type,	/* workstation type	*/
Pint	method,	/* colour mapping methods	*/
Pstore	store,	/* handle to store object	*/
Pint	*error_ind,	/* (out) error indicator	*/
Pcolr_map_method	**data	/* (out) data record	*/

TYPES

typedef void * Pstore;

typedef struct {
	Pint		method;		/* colour mapping method	*/
	union Pcolr_map_method_data {
		Pint	num_true_colrs;	/* number of true colours	*/
		Pint	max_num_pseudo_colrs;	/* maximum number of pseudo colours	*/
	} data;
} Pcolr_map_method;

PHIGS STATE

(PHOP,*,*,*)

EFFECT

Returns the colour mapping method facilities offered by workstations of type ws_type. If the inquired information is available, the error indicator is returned as 0 and values are returned in the output parameters.

The memory referenced by *data is managed by store

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:

ERRORS

2: Ignoring function, function requires state (PHOP, *,*,*)
52: Ignoring function, workstation type not recognized by the implementation
51: Ignoring function, this information is not yet available for this generic workstation
type: open a
59: Ignoring function, the specified workstation does not have output capability (i.e. the workstation category is neither OUTPUT, OUTIN, nor MO)
62: Ignoring function, this information is not available for this MO workstation type
126: Ignoring function, the specified colour mapping method is not available on the specified