colorequal.c File Reference

#include <math.h>
#include <stdlib.h>
#include <string.h>
#include "bauhaus/bauhaus.h"
#include "common/colorequal_shared.h"
#include "common/chromatic_adaptation.h"
#include "common/colorspaces_inline_conversions.h"
#include "common/darktable.h"
#include "common/imagebuf.h"
#include "common/interpolation.h"
#include "common/lut3d.h"
#include "common/lut_viewer.h"
#include "common/opencl.h"
#include "control/conf.h"
#include "control/control.h"
#include "control/signal.h"
#include "develop/develop.h"
#include "develop/dev_pixelpipe.h"
#include "develop/imageop.h"
#include "develop/imageop_gui.h"
#include "develop/imageop_math.h"
#include "develop/pixelpipe_cache.h"
#include "dtgtk/drawingarea.h"
#include "gui/color_picker_proxy.h"
#include "gui/draw.h"
#include "gui/gtk.h"
#include "gui/gui_throttle.h"
#include "iop/iop_api.h"

Include dependency graph for colorequal.c:

Go to the source code of this file.

Data Structures
struct	dt_iop_colorequal_node_t
struct	dt_iop_colorequal_params_t
struct	dt_iop_colorequal_data_t
struct	dt_iop_colorequal_global_data_t
struct	dt_iop_colorequal_gui_data_t

Macros
#define	DT_IOP_COLOREQUAL_NUM_CHANNELS   3
#define	DT_IOP_COLOREQUAL_NUM_RINGS   3
#define	DT_IOP_COLOREQUAL_MAXNODES   20
#define	DT_IOP_COLOREQUAL_DEFAULT_NODES   8
#define	DT_IOP_COLOREQUAL_GRAPH_RES   360
#define	DT_IOP_COLOREQUAL_GRAPH_GRADIENTS   48
#define	DT_IOP_COLOREQUAL_HUE_SAMPLES   64
#define	DT_IOP_COLOREQUAL_VIEWER_CONTROL_NODES   (DT_IOP_COLOREQUAL_NUM_RINGS * DT_IOP_COLOREQUAL_HUE_SAMPLES)
#define	DT_IOP_COLOREQUAL_AXIAL_SAMPLES   64
#define	DT_IOP_COLOREQUAL_CLUT_LEVEL   64
#define	DT_IOP_COLOREQUAL_LOCAL_FIELD_RINGS   (DT_IOP_COLOREQUAL_NUM_RINGS + 1)
#define	DT_IOP_COLOREQUAL_MIN_X_DISTANCE   0.01f
#define	DT_IOP_COLOREQUAL_PREVIEW_CURSOR_RADIUS   DT_PIXEL_APPLY_DPI(14.f)
#define	DT_IOP_COLOREQUAL_GRAPH_INSET   DT_PIXEL_APPLY_DPI(4)
#define	DT_IOP_COLOREQUAL_AXIS_HEIGHT   DT_PIXEL_APPLY_DPI(14)
#define	DT_IOP_COLOREQUAL_SCROLL_SIGMA   2.f * M_PI_F / 128.f
#define	DT_IOP_COLOREQUAL_SCROLL_STEP   0.05f
#define	DT_IOP_COLOREQUAL_SCROLL_STEP_FINE   0.02f
#define	DT_IOP_COLOREQUAL_SCROLL_STEP_COARSE   0.10f
#define	DT_IOP_COLOREQUAL_SCROLL_HUE_STEP   (5.f * M_PI_F / 180.f)
#define	DT_IOP_COLOREQUAL_SCROLL_HUE_STEP_FINE   (1.f * M_PI_F / 180.f)
#define	DT_IOP_COLOREQUAL_SCROLL_HUE_STEP_COARSE   (10.f * M_PI_F / 180.f)

Typedefs
typedef enum dt_iop_colorequal_channel_t	dt_iop_colorequal_channel_t
typedef enum dt_iop_colorequal_ring_t	dt_iop_colorequal_ring_t
typedef enum dt_iop_colorequal_interpolation_t	dt_iop_colorequal_interpolation_t
typedef struct dt_iop_colorequal_node_t	dt_iop_colorequal_node_t
typedef struct dt_iop_colorequal_params_t	dt_iop_colorequal_params_t
typedef struct dt_iop_colorequal_data_t	dt_iop_colorequal_data_t
typedef struct dt_iop_colorequal_global_data_t	dt_iop_colorequal_global_data_t
typedef struct dt_iop_colorequal_gui_data_t	dt_iop_colorequal_gui_data_t

Enumerations
enum	dt_iop_colorequal_channel_t {   DT_IOP_COLOREQUAL_SATURATION = 0 ,   DT_IOP_COLOREQUAL_HUE = 1 ,   DT_IOP_COLOREQUAL_BRIGHTNESS = 2 }
enum	dt_iop_colorequal_ring_t {   DT_IOP_COLOREQUAL_RING_DARK = 0 ,   DT_IOP_COLOREQUAL_RING_MID = 1 ,   DT_IOP_COLOREQUAL_RING_LIGHT = 2 }
enum	dt_iop_colorequal_interpolation_t {   DT_IOP_COLOREQUAL_TETRAHEDRAL = 0 ,   DT_IOP_COLOREQUAL_TRILINEAR = 1 ,   DT_IOP_COLOREQUAL_PYRAMID = 2 }

