SET HLHSR MODE(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

SET HLHSR MODE − enable or disable hidden line and hidden surface removal on a workstation

SYNOPSIS

C Syntax

void
pset_hlhsr_mode ( ws, mode )
Pintws;workstation identifier
Pintmode;HLHSR mode

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

The SET HLHSR MODE requests a certain Hidden Line and Hidden Surface Removal (HLHSR) mode of the workstation. The workstation’s current HLHSR mode enables or disables HLHSR for a workstation. The current HLHSR identifier from the structure network is used in conjunction with the HLHSR mode on the workstation during traversal.

C Input Parameters

wsThe identifier of the workstation whose HLHSR mode is being set.

modeThe HLHSR mode value. Presently defined values are:

0PHIGS_HLHSR_MODE_NONEDisable Z-buffering
1PHIGS_HLHSR_MODE_ZBUFFEnable Z-buffering
2PHIGS_HLHSR_MODE_PAINTERS
3PHIGS_HLHSR_MODE_SCANLINE
4PHIGS_HLHSR_MODE_LINE_ONLY

Execution

If the requested HLHSR mode value is supported on the specified workstation, then SET HLHSR MODE immediately sets the requested HLHSR mode entry in the PHIGS workstation state list to the specified mode. The effect of calling SET HLHSR MODE is not visible until the requested HLHSR mode replaces the current HLHSR mode. The time at which this occurs depends on the workstation’s display update state.

This assignment is performed immediately and the HLHSR update state is set to Not Pending if any one of the following is true:

•The workstation display update state allows update.

•The workstation modification mode is any value other than No Immediate Visual Effect, and the dynamic modification accepted for HLHSR mode entry in the workstation description table is set to Immediate.

•The display space empty status in the workstation state list is EMPTY.

Otherwise, the HLHSR update state is set to Pending and the requested HLHSR mode will not replace the current HLHSR mode until the next time the workstation is updated. The HLHSR update state will be set to Not Pending at that time.

During traversal, the workstation’s current HLHSR mode entry and the primitive’s current HLHSR identifier attribute are both checked.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (that is, the workstation category is neither OUTPUT, OUTIN, nor MO)

111Ignoring function, the specified HLHSR mode is not available on the specified workstation

Museum