PEXChangeRenderer(3) — Subroutines

Name

PEXChangeRenderer - Change Renderer Attributes

Synopsis

void PEXChangeRenderer(Display ∗display, PEXRenderer renderer, unsigned long value_mask, PEXRendererAttributes ∗values)

Arguments

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

rendererThe resource identifier of the renderer.

value_maskA mask indicating the renderer attributes to be changed.

valuesA pointer to new values for the renderer attributes.

Returns

None

Description

This function modifies attributes of the specified renderer resource. The value mask indicates the attribute values to be modified. 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

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

BadMatchThe specified lookup table resource was not created with a drawable compatible with the drawable used to create the renderer resource.

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.

Museum