PEXRenderNetwork - Render Network (5.0)


Synopsis

 
   void PEXRenderNetwork(
        Display *display,
        Drawable drawable,
        PEXRenderer renderer,
        PEXStructure structure
   )
 

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

drawable
The resource identifier of a drawable.

renderer
The resource identifier of a renderer resource.

structure
The resource identifier of a structure resource.

Returns

None.

Description

Invoke PEXRenderNetwork to process all output commands stored in structure using the specified renderer.

The output primitives in the structure are rendered to the specified drawable. Structures referenced by structure elements are also processed. This request effectively performs an implicit PEXBeginRendering before the traversal with an initial current path of (structure,0) and an implicit PEXEndRendering, with a flush value of True, after the traversal.

If the renderer's state is PEXRendering, PEXPicking, or PEXMultipassRendering when this request is received, then the implementation performs the above operations, but also generates an error.

Errors

BadAlloc
The implementation failed to allocate resources necessary to complete request.

BadDrawable
The specified drawable resource identifier is invalid.

BadMatch
The specified drawable is unsupported, or the specified renderer resource was not created with a compatible drawable.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXRendererState
The specified renderer is not in renderer state PEXIdle.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For a list of all Renderer functions and related topics, see Rendering.