/* LIBGIMP - The GIMP Library * Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball * * gimpcairo.c * Copyright (C) 2007 Sven Neumann * 2010-2012 Michael Natterer * * This library is free software: you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 3 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library. If not, see * . */ #include "config.h" #include #include #include #include "libgimpbase/gimpbase.h" #include "gimpcolortypes.h" #include "gimpcairo.h" /** * SECTION: gimpcairo * @title: GimpCairo * @short_description: Color utility functions for cairo * * Utility functions that make cairo easier to use with GIMP color * data types. **/ /** * gimp_cairo_set_source_rgb: * @cr: Cairo context * @color: GimpRGB color * * Sets the source pattern within @cr to the solid opaque color * described by @color. * * This function calls cairo_set_source_rgb() for you. * * Since: 2.6 **/ void gimp_cairo_set_source_rgb (cairo_t *cr, const GimpRGB *color) { cairo_set_source_rgb (cr, color->r, color->g, color->b); } /** * gimp_cairo_set_source_rgba: * @cr: Cairo context * @color: GimpRGB color * * Sets the source pattern within @cr to the solid translucent color * described by @color. * * This function calls cairo_set_source_rgba() for you. * * Since: 2.6 **/ void gimp_cairo_set_source_rgba (cairo_t *cr, const GimpRGB *color) { cairo_set_source_rgba (cr, color->r, color->g, color->b, color->a); } /** * gimp_cairo_checkerboard_create: * @cr: Cairo context * @size: check size * @light: light check color or %NULL to use the default light gray * @dark: dark check color or %NULL to use the default dark gray * * Create a repeating checkerboard pattern. * * Returns: a new Cairo pattern that can be used as a source on @cr. * * Since: 2.6 **/ cairo_pattern_t * gimp_cairo_checkerboard_create (cairo_t *cr, gint size, const GeglColor *light, const GeglColor *dark) { cairo_t *context; cairo_surface_t *surface; cairo_pattern_t *pattern; g_return_val_if_fail (cr != NULL, NULL); g_return_val_if_fail (size > 0, NULL); surface = cairo_surface_create_similar (cairo_get_target (cr), CAIRO_CONTENT_COLOR, 2 * size, 2 * size); context = cairo_create (surface); if (light) { gdouble rgb[3]; gegl_color_get_pixel (GEGL_COLOR (light), babl_format ("R'G'B' double"), rgb); cairo_set_source_rgb (context, rgb[0], rgb[1], rgb[2]); } else { cairo_set_source_rgb (context, GIMP_CHECK_LIGHT, GIMP_CHECK_LIGHT, GIMP_CHECK_LIGHT); } cairo_rectangle (context, 0, 0, size, size); cairo_rectangle (context, size, size, size, size); cairo_fill (context); if (dark) { gdouble rgb[3]; gegl_color_get_pixel (GEGL_COLOR (dark), babl_format ("R'G'B' double"), rgb); cairo_set_source_rgb (context, rgb[0], rgb[1], rgb[2]); } else { cairo_set_source_rgb (context, GIMP_CHECK_DARK, GIMP_CHECK_DARK, GIMP_CHECK_DARK); } cairo_rectangle (context, 0, size, size, size); cairo_rectangle (context, size, 0, size, size); cairo_fill (context); cairo_destroy (context); pattern = cairo_pattern_create_for_surface (surface); cairo_pattern_set_extend (pattern, CAIRO_EXTEND_REPEAT); cairo_surface_destroy (surface); return pattern; } /** * gimp_cairo_surface_get_format: * @surface: a Cairo surface * * This function returns a #Babl format that corresponds to @surface's * pixel format. * * Returns: the #Babl format of @surface. * * Since: 2.10 **/ const Babl * gimp_cairo_surface_get_format (cairo_surface_t *surface) { g_return_val_if_fail (surface != NULL, NULL); g_return_val_if_fail (cairo_surface_get_type (surface) == CAIRO_SURFACE_TYPE_IMAGE, NULL); switch (cairo_image_surface_get_format (surface)) { case CAIRO_FORMAT_RGB24: return babl_format ("cairo-RGB24"); case CAIRO_FORMAT_ARGB32: return babl_format ("cairo-ARGB32"); case CAIRO_FORMAT_A8: return babl_format ("cairo-A8"); #if CAIRO_VERSION >= CAIRO_VERSION_ENCODE(1, 17, 2) /* Since Cairo 1.17.2 */ case CAIRO_FORMAT_RGB96F: return babl_format ("R'G'B' float"); case CAIRO_FORMAT_RGBA128F: return babl_format ("R'aG'aB'aA float"); #endif default: break; } g_return_val_if_reached (NULL); } /** * gimp_cairo_surface_create_buffer: * @surface: a Cairo surface * @format: a Babl format. * * This function returns a #GeglBuffer which wraps @surface's pixels. * It must only be called on image surfaces, calling it on other surface * types is an error. * * If @format is set, the returned [class@Gegl.Buffer] will use it. It has to * map with @surface Cairo format. If unset, the buffer format will be * determined from @surface. The main difference is that automatically * determined format has sRGB space and TRC by default. * * Returns: (transfer full): a #GeglBuffer * * Since: 2.10 **/ GeglBuffer * gimp_cairo_surface_create_buffer (cairo_surface_t *surface, const Babl *format) { gint width; gint height; g_return_val_if_fail (surface != NULL, NULL); g_return_val_if_fail (cairo_surface_get_type (surface) == CAIRO_SURFACE_TYPE_IMAGE, NULL); g_return_val_if_fail (format == NULL || babl_format_get_bytes_per_pixel (format) == babl_format_get_bytes_per_pixel (gimp_cairo_surface_get_format (surface)), NULL); if (format == NULL) format = gimp_cairo_surface_get_format (surface); width = cairo_image_surface_get_width (surface); height = cairo_image_surface_get_height (surface); return gegl_buffer_linear_new_from_data (cairo_image_surface_get_data (surface), format, GEGL_RECTANGLE (0, 0, width, height), cairo_image_surface_get_stride (surface), (GDestroyNotify) cairo_surface_destroy, cairo_surface_reference (surface)); }