PEXOCCSetVertexOrder - Set Vertex Order (5.2)

Synopsis

 
   void PEXOCCSetVertexOrder(
        PEXOCC context,
        unsigned int order
   )

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

order

The vertex order (PEXVertexOrderRightHand or PEXVertexOrderLeftHand).

Returns

None.

Description

Invoke PEXOCCSetVertexOrder to set the vertex order entry of the renderer's pipeline state according to the value specified by order.

PEXlib uses the vertex order in computing the facet normals of surfaces. For surface primitives which do not have facet normals supplied, the normal for each facet is calculated assuming the vertex order given through order.

If the vertex order is not set to PEXVertexOrderRightHand or PEXVertexOrderLeftHand, then the implementation issues a BadPEXOutputCommand error.

The vertex order function is a member of the general surface attribute set.

Errors

BadPEXOutputCommand

The output command contains an illegal value.

BadPEXRenderer

The specified renderer resource identifier is invalid.

BadPEXStructure

The specified structure resource identifier is invalid.

See Also

For an overview and for a list of output attribute functions, see Output Attribute Functions.