PEXCreateRenderer - Create Renderer (5.0)

Note: This function has been superseded by the PEXCreateRendererWithExtAttributes, but it is maintained here for backwards compatibility with PEXlib 5.1.

Synopsis

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

Arguments

display

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

drawable

The resource identifier of a drawable.

value_mask

A mask indicating the attribute values specified.

values

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

Returns

The resource identifier of the newly-created renderer resource.

Description

Invoke PEXCreateRenderer to create 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 some of the following constants:

• RAPipelineContext
• RAMarkerBundle
• RATextBundle
• RALineBundle
• RAInteriorBundle
• RAEdgeBundle
• RAViewTable
• RAColorTable
• RADepthCueTable
• RALightTable
• RAColorApproxTable
• RAPatternTable
• RATextFontTable
• RAHighlightIncl
• RAHighlightExcl
• RAInvisibilityIncl
• RAInvisibilityExcl
• RAHLHSRMode
• RANPCSubVolume
• RAViewport
• RAClipList
• RAPickIncl
• RAPickExcl
• RAPickStartPath
• RABackgroundColor
• RAClearImage
• RAClearZ
• RAEchoMode

Fields not explicitly set have default values (see the Renderer Attributes. You can use the renderer resource only in conjunction with drawables that have the same root and depth as specified drawable.

You cannot explicitly set the renderer's current path and renderer state attributes using this function.

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 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.

BadValue

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

See Also

• PEXFreeRenderer

For a list of compatibility functions, see Renderer Requests for PEXlib 5.0 and 5.1 Compatibility. For a list of all Renderer functions and related topics, see Rendering.