libgimpcolor/gimpcolormanaged.c

   1 /* LIBGIMP - The GIMP Library
   2  * Copyright (C) 1995-1997 Spencer Kimball and Peter Mattis
   3  *
   4  * GimpColorManaged interface
   5  * Copyright (C) 2007  Sven Neumann <sven@gimp.org>
   6  *
   7  * This library is free software: you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 3 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Library General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with this library.  If not, see
  19  * <https://www.gnu.org/licenses/>.
  20  */
  21
  22 #include "config.h"
  23
  24 #include <gio/gio.h>
  25 #include <gegl.h>
  26
  27 #include "gimpcolortypes.h"
  28
  29 #include "gimpcolormanaged.h"
  30 #include "gimpcolorprofile.h"
  31
  32
  33 /**
  34  * SECTION: gimpcolormanaged
  35  * @title: GimpColorManaged
  36  * @short_description: An interface dealing with color profiles.
  37  *
  38  * An interface dealing with color profiles.
  39  **/
  40
  41
  42 enum
  43 {
  44   PROFILE_CHANGED,
  45   LAST_SIGNAL
  46 };
  47
  48
  49 G_DEFINE_INTERFACE (GimpColorManaged, gimp_color_managed, G_TYPE_OBJECT)
  50
  51
  52 static guint gimp_color_managed_signals[LAST_SIGNAL] = { 0 };
  53
  54
  55 /*  private functions  */
  56
  57
  58 static void
  59 gimp_color_managed_default_init (GimpColorManagedInterface *iface)
  60 {
  61   gimp_color_managed_signals[PROFILE_CHANGED] =
  62     g_signal_new ("profile-changed",
  63                   G_TYPE_FROM_INTERFACE (iface),
  64                   G_SIGNAL_RUN_FIRST,
  65                   G_STRUCT_OFFSET (GimpColorManagedInterface,
  66                                    profile_changed),
  67                   NULL, NULL,
  68                   g_cclosure_marshal_VOID__VOID,
  69                   G_TYPE_NONE, 0);
  70 }
  71
  72
  73 /*  public functions  */
  74
  75
  76 /**
  77  * gimp_color_managed_get_icc_profile:
  78  * @managed: an object the implements the #GimpColorManaged interface
  79  * @len:     return location for the number of bytes in the profile data
  80  *
  81  * Return value: A pointer to a blob of data that represents an ICC
  82  *               color profile.
  83  *
  84  * Since: 2.4
  85  **/
  86 const guint8 *
  87 gimp_color_managed_get_icc_profile (GimpColorManaged *managed,
  88                                     gsize            *len)
  89 {
  90   GimpColorManagedInterface *iface;
  91
  92   g_return_val_if_fail (GIMP_IS_COLOR_MANAGED (managed), NULL);
  93   g_return_val_if_fail (len != NULL, NULL);
  94
  95   *len = 0;
  96
  97   iface = GIMP_COLOR_MANAGED_GET_INTERFACE (managed);
  98
  99   if (iface->get_icc_profile)
 100     return iface->get_icc_profile (managed, len);
 101
 102   return NULL;
 103 }
 104
 105 /**
 106  * gimp_color_managed_get_color_profile:
 107  * @managed: an object the implements the #GimpColorManaged interface
 108  *
 109  * This function always returns a #GimpColorProfile and falls back to
 110  * gimp_color_profile_new_rgb_srgb() if the method is not implemented.
 111  *
 112  * Return value: The @managed's #GimpColorProfile.
 113  *
 114  * Since: 2.10
 115  **/
 116 GimpColorProfile *
 117 gimp_color_managed_get_color_profile (GimpColorManaged *managed)
 118 {
 119   GimpColorManagedInterface *iface;
 120
 121   g_return_val_if_fail (GIMP_IS_COLOR_MANAGED (managed), NULL);
 122
 123   iface = GIMP_COLOR_MANAGED_GET_INTERFACE (managed);
 124
 125   if (iface->get_color_profile)
 126     return iface->get_color_profile (managed);
 127
 128   return NULL;
 129 }
 130
 131 /**
 132  * gimp_color_managed_profile_changed:
 133  * @managed: an object the implements the #GimpColorManaged interface
 134  *
 135  * Emits the "profile-changed" signal.
 136  *
 137  * Since: 2.4
 138  **/
 139 void
 140 gimp_color_managed_profile_changed (GimpColorManaged *managed)
 141 {
 142   g_return_if_fail (GIMP_IS_COLOR_MANAGED (managed));
 143
 144   g_signal_emit (managed, gimp_color_managed_signals[PROFILE_CHANGED], 0);
 145 }