PEXOCCSetLineBundleIndex - Set Line Bundle Index (5.0)


Synopsis

 
   void PEXOCCSetLineBundleIndex(
        PEXOCC context,
        unsigned int index
   )
 

 
   void PEXSetLineBundleIndex(
        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 line bundle table index.

Returns

None.

Description

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

You use the line bundle index to select an entry of the renderer's line bundle table whenever a bundlable line attribute's ASF is set to PEXBundled (see PEXOCCSetIndividualASF). PEXlib supports the bundling of the following line attributes: line type, polyline interpolation, curve approximation, line width, line cap style, line join style and line color.

If you specify an undefined line bundle index, then the index defaults to one. If index one is not defined, then the implementation sets the bundled line type to PEXLineTypeSolid; polyline interpolation to PEXPolylineInterpNone; curve approximation to PEXApproxImpDep with a tolerance of 1.0; line width to 1.0, line cap style to PEXLineCapStyleButt, line join style to PEXLineJoinStyleImpDep, and line color to index color one. If you specify a line bundle index of zero, then the implementation issues a BadPEXOutputCommand error.

This function is a member of the line, shaded line, and curve 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.