16.3.2 The picture object

The picture object contains a drawable, a picture-format and some rendering state. More than one picture can refer to the same drawable.

A picture is almost like a gcontext, except that it is tied in use to a single drawable. Another similarity it has with gcontext is that it is a cached object. Updates are not processed until the picture is used. This also makes it possible to query state, as there is no such request in XRENDER to do so.

The picture object is also a lot like a drawable, in that it is used as a target for graphics operations. Or at least that it occurs where you would expect a drawable in XRENDER requests.

Function: render-create-picture drawable &key format picture ...

drawable

A Drawable

format

A picture-format

picture

An existing picture object to use, one is created if not specified.

repeat

(member :off :on)

alpha-map

A picture or :none

alpha-x-origin

int16

alpha-y-origin

int16

clip-x-origin

int16

clip-y-origin

int16

clip-mask

A Pixmap or :none

graphics-exposures

(member :off :on)

subwindow-mode

(member :clip-by-children :include-inferiors)

poly-edge

(member :sharp :smooth)

poly-mode

(member :precise :imprecise)

dither

xatom or :none

component-alpha

(member :off :on)

This request creates a Picture object. If the drawable is a Window then the Red, Green and Blue masks must match those in the visual for the window else a Match error is generated.

picture

A picture

Function: render-free-picture picture This request deletes all server resources associated with the picture object.

picture

The picture object to free