PEXBindDrawableToRenderer - Bind Drawable to Renderer (5.2)

Synopsis 

 
   void PEXBindDrawableToRenderer(
        Display *display,
        Drawable drawable,
        PEXRenderer renderer
   )

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.

Returns

None.

Description

Invoke PEXBindDrawableToRenderer to associate the specified drawable to the specified renderer.

The renderer directs its output to the specified drawable until the renderer receives another PEXBindDrawableToRenderer request or a PEXEndRendering request.

If the renderer's state is PEXRendering when this function is invoked, the renderer aborts the operation in progress with an implicit PEXFlushRenderer (with flush flag set to true) and remains in PEXRendering state. If the renderer's state is PEXPicking or PEXMultipassRendering when this function is invoked, then the renderer also performs the abort and flush operations, generates a renderer state error, and enters the PEXRendering state. If the renderer state is PEXIdle when this function is invoked, the renderer does nothing and does not issue an error.

Errors

BadAlloc
The implementation failed to allocate the resource.

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 was in state PEXPicking or PEXMultipassRendering.

See Also

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