fdo-mirrors/cairo
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/cairo/cairo.git synced 2026-01-08 10:40:33 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

subsurface: Add a note to the docs about usage restrictions.

Browse source 
Make our assumptions about constructed subsurfaces explicit
while we work out the correct semantics for the edge cases.
This commit is contained in:
M Joonas Pihlaja 2010-08-29 00:03:07 +03:00
parent 92fe2d370d
commit b0f65054b8
1 changed files with 7 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
src/cairo-surface-subsurface.c
View file

@ -486,6 +486,11 @@ static const cairo_surface_backend_t _cairo_surface_subsurface_backend = {
* directly onto the parent surface, i.e. with no further backend allocations,
* double buffering or copies.
*
* <note><para>The semantics of subsurfaces have not been finalized yet
* unless the rectangle is in full device units, is contained within
* the extents of the target surface, and the target or subsurface's
* device transforms are not changed.</para></note>
*
* Return value: a pointer to the newly allocated surface. The caller
* owns the surface and should call cairo_surface_destroy() when done
* with it.
@ -493,6 +498,8 @@ static const cairo_surface_backend_t _cairo_surface_subsurface_backend = {
* This function always returns a valid pointer, but it will return a
* pointer to a "nil" surface if @other is already in an error state
* or any other error occurs.
*
* Since: 1.10
**/
cairo_surface_t *
cairo_surface_create_for_rectangle (cairo_surface_t *target,