Functions
const char *	name ()
const char *	aliases ()
const char **	description (struct dt_iop_module_t *self)
int	default_group ()
int	flags ()
int	default_colorspace (dt_iop_module_t *self, dt_dev_pixelpipe_t *pipe, const dt_dev_pixelpipe_iop_t *piece)
static void	_update_gui_lut_cache (dt_iop_module_t *self)
static void	_switch_preview_cursor (dt_iop_module_t *self)
static gboolean	_refresh_preview_cursor_sample (dt_iop_module_t *self)
static void	_preview_cache_wait_restart (gpointer user_data)
static float	_channel_value_from_y (const dt_iop_colorequal_channel_t channel, const float y)
static float	_channel_y_from_value (const dt_iop_colorequal_channel_t channel, const float value)
static const char *	_ring_label (const dt_iop_colorequal_ring_t ring)
static dt_iop_colorequal_node_t *	_curve_nodes (dt_iop_colorequal_params_t *p, const dt_iop_colorequal_ring_t ring, const dt_iop_colorequal_channel_t channel)
static const dt_iop_colorequal_node_t *	_curve_nodes_const (const dt_iop_colorequal_params_t *p, const dt_iop_colorequal_ring_t ring, const dt_iop_colorequal_channel_t channel)
static int *	_curve_nodes_count (dt_iop_colorequal_params_t *p, const dt_iop_colorequal_ring_t ring, const dt_iop_colorequal_channel_t channel)
static int	_curve_nodes_count_const (const dt_iop_colorequal_params_t *p, const dt_iop_colorequal_ring_t ring, const dt_iop_colorequal_channel_t channel)
static void	_reset_channel_nodes (dt_iop_colorequal_params_t *p, const dt_iop_colorequal_ring_t ring, const dt_iop_colorequal_channel_t channel)
static void	_init_default_curves (dt_iop_colorequal_params_t *p)
static gboolean	_curve_fields_equal (const dt_iop_colorequal_params_t *const a, const dt_iop_colorequal_params_t *const b)
static gboolean	_lut_fields_equal (const dt_iop_colorequal_params_t *const a, const dt_iop_colorequal_params_t *const b)
static float	_curve_periodic_distance (const float x0, const float x1)
static dt_iop_colorequal_channel_t	_channel_from_page (const int page)
static dt_iop_colorequal_ring_t	_active_ring_from_gui (const dt_iop_colorequal_gui_data_t *g)
static dt_iop_colorequal_channel_t	_active_channel_from_gui (const dt_iop_colorequal_gui_data_t *g, const dt_iop_colorequal_ring_t ring)
static void	_invalidate_preview_cursor (dt_iop_colorequal_gui_data_t *g)
static gboolean	_cursor_curve_state (const dt_iop_colorequal_params_t *p, const dt_iop_colorequal_ring_t ring, const dt_iop_colorequal_channel_t channel, const float hue, float *curve_x, float *curve_y, float *offset_normalized)
static void	_clamp_display_rgb (dt_aligned_pixel_t RGB)
static void	_work_rgb_to_display_rgb (dt_iop_module_t *self, dt_dev_pixelpipe_t *pipe, const dt_aligned_pixel_t work_rgb, dt_aligned_pixel_t display_rgb)
static void	_mix_rgb_anchors (const dt_aligned_pixel_t low, const dt_aligned_pixel_t high, const float mix, dt_aligned_pixel_t RGB)
static void	_sample_ring_hue (const float ring_surface[3][64][3], const int ring, const float hue_position, dt_aligned_pixel_t RGB)
static void	_sample_ring_anchor (const float ring_surface[3][64][3], const float brightness, const float hue_position, const float white, const dt_iop_order_iccprofile_info_t *const profile, dt_aligned_pixel_t RGB)
static void	_build_clut (dt_iop_colorequal_data_t *d, const dt_iop_colorequal_params_t *p, const dt_iop_order_iccprofile_info_t *lut_profile)
static size_t	_build_viewer_control_nodes (const dt_iop_colorequal_params_t *p, const dt_iop_order_iccprofile_info_t *lut_profile, dt_lut_viewer_control_node_t *control_nodes)
void	commit_params (struct dt_iop_module_t *self, dt_iop_params_t *p1, dt_dev_pixelpipe_t *pipe, dt_dev_pixelpipe_iop_t *piece)
void	init_pipe (struct dt_iop_module_t *self, dt_dev_pixelpipe_t *pipe, dt_dev_pixelpipe_iop_t *piece)
void	cleanup_pipe (struct dt_iop_module_t *self, dt_dev_pixelpipe_t *pipe, dt_dev_pixelpipe_iop_t *piece)
int	process_cl (struct dt_iop_module_t *self, const dt_dev_pixelpipe_t *pipe, const dt_dev_pixelpipe_iop_t *piece, cl_mem dev_in, cl_mem dev_out)
__DT_CLONE_TARGETS__ int	process (struct dt_iop_module_t *self, const dt_dev_pixelpipe_t *pipe, const dt_dev_pixelpipe_iop_t *piece, const void *const ibuf, void *const obuf)
static void	_update_curve_cache (dt_iop_colorequal_gui_data_t *g, const dt_iop_colorequal_params_t *p)
static void	_graph_background_hsb (const dt_iop_colorequal_channel_t channel, const float x, const float y, const float ring_brightness, const float reference_saturation, dt_aligned_pixel_t HSB)
static void	_draw_graph_background (cairo_t *cr, const dt_iop_colorequal_channel_t channel, const dt_iop_colorequal_ring_t ring, const float graph_width, const float graph_height, const float white, const float reference_saturation, const dt_iop_order_iccprofile_info_t *display_profile)
static gboolean	_draw_curve (GtkWidget *widget, cairo_t *crf, gpointer user_data)
static void	_cacheline_ready_callback (gpointer instance, const guint64 hash, gpointer user_data)
static int	_find_selected_node (const dt_iop_module_t *self, const dt_iop_colorequal_ring_t ring, const dt_iop_colorequal_channel_t channel, const float mouse_x, const float mouse_y, const float graph_width, const float graph_height)
static int	_add_node (dt_iop_colorequal_node_t *curve, int *nodes, const float x, const float y)
static gboolean	_move_selected_node (dt_iop_module_t *self, const dt_iop_colorequal_ring_t ring, const dt_iop_colorequal_channel_t channel, const int node, const float x, const float y)
static gboolean	_area_motion_notify_callback (GtkWidget *widget, GdkEventMotion *event, gpointer user_data)
static gboolean	_area_button_press_callback (GtkWidget *widget, GdkEventButton *event, gpointer user_data)
static gboolean	_area_button_release_callback (GtkWidget *widget, GdkEventButton *event, gpointer user_data)
static void	_channel_tabs_switch_callback (GtkNotebook *notebook, GtkWidget *page, guint page_num, gpointer user_data)
static void	_ring_tabs_switch_callback (GtkNotebook *notebook, GtkWidget *page, guint page_num, gpointer user_data)
int	mouse_moved (struct dt_iop_module_t *self, double x, double y, double pressure, int which)
int	mouse_leave (struct dt_iop_module_t *self)
int	button_pressed (struct dt_iop_module_t *self, double x, double y, double pressure, int which, int type, uint32_t state)
int	scrolled (struct dt_iop_module_t *self, double x, double y, int up, uint32_t state)
void	gui_post_expose (struct dt_iop_module_t *self, cairo_t *cr, int32_t width, int32_t height, int32_t pointerx, int32_t pointery)
static void	_pipe_rgb_to_Ych (dt_iop_module_t *self, dt_dev_pixelpipe_t *pipe, const dt_aligned_pixel_t RGB, dt_aligned_pixel_t Ych)
static void	_pipe_rgb_to_dt_ucs_hsb (dt_iop_module_t *self, dt_dev_pixelpipe_t *pipe, const dt_aligned_pixel_t RGB, dt_aligned_pixel_t HSB)
static void	_format_picker_brightness_position (const float brightness, char *text, const size_t size)
void	color_picker_apply (dt_iop_module_t *self, GtkWidget *picker, dt_dev_pixelpipe_t *pipe, dt_dev_pixelpipe_iop_t *piece)
void	autoset (struct dt_iop_module_t *self, const struct dt_dev_pixelpipe_t *pipe, const struct dt_dev_pixelpipe_iop_t *piece, const void *i)
void	gui_changed (dt_iop_module_t *self, GtkWidget *w, void *previous)
void	gui_update (dt_iop_module_t *self)
void	gui_focus (struct dt_iop_module_t *self, gboolean in)
void	gui_cleanup (dt_iop_module_t *self)
void	gui_init (dt_iop_module_t *self)
void	init_global (dt_iop_module_so_t *module)
void	cleanup_global (dt_iop_module_so_t *module)
void	init (dt_iop_module_t *module)

Macro Definition Documentation

DT_IOP_COLOREQUAL_AXIAL_SAMPLES

#define DT_IOP_COLOREQUAL_AXIAL_SAMPLES   64

Definition at line 70 of file colorequal.c.

DT_IOP_COLOREQUAL_AXIS_HEIGHT

#define DT_IOP_COLOREQUAL_AXIS_HEIGHT   DT_PIXEL_APPLY_DPI(14)

Definition at line 76 of file colorequal.c.

DT_IOP_COLOREQUAL_CLUT_LEVEL

#define DT_IOP_COLOREQUAL_CLUT_LEVEL   64

Definition at line 71 of file colorequal.c.

DT_IOP_COLOREQUAL_DEFAULT_NODES

#define DT_IOP_COLOREQUAL_DEFAULT_NODES   8

Definition at line 65 of file colorequal.c.

DT_IOP_COLOREQUAL_GRAPH_GRADIENTS

#define DT_IOP_COLOREQUAL_GRAPH_GRADIENTS   48

Definition at line 67 of file colorequal.c.

DT_IOP_COLOREQUAL_GRAPH_INSET

#define DT_IOP_COLOREQUAL_GRAPH_INSET   DT_PIXEL_APPLY_DPI(4)

Definition at line 75 of file colorequal.c.

DT_IOP_COLOREQUAL_GRAPH_RES

#define DT_IOP_COLOREQUAL_GRAPH_RES   360

Definition at line 66 of file colorequal.c.

DT_IOP_COLOREQUAL_HUE_SAMPLES

#define DT_IOP_COLOREQUAL_HUE_SAMPLES   64

Definition at line 68 of file colorequal.c.

DT_IOP_COLOREQUAL_LOCAL_FIELD_RINGS

#define DT_IOP_COLOREQUAL_LOCAL_FIELD_RINGS   (DT_IOP_COLOREQUAL_NUM_RINGS + 1)

Definition at line 72 of file colorequal.c.

DT_IOP_COLOREQUAL_MAXNODES

#define DT_IOP_COLOREQUAL_MAXNODES   20

Definition at line 64 of file colorequal.c.

DT_IOP_COLOREQUAL_MIN_X_DISTANCE

#define DT_IOP_COLOREQUAL_MIN_X_DISTANCE   0.01f

Definition at line 73 of file colorequal.c.

DT_IOP_COLOREQUAL_NUM_CHANNELS

#define DT_IOP_COLOREQUAL_NUM_CHANNELS   3

We keep the same GUI hue convention as the old prototype: the darktable UCS hue of sRGB red sits around +20 degrees, so the graph is shifted to place red at the left edge of the widget.

Definition at line 62 of file colorequal.c.

DT_IOP_COLOREQUAL_NUM_RINGS

#define DT_IOP_COLOREQUAL_NUM_RINGS   3

Definition at line 63 of file colorequal.c.

DT_IOP_COLOREQUAL_PREVIEW_CURSOR_RADIUS

#define DT_IOP_COLOREQUAL_PREVIEW_CURSOR_RADIUS   DT_PIXEL_APPLY_DPI(14.f)

Definition at line 74 of file colorequal.c.

DT_IOP_COLOREQUAL_SCROLL_HUE_STEP

#define DT_IOP_COLOREQUAL_SCROLL_HUE_STEP   (5.f * M_PI_F / 180.f)

Definition at line 81 of file colorequal.c.

DT_IOP_COLOREQUAL_SCROLL_HUE_STEP_COARSE

#define DT_IOP_COLOREQUAL_SCROLL_HUE_STEP_COARSE   (10.f * M_PI_F / 180.f)

Definition at line 83 of file colorequal.c.

DT_IOP_COLOREQUAL_SCROLL_HUE_STEP_FINE

