diff options
author | Philip Withnall <philip@tecnocode.co.uk> | 2017-01-07 18:54:37 +0000 |
---|---|---|
committer | Philip Withnall <withnall@endlessm.com> | 2017-01-10 09:46:42 +0000 |
commit | f3b65760503422e1c4b05b5d7196b5265f970e52 (patch) | |
tree | 06ed24fcc2cfdcfedacb5d17b27eb2e0a4e5840e | |
parent | a4421926b2d7a40b6c1f36d46a88a93144f59c30 (diff) | |
download | gdk-pixbuf-f3b65760503422e1c4b05b5d7196b5265f970e52.tar.gz |
docs: Use ‘alpha blending’ rather than ‘compositing’
It’s a slightly more accurate term, as compositing seems to mostly refer
to bit-mask composition of two images, rather than blending.
https://bugzilla.gnome.org/show_bug.cgi?id=442452
-rw-r--r-- | gdk-pixbuf/gdk-pixbuf-scale.c | 22 |
1 files changed, 12 insertions, 10 deletions
diff --git a/gdk-pixbuf/gdk-pixbuf-scale.c b/gdk-pixbuf/gdk-pixbuf-scale.c index 945e3a4d3..cc41961e8 100644 --- a/gdk-pixbuf/gdk-pixbuf-scale.c +++ b/gdk-pixbuf/gdk-pixbuf-scale.c @@ -27,16 +27,18 @@ /** * SECTION:scaling - * @Short_description: Scaling pixbufs and scaling and compositing pixbufs + * @Short_description: Scaling pixbufs and scaling and alpha blending pixbufs * @Title: Scaling * @See_also: <link linkend="gdk-GdkRGB">GdkRGB</link>. * * The GdkPixBuf contains functions to scale pixbufs, to scale - * pixbufs and composite against an existing image, and to scale - * pixbufs and composite against a solid color or checkerboard. - * Compositing a checkerboard is a common way to show an image with + * pixbufs and alpha blend against an existing image, and to scale + * pixbufs and alpha blend against a solid color or checkerboard. + * Alpha blending a checkerboard is a common way to show an image with * an alpha channel in image-viewing and editing software. * + * Note that in these functions, the terms ‘alpha blending’ and ‘compositing’ + * are used synonymously. * * Since the full-featured functions (gdk_pixbuf_scale(), * gdk_pixbuf_composite(), and gdk_pixbuf_composite_color()) are @@ -49,7 +51,7 @@ * If the destination pixbuf was created from a readonly source, these * operations will force a copy into a mutable buffer. * - * Scaling and compositing functions take advantage of MMX hardware + * Scaling and alpha blending functions take advantage of MMX hardware * acceleration on systems where MMX is supported. If gdk-pixbuf is built * with the Sun mediaLib library, these functions are instead accelerated * using mediaLib, which provides hardware acceleration on Intel, AMD, @@ -179,7 +181,7 @@ gdk_pixbuf_scale (const GdkPixbuf *src, * @scale_x and @scale_y then translating by @offset_x and @offset_y. * This gives an image in the coordinates of the destination pixbuf. * The rectangle (@dest_x, @dest_y, @dest_width, @dest_height) - * is then composited onto the corresponding rectangle of the + * is then alpha blended onto the corresponding rectangle of the * original destination image. * * When the destination rectangle contains parts not in the source @@ -248,7 +250,7 @@ gdk_pixbuf_composite (const GdkPixbuf *src, * * Creates a transformation of the source image @src by scaling by * @scale_x and @scale_y then translating by @offset_x and @offset_y, - * then composites the rectangle (@dest_x ,@dest_y, @dest_width, + * then alpha blends the rectangle (@dest_x ,@dest_y, @dest_width, * @dest_height) of the resulting image with a checkboard of the * colors @color1 and @color2 and renders it onto the destination * image. @@ -319,7 +321,7 @@ gdk_pixbuf_composite_color (const GdkPixbuf *src, * You can scale a sub-portion of @src by creating a sub-pixbuf * pointing into @src; see gdk_pixbuf_new_subpixbuf(). * - * For more complicated scaling/compositing see gdk_pixbuf_scale() + * For more complicated scaling/alpha blending see gdk_pixbuf_scale() * and gdk_pixbuf_composite(). * * Return value: (transfer full): the new #GdkPixbuf, or %NULL if not enough memory could be @@ -359,9 +361,9 @@ gdk_pixbuf_scale_simple (const GdkPixbuf *src, * @check_size: the size of checks in the checkboard (must be a power of two) * @color1: the color of check at upper left * @color2: the color of the other check - * + * * Creates a new #GdkPixbuf by scaling @src to @dest_width x - * @dest_height and compositing the result with a checkboard of colors + * @dest_height and alpha blending the result with a checkboard of colors * @color1 and @color2. * * Return value: (transfer full): the new #GdkPixbuf, or %NULL if not enough memory could be |