void PEXBeginRendering(
Display *display,
Drawable drawable,
PEXRenderer renderer
)
None.
Invoke PEXBeginRendering to initialize the specified renderer and to bind the specified drawable to it.
Subsequent output primitive commands sent to the renderer produce output to the specified drawable until the renderer receives a PEXEndRendering request or a PEXBindDrawableToRenderer request. The renderer's pipeline state is initialized to the values in its pipeline context, or to default values if there is no pipeline context. This function sets the renderer's state to PEXRendering and sets its current path to <0,0>. If the renderer's clear image attribute is True, then the renderer initializes the drawable's image buffer to the renderer's current background color within the areas defined by the clip list. If the renderer's clear Z attribute is True, then the renderer initializes the Z-buffer with the value in the clear Z value attribute and within the areas defined by the clip list. If the renderer's clear alpha attribute is True, then the renderer clears the alpha buffer to the values specified in the renderer's background color within areas defined by the clip list.
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. The new renderer state is then PEXRendering.
For a list of all Renderer functions and related topics, see Rendering.