PEXOCCSetHLHSRID - Set Hidden-Line Hidden-Surface Removal Identifier (5.0)

Synopsis

 
   void PEXOCCSetHLHSRID(
        PEXOCC context,
        unsigned long hlhsr_id
   )

 
   void PEXSetHLHSRID(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        unsigned long hlhsr_id
   )

Arguments

context: An OC context returned by a successful PEXCreateOCC call.
display (OCC): A pointer to a display structure returned by a successful XOpenDisplay call.
resource_id (OCC): The resource identifier of the renderer or structure.
req_type (OCC): The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).
hlhsr_id: The HLHSR identifier (PEXHLHSRIDDisable, PEXHLHSRIDEnable or PEXHLHSRIDEnableTestOnly).

Returns

None.

Description

Invoke PEXOCCSetHLHSRID to create an attribute output command which sets the HLHSR identifier attribute in the renderer's pipeline state according to the value specified by hlhsr_id.

This output command is a no-op for all standard HLHSR modes except PEXHLHSRZBufferID.

PEXlib defines the following HLHSR identifiers (hlhsr_id) when you set the renderer's HLHSR mode to PEXHLHSRZBufferID:

PEXHLHSRIDDisable -: disables z-buffering. (5.0)
PEXHLHSRIDEnable -: tests each pixel's z-value against the z-buffer to determine if the pixel should be rendered. If the pixel is rendered, then the z-buffer is updated to reflect the pixel's z-value. (5.0)
PEXHLHSRIDEnableTestOnly -: tests each pixel's z-value against the z-buffer to determine if the pixel should be rendered. The z-buffer is not updated to reflect the pixel's z-value. (5.2)

Inquire the supported HLHSR modes by invoking the PEXGetEnumTypeInfo request.

If you specify an unsupported HLHSR identifier (hlhsr_id), then the HLHSR identifier used is implementation-dependent. For non-standard HLHSR modes, the result is implementation-dependent.

HLHSR interacts with alpha blending, antialiasing, transparency, drawing functions (except GXcopy), and plane masking (except all planes enabled), in an implementation-dependent way.

This function is a member of the global attribute set.

Errors