gimpcolormanaged.c 3.64 KB
Newer Older
1 2 3 4 5 6
/* LIBGIMP - The GIMP Library
 * Copyright (C) 1995-1997 Spencer Kimball and Peter Mattis
 *
 * GimpColorManaged interface
 * Copyright (C) 2007  Sven Neumann <sven@gimp.org>
 *
7
 * This library is free software: you can redistribute it and/or
8 9
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
10
 * version 3 of the License, or (at your option) any later version.
11 12 13 14 15 16 17
 *
 * 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
 * Library General Public License for more details.
 *
 * 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 23
 */

#include "config.h"

24 25
#include <gio/gio.h>
#include <gegl.h>
26 27 28 29

#include "gimpcolortypes.h"

#include "gimpcolormanaged.h"
30
#include "gimpcolorprofile.h"
31 32


33
/**
34
 * SECTION: gimpcolormanaged
35 36 37 38 39 40 41
 * @title: GimpColorManaged
 * @short_description: An interface dealing with color profiles.
 *
 * An interface dealing with color profiles.
 **/


42 43 44 45 46 47 48
enum
{
  PROFILE_CHANGED,
  LAST_SIGNAL
};


49
G_DEFINE_INTERFACE (GimpColorManaged, gimp_color_managed, G_TYPE_OBJECT)
50 51 52 53 54


static guint gimp_color_managed_signals[LAST_SIGNAL] = { 0 };


55 56 57
/*  private functions  */


58
static void
59
gimp_color_managed_default_init (GimpColorManagedInterface *iface)
60
{
61 62 63 64 65 66 67 68 69
  gimp_color_managed_signals[PROFILE_CHANGED] =
    g_signal_new ("profile-changed",
                  G_TYPE_FROM_INTERFACE (iface),
                  G_SIGNAL_RUN_FIRST,
                  G_STRUCT_OFFSET (GimpColorManagedInterface,
                                   profile_changed),
                  NULL, NULL,
                  g_cclosure_marshal_VOID__VOID,
                  G_TYPE_NONE, 0);
70 71
}

72 73 74 75

/*  public functions  */


76 77 78 79 80 81 82 83
/**
 * gimp_color_managed_get_icc_profile:
 * @managed: an object the implements the #GimpColorManaged interface
 * @len:     return location for the number of bytes in the profile data
 *
 * Return value: A pointer to a blob of data that represents an ICC
 *               color profile.
 *
84
 * Since: 2.4
85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104
 **/
const guint8 *
gimp_color_managed_get_icc_profile (GimpColorManaged *managed,
                                    gsize            *len)
{
  GimpColorManagedInterface *iface;

  g_return_val_if_fail (GIMP_IS_COLOR_MANAGED (managed), NULL);
  g_return_val_if_fail (len != NULL, NULL);

  *len = 0;

  iface = GIMP_COLOR_MANAGED_GET_INTERFACE (managed);

  if (iface->get_icc_profile)
    return iface->get_icc_profile (managed, len);

  return NULL;
}

105 106 107 108
/**
 * gimp_color_managed_get_color_profile:
 * @managed: an object the implements the #GimpColorManaged interface
 *
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 113
 *
 * Return value: The @managed's #GimpColorProfile.
 *
114
 * Since: 2.10
115
 **/
116
GimpColorProfile *
117 118 119 120 121 122 123 124 125 126 127
gimp_color_managed_get_color_profile (GimpColorManaged *managed)
{
  GimpColorManagedInterface *iface;

  g_return_val_if_fail (GIMP_IS_COLOR_MANAGED (managed), NULL);

  iface = GIMP_COLOR_MANAGED_GET_INTERFACE (managed);

  if (iface->get_color_profile)
    return iface->get_color_profile (managed);

128
  return NULL;
129 130
}

131 132 133 134 135 136
/**
 * gimp_color_managed_profile_changed:
 * @managed: an object the implements the #GimpColorManaged interface
 *
 * Emits the "profile-changed" signal.
 *
137
 * Since: 2.4
138 139 140 141 142 143 144 145
 **/
void
gimp_color_managed_profile_changed (GimpColorManaged *managed)
{
  g_return_if_fail (GIMP_IS_COLOR_MANAGED (managed));

  g_signal_emit (managed, gimp_color_managed_signals[PROFILE_CHANGED], 0);
}