NAME

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

SYNOPSIS

C Syntax

void
pinq_hlhsr_mode_facs ( type, length, start, error_ind, modes, length_list )
Pinttype;workstation type
Pintlength;length of mode list
Pintstart;starting position of mode list
Pint∗error_ind;OUT error indicator
Pint_list∗modes;OUT list of HLHSR modes
Pint∗length_list;OUT length of mode list in PHIGS

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

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

C Input Parameters

type
Type of workstation.

length
The number of ints in the modes output parameter for which the application has allocated memory. length is the number of list elements that the system can return in modes→ints.  If a value of 0 is used here, no data will be returned in the modes→ints list, but the total number of modes in the PHIGS state list will be returned in length_list. 

start
Starting position of inquiry into the PHIGS state list of current mode. The elements of the list of mode, beginning with the item number specified by start, are copied sequentially into mode→ints until modes→ints is full or all the modes have been copied. 

C Output Parameters

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

modesA pointer to a Pint_list data structure in which the system returns a list of the HLHSR modes available on this workstation type.  The returned list starts with the start item in the list of modes and returns the next length items.  Pint_list is defined in phigs.h as follows:

typedef struct {
Pintnum_ints;/∗ number of modes in list ∗/
Pint∗ints;/∗ list of modes ∗/
} Pint_list;

Possible modes are:

0PHIGS_HLHSR_MODE_NONE  Disable HLHSR
1PHIGS_HLHSR_MODE_ZBUFF Enable HLHSR using Z-buffer
2PHIGS_HLHSR_MODE_PAINTERS Enable HLHSR using painter
3PHIGS_HLHSR_MODE_SCANLINE Enable HLHSR using scanline
4PHIGS_HLHSR_MODE_LINE_ONLY Enable hidden line removal only

length_list
A pointer to an integer in which the system returns the total number of elements in the PHIGS state list of currently used modes. This is the value required for length if all modes are to be returned. 

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

SEE ALSO

INQUIRE WORKSTATION CONNECTION AND TYPE (3P)
INQUIRE HLHSR MODE (3P)
INQUIRE HLHSR IDENTIFIER (3P)
SET HLHSR MODE (3P)
SET HLHSR IDENTIFIER (3P)

September 02, 1992