guac_display_layer_cairo_context Struct Reference

The current Cairo drawing context of a guac_display_layer, including a Cairo image surface wrapping the underlying drawing buffer of the guac_display_layer. More...

Data Fields
cairo_t *	cairo
	A Cairo context created for the Cairo surface.
cairo_surface_t *	surface
	A Cairo image surface wrapping the image buffer of this guac_display_layer.
guac_rect	bounds
	A rectangle covering the current bounds of the graphical surface.
guac_rect	dirty
	A rectangle covering the region of the guac_display_layer that has changed since the last frame.
guac_display_layer *	hint_from
	The layer that should be searched for possible scroll/copy operations related to the changes being made via this guac_display_layer_cairo_context.

Detailed Description

The current Cairo drawing context of a guac_display_layer, including a Cairo image surface wrapping the underlying drawing buffer of the guac_display_layer.

After making graphical changes, the dirty rectangle of this context must be updated such that it includes the regions modified by those changes.

Field Documentation

cairo

cairo_t* guac_display_layer_cairo_context::cairo

A Cairo context created for the Cairo surface.

This Cairo context is persistent and will maintain its state between different calls to guac_display_layer_open_cairo() for the same layer.

dirty

guac_rect guac_display_layer_cairo_context::dirty

A rectangle covering the region of the guac_display_layer that has changed since the last frame.

This rectangle is initially empty and must be manually updated to cover any additional changed regions before closing the guac_display_layer_cairo_context.

hint_from

guac_display_layer* guac_display_layer_cairo_context::hint_from

The layer that should be searched for possible scroll/copy operations related to the changes being made via this guac_display_layer_cairo_context.

This value is initially the layer being drawn to and must be updated before closing the context if a different source layer should be considered for scroll/copy optimizations. This value may be set to NULL to hint that no scroll/copy optimization should be performed.

---

The documentation for this struct was generated from the following file:

• guacamole/display.h