NAME

INQUIRE RENDERING COLOUR MODEL FACILITIES - inquire for list of available direct colour models

SYNOPSIS

C Syntax

void

pinq_rendering_colr_model_facs ( type, length, start, error_ind, models, total_length )

Pint       type;            workstation type
Pint       length;          length of application's list
Pint       start;           starting position
Pint       * error_ind;     OUT error indicator
Pint_list  * models;        OUT rendering colour models
Pint       * total_length;  OUT total number of rendering

FORTRAN Syntax

SUBROUTINE pqrcmf ( WTYPE, N, ERRIND, NRCM, RCM )

INTEGER      WTYPE       workstation type
INTEGER      N           list element requested
INTEGER      ERRIND      OUT error indicator
INTEGER      NRCM        OUT number of rendering colour models
INTEGER      RCM         OUT Nth element of list of rendering colour models

Required PHIGS Operating States

(PHOP, * ,* ,* )

DESCRIPTION

Purpose

INQUIRE RENDERING COLOUR MODEL FACILITIES inquires for a list of colour model facilities available for rendering for the specified workstation type

C Input Parameters

type

The workstation type.

length

The number of ints in the models output parameter for which the application has allocated memory. length is the number of list elements that the system can return in models.ints. If a value of 0 is used here, no data is returned in the models.ints list, but the total number of elements is returned in total_length.

start

Starting position of inquiry. The elements in the list, beginning with the item number specified by start, are copied sequentially into models.ints until models.ints is full or all the elements have been copied.

C Output Parameters

error_ind

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

models A pointer to a Pint_list that returns the portion of the list of available rendering

colour models from the workstation description table, starting with start. Pint_list is defined in phigs.h as follows:

typedef struct {

Pint            num_ints;       /* number of Pints in list * /
Pint            * ints;         /* list of integers * /

} Pint_list;

The num_ints component specifies the number of elements in the list. The ints component is a pointer to a list num_ints long.

The application must allocate memory for length elements in the list of ints.

total_length

A pointer to an integer in which to return the total length of the list. This is the value required for length if all the items in the list are to be returned.

FORTRAN Input Parameters

WTYPE The workstation type.

N

Element of list of rendering colour models to return in output parameter RCM.

FORTRAN Output Parameters

ERRIND

The number of rendering colour models available for the specified workstation type.

RCM

The Nth element of the list of rendering colour models available for the specified workstation type.

Execution

If the inquired information is available, then the error indicator is returned as zero, and values are returned in the output parameters.

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

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

ERRORS

-153

List length is less than zero -- zero will be used

002

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

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, OUTIN, or MO)

062

Ignoring function, specified workstation category is not OUTPUT or OUTIN

2201

Start index out of range

SEE ALSO

SET RENDERING COLOUR MODEL (3P)