CoglTexturePixmapX11

typedef struct _CoglTexturePixmapX11 CoglTexturePixmapX11;

cogl_is_texture_pixmap_x11 ()

CoglBool            cogl_is_texture_pixmap_x11          (void *object);

Checks whether object points to a CoglTexturePixmapX11 instance.

Since 1.4

Stability Level: Unstable

cogl_texture_pixmap_x11_new ()

CoglTexturePixmapX11 * cogl_texture_pixmap_x11_new      (CoglContext *context,
                                                         uint32_t pixmap,
                                                         CoglBool automatic_updates,
                                                         CoglError **error);

Creates a texture that contains the contents of pixmap. If automatic_updates is TRUE then Cogl will attempt to listen for damage events on the pixmap and automatically update the texture when it changes.

Since 1.10

Stability Level: Unstable

cogl_texture_pixmap_x11_update_area ()

void                cogl_texture_pixmap_x11_update_area (CoglTexturePixmapX11 *texture,
                                                         int x,
                                                         int y,
                                                         int width,
                                                         int height);

Forces an update of the given texture so that it is refreshed with the contents of the pixmap that was given to cogl_texture_pixmap_x11_new().

Since 1.4

Stability Level: Unstable

cogl_texture_pixmap_x11_is_using_tfp_extension ()

CoglBool            cogl_texture_pixmap_x11_is_using_tfp_extension
                                                        (CoglTexturePixmapX11 *texture);

Checks whether the given texture is using the GLX_EXT_texture_from_pixmap or similar extension to copy the contents of the pixmap to the texture. This extension is usually implemented as zero-copy operation so it implies the updates are working efficiently.

Since 1.4

Stability Level: Unstable

enum CoglTexturePixmapX11ReportLevel

typedef enum {
  COGL_TEXTURE_PIXMAP_X11_DAMAGE_RAW_RECTANGLES,
  COGL_TEXTURE_PIXMAP_X11_DAMAGE_DELTA_RECTANGLES,
  COGL_TEXTURE_PIXMAP_X11_DAMAGE_BOUNDING_BOX,
  COGL_TEXTURE_PIXMAP_X11_DAMAGE_NON_EMPTY
} CoglTexturePixmapX11ReportLevel;

cogl_texture_pixmap_x11_set_damage_object ()

void                cogl_texture_pixmap_x11_set_damage_object
                                                        (CoglTexturePixmapX11 *texture,
                                                         uint32_t damage,
                                                         CoglTexturePixmapX11ReportLevel report_level);

Sets the damage object that will be used to track automatic updates to the texture. Damage tracking can be disabled by passing 0 for damage. Otherwise this damage will replace the one used if TRUE was passed for automatic_updates to cogl_texture_pixmap_x11_new().

Note that Cogl will subtract from the damage region as it processes damage events.

Since 1.4

Stability Level: Unstable