XLib-XRender Backend: Cairo: A Vector Graphics Library

+ + +

XLib-XRender Backend

XLib-XRender Backend — X Window System rendering using XLib and the X Render extension

Functions

++++ + + + + + + + + + + +

+cairo_surface_t * +	+cairo_xlib_surface_create_with_xrender_format () +
+XRenderPictFormat * +	+cairo_xlib_surface_get_xrender_format () +

Types and Values

++++ + + + + +

#define

CAIRO_HAS_XLIB_XRENDER_SURFACE

Description

The XLib surface is used to render cairo graphics to X Window System +windows and pixmaps using the XLib and Xrender libraries.

Note that the XLib surface automatically takes advantage of X Render extension +if it is available.

Functions

cairo_xlib_surface_create_with_xrender_format ()

cairo_surface_t *
+cairo_xlib_surface_create_with_xrender_format
+                               (Display *dpy,
+                                Drawable drawable,
+                                Screen *screen,
+                                XRenderPictFormat *format,
+                                int width,
+                                int height);

Creates an Xlib surface that draws to the given drawable. +The way that colors are represented in the drawable is specified +by the provided picture format.

Note: If drawable + is a Window, then the function +cairo_xlib_surface_set_size() must be called whenever the size of the +window changes.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

dpy	an X Display
drawable	an X Drawable, (a Pixmap or a Window)
screen	the X Screen associated with `drawable` +
format	the picture format to use for drawing to `drawable` +. The depth +of `format` +must match the depth of the drawable.
width	the current width of `drawable` +.
height	the current height of `drawable` +.

Returns

the newly created surface

Since: 1.0

cairo_xlib_surface_get_xrender_format ()

XRenderPictFormat *
+cairo_xlib_surface_get_xrender_format (cairo_surface_t *surface);

Gets the X Render picture format that surface + uses for rendering with the +X Render extension. If the surface was created by +cairo_xlib_surface_create_with_xrender_format() originally, the return +value is the format passed to that constructor.

Parameters

+++++ + + + + + +

surface

an xlib surface

Returns

the XRenderPictFormat* associated with surface +, +or NULL if the surface is not an xlib surface +or if the X Render extension is not available.

Since: 1.6

Types and Values

CAIRO_HAS_XLIB_XRENDER_SURFACE

#define CAIRO_HAS_XLIB_XRENDER_SURFACE 1
+

Defined if the XLib/XRender surface functions are available. +This macro can be used to conditionally compile backend-specific code.

Since: 1.6