INQUIRE MODELLING CLIPPING FACILITIES(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
pinqmodelclipfacil ( 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
Pintlst∗ops;OUT list of operators
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqmclf ( N, ERRIND, NMCLHS, OL, MCLPOP )
INTEGERNlist element requested
INTEGERERRINDOUT error indicator
INTEGERNMCLHSOUT number of available
modelling clipping half-spaces
INTEGEROLOUT number of modelling clipping operators
INTEGERMCLPOPOUT Nth element of list
of modelling clipping operators

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

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.

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

opsA pointer to a Pintlst in which the system returns the portion of the list of supported modelling clipping operators, starting at the entry specified with start.

Pintlst is defined in phigs.h as follows:

typedef struct {
Pint number;/∗ number of Pints in list ∗/
Pint ∗integers;/∗ list of integers ∗/

} Pintlst; The pointer ops->integers must be initialized to an array of length Pint elements.

FORTRAN Input Parameters

NPosition in the list of the item requested. The Nth supported operator will be returned in MCLPOP.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

NMCLHS
The number of modelling clipping half-spaces (planes) that may be used to determine the modelling clipping volume.

OLThe total length of the list of supported operators.

MCLPOP
The Nth element in the list of supported modelling clipping operators.

ERRORS

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

Museum

Related Articles