Name

PEXBeginRendering - Begin Rendering

Synopsis

void PEXBeginRendering(Display ∗display, Drawable drawable, PEXRenderer renderer)

Arguments

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

drawableThe resource identifier of a drawable. 

rendererThe resource identifier of a renderer. 

Returns

None

Description

This function initializes the specified renderer and binds the specified drawable to it.  Subsequent output primitive commands sent to renderer produce output to the specified drawable.  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 causes the renderer’s renderer state to be set to PEXRendering and its current path to be set to <0,0>.  The renderer’s HLHSR mode is used to initialize hidden surface computations. (For example, the z-buffer is initialized if the HLHSR mode is set to PEXHLHSRZBuffer or PEXHLHSRZBufferID.)

If the renderer’s state is PEXRendering or PEXPicking when this request is received, an implicit "end rendering or picking" request is performed before the "begin rendering" request is executed. Output commands received by a renderer are ignored if the state is not PEXRendering or PEXPicking.

Data Structures

typedef XID             PEXRenderer;

Errors

BadAllocThe server failed to allocate the resource. 

BadDrawableThe specified drawable resource identifier is invalid. 

BadMatchThe 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 an invalid state.

See Also

PEXCreateRenderer, PEXEndRendering