#define DT_IOP_COLOREQUAL_SCROLL_HUE_STEP_FINE   (1.f * M_PI_F / 180.f)

Definition at line 82 of file colorequal.c.

DT_IOP_COLOREQUAL_SCROLL_SIGMA

#define DT_IOP_COLOREQUAL_SCROLL_SIGMA   2.f * M_PI_F / 128.f

Definition at line 77 of file colorequal.c.

DT_IOP_COLOREQUAL_SCROLL_STEP

#define DT_IOP_COLOREQUAL_SCROLL_STEP   0.05f

Definition at line 78 of file colorequal.c.

DT_IOP_COLOREQUAL_SCROLL_STEP_COARSE

#define DT_IOP_COLOREQUAL_SCROLL_STEP_COARSE   0.10f

Definition at line 80 of file colorequal.c.

DT_IOP_COLOREQUAL_SCROLL_STEP_FINE

#define DT_IOP_COLOREQUAL_SCROLL_STEP_FINE   0.02f

Definition at line 79 of file colorequal.c.

DT_IOP_COLOREQUAL_VIEWER_CONTROL_NODES

#define DT_IOP_COLOREQUAL_VIEWER_CONTROL_NODES   (DT_IOP_COLOREQUAL_NUM_RINGS * DT_IOP_COLOREQUAL_HUE_SAMPLES)

Definition at line 69 of file colorequal.c.

Typedef Documentation

dt_iop_colorequal_channel_t

typedef enum dt_iop_colorequal_channel_t dt_iop_colorequal_channel_t

dt_iop_colorequal_data_t

typedef struct dt_iop_colorequal_data_t dt_iop_colorequal_data_t

dt_iop_colorequal_global_data_t

typedef struct dt_iop_colorequal_global_data_t dt_iop_colorequal_global_data_t

dt_iop_colorequal_gui_data_t

typedef struct dt_iop_colorequal_gui_data_t dt_iop_colorequal_gui_data_t

dt_iop_colorequal_interpolation_t

typedef enum dt_iop_colorequal_interpolation_t dt_iop_colorequal_interpolation_t

dt_iop_colorequal_node_t

typedef struct dt_iop_colorequal_node_t dt_iop_colorequal_node_t

dt_iop_colorequal_params_t

typedef struct dt_iop_colorequal_params_t dt_iop_colorequal_params_t

dt_iop_colorequal_ring_t

typedef enum dt_iop_colorequal_ring_t dt_iop_colorequal_ring_t

Enumeration Type Documentation

dt_iop_colorequal_channel_t

enum dt_iop_colorequal_channel_t

Enumerator
DT_IOP_COLOREQUAL_SATURATION
DT_IOP_COLOREQUAL_HUE
DT_IOP_COLOREQUAL_BRIGHTNESS

Definition at line 87 of file colorequal.c.

dt_iop_colorequal_interpolation_t

enum dt_iop_colorequal_interpolation_t

Enumerator
DT_IOP_COLOREQUAL_TETRAHEDRAL
DT_IOP_COLOREQUAL_TRILINEAR
DT_IOP_COLOREQUAL_PYRAMID

Definition at line 101 of file colorequal.c.

dt_iop_colorequal_ring_t

enum dt_iop_colorequal_ring_t

Enumerator
DT_IOP_COLOREQUAL_RING_DARK
DT_IOP_COLOREQUAL_RING_MID
DT_IOP_COLOREQUAL_RING_LIGHT

Definition at line 94 of file colorequal.c.

Function Documentation

_active_channel_from_gui()

static dt_iop_colorequal_channel_t _active_channel_from_gui ( const dt_iop_colorequal_gui_data_t *  g, const dt_iop_colorequal_ring_t  ring  )

inlinestatic

Definition at line 368 of file colorequal.c.

References _channel_from_page(), dt_conf_get_int(), DT_IOP_COLOREQUAL_NUM_CHANNELS, and g.

Referenced by _cacheline_ready_callback(), _draw_curve(), _preview_cache_wait_restart(), _ring_tabs_switch_callback(), button_pressed(), gui_post_expose(), mouse_leave(), mouse_moved(), and scrolled().

_active_ring_from_gui()

static dt_iop_colorequal_ring_t _active_ring_from_gui ( const dt_iop_colorequal_gui_data_t *  g )

inlinestatic

Definition at line 360 of file colorequal.c.

References dt_conf_get_int(), DT_IOP_COLOREQUAL_NUM_RINGS, and g.

Referenced by _cacheline_ready_callback(), _draw_curve(), _preview_cache_wait_restart(), _ring_tabs_switch_callback(), button_pressed(), gui_post_expose(), mouse_leave(), mouse_moved(), and scrolled().

_add_node()

static int _add_node ( dt_iop_colorequal_node_t *  curve, int *  nodes, const float  x, const float  y  )

static

Definition at line 1397 of file colorequal.c.

References DT_IOP_COLOREQUAL_MIN_X_DISTANCE, k, x, dt_iop_colorequal_node_t::x, and dt_iop_colorequal_node_t::y.

Referenced by _area_button_press_callback(), and button_pressed().

_area_button_press_callback()

static gboolean _area_button_press_callback ( GtkWidget *  widget, GdkEventButton *  event, gpointer  user_data  )

static

Definition at line 1507 of file colorequal.c.

References _add_node(), _curve_nodes(), _curve_nodes_count(), _curve_nodes_count_const(), _find_selected_node(), _refresh_preview_cursor_sample(), d, dt_iop_module_t::default_params, dt_colorrings_curve_periodic_sample(), dt_control_queue_redraw_center(), dt_gui_throttle_queue(), DT_IOP_COLOREQUAL_AXIS_HEIGHT, DT_IOP_COLOREQUAL_GRAPH_INSET, DT_IOP_COLOREQUAL_MAXNODES, dt_iop_throttled_history_update(), dt_modifier_is(), FALSE, g, dt_iop_module_t::gui_data, k, p, dt_iop_module_t::params, and TRUE.

Referenced by gui_init().

_area_button_release_callback()

static gboolean _area_button_release_callback ( GtkWidget *  widget, GdkEventButton *  event, gpointer  user_data  )

static

Curve drags are throttled while the pointer moves, but the final pointer release must always commit the last state to history so the pixelpipes recompute even if another GUI refresh happens before the throttle timer expires.

Definition at line 1603 of file colorequal.c.

References dt_gui_throttle_cancel(), dt_iop_throttled_history_update(), FALSE, g, dt_iop_module_t::gui_data, and TRUE.

Referenced by gui_init().

_area_motion_notify_callback()

static gboolean _area_motion_notify_callback ( GtkWidget *  widget, GdkEventMotion *  event, gpointer  user_data  )

static

Definition at line 1464 of file colorequal.c.

References _find_selected_node(), _move_selected_node(), _refresh_preview_cursor_sample(), dt_control_queue_redraw_center(), dt_gui_throttle_queue(), DT_IOP_COLOREQUAL_AXIS_HEIGHT, DT_IOP_COLOREQUAL_GRAPH_INSET, dt_iop_throttled_history_update(), FALSE, g, dt_iop_module_t::gui_data, dt_iop_module_t::params, and TRUE.

Referenced by gui_init().

_build_clut()

static void _build_clut ( dt_iop_colorequal_data_t *  d, const dt_iop_colorequal_params_t *  p, const dt_iop_order_iccprofile_info_t *  lut_profile  )

static

Build a procedural RGB CLUT from the three dt UCS HSB hue rings.

The editable control surface lives in dt UCS HSB because it gives uniform hue, saturation and brightness handles in the GUI. The CLUT itself however is authored in HLG Rec2020 code values, so the LUT generation never leaves those coordinates once the sparse before -> after ring samples have been turned into Rec2020 HLG RGB anchors.

The deformation model is:

• black and white stay fixed,
• each CLUT lattice point is first interpreted in dt UCS HSB only to know which ring displacement to sample from the user controls,
• that sampled ring displacement is then applied as a local 3D scale and rotation around the neutral point of the same dt UCS brightness, in HLG Rec2020 code coordinates,
• every dense lattice point is finally projected back to the RGB cube shell when needed, so the authored LUT itself never carries out-of-gamut values.

This avoids assuming that the dt UCS hue rings become flat slices orthogonal to the RGB diagonal once projected into the LUT profile.

Sample every ring on 64 evenly-spaced hue positions. Those samples are the sparse control surface the user actually edits: one in-gamut source ring and one deformed destination ring, both expressed in the current work RGB.

The user edits hue and saturation in dt UCS HSB, so the local field must preserve that semantic separation in work RGB too:

• hue rotations are explicit angular edits and must not contract chroma just because target hues sit at a different radius in the RGB cube,
• saturation edits are the only thing allowed to scale chroma,
• brightness edits are carried by the achromatic-axis shift measured on the projected work-RGB anchors.

When saturation expands beyond the cube shell, clamp the requested scale to the actually projected anchor so the sparse ring samples stay inside gamut.

The local field is evaluated in LUT code coordinates, so the smoothing sigmas belong to that geometry too:

