PEXOCCSetSurfaceEdgeFlag - Set Surface Edge Flag (5.0)

Synopsis

 
   void PEXOCCSetSurfaceEdgeFlag(
        PEXOCC context,
        int flag
   )
 

 
   void PEXSetSurfaceEdgeFlag(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        int flag
   )
 

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

flag

A flag indicating whether surface edge drawing is enabled or disabled (PEXOn or PEXOff).

Returns

None.

Description

Invoke PEXOCCSetSurfaceEdgeFlag to create an attribute output command which sets the surface edge flag attribute in the renderer's pipeline state according to the value specified by flag.

By setting the surface edge attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's surface edge flag entry to indicate whether or not surfaces edges are drawn. When you set the surface edge attribute's ASF to PEXBundled, the implementation uses the surface edge flag from the edge bundle table.

PEXlib defines the following values for the surface edge flag (flag):

PEXOn -

enables surface edges. (5.0)

PEXOff -

disables surface edges. (5.0)

If you specify a flag value that is not defined, then the implementation issues a BadPEXOutputCommand error.

This function is a member of the edge attribute set.

Errors

BadPEXOutputCommand

The output command contains an invalid value.

BadPEXRenderer

The specified renderer resource identifier is invalid.

BadPEXStructure

The specified structure resource identifier is invalid.

See Also

• PEXOCCSetIndividualASF

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