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



render-create-picture drawable &key format picture ... Function
        
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


render-free-picture picture Function
        
picture
The picture object to free

This request deletes all server resources associated with the picture object.