NAME

INQUIRE COLOUR MAPPING METHOD FACILITIES - inquire for 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 )

Pwstype         type;            workstation type
Pint            map_method;      mapping method
Pint            * error_ind;     OUT error indicator
Pcolr_map_st    * map_st;        OUT method-specific facilities

FORTRAN Syntax

SUBROUTINE pqcmmf ( WTYPE, METH, MLDR, ERRIND, LDR, DATREC )

INTEGER             WTYPE                workstation type
INTEGER             METH                 colour mapping method of interest
INTEGER             MLDR                 dimension of data record array
INTEGER             ERRIND               OUT error indicator
INTEGER             LDR                  OUT number of array elements used in
                                         data record
CHARACTER* 80       DATREC(MLDR)         OUT data record

Required PHIGS Operating States

(PHOP, * ,* ,* )

DESCRIPTION

Purpose

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

C Input Parameters

type

The 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:

1

PCOLR_MAP_TRUE

2

PCOLR_MAP_PSUEDO

3

PCOLR_MAP_PSEUDO_N

C Output Parameters

error_ind

A pointer to the location in which to store the error number of any error that this function detects.

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 {

Pint

int_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.

FORTRAN Input Parameters

WTYPE The workstation type for which to return the colour mapping method facilities.

METH

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

1

PCMAPTRUE

2

PCMAPPSEUDO

3

PCMAPPSEUDON

MLDR

The dimension of the data record array, DATREC.

FORTRAN Output Parameters

ERRIND

The error number of any error detected by this function. The dimension of the data record array, DATREC.

DATREC(MLDR)

The data record array. This must subsequently be passed to UNPACK DATA RECORD (3P) to access its contents. The contents of the data record are determined by the colour mapping method:

IL = the number of integers, 0 or 1.

IA = For colour mapping method PCMAPTRUE, IA is an array of a single integer containing the number of available true colours. For colour mapping method PCMAPPSEUDO, IA is an array of a single integer containing the maximum number of pseudo colour entries. For colour mapping method PCMAPPSEUDON, IA is empty.

RL = the number of real values, 0

SL = the number of strings, 0

Execution

If the inquired information is available, then 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 (3P) is not invoked when an error is detected by this function.

ERRORS

002

Ignoring function, function requires state (PHOP, * ,* ,* )

051

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

052

Ignoring function, workstation type not recognized by the implementation

059

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

062

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 workstation.

SEE ALSO

INQUIRE COLOUR MAPPING FACILITIES (3PP)

PHIGS WORKSTATION DESCRIPTION TABLE (7P)