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

doc: Clarify when the device scale is inherited and when it isn't

Browse source 
In short, cairo_surface_create_similar inherits it, while
cairo_surface_create_similar_image doesn't. It wasn't obvious without
reading the code or explicitly checking the device scale of the new
surface.

Fixes: https://bugs.freedesktop.org/show_bug.cgi?id=99094

Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
This commit is contained in:
Debarshi Ray 2016-12-15 12:50:13 +01:00 • committed by Bryce Harrington
parent 1192f97388
commit cffa452f44
1 changed files with 8 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
src/cairo-surface.c
View file

@ -466,10 +466,11 @@ _cairo_surface_copy_similar_properties (cairo_surface_t *surface,
*
* Create a new surface that is as compatible as possible with an
* existing surface. For example the new surface will have the same
* fallback resolution and font options as @other. Generally, the new
* surface will also use the same backend as @other, unless that is
* not possible for some reason. The type of the returned surface may
* be examined with cairo_surface_get_type().
* device scale, fallback resolution and font options as
* @other. Generally, the new surface will also use the same backend
* as @other, unless that is not possible for some reason. The type of
* the returned surface may be examined with
* cairo_surface_get_type().
*
* Initially the surface contents are all 0 (transparent if contents
* have transparency, black otherwise.)
@ -556,7 +557,9 @@ cairo_surface_create_similar (cairo_surface_t *other,
*
* Create a new image surface that is as compatible as possible for uploading
* to and the use in conjunction with an existing surface. However, this surface
* can still be used like any normal image surface.
* can still be used like any normal image surface. Unlike
* cairo_surface_create_similar() the new image surface won't inherit
* the device scale from @other.
*
* Initially the surface contents are all 0 (transparent if contents
* have transparency, black otherwise.)