INQUIRE HLHSR FACILITIES(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE HLHSR FACILITIES − inquire the hidden line and hidden surface removal facilities of a specified workstation type

SYNOPSIS

C Syntax

void
pinqhlhsrfacil ( type, i_len, i_st, m_len, m_st, error_ind, ids, modes, tot_i_len, tot_m_len )
Pwstypetype;workstation type
Pinti_len;length of id list
Pinti_st;starting position of id list
Pintm_len;length of mode list
Pintm_st;starting position of mode list
Pint∗error_ind;OUT error indicator
Pintlst∗ids;OUT list of HLHSR ids
Pintlst∗modes;OUT list of HLHSR modes
Pint∗tot_i_len;OUT len of id list in PHIGS
Pint∗tot_m_len;OUT len of mode list in PHIGS

FORTRAN Syntax

SUBROUTINE pqhrf ( WTYPE, NI, NM, ERRIND, NHRID, HRID, NHRMD, HRMD )
INTEGERWTYPEworkstation type
INTEGERNIsequence number of HLHSR identifier list
element requested
INTEGERNMsequence number of HLHSR mode list element
requested
INTEGERERRINDOUT error indicator
INTEGERNHRIDOUT number of available HLHSR identifiers
INTEGERHRIDOUT NIth element of list of available
HLHSR identifiers
INTEGERNHRMDOUT number of available HLHSR modes
INTEGERHRMDOUT NMth element of list of available
HLHSR modes

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

INQUIRE HLHSR FACILITIES obtains the available HLHSR (hidden line and hidden surface removal) identifiers and modes on the specified workstation type. See SET HLHSR IDENTIFIER and SET HLHSR MODE for a description of how to enable hidden surface removal.

C Input Parameters

type
Type of workstation.

i_len
Length of the list of HLHSR identifiers to be returned from the workstation description table. i_len is the number of list elements for which space has been allocated in ids. 0 may be specified in order to get the total number of elements in the list.

i_st
Starting position in the list of HLHSR identifiers on the workstation description table at which to begin the inquiry.

m_len
Length of the list of HLHSR modes to be returned from the workstation description table. m_len is the number of list elements for which space has been allocated in modes. 0 may be specified in order to get the total number of elements in the list.

m_st
Starting position in the list of HLHSR modes on the workstation description table 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.

idsA pointer to a Pintlst data structure in which the system returns a list of the HLHSR identifiers available on this workstation type. The returned list starts with the id_st item in the list of identifiers and returns the next i_len items. Pintlst is defined in phigs.h as follows:

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

Prior to calling this function, the integers field of the Pintlst structures must contain a pointer to an application supplied buffer. This buffer must be at least as large as the corresponding length parameter. Values in the list are one of:

ValueHLHSR NameSunPHIGS Meaning
0PHIGS_HLHSR_ID_NONE“Remove nothing”
1PHIGS_HLHSR_ID_ZBUFF“Remove Hidden Surfaces using Z-buffer”

modesA pointer to a Pintlst data structure in which the system returns a list of the HLHSR modes available on this workstation type. The returned list starts with the m_st item in the list of modes and returns the next m_len items. Pintlst is as described above for ids.

Each mode is one of:

ValueHLHSR NameSunPHIGS Meaning
0PHIGS_HLHSR_MODE_NONE“Disable GB Z-buffer”
1PHIGS_HLHSR_MODE_ZBUFF“Enable GB Z-buffer”

total_i_len
An integer pointer in which the system returns the total number of items in the list of HLHSR identifiers on the workstation description table. This is the value required for i_len if all the HLHSR identifiers on the workstation list are to be returned.

total_m_len
An integer pointer in which the system returns the total number of items in the list of HLHSR modes on the workstation description table. This is the value required for m_len if all the HLHSR modes on the workstation list are to be returned.

FORTRAN Input Parameters

WTYPE
Get the HLHSR facilities for this workstation type.

NIThe number of entry desired from the list of HLHSR identifiers.

NMThe number of entry desired from the list of HLHSR modes.

FORTRAN Output Parameters

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

NHRID
The total number of items in the workstation list of HLHSR identifiers.

HRIDThe NIth element of the list of HLHSR identifiers; one of

ValueHLHSR NameSunPHIGS Meaning
0PHIGSHLHSRIDNONE“Remove nothing”
1PHIGSHLHSRIDZBUF“Remove Hidden Surfaces using Z-buffer”

NHRMD
The total number of elements in the list of HLHSR modes.

HRMD
The NMth element of the list of HLHSR modes; one of

ValueHLHSR NameSunPHIGS Meaning
0PHIGSHLHSRMDNONE“Disable GB Z-buffer”
1PHIGSHLHSRMDZBUF“Enable GB Z-buffer”

ERRORS

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

052Ignoring function, workstation type not recognized by the implementation

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

057Ignoring function, specified workstation is of category MI

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

Museum