• sigma_L is exposed as a percentage of the normalized achromatic-axis length because that is easier to reason about in the GUI,
• sigma_rho is the radial support around the neutral axis,
• sigma_theta controls how many neighbouring hue anchors contribute to a query point on the ring,
• neutral_protection defines how wide the fade-to-zero region is around the achromatic axis before color shifts reach full strength.

Definition at line 539 of file colorequal.c.

References _channel_value_from_y(), _curve_nodes_const(), _curve_nodes_count_const(), d, darktable, dt_alloc_align_float(), dt_colorrings_brightness_to_axis_rgb(), dt_colorrings_compute_reference_saturations(), dt_colorrings_curve_periodic_sample(), dt_colorrings_curve_x_to_hue(), dt_colorrings_fill_lut_local_field(), dt_colorrings_graph_white(), dt_colorrings_hsb_to_profile_rgb(), dt_colorrings_project_to_cube_shell(), dt_colorrings_rgb_to_gray_cyl(), dt_colorrings_ring_brightness(), dt_colorrings_wrap_hue_pi(), dt_colorrings_wrap_pi(), DT_DEBUG_PERF, dt_get_wtime(), DT_IOP_COLOREQUAL_BRIGHTNESS, DT_IOP_COLOREQUAL_CLUT_LEVEL, DT_IOP_COLOREQUAL_HUE, DT_IOP_COLOREQUAL_HUE_SAMPLES, DT_IOP_COLOREQUAL_LOCAL_FIELD_RINGS, DT_IOP_COLOREQUAL_NUM_RINGS, DT_IOP_COLOREQUAL_SATURATION, dt_print(), IS_NULL_PTR, p, darktable_t::unmuted, value, and x.

Referenced by _update_gui_lut_cache(), and commit_params().

_build_viewer_control_nodes()

static size_t _build_viewer_control_nodes ( const dt_iop_colorequal_params_t *  p, const dt_iop_order_iccprofile_info_t *  lut_profile, dt_lut_viewer_control_node_t *  control_nodes  )

static

The LUT viewer should display the same sparse control surface the local field actually interpolates. Rebuild the ring samples here from the GUI curves so the control-node overlay matches the authored RGB anchors exactly, not just the user-visible spline control points.

Definition at line 679 of file colorequal.c.

References _channel_value_from_y(), _curve_nodes_const(), _curve_nodes_count_const(), dt_colorrings_brightness_to_axis_rgb(), dt_colorrings_compute_reference_saturations(), dt_colorrings_curve_periodic_sample(), dt_colorrings_curve_x_to_hue(), dt_colorrings_graph_white(), dt_colorrings_hsb_to_profile_rgb(), dt_colorrings_project_to_cube_shell(), dt_colorrings_ring_brightness(), dt_colorrings_wrap_hue_pi(), DT_IOP_COLOREQUAL_BRIGHTNESS, DT_IOP_COLOREQUAL_HUE, DT_IOP_COLOREQUAL_HUE_SAMPLES, DT_IOP_COLOREQUAL_NUM_RINGS, DT_IOP_COLOREQUAL_SATURATION, dt_lut_viewer_control_node_t::input_rgb, IS_NULL_PTR, dt_lut_viewer_control_node_t::output_rgb, p, and x.

Referenced by _update_gui_lut_cache().

_cacheline_ready_callback()

static void _cacheline_ready_callback ( gpointer  instance, const guint64  hash, gpointer  user_data  )

static

Definition at line 1341 of file colorequal.c.

References _active_channel_from_gui(), _active_ring_from_gui(), _refresh_preview_cursor_sample(), dt_control_queue_redraw_center(), g, dt_iop_module_t::gui_data, and void().

Referenced by gui_cleanup(), and gui_focus().

_channel_from_page()

static dt_iop_colorequal_channel_t _channel_from_page ( const int  page )

inlinestatic

Definition at line 346 of file colorequal.c.

References DT_IOP_COLOREQUAL_BRIGHTNESS, DT_IOP_COLOREQUAL_HUE, DT_IOP_COLOREQUAL_NUM_CHANNELS, and DT_IOP_COLOREQUAL_SATURATION.

Referenced by _active_channel_from_gui().

_channel_tabs_switch_callback()

static void _channel_tabs_switch_callback ( GtkNotebook *  notebook, GtkWidget *  page, guint  page_num, gpointer  user_data  )

static

Definition at line 1632 of file colorequal.c.

References darktable, dt_conf_set_int(), dt_control_queue_redraw_center(), DT_IOP_COLOREQUAL_NUM_CHANNELS, DT_IOP_COLOREQUAL_NUM_RINGS, g, darktable_t::gui, dt_iop_module_t::gui_data, and dt_gui_gtk_t::reset.

Referenced by gui_init().

_channel_value_from_y()

static float _channel_value_from_y ( const dt_iop_colorequal_channel_t  channel, const float  y  )

inlinestatic

Definition at line 240 of file colorequal.c.

References DT_IOP_COLOREQUAL_BRIGHTNESS, DT_IOP_COLOREQUAL_HUE, DT_IOP_COLOREQUAL_SATURATION, and M_PI_F.

Referenced by _build_clut(), _build_viewer_control_nodes(), _cursor_curve_state(), _graph_background_hsb(), and scrolled().

_channel_y_from_value()

static float _channel_y_from_value ( const dt_iop_colorequal_channel_t  channel, const float  value  )

inlinestatic

Definition at line 253 of file colorequal.c.

References DT_IOP_COLOREQUAL_BRIGHTNESS, DT_IOP_COLOREQUAL_HUE, DT_IOP_COLOREQUAL_SATURATION, M_PI_F, and value.

Referenced by scrolled().

_clamp_display_rgb()

static void _clamp_display_rgb ( dt_aligned_pixel_t  RGB )

inlinestatic

Definition at line 419 of file colorequal.c.

References RGB.

Referenced by _work_rgb_to_display_rgb().

_cursor_curve_state()

static gboolean _cursor_curve_state ( const dt_iop_colorequal_params_t *  p, const dt_iop_colorequal_ring_t  ring, const dt_iop_colorequal_channel_t  channel, const float  hue, float *  curve_x, float *  curve_y, float *  offset_normalized  )

inlinestatic

Definition at line 384 of file colorequal.c.

References _channel_value_from_y(), _curve_nodes_const(), _curve_nodes_count_const(), dt_colorrings_curve_periodic_sample(), dt_colorrings_hue_to_curve_x(), DT_IOP_COLOREQUAL_BRIGHTNESS, DT_IOP_COLOREQUAL_HUE, DT_IOP_COLOREQUAL_SATURATION, FALSE, IS_NULL_PTR, M_PI_F, p, TRUE, value, and x.

Referenced by _draw_curve(), and gui_post_expose().

_curve_fields_equal()

static gboolean _curve_fields_equal ( const dt_iop_colorequal_params_t *const  a, const dt_iop_colorequal_params_t *const  b  )

inlinestatic

Definition at line 326 of file colorequal.c.

References dt_iop_colorequal_params_t::curve, and dt_iop_colorequal_params_t::curve_num_nodes.

Referenced by _draw_curve(), _lut_fields_equal(), and gui_changed().

_curve_nodes()

static dt_iop_colorequal_node_t * _curve_nodes ( dt_iop_colorequal_params_t *  p, const dt_iop_colorequal_ring_t  ring, const dt_iop_colorequal_channel_t  channel  )

inlinestatic

Definition at line 280 of file colorequal.c.

References p.

Referenced by _area_button_press_callback(), _move_selected_node(), _reset_channel_nodes(), button_pressed(), and scrolled().

_curve_nodes_const()

static const dt_iop_colorequal_node_t * _curve_nodes_const ( const dt_iop_colorequal_params_t *  p, const dt_iop_colorequal_ring_t  ring, const dt_iop_colorequal_channel_t  channel  )

inlinestatic

Definition at line 287 of file colorequal.c.

References p.

Referenced by _build_clut(), _build_viewer_control_nodes(), _cursor_curve_state(), _draw_curve(), _find_selected_node(), and _update_curve_cache().

_curve_nodes_count()

static int * _curve_nodes_count ( dt_iop_colorequal_params_t *  p, const dt_iop_colorequal_ring_t  ring, const dt_iop_colorequal_channel_t  channel  )

inlinestatic

Definition at line 294 of file colorequal.c.

References p.

Referenced by _area_button_press_callback(), _reset_channel_nodes(), and button_pressed().

_curve_nodes_count_const()

static int _curve_nodes_count_const ( const dt_iop_colorequal_params_t *  p, const dt_iop_colorequal_ring_t  ring, const dt_iop_colorequal_channel_t  channel  )

inlinestatic

Definition at line 300 of file colorequal.c.

References p.

Referenced by _area_button_press_callback(), _build_clut(), _build_viewer_control_nodes(), _cursor_curve_state(), _draw_curve(), _find_selected_node(), _move_selected_node(), _update_curve_cache(), and scrolled().

