SET HLHSR MODE(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

void
psethlhsrmode ( wsid, mode )
Pintwsid;workstation identifier
Pintmode;HLHSR mode

FORTRAN Syntax

SUBROUTINE pshrm ( WKID, HRM )
INTEGERWKIDworkstation identifier
INTEGERHRMHLHSR 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

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

modeThe HLHSR mode value. Presently defined values are:

0PHIGS_HLHSR_MODE_NONEDisable GB Z-buffer
1PHIGS_HLHSR_MODE_ZBUFFEnable GB Z-buffer

FORTRAN Input Parameters

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

HRMThe HLHSR mode value. Presently defined values are:

0PHIGSHLHSRMDNONEDisable GB Z-buffer
1PHIGSHLHSRMDZBUFEnable GB Z-buffer

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 workstation’s 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:

1.The workstation display update state allows update.

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

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

HLHSR is performed using a Z-buffer algorithm.

The Z buffer processing does not work when primitives are filled with transparent hatches. When a transparent hatched filled area-defining primitive is to be Z buffered, SunPHIGS will fill it with an opaque hatch.

For systems without Z-buffered hardware, HLHSR is done in software, but with a significant loss of performance.

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 (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

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

Museum