INQUIRE MODELLING CLIPPING FACILITIES(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE MODELLING CLIPPING FACILITIES − inquire number of modelling clipping planes and operators available

SYNOPSIS

C Syntax

void
pinq_model_clip_facs ( length, start, error_ind, num, ops, total_length )
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint∗num;OUT number of distinct planes in modelling clipping volume
Pint_list∗ops;OUT list of operators
Pint∗total_length;OUT length of list in PHIGS

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

INQUIRE MODELLING CLIPPING FACILITIES obtains the number of planes and available operators that may be used to determine the modelling clipping volume in the PHIGS implementation.

C Input Parameters

lengthNumber of items for which the application has allocated memory in the output parameter ops. 0 can be specified, in order to get the total length of the list of operators.

startStarting position in the list of operators at which to begin the inquiry.

C Output Parameters

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

numA pointer to a location in which the system return the number of distinct planes (half-spaces) that can be used to determine the modelling clipping volume.

opsA pointer to a Pint_list in which the system returns the portion of the list of supported modelling clipping operators, starting at the entry specified 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 pointer ops→ints must be initialized to an array of length Pint elements.

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

ERRORS

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

Museum