PEXOCCSetEdgeBundleIndex - Set Edge Bundle Index (5.0)

Synopsis

    void PEXOCCSetEdgeBundleIndex(
         PEXOCC context,
         unsigned int index
    )
 

 
   void PEXSetEdgeBundleIndex(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        unsigned int index)
 

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

index
The edge bundle table index.

Returns

None.

Description

Invoke PEXOCCSetEdgeBundleIndex to create an attribute output command which sets the edge bundle index attribute in the renderer's pipeline state according to the value specified by index.

You use the edge bundle index to select an entry of the renderer's edge bundle table whenever you have set a bundlable edge attribute's ASF to PEXBundled (see PEXOCCSetIndividualASF). PEXlib supports the bundling of the following edge attributes: surface edge flag, surface edge type, surface edge width, and surface edge color.

If you specify an undefined edge bundle index, then the index defaults to edge bundle index one. If index one is undefined, then the implementation sets the bundled surface edge flag to PEXOff, the surface edge type to PEXSurfaceEdgeSolid, the surface edge width to 1.0, and the surface edge color to index color one. If you specify an edge bundle index of zero, then the implementation issues a BadPEXOutputCommand error.

This function is a member of the general 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

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