Name

PEXCreateRenderer - Create Renderer

Synopsis

PEXRenderer PEXCreateRenderer(Display ∗display, Drawable drawable, unsigned long value_mask, PEXRendererAttributes ∗values)

Arguments

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

drawableThe resource identifier of a drawable. 

value_maskA mask indicating the attribute values specified. 

valuesA pointer to values used to override default values in the new renderer resource. 

Returns

The resource identifier of the newly-created renderer resource. 

Description

This function creates a renderer and returns the resource identifier of the newly-created renderer resource.  The value mask indicates which attribute values are specified.  The value mask is constructed by or’ing together the following constants:

PEXRAPipelineContext
PEXRAMarkerBundle
PEXRATextBundle
PEXRALineBundle
PEXRAInteriorBundle
PEXRAEdgeBundle
PEXRAViewTable
PEXRAColorTable
PEXRADepthCueTable
PEXRALightTable
PEXRAColorApproxTable
PEXRAPatternTable
PEXRATextFontTable
PEXRAHighlightIncl
PEXRAHighlightExcl
PEXRAInvisibilityIncl
PEXRAInvisibilityExcl
PEXRAHLHSRMode
PEXRANPCSubVolume
PEXRAViewport
PEXRAClipList
PEXRAPickIncl
PEXRAPickExcl
PEXRAPickStartPath
PEXRABackgroundColor
PEXRAClearImage
PEXRAClearZ
PEXRAEchoMode

Fields not explicitly set have default values (see the beginning of the chapter).  The renderer resource may only be used in conjunction with drawables that have the same root and depth as specified drawable. 

Note that the renderer’s current path and renderer state attributes cannot be set explicitly using this function. 

Data Structures

typedef XID             PEXRenderer;
See also the PEXStructuresman page.

Errors

BadAllocThe server failed to allocate the resource. 

BadDrawableThe specified drawable resource identifier is invalid. 

BadMatchThe specified drawable is unsupported, or the specified lookup table resource was not created with a drawable compatible with the specified drawable. 

BadPEXLookupTable
The specified lookup table resource identifier is invalid.

BadPEXNameSet
The specified name set resource identifier is invalid.

BadPEXPipelineContext
The specified pipeline context resource identifier is invalid.

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadValueA specified value is out of range, or an invalid bit is set in the value mask. 

See Also

PEXFreeRenderer