text: /*
   * This program is free software; you can redistribute it and/or
   * modify it under the terms of the GNU General Public License
   * as published by the Free Software Foundation; either version 2
   * of the License, or (at your option) any later version.
   *
   * This program 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 General Public License for more details.
   *
   * You should have received a copy of the GNU General Public License
   * along with this program; if not, write to the Free Software Foundation,
   * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
   *
   * The Original Code is Copyright (C) 2006 Blender Foundation.
   * All rights reserved.
   */
  #ifndef __BKE_COLORTOOLS_H__
  #define __BKE_COLORTOOLS_H__
  
  /** \file
   * \ingroup bke
   */
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  struct ColorManagedColorspaceSettings;
  struct ColorManagedDisplaySettings;
  struct ColorManagedViewSettings;
  struct CurveMap;
  struct CurveMapPoint;
  struct CurveMapping;
  struct Histogram;
  struct ImBuf;
  struct Scopes;
  struct rctf;
  struct BlendWriter;
  struct BlendDataReader;
  
  void BKE_curvemapping_set_defaults(
      struct CurveMapping *cumap, int tot, float minx, float miny, float maxx, float maxy);
  struct CurveMapping *BKE_curvemapping_add(int tot, float minx, float miny, float maxx, float maxy);
  void BKE_curvemapping_free_data(struct CurveMapping *cumap);
  void BKE_curvemapping_free(struct CurveMapping *cumap);
  void BKE_curvemapping_copy_data(struct CurveMapping *target, const struct CurveMapping *cumap);
  struct CurveMapping *BKE_curvemapping_copy(const struct CurveMapping *cumap);
  void BKE_curvemapping_set_black_white_ex(const float black[3],
                                           const float white[3],
                                           float r_bwmul[3]);
  void BKE_curvemapping_set_black_white(struct CurveMapping *cumap,
                                        const float black[3],
                                        const float white[3]);
  
  enum {
    CURVEMAP_SLOPE_NEGATIVE = 0,
    CURVEMAP_SLOPE_POSITIVE = 1,
    CURVEMAP_SLOPE_POS_NEG = 2,
  };
  
  void BKE_curvemap_reset(struct CurveMap *cuma, const struct rctf *clipr, int preset, int slope);
  void BKE_curvemap_remove(struct CurveMap *cuma, const short flag);
  bool BKE_curvemap_remove_point(struct CurveMap *cuma, struct CurveMapPoint *cmp);
  struct CurveMapPoint *BKE_curvemap_insert(struct CurveMap *cuma, float x, float y);
  void BKE_curvemap_handle_set(struct CurveMap *cuma, int type);
  
  void BKE_curvemapping_changed(struct CurveMapping *cumap, const bool rem_doubles);
  void BKE_curvemapping_changed_all(struct CurveMapping *cumap);
  
  /* call before _all_ evaluation functions */
  void BKE_curvemapping_initialize(struct CurveMapping *cumap);
  
  /* keep these (const CurveMap) - to help with thread safety */
  /* single curve, no table check */
  float BKE_curvemap_evaluateF(const struct CurveMapping *cumap,
                               const struct CurveMap *cuma,
                               float value);
  /* single curve, with table check */
  float BKE_curvemapping_evaluateF(const struct CurveMapping *cumap, int cur, float value);
  void BKE_curvemapping_evaluate3F(const struct CurveMapping *cumap,
                                   float vecout[3],
                                   const float vecin[3]);
  void BKE_curvemapping_evaluateRGBF(const struct CurveMapping *cumap,
                                     float vecout[3],
                                     const float vecin[3]);
  void BKE_curvemapping_evaluate_premulRGB(const struct CurveMapping *cumap,
                                           unsigned char vecout_byte[3],
                                           const unsigned char vecin_byte[3]);
  void BKE_curvemapping_evaluate_premulRGBF_ex(const struct CurveMapping *cumap,
                                               float vecout[3],
                                               const float vecin[3],
                                               const float black[3],
                                               const float bwmul[3]);
  void BKE_curvemapping_evaluate_premulRGBF(const struct CurveMapping *cumap,
                                            float vecout[3],
                                            const float vecin[3]);
  int BKE_curvemapping_RGBA_does_something(const struct CurveMapping *cumap);
  void BKE_curvemapping_table_RGBA(const struct CurveMapping *cumap, float **array, int *size);
  
  /* non-const, these modify the curve */
  void BKE_curvemapping_premultiply(struct CurveMapping *cumap, int restore);
  
  void BKE_curvemapping_blend_write(struct BlendWriter *writer, const struct CurveMapping *cumap);
  void BKE_curvemapping_curves_blend_write(struct BlendWriter *writer,
                                           const struct CurveMapping *cumap);
  void BKE_curvemapping_blend_read(struct BlendDataReader *reader, struct CurveMapping *cumap);
  
  void BKE_histogram_update_sample_line(struct Histogram *hist,
                                        struct ImBuf *ibuf,
                                        const struct ColorManagedViewSettings *view_settings,
                                        const struct ColorManagedDisplaySettings *display_settings);
  void BKE_scopes_update(struct Scopes *scopes,
                         struct ImBuf *ibuf,
                         const struct ColorManagedViewSettings *view_settings,
                         const struct ColorManagedDisplaySettings *display_settings);
  void BKE_scopes_free(struct Scopes *scopes);
  void BKE_scopes_new(struct Scopes *scopes);
  
  void BKE_color_managed_display_settings_init(struct ColorManagedDisplaySettings *settings);
  void BKE_color_managed_display_settings_copy(struct ColorManagedDisplaySettings *new_settings,
                                               const struct ColorManagedDisplaySettings *settings);
  
  /* Initialize view settings to be best suitable for render type of viewing.
   * This will use default view transform from the OCIO configuration if none
   * is specified. */
  void BKE_color_managed_view_settings_init_render(
      struct ColorManagedViewSettings *settings,
      const struct ColorManagedDisplaySettings *display_settings,
      const char *view_transform);
  
  /* Initialize view settings which are best suitable for viewing non-render
   * images. For example,s movie clips while tracking. */
  void BKE_color_managed_view_settings_init_default(
      struct ColorManagedViewSettings *settings,
      const struct ColorManagedDisplaySettings *display_settings);
  
  void BKE_color_managed_view_settings_copy(struct ColorManagedViewSettings *new_settings,
                                            const struct ColorManagedViewSettings *settings);
  void BKE_color_managed_view_settings_free(struct ColorManagedViewSettings *settings);
  
  void BKE_color_managed_colorspace_settings_init(
      struct ColorManagedColorspaceSettings *colorspace_settings);
  void BKE_color_managed_colorspace_settings_copy(
      struct ColorManagedColorspaceSettings *colorspace_settings,
      const struct ColorManagedColorspaceSettings *settings);
  bool BKE_color_managed_colorspace_settings_equals(
      const struct ColorManagedColorspaceSettings *settings1,
      const struct ColorManagedColorspaceSettings *settings2);
  
  #ifdef __cplusplus
  }
  #endif
  
  #endif
  