gimp/libgimpcolor/gimpcolormanaged.h

/* LIBGIMP - The GIMP Library
 * Copyright (C) 1995-1997 Spencer Kimball and Peter Mattis
 *
 * GimpColorManaged interface
 * Copyright (C) 2007  Sven Neumann <sven@gimp.org>
 *
 * 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
 * Library 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
 * <https://www.gnu.org/licenses/>.
 */

#if !defined (__GIMP_COLOR_H_INSIDE__) && !defined (GIMP_COLOR_COMPILATION)
#error "Only <libgimpcolor/gimpcolor.h> can be included directly."
#endif

#ifndef __GIMP_COLOR_MANAGED_H__
#define __GIMP_COLOR_MANAGED_H__

G_BEGIN_DECLS

/* For information look into the C source or the html documentation */


#define GIMP_TYPE_COLOR_MANAGED (gimp_color_managed_get_type ())
G_DECLARE_INTERFACE (GimpColorManaged, gimp_color_managed, GIMP, COLOR_MANAGED, GObject)

/**
 * GimpColorManagedInterface:
 * @base_iface: The parent interface
 * @get_icc_profile: Returns the ICC profile of the pixels managed by
 *                   the object
 * @profile_changed: This signal is emitted when the object's color profile
 *                   has changed
 * @get_color_profile: Returns the #GimpColorProfile of the pixels managed
 *                     by the object
 * @get_simulation_profile: Returns the simulation #GimpColorProfile of the
 *                          pixels managed by the object
 * @get_simulation_rendering_intent: Returns the simulation #GimpColorRenderingIntent
 *                                   of the pixels managed by the object
 * @get_simulation_bpc: Returns whether black point compensation is enabled for the
 *                      simulation of the pixels managed by the object
 **/
struct _GimpColorManagedInterface
{
  GTypeInterface  base_iface;

  /**
   * GimpColorManagedInterface::get_icc_profile:
   * @managed: an object the implements the #GimpColorManaged interface
   * @len: (out): return location for the number of bytes in the profile data
   *
   * Returns: (array length=len): A blob of data that represents an ICC color
   *                              profile.
   *
   * Since: 2.4
   */
  const guint8     * (* get_icc_profile)                     (GimpColorManaged *managed,
                                                              gsize            *len);

  /*  signals  */
  void               (* profile_changed)                     (GimpColorManaged *managed);

  void               (* simulation_profile_changed)          (GimpColorManaged *managed);

  void               (* simulation_intent_changed)           (GimpColorManaged *managed);

  void               (* simulation_bpc_changed)              (GimpColorManaged *managed);

  /*  virtual functions  */
  GimpColorProfile * (* get_color_profile)               (GimpColorManaged *managed);
  GimpColorProfile * (* get_simulation_profile)          (GimpColorManaged *managed);
  GimpColorRenderingIntent
                     (* get_simulation_intent)           (GimpColorManaged *managed);
  gboolean           (* get_simulation_bpc)              (GimpColorManaged *managed);
};


const guint8     *       gimp_color_managed_get_icc_profile            (GimpColorManaged *managed,
                                                                        gsize            *len);
GimpColorProfile *       gimp_color_managed_get_color_profile          (GimpColorManaged *managed);

GimpColorProfile *       gimp_color_managed_get_simulation_profile     (GimpColorManaged *managed);

GimpColorRenderingIntent gimp_color_managed_get_simulation_intent      (GimpColorManaged *managed);

gboolean                 gimp_color_managed_get_simulation_bpc         (GimpColorManaged *managed);

void                     gimp_color_managed_profile_changed            (GimpColorManaged *managed);

void                     gimp_color_managed_simulation_profile_changed (GimpColorManaged *managed);

void                     gimp_color_managed_simulation_intent_changed  (GimpColorManaged *managed);

void                     gimp_color_managed_simulation_bpc_changed     (GimpColorManaged *managed);


G_END_DECLS

#endif  /* __GIMP_COLOR_MANAGED_IFACE_H__ */