INQUIRE COLOUR MAPPING METHOD FACILITIES(3P+) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE COLOUR MAPPING METHOD FACILITIES − inquire the available colour mapping facilities specific to a colour mapping method.

SYNOPSIS

C Syntax

void
pinq_colr_map_method_facs ( type, map_method, error_ind, map_st )
Pwstypetype;workstation type
Pintmap_method; mapping method
Pint∗error_ind;OUT error indicator
Pcolr_map_st∗map_st;OUT method-specific facilities

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE COLOUR MAPPING METHOD FACILITIES to obtain the available colour mapping facilities specific to a specified colour mapping method.

C Input Parameters

typeThe workstation type for which to get the colour mapping method facilities.

map_method
The colour mapping method of interest. The colour mapping methods defined in phigs.h are as follows:

1PCOLR_MAP_TRUE
2PCOLR_MAP_PSUEDO
3PCOLR_MAP_PSEUDO_N

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

map_st
A pointer to a Pcolr_map_st structure in which to store the information. Pcolr_map_st is defined in phigs.h as:

typedef union {
Pintint_data;for map_method 1 and 2
} Pcolr_map_st;

For colour mapping method PCOLR_MAP_TRUE, int_data will contain the number of available true colours. For colour mapping method PCOLR_MAP_PSEUDO, int_data will contain the maximum number of available pseudo colour entries. There is no information returned for colour mapping method PCOLR_MAP_PSEUDO_N.

Execution

If the inquired information is available, the error indicator is returned as zero and the requested information is returned.

If the inquired information is not available, the values returned in the output parameters are undefined and the error indicator is set to one of the following error numbers to indicate the reason for nonavailability.

Since this is an inquiry function, ERROR HANDLING is not invoked when an error is detected by this function.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

052Ignoring function, workstation type not recognized by the implementation

059Ignoring function, the specified workstation does not have output capability (that is, the workstation category is neither OUTPUT nor OUTIN)

062Ignoring function, this information is not available for this MO workstation type

126Ignoring function, the specified colour mapping method is not available on the specified workstation.

Museum