_curve_periodic_distance()

static float _curve_periodic_distance ( const float  x0, const float  x1  )

inlinestatic

Definition at line 340 of file colorequal.c.

Referenced by scrolled().

_draw_curve()

static gboolean _draw_curve ( GtkWidget *  widget, cairo_t *  crf, gpointer  user_data  )

static

Hue backgrounds need to keep the ring lightness cue readable across the three tabs. Pushing their saturation beyond the in-gamut reference sends more hues into the display normalization path, which flattens the intended 15/45/75% brightness separation. Keep the hue tab on the reference ring and only boost the other channels for contrast.

Definition at line 1121 of file colorequal.c.

References _active_channel_from_gui(), _active_ring_from_gui(), _cursor_curve_state(), _curve_fields_equal(), _curve_nodes_const(), _curve_nodes_count_const(), _draw_graph_background(), _update_curve_cache(), darktable_t::bauhaus, darktable, dt_iop_module_t::dev, dt_cairo_image_surface_create(), dt_colorrings_compute_reference_saturations(), dt_colorrings_curve_x_to_hue(), dt_colorrings_graph_white(), dt_colorrings_hsb_to_display_rgb(), dt_colorrings_hue_to_curve_x(), dt_colorrings_ring_brightness(), dt_draw_grid(), DT_IOP_COLOREQUAL_AXIS_HEIGHT, DT_IOP_COLOREQUAL_GRAPH_INSET, DT_IOP_COLOREQUAL_GRAPH_RES, DT_IOP_COLOREQUAL_HUE, dt_ioppr_get_pipe_output_profile_info(), DT_PIXEL_APPLY_DPI, g, dt_bauhaus_t::graph_bg, dt_bauhaus_t::graph_border, dt_bauhaus_t::graph_fg, dt_iop_module_t::gui_data, k, M_PI_F, p, dt_develop_t::preview_pipe, RGB, set_color(), TRUE, x, dt_iop_colorequal_node_t::x, and dt_iop_colorequal_node_t::y.

Referenced by gui_init().

_draw_graph_background()

static void _draw_graph_background ( cairo_t *  cr, const dt_iop_colorequal_channel_t  channel, const dt_iop_colorequal_ring_t  ring, const float  graph_width, const float  graph_height, const float  white, const float  reference_saturation, const dt_iop_order_iccprofile_info_t *  display_profile  )

static

Definition at line 1078 of file colorequal.c.

References __OMP_PARALLEL_FOR__, _graph_background_hsb(), colors, dt_alloc_align_float(), dt_colorrings_hsb_to_display_rgb(), dt_colorrings_ring_brightness(), dt_free_align, DT_IOP_COLOREQUAL_GRAPH_GRADIENTS, DT_IOP_COLOREQUAL_GRAPH_RES, k, and x.

Referenced by _draw_curve().

_find_selected_node()

static int _find_selected_node ( const dt_iop_module_t *  self, const dt_iop_colorequal_ring_t  ring, const dt_iop_colorequal_channel_t  channel, const float  mouse_x, const float  mouse_y, const float  graph_width, const float  graph_height  )

static

Definition at line 1368 of file colorequal.c.

References _curve_nodes_const(), _curve_nodes_count_const(), DT_PIXEL_APPLY_DPI, g, dt_iop_module_t::gui_data, k, p, dt_iop_colorequal_node_t::x, and dt_iop_colorequal_node_t::y.

Referenced by _area_button_press_callback(), and _area_motion_notify_callback().

_format_picker_brightness_position()

static void _format_picker_brightness_position ( const float  brightness, char *  text, const size_t  size  )

static

The module-level picker reports where the sampled dt UCS brightness sits between the three editable rings, using the same fixed ring boundaries as the control surface. This gives users an immediate reading of which graph pair will mostly influence the picked color.

Definition at line 2081 of file colorequal.c.

References size, and t.

Referenced by color_picker_apply().

_graph_background_hsb()

static void _graph_background_hsb ( const dt_iop_colorequal_channel_t  channel, const float  x, const float  y, const float  ring_brightness, const float  reference_saturation, dt_aligned_pixel_t  HSB  )

inlinestatic

Definition at line 1051 of file colorequal.c.

References _channel_value_from_y(), dt_colorrings_curve_x_to_hue(), dt_colorrings_wrap_hue_pi(), DT_IOP_COLOREQUAL_BRIGHTNESS, DT_IOP_COLOREQUAL_HUE, DT_IOP_COLOREQUAL_SATURATION, and x.

Referenced by _draw_graph_background().

_init_default_curves()

static void _init_default_curves ( dt_iop_colorequal_params_t *  p )

static

Definition at line 319 of file colorequal.c.

References _reset_channel_nodes(), ch, DT_IOP_COLOREQUAL_NUM_CHANNELS, DT_IOP_COLOREQUAL_NUM_RINGS, and p.

Referenced by init().

_invalidate_preview_cursor()

static void _invalidate_preview_cursor ( dt_iop_colorequal_gui_data_t *  g )

inlinestatic

Definition at line 376 of file colorequal.c.

References FALSE, and g.

Referenced by _refresh_preview_cursor_sample(), mouse_leave(), and mouse_moved().

_lut_fields_equal()

static gboolean _lut_fields_equal ( const dt_iop_colorequal_params_t *const  a, const dt_iop_colorequal_params_t *const  b  )

inlinestatic

Definition at line 333 of file colorequal.c.

References _curve_fields_equal(), dt_iop_colorequal_params_t::neutral_protection, dt_iop_colorequal_params_t::sigma_L, dt_iop_colorequal_params_t::sigma_rho, and dt_iop_colorequal_params_t::sigma_theta.

Referenced by _update_gui_lut_cache(), and commit_params().

_mix_rgb_anchors()

static void _mix_rgb_anchors ( const dt_aligned_pixel_t  low, const dt_aligned_pixel_t  high, const float  mix, dt_aligned_pixel_t  RGB  )

inlinestatic

Definition at line 450 of file colorequal.c.

References mix(), and RGB.

Referenced by _sample_ring_anchor().

_move_selected_node()

static gboolean _move_selected_node ( dt_iop_module_t *  self, const dt_iop_colorequal_ring_t  ring, const dt_iop_colorequal_channel_t  channel, const int  node, const float  x, const float  y  )

static

Definition at line 1431 of file colorequal.c.

References _curve_nodes(), _curve_nodes_count_const(), DT_IOP_COLOREQUAL_MIN_X_DISTANCE, FALSE, g, dt_iop_module_t::gui_data, p, TRUE, x, dt_iop_colorequal_node_t::x, and dt_iop_colorequal_node_t::y.

Referenced by _area_motion_notify_callback().

_pipe_rgb_to_dt_ucs_hsb()

static void _pipe_rgb_to_dt_ucs_hsb ( dt_iop_module_t *  self, dt_dev_pixelpipe_t *  pipe, const dt_aligned_pixel_t  RGB, dt_aligned_pixel_t  HSB  )

static

Definition at line 1934 of file colorequal.c.

References dt_colorrings_graph_white(), dt_colorrings_profile_rgb_to_dt_ucs_hsb(), dt_ioppr_get_pipe_current_profile_info(), IS_NULL_PTR, and RGB.

Referenced by _refresh_preview_cursor_sample(), and color_picker_apply().

_pipe_rgb_to_Ych()

static void _pipe_rgb_to_Ych ( dt_iop_module_t *  self, dt_dev_pixelpipe_t *  pipe, const dt_aligned_pixel_t  RGB, dt_aligned_pixel_t  Ych  )

static

Definition at line 1926 of file colorequal.c.

References dt_colorrings_profile_rgb_to_Ych(), dt_ioppr_get_pipe_current_profile_info(), IS_NULL_PTR, and RGB.

Referenced by color_picker_apply().

_preview_cache_wait_restart()

static void _preview_cache_wait_restart ( gpointer  user_data )

static

Definition at line 1354 of file colorequal.c.

References _active_channel_from_gui(), _active_ring_from_gui(), _refresh_preview_cursor_sample(), dt_control_queue_redraw_center(), g, dt_iop_module_t::gui_data, and IS_NULL_PTR.

Referenced by _refresh_preview_cursor_sample().

_refresh_preview_cursor_sample()

static gboolean _refresh_preview_cursor_sample ( dt_iop_module_t *  self )

static

Definition at line 1975 of file colorequal.c.

