PEXRenderer PEXCreateRendererWithExtAttributes(
Display *display,
Drawable drawable,
unsigned long *value_mask,
PEXRendererAttributes5_2 *values
)
- display
- A pointer to a display structure returned by a successful
XOpenDisplay call.
- drawable
- The resource identifier of a drawable.
The renderer will render to drawables which has a root,
depth, and visual identifier that are the same as those of
this example drawable.
- value_mask
- A two word bitmask indicating which renderer attribute
values are specified by values.
- values
- A pointer to values used to override default values in the
new renderer resource.
The resource identifier of the newly-created renderer
resource.
Invoke PEXCreateRendererWithExtAttributes to create
a renderer and get the identifier of the newly-created
renderer resource.
You may use this renderer to render to drawables with
the same root, depth, and visual ID as the drawable
specified by drawable.
The value_mask is a bitmask which can be manipulated
with the
PEXSetRendererExtAttributeMask function.
See Renderer Attributes
for the bitmask names.
Renderer attributes not explicitly set have default values.
Renderer Attributes.
Attempts to set the renderer's current path and renderer
state attributes are ignored.
- BadAlloc
- The implementation failed to allocate the resource.
- BadDrawable
- The specified drawable resource identifier is invalid.
- BadMatch
- The specified drawable is unsupported, or one of the
specified lookup table resources was not created for the
same root, depth and visual ID as the specified drawable.
- BadPEXLookupTable
- A specified lookup table resource identifier is invalid.
- BadPEXNameSet
- A specified name set resource identifier is invalid.
- BadPEXPipelineContext
- The specified pipeline context resource identifier is invalid.
- BadValue
- A specified value in values is out of range, or an
invalid bit is set in the value mask.
For a list of all Renderer functions and related topics,
see Rendering.