References _invalidate_preview_cursor(), _pipe_rgb_to_dt_ucs_hsb(), _preview_cache_wait_restart(), _work_rgb_to_display_rgb(), dt_dev_pixelpipe_iop_t::buf_out, dt_iop_buffer_dsc_t::channels, darktable, dt_iop_buffer_dsc_t::datatype, dt_iop_module_t::dev, dt_dev_pixelpipe_iop_t::dsc_out, dt_colorrings_apply_rgb_lut(), dt_colorrings_project_to_cube_shell(), dt_colorrings_wrap_hue_pi(), dt_dev_coordinates_preview_abs_to_image_norm(), dt_dev_pixelpipe_cache_peek_gui(), dt_dev_pixelpipe_cache_rdlock_entry(), dt_dev_pixelpipe_cache_ref_count_entry(), dt_dev_pixelpipe_cache_wait_cleanup(), dt_dev_pixelpipe_cache_wait_set_owner(), dt_dev_pixelpipe_get_module_piece(), dt_dev_pixelpipe_get_prev_enabled_piece(), dt_dev_pixelpipe_update_history_preview, dt_ioppr_get_pipe_current_profile_info(), DT_PIXELPIPE_CACHE_HASH_INVALID, dt_iop_module_t::enabled, FALSE, g, dt_iop_module_t::global_data, dt_dev_pixelpipe_iop_t::global_hash, dt_iop_module_t::gui_data, dt_iop_roi_t::height, IS_NULL_PTR, dt_iop_colorequal_global_data_t::lock, neutral, darktable_t::pixelpipe_cache, dt_develop_t::preview_pipe, dt_dev_pixelpipe_t::processing, dt_dev_pixelpipe_iop_t::roi_out, TRUE, TYPE_FLOAT, dt_iop_roi_t::width, dt_iop_roi_t::x, and dt_iop_roi_t::y.

Referenced by _area_button_press_callback(), _area_motion_notify_callback(), _cacheline_ready_callback(), _preview_cache_wait_restart(), button_pressed(), gui_focus(), gui_post_expose(), mouse_moved(), and scrolled().

_reset_channel_nodes()

static void _reset_channel_nodes ( dt_iop_colorequal_params_t *  p, const dt_iop_colorequal_ring_t  ring, const dt_iop_colorequal_channel_t  channel  )

static

Definition at line 307 of file colorequal.c.

References _curve_nodes(), _curve_nodes_count(), DT_IOP_COLOREQUAL_DEFAULT_NODES, k, p, dt_iop_colorequal_node_t::x, and dt_iop_colorequal_node_t::y.

Referenced by _init_default_curves().

_ring_label()

static const char * _ring_label ( const dt_iop_colorequal_ring_t  ring )

inlinestatic

Definition at line 266 of file colorequal.c.

References DT_IOP_COLOREQUAL_RING_DARK, DT_IOP_COLOREQUAL_RING_LIGHT, and DT_IOP_COLOREQUAL_RING_MID.

Referenced by gui_init().

_ring_tabs_switch_callback()

static void _ring_tabs_switch_callback ( GtkNotebook *  notebook, GtkWidget *  page, guint  page_num, gpointer  user_data  )

static

Definition at line 1658 of file colorequal.c.

References _active_channel_from_gui(), _active_ring_from_gui(), darktable, dt_conf_set_int(), dt_control_queue_redraw_center(), DT_IOP_COLOREQUAL_NUM_CHANNELS, DT_IOP_COLOREQUAL_NUM_RINGS, g, darktable_t::gui, dt_iop_module_t::gui_data, and dt_gui_gtk_t::reset.

Referenced by gui_init().

_sample_ring_anchor()

static void _sample_ring_anchor ( const float  ring_surface[3][64][3], const float  brightness, const float  hue_position, const float  white, const dt_iop_order_iccprofile_info_t *const  profile, dt_aligned_pixel_t  RGB  )

inlinestatic

The editable hue rings are defined in dt UCS HSB brightness. We therefore sample them by that same brightness coordinate when extending the sparse ring displacements to the full RGB cube. Black and white stay fixed and provide the boundary conditions of the interpolation.

Definition at line 477 of file colorequal.c.

References _mix_rgb_anchors(), _sample_ring_hue(), dt_colorrings_brightness_to_axis_rgb(), dt_colorrings_ring_brightness(), DT_IOP_COLOREQUAL_NUM_RINGS, DT_IOP_COLOREQUAL_RING_DARK, DT_IOP_COLOREQUAL_RING_LIGHT, DT_IOP_COLOREQUAL_RING_MID, mix(), and RGB.

_sample_ring_hue()

static void _sample_ring_hue ( const float  ring_surface[3][64][3], const int  ring, const float  hue_position, dt_aligned_pixel_t  RGB  )

inlinestatic

Definition at line 457 of file colorequal.c.

References dt_colorrings_wrap_hue_2pi(), DT_IOP_COLOREQUAL_HUE_SAMPLES, M_PI_F, mix(), and RGB.

Referenced by _sample_ring_anchor().

_switch_preview_cursor()

static void _switch_preview_cursor ( dt_iop_module_t *  self )

static

Definition at line 1942 of file colorequal.c.

References darktable_t::control, darktable, dt_iop_module_t::dev, dt_control_hinter_message(), dt_control_queue_cursor_by_name(), dt_control_set_cursor_visible, dt_iop_color_picker_is_visible(), dt_ui_main_window(), dt_iop_module_t::enabled, FALSE, g, darktable_t::gui, dt_iop_module_t::gui_data, dt_develop_t::preview_pipe, dt_dev_pixelpipe_t::processing, TRUE, and dt_gui_gtk_t::ui.

Referenced by gui_focus(), mouse_leave(), and mouse_moved().

_update_curve_cache()

static void _update_curve_cache ( dt_iop_colorequal_gui_data_t *  g, const dt_iop_colorequal_params_t *  p  )

static

Definition at line 1014 of file colorequal.c.

References _curve_nodes_const(), _curve_nodes_count_const(), ch, darktable, DT_DEBUG_PERF, dt_draw_curve_add_point(), dt_draw_curve_calc_values_V2(), dt_draw_curve_destroy(), dt_draw_curve_new(), dt_draw_curve_set_point(), dt_get_wtime(), DT_IOP_COLOREQUAL_GRAPH_RES, DT_IOP_COLOREQUAL_NUM_CHANNELS, DT_IOP_COLOREQUAL_NUM_RINGS, dt_print(), g, k, MONOTONE_HERMITE, p, TRUE, darktable_t::unmuted, dt_iop_colorequal_node_t::x, and dt_iop_colorequal_node_t::y.

Referenced by _draw_curve().

_update_gui_lut_cache()

static void _update_gui_lut_cache ( dt_iop_module_t *  self )

static

The authoritative CLUT lives in module-global data so pixelpipes and the GUI can reuse the same build. The viewer only receives that shared pointer plus the global read/write lock, which lets it read safely while the cache is rebuilt on parameter changes.

Definition at line 948 of file colorequal.c.

References _build_clut(), _build_viewer_control_nodes(), _lut_fields_equal(), dt_iop_colorequal_global_data_t::cache, dt_iop_colorequal_global_data_t::cache_generation, dt_iop_colorequal_global_data_t::cache_valid, dt_iop_colorequal_data_t::clut, dt_iop_colorequal_data_t::clut_level, darktable, dt_iop_module_t::dev, DT_COLORSPACE_HLG_REC2020, DT_DEBUG_PERF, dt_get_wtime(), DT_INTENT_PERCEPTUAL, dt_ioppr_add_profile_info_to_list(), dt_ioppr_get_pipe_output_profile_info(), dt_lut_viewer_queue_draw(), dt_lut_viewer_set_control_nodes(), dt_lut_viewer_set_lut(), dt_print(), dt_pthread_rwlock_rdlock, dt_pthread_rwlock_unlock, dt_pthread_rwlock_wrlock, dt_iop_module_t::enabled, FALSE, g, dt_iop_module_t::global_data, dt_iop_module_t::gui_data, IS_NULL_PTR, dt_iop_colorequal_global_data_t::lock, p, dt_iop_module_t::params, dt_iop_colorequal_global_data_t::params, dt_develop_t::preview_pipe, dt_iop_colorequal_data_t::reference_saturation, TRUE, and darktable_t::unmuted.

Referenced by commit_params().

_work_rgb_to_display_rgb()

static void _work_rgb_to_display_rgb ( dt_iop_module_t *  self, dt_dev_pixelpipe_t *  pipe, const dt_aligned_pixel_t  work_rgb, dt_aligned_pixel_t  display_rgb  )

static

Definition at line 427 of file colorequal.c.

References _clamp_display_rgb(), dt_ioppr_get_pipe_current_profile_info(), dt_ioppr_get_pipe_output_profile_info(), dt_ioppr_transform_image_colorspace_rgb(), IS_NULL_PTR, and out.

Referenced by _refresh_preview_cursor_sample().

aliases()

const char * aliases

(

)

Definition at line 208 of file colorequal.c.

autoset()

void autoset	(	struct dt_iop_module_t *	self,
		const struct dt_dev_pixelpipe_t *	pipe,
		const struct dt_dev_pixelpipe_iop_t *	piece,
		const void *	i
	)

Definition at line 2173 of file colorequal.c.

References __OMP_PARALLEL_FOR__, dt_iop_buffer_dsc_t::channels, dt_dev_pixelpipe_iop_t::dsc_in, dt_colorrings_profile_rgb_to_Ych(), dt_ioppr_get_pipe_current_profile_info(), g, dt_iop_module_t::gui_data, dt_iop_roi_t::height, i, IS_NULL_PTR, k, max, p, dt_iop_module_t::params, dt_dev_pixelpipe_iop_t::roi_out, and dt_iop_roi_t::width.

button_pressed()

int button_pressed	(	struct dt_iop_module_t *	self,
		double	x,
		double	y,
		double	pressure,
		int	which,
		int	type,
		uint32_t	state
	)

Definition at line 1749 of file colorequal.c.

References _active_channel_from_gui(), _active_ring_from_gui(), _add_node(), _curve_nodes(), _curve_nodes_count(), _refresh_preview_cursor_sample(), darktable, dt_iop_module_t::dev, darktable_t::develop, dt_colorrings_curve_periodic_sample(), dt_colorrings_hue_to_curve_x(), dt_control_queue_redraw_center(), dt_dev_add_history_item, dt_iop_color_picker_is_visible(), DT_IOP_COLOREQUAL_MAXNODES, dt_iop_module_t::enabled, FALSE, g, dt_iop_module_t::gui_data, dt_iop_module_t::off, dt_iop_module_t::params, and TRUE.

cleanup_global()

void cleanup_global

(

dt_iop_module_so_t *

module

)

Definition at line 2461 of file colorequal.c.

References dt_iop_colorequal_global_data_t::cache, dt_iop_colorequal_data_t::clut, dt_iop_module_so_t::data, dt_free, dt_free_align, dt_opencl_free_kernel(), dt_pthread_rwlock_destroy, dt_iop_colorequal_global_data_t::kernel_exposure, dt_iop_colorequal_global_data_t::kernel_lut3d_pyramid, dt_iop_colorequal_global_data_t::kernel_lut3d_tetrahedral, dt_iop_colorequal_global_data_t::kernel_lut3d_trilinear, and dt_iop_colorequal_global_data_t::lock.

cleanup_pipe()

void cleanup_pipe	(	struct dt_iop_module_t *	self,
		dt_dev_pixelpipe_t *	pipe,
		dt_dev_pixelpipe_iop_t *	piece
	)

Definition at line 806 of file colorequal.c.

References d, dt_dev_pixelpipe_iop_t::data, and dt_free_align.

color_picker_apply()

void color_picker_apply	(	dt_iop_module_t *	self,
		GtkWidget *	picker,
		dt_dev_pixelpipe_t *	pipe,
		dt_dev_pixelpipe_iop_t *	piece
	)

The pipe sample is scene-linear working RGB and may be negative or far above diffuse white. The GUI rings however live on bounded dt UCS hue rings derived from RGB code values in [0, 1]. Project the normalized sample back to the RGB cube shell before converting it to dt UCS HSB so the marker reports where that color sits in the editable control space.

Definition at line 2105 of file colorequal.c.

References _format_picker_brightness_position(), _pipe_rgb_to_dt_ucs_hsb(), _pipe_rgb_to_Ych(), ch, darktable, darktable_t::develop, dt_bauhaus_slider_set(), dt_colorrings_project_to_cube_shell(), dt_colorrings_wrap_hue_pi(), dt_dev_add_history_item, DT_IOP_COLOREQUAL_NUM_CHANNELS, DT_IOP_COLOREQUAL_NUM_RINGS, FALSE, g, darktable_t::gui, dt_iop_module_t::gui_data, neutral, p, dt_iop_module_t::params, dt_iop_module_t::picked_color, dt_iop_module_t::picked_color_max, dt_iop_module_t::picked_color_min, dt_gui_gtk_t::reset, RGB, and TRUE.

commit_params()

void commit_params	(	struct dt_iop_module_t *	self,
		dt_iop_params_t *	p1,
		dt_dev_pixelpipe_t *	pipe,
		dt_dev_pixelpipe_iop_t *	piece
	)

Definition at line 749 of file colorequal.c.

References _build_clut(), _lut_fields_equal(), _update_gui_lut_cache(), dt_iop_colorequal_global_data_t::cache, dt_iop_colorequal_global_data_t::cache_generation, dt_iop_colorequal_global_data_t::cache_valid, dt_iop_colorequal_data_t::clut, dt_iop_colorequal_data_t::clut_level, d, dt_dev_pixelpipe_iop_t::data, dt_iop_module_t::dev, DT_COLORSPACE_HLG_REC2020, DT_INTENT_PERCEPTUAL, dt_ioppr_add_profile_info_to_list(), dt_ioppr_get_pipe_current_profile_info(), DT_LUT3D_INTERP_TETRAHEDRAL, dt_pthread_rwlock_unlock, dt_pthread_rwlock_wrlock, g, dt_iop_module_t::global_data, dt_iop_module_t::gui_data, IS_NULL_PTR, dt_iop_colorequal_global_data_t::lock, p, dt_iop_colorequal_global_data_t::params, dt_iop_colorequal_data_t::reference_saturation, and TRUE.

default_colorspace()

int default_colorspace	(	dt_iop_module_t *	self,
		dt_dev_pixelpipe_t *	pipe,
		const dt_dev_pixelpipe_iop_t *	piece
	)

Definition at line 230 of file colorequal.c.

References IOP_CS_RGB.

default_group()

int default_group

(

)

Definition at line 220 of file colorequal.c.

References IOP_GROUP_COLOR.

description()

const char ** description

(

struct dt_iop_module_t *

self

)

Definition at line 213 of file colorequal.c.

References dt_iop_set_description().

flags()

int flags

(

)

Definition at line 225 of file colorequal.c.

References IOP_FLAGS_INCLUDE_IN_STYLES, and IOP_FLAGS_SUPPORTS_BLENDING.

gui_changed()

void gui_changed	(	dt_iop_module_t *	self,
		GtkWidget *	w,
		void *	previous
	)

Definition at line 2199 of file colorequal.c.

References _curve_fields_equal(), ch, dt_control_queue_redraw_center(), DT_IOP_COLOREQUAL_NUM_CHANNELS, DT_IOP_COLOREQUAL_NUM_RINGS, FALSE, g, dt_iop_module_t::gui_data, p, and dt_iop_module_t::params.

Referenced by gui_update().

gui_cleanup()

void gui_cleanup

(

dt_iop_module_t *

self

)

Definition at line 2259 of file colorequal.c.

References _cacheline_ready_callback(), ch, darktable, dt_conf_set_int(), DT_DEBUG_CONTROL_SIGNAL_DISCONNECT, dt_dev_pixelpipe_cache_wait_cleanup(), dt_draw_curve_destroy(), dt_gui_throttle_cancel(), DT_IOP_COLOREQUAL_NUM_CHANNELS, DT_IOP_COLOREQUAL_NUM_RINGS, dt_lut_viewer_destroy(), DT_REQUEST_COLORPICK_OFF, FALSE, g, dt_iop_module_t::gui_data, IOP_GUI_FREE, dt_iop_module_t::request_color_pick, and darktable_t::signals.

gui_focus()

void gui_focus	(	struct dt_iop_module_t *	self,
		gboolean	in
	)

Definition at line 2230 of file colorequal.c.

References _cacheline_ready_callback(), _refresh_preview_cursor_sample(), _switch_preview_cursor(), darktable, dt_iop_module_t::dev, dt_control_queue_redraw_center(), DT_DEBUG_CONTROL_SIGNAL_CONNECT, DT_DEBUG_CONTROL_SIGNAL_DISCONNECT, dt_dev_pixelpipe_cache_wait_cleanup(), DT_PIXELPIPE_CACHE_HASH_INVALID, DT_SIGNAL_CACHELINE_READY, FALSE, g, dt_iop_module_t::gui_data, dt_develop_t::preview_pipe, dt_dev_pixelpipe_t::processing, darktable_t::signals, and TRUE.

gui_init()

void gui_init

(

dt_iop_module_t *

self

)

Definition at line 2291 of file colorequal.c.

References _area_button_press_callback(), _area_button_release_callback(), _area_motion_notify_callback(), _channel_tabs_switch_callback(), _draw_curve(), _ring_label(), _ring_tabs_switch_callback(), ch, darktable, dt_bauhaus_combobox_from_params(), dt_bauhaus_slider_from_params(), dt_bauhaus_slider_set_format(), dt_bauhaus_slider_set_soft_range(), DT_COLOR_PICKER_AREA, dt_color_picker_new(), dt_color_picker_new_with_cst(), dt_conf_get_int(), dt_gui_add_class(), DT_GUI_BOX_SPACING, DT_GUI_MODULE, DT_IOP_COLOREQUAL_BRIGHTNESS, DT_IOP_COLOREQUAL_HUE, DT_IOP_COLOREQUAL_NUM_CHANNELS, DT_IOP_COLOREQUAL_NUM_RINGS, DT_IOP_COLOREQUAL_SATURATION, dt_lut_viewer_get_widget(), dt_lut_viewer_new(), DT_PIXELPIPE_CACHE_HASH_INVALID, dt_ui_resizable_drawing_area(), FALSE, g, darktable_t::gui, IOP_CS_RGB, IOP_GUI_ALLOC, dt_iop_module_t::params, dt_gui_gtk_t::reset, TRUE, and dt_iop_module_t::widget.

gui_post_expose()

void gui_post_expose	(	struct dt_iop_module_t *	self,
		cairo_t *	cr,
		int32_t	width,
		int32_t	height,
		int32_t	pointerx,
		int32_t	pointery
	)

Definition at line 1848 of file colorequal.c.

References _active_channel_from_gui(), _active_ring_from_gui(), _cursor_curve_state(), _refresh_preview_cursor_sample(), dt_iop_module_t::dev, dt_dev_get_overlay_scale(), dt_dev_rescale_roi(), dt_iop_color_picker_is_visible(), DT_IOP_COLOREQUAL_PREVIEW_CURSOR_RADIUS, DT_PIXEL_APPLY_DPI, dt_iop_module_t::enabled, g, dt_iop_module_t::gui_data, height, IS_NULL_PTR, M_PI_F, dt_develop_t::preview_pipe, dt_dev_pixelpipe_t::processing, and width.

gui_update()

void gui_update

(

dt_iop_module_t *

self

)

Todo:

check why needed

Todo:

by hand

Definition at line 2216 of file colorequal.c.

References dt_bauhaus_combobox_set(), dt_bauhaus_slider_set(), g, gui_changed(), dt_iop_module_t::gui_data, p, and dt_iop_module_t::params.

init()

void init

(

dt_iop_module_t *

module

)

Definition at line 2476 of file colorequal.c.

References _init_default_curves(), dt_iop_module_t::default_params, dt_iop_default_init(), dt_iop_module_t::params, and dt_iop_module_t::params_size.

init_global()

void init_global

(

dt_iop_module_so_t *

module

)

Definition at line 2432 of file colorequal.c.

References dt_iop_colorequal_global_data_t::cache, dt_iop_colorequal_global_data_t::cache_generation, dt_iop_colorequal_global_data_t::cache_valid, dt_iop_colorequal_data_t::clut, dt_iop_colorequal_data_t::clut_level, dt_opencl_create_kernel(), dt_pthread_rwlock_init, FALSE, dt_iop_colorequal_global_data_t::kernel_exposure, dt_iop_colorequal_global_data_t::kernel_lut3d_pyramid, dt_iop_colorequal_global_data_t::kernel_lut3d_tetrahedral, dt_iop_colorequal_global_data_t::kernel_lut3d_trilinear, dt_iop_colorequal_global_data_t::lock, dt_iop_colorequal_data_t::lut_profile, dt_iop_colorequal_global_data_t::params, dt_iop_colorequal_data_t::reference_saturation, dt_iop_colorequal_data_t::white_level, and dt_iop_colorequal_data_t::work_profile.

init_pipe()

void init_pipe	(	struct dt_iop_module_t *	self,
		dt_dev_pixelpipe_t *	pipe,
		dt_dev_pixelpipe_iop_t *	piece
	)

Definition at line 792 of file colorequal.c.

References d, dt_dev_pixelpipe_iop_t::data, dt_dev_pixelpipe_iop_t::data_size, dt_calloc_align(), and DT_LUT3D_INTERP_TETRAHEDRAL.

mouse_leave()

int mouse_leave

(

struct dt_iop_module_t *

self

)

Definition at line 1735 of file colorequal.c.

References _active_channel_from_gui(), _active_ring_from_gui(), _invalidate_preview_cursor(), _switch_preview_cursor(), dt_control_queue_redraw_center(), FALSE, g, and dt_iop_module_t::gui_data.

mouse_moved()

int mouse_moved	(	struct dt_iop_module_t *	self,
		double	x,
		double	y,
		double	pressure,
		int	which
	)

Definition at line 1687 of file colorequal.c.

References _active_channel_from_gui(), _active_ring_from_gui(), _invalidate_preview_cursor(), _refresh_preview_cursor_sample(), _switch_preview_cursor(), dt_iop_module_t::dev, dt_control_queue_redraw_center(), dt_dev_coordinates_image_norm_to_preview_abs(), dt_dev_coordinates_widget_to_image_norm(), dt_iop_color_picker_is_visible(), FALSE, g, dt_iop_module_t::gui_data, dt_develop_t::preview_height, dt_develop_t::preview_pipe, dt_develop_t::preview_width, dt_dev_pixelpipe_t::processing, dt_develop_t::roi, TRUE, and x.

name()

const char * name

(

)

Definition at line 203 of file colorequal.c.

process()

__DT_CLONE_TARGETS__ int process	(	struct dt_iop_module_t *	self,
		const dt_dev_pixelpipe_t *	pipe,
		const dt_dev_pixelpipe_iop_t *	piece,
		const void *const	ibuf,
		void *const	obuf
	)

Definition at line 894 of file colorequal.c.

References __OMP_PARALLEL_FOR__, ch, dt_iop_buffer_dsc_t::channels, d, dt_dev_pixelpipe_iop_t::data, dt_dev_pixelpipe_iop_t::dsc_in, dt_iop_image_copy_by_size(), dt_ioppr_transform_image_colorspace_rgb(), dt_lut3d_apply(), dt_pthread_rwlock_rdlock, dt_pthread_rwlock_unlock, dt_iop_module_t::global_data, height, dt_iop_roi_t::height, IS_NULL_PTR, k, dt_iop_colorequal_global_data_t::lock, out, dt_dev_pixelpipe_iop_t::roi_in, width, and dt_iop_roi_t::width.

process_cl()

int process_cl	(	struct dt_iop_module_t *	self,
		const dt_dev_pixelpipe_t *	pipe,
		const dt_dev_pixelpipe_iop_t *	piece,
		cl_mem	dev_in,
		cl_mem	dev_out
	)

Definition at line 815 of file colorequal.c.

References dt_iop_colorequal_global_data_t::cache, cleanup(), dt_iop_colorequal_data_t::clut, d, dt_dev_pixelpipe_iop_t::data, dt_dev_pixelpipe_t::devid, DT_DEBUG_OPENCL, dt_ioppr_transform_image_colorspace_rgb_cl(), DT_LUT3D_INTERP_PYRAMID, DT_LUT3D_INTERP_TRILINEAR, dt_opencl_copy_host_to_device_constant(), dt_opencl_enqueue_kernel_2d(), dt_opencl_release_mem_object(), dt_opencl_set_kernel_arg(), dt_print(), dt_pthread_rwlock_rdlock, dt_pthread_rwlock_unlock, FALSE, dt_iop_module_t::global_data, height, dt_iop_roi_t::height, IS_NULL_PTR, kernel(), dt_iop_colorequal_global_data_t::kernel_exposure, dt_iop_colorequal_global_data_t::kernel_lut3d_pyramid, dt_iop_colorequal_global_data_t::kernel_lut3d_tetrahedral, dt_iop_colorequal_global_data_t::kernel_lut3d_trilinear, dt_iop_colorequal_global_data_t::lock, normalize(), dt_dev_pixelpipe_iop_t::roi_in, ROUNDUPDHT, ROUNDUPDWD, width, and dt_iop_roi_t::width.

scrolled()

int scrolled	(	struct dt_iop_module_t *	self,
		double	x,
		double	y,
		int	up,
		uint32_t	state
	)

Definition at line 1786 of file colorequal.c.

References _active_channel_from_gui(), _active_ring_from_gui(), _channel_value_from_y(), _channel_y_from_value(), _curve_nodes(), _curve_nodes_count_const(), _curve_periodic_distance(), _refresh_preview_cursor_sample(), darktable, dt_iop_module_t::dev, darktable_t::develop, dt_colorrings_hue_to_curve_x(), dt_control_queue_redraw_center(), dt_dev_add_history_item, dt_iop_color_picker_is_visible(), DT_IOP_COLOREQUAL_BRIGHTNESS, DT_IOP_COLOREQUAL_HUE, DT_IOP_COLOREQUAL_SATURATION, DT_IOP_COLOREQUAL_SCROLL_HUE_STEP, DT_IOP_COLOREQUAL_SCROLL_HUE_STEP_COARSE, DT_IOP_COLOREQUAL_SCROLL_HUE_STEP_FINE, DT_IOP_COLOREQUAL_SCROLL_SIGMA, DT_IOP_COLOREQUAL_SCROLL_STEP, DT_IOP_COLOREQUAL_SCROLL_STEP_COARSE, DT_IOP_COLOREQUAL_SCROLL_STEP_FINE, dt_modifier_is(), dt_iop_module_t::enabled, FALSE, g, dt_iop_module_t::gui_data, k, M_PI_F, dt_iop_module_t::off, dt_iop_module_t::params, sigma, state, TRUE, value, weight(), x, and dt_iop_colorequal_node_t::y.