color_picker_proxy.h File Reference

#include <gtk/gtk.h>
#include "develop/imageop.h"
#include "develop/develop.h"

Include dependency graph for color_picker_proxy.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	dt_iop_color_picker_t

Typedefs
typedef enum _iop_color_picker_kind_t	dt_iop_color_picker_kind_t
typedef struct dt_iop_color_picker_t	dt_iop_color_picker_t

Enumerations
enum	_iop_color_picker_kind_t {   DT_COLOR_PICKER_POINT = 0 ,   DT_COLOR_PICKER_AREA ,   DT_COLOR_PICKER_POINT_AREA }

Functions
gboolean	dt_iop_color_picker_is_visible (const dt_develop_t *dev)
gboolean	dt_iop_color_picker_is_active_module (const dt_iop_module_t *module)
	Tell whether one module currently owns the active darkroom picker.
void	dt_iop_color_picker_reset (dt_iop_module_t *module, gboolean keep)
void	dt_iop_color_picker_set_cst (dt_iop_module_t *module, const dt_iop_colorspace_type_t picker_cst)
dt_iop_colorspace_type_t	dt_iop_color_picker_get_active_cst (dt_iop_module_t *module)
void	dt_iop_color_picker_request_update (void)
int	dt_iop_color_picker_get_ready_data (const dt_iop_module_t *module, GtkWidget **picker, struct dt_dev_pixelpipe_t **pipe, const struct dt_dev_pixelpipe_iop_t **piece)
	Resolve the current ready picker payload for one module.
void	dt_iop_color_picker_init ()
void	dt_iop_color_picker_cleanup ()
GtkWidget *	dt_color_picker_new (dt_iop_module_t *module, dt_iop_color_picker_kind_t kind, GtkWidget *w)
GtkWidget *	dt_color_picker_new_with_cst (dt_iop_module_t *module, dt_iop_color_picker_kind_t kind, GtkWidget *w, const dt_iop_colorspace_type_t cst)

Typedef Documentation

dt_iop_color_picker_kind_t

typedef enum _iop_color_picker_kind_t dt_iop_color_picker_kind_t

dt_iop_color_picker_t

typedef struct dt_iop_color_picker_t dt_iop_color_picker_t

Enumeration Type Documentation

_iop_color_picker_kind_t

enum _iop_color_picker_kind_t

Enumerator
DT_COLOR_PICKER_POINT
DT_COLOR_PICKER_AREA	Todo: : s/AREA/BOX/
DT_COLOR_PICKER_POINT_AREA

Definition at line 42 of file color_picker_proxy.h.

Function Documentation

dt_color_picker_new()

GtkWidget * dt_color_picker_new	(	dt_iop_module_t *	module,
		dt_iop_color_picker_kind_t	kind,
		GtkWidget *	w
	)

Definition at line 1085 of file color_picker_proxy.c.

References _color_picker_new(), FALSE, IOP_CS_NONE, and kind.

Referenced by dt_iop_gui_init_blendif(), gui_init(), gui_init(), and gui_init_section().

dt_color_picker_new_with_cst()

GtkWidget * dt_color_picker_new_with_cst	(	dt_iop_module_t *	module,
		dt_iop_color_picker_kind_t	kind,
		GtkWidget *	w,
		const dt_iop_colorspace_type_t	cst
	)

Definition at line 1090 of file color_picker_proxy.c.

References _color_picker_new(), kind, and TRUE.

Referenced by gui_init(), and gui_init().

dt_iop_color_picker_cleanup()

void dt_iop_color_picker_cleanup

(

)

Definition at line 1012 of file color_picker_proxy.c.

References _iop_color_picker_cacheline_ready_callback(), _iop_color_picker_history_resync_callback(), _iop_color_picker_notebook_tab_changed_callback(), _iop_color_picker_pipe_finished_callback(), dt_control_signal_get_global(), and DT_DEBUG_CONTROL_SIGNAL_DISCONNECT.

Referenced by leave().

dt_iop_color_picker_get_active_cst()

dt_iop_colorspace_type_t dt_iop_color_picker_get_active_cst

(

dt_iop_module_t *

module

)

Definition at line 874 of file color_picker_proxy.c.

References dt_develop_t::color_picker, dt_dev_get_global(), IOP_CS_NONE, dt_develop_t::picker, and dt_iop_color_picker_t::picker_cst.

Referenced by _blendif_colorpicker_cst(), and _sample_picker_buffer().

dt_iop_color_picker_get_ready_data()

int dt_iop_color_picker_get_ready_data	(	const dt_iop_module_t *	module,
		GtkWidget **	picker,
		struct dt_dev_pixelpipe_t **	pipe,
		const struct dt_dev_pixelpipe_iop_t **	piece
	)

Resolve the current ready picker payload for one module.

DT_SIGNAL_CONTROL_PICKERDATA_READY does not carry the sampled module, pipe, picker widget, or piece as signal parameters anymore. The picker manager stores that ready state under dt_develop_t until signal subscribers consume it on the GUI thread. This accessor lets any subscriber check whether the ready sample belongs to module and, if so, recover the current live piece from the current preview pipe graph through its immutable global_hash.

Parameters

module	Signal subscriber asking whether the current ready sample is for it.
picker	Optional output pointer receiving the active picker widget.
pipe	Optional output pointer receiving the preview pipe used for sampling.
piece	Optional output pointer receiving the current live piece matching the sampled global_hash.

Returns

0 when the ready sample belongs to module and all requested outputs were resolved, 1 otherwise.

dt_iop_color_picker_init()

void dt_iop_color_picker_init

(

)

Definition at line 1000 of file color_picker_proxy.c.

References _iop_color_picker_cacheline_ready_callback(), _iop_color_picker_history_resync_callback(), _iop_color_picker_notebook_tab_changed_callback(), _iop_color_picker_pipe_finished_callback(), dt_control_signal_get_global(), DT_DEBUG_CONTROL_SIGNAL_CONNECT, DT_SIGNAL_CACHELINE_READY, DT_SIGNAL_CONTROL_NOTEBOOK_TAB_CHANGED, DT_SIGNAL_DEVELOP_PREVIEW_PIPE_FINISHED, and DT_SIGNAL_HISTORY_RESYNC.

Referenced by enter().

dt_iop_color_picker_is_active_module()

gboolean dt_iop_color_picker_is_active_module

(

const dt_iop_module_t *

module

)

Tell whether one module currently owns the active darkroom picker.

Module code often needs to know whether a GUI callback is running for the module that currently captures picker updates. That ownership lives under dt_develop_t::color_picker, so callers should query it through this API instead of open-coding the develop-state test at each call site.

Parameters

module

Candidate module.

Returns

TRUE when the picker manager is enabled and the active picker belongs to module.

Definition at line 96 of file color_picker_proxy.c.

Referenced by _spot_settings_changed_callback(), and _spot_settings_changed_callback().

dt_iop_color_picker_is_visible()

gboolean dt_iop_color_picker_is_visible

(

const dt_develop_t *

dev

)

Todo:

: should this be here or perhaps lib.c?

Definition at line 84 of file color_picker_proxy.c.

References dt_develop_t::color_picker, dt_develop_t::enabled, dt_iop_module_t::enabled, and dt_develop_t::gui_module.

Referenced by _studio_draw_pickers(), _switch_cursors(), _switch_preview_cursor(), button_pressed(), button_pressed(), button_pressed(), button_released(), button_released(), expose(), gui_post_expose(), mouse_moved(), mouse_moved(), mouse_moved(), scrolled(), and scrolled().

dt_iop_color_picker_request_update()

void dt_iop_color_picker_request_update

(

void

)

Definition at line 884 of file color_picker_proxy.c.

References _queue_refresh_active_picker(), dt_develop_t::color_picker, DT_DEBUG_DEV, dt_dev_get_global(), dt_print(), dt_develop_t::picker, TRUE, dt_develop_t::update_pending, dt_iop_color_picker_t::update_pending, and dt_develop_t::widget.

Referenced by _color_picker_callback_button_press(), dt_iop_color_picker_set_cst(), dt_lib_colorpicker_set_box_area(), and dt_lib_colorpicker_set_point().

dt_iop_color_picker_reset()

void dt_iop_color_picker_reset	(	dt_iop_module_t *	module,
		gboolean	keep
	)

Definition at line 703 of file color_picker_proxy.c.

References _color_picker_reset(), dt_develop_t::color_picker, DT_COLOR_PICKER_POINT, dt_dev_get_global(), dt_dev_pixelpipe_cache_wait_cleanup(), dt_develop_t::enabled, FALSE, dt_develop_t::input_wait, IOP_CS_NONE, dt_develop_t::kind, dt_develop_t::output_wait, dt_develop_t::picker, dt_develop_t::picker_cst, dt_develop_t::update_pending, and dt_develop_t::widget.

Referenced by _area_button_press_callback(), _area_button_press_callback(), _area_key_press_callback(), _area_key_press_callback(), _area_motion_notify_callback(), _area_motion_notify_callback(), _area_scrolled_callback(), _area_scrolled_callback(), _autoexp_disable(), _blendop_blendif_reset(), _blendop_blendif_sliders_callback(), _blendop_blendif_tab_switch(), _blendop_masks_shape_can_start(), _blendop_masks_show_and_edit(), _delete_node(), _edit_masks(), _gui_reset_callback(), _interpolator_callback(), _iop_color_picker_notebook_tab_changed_callback(), _select_region_toggled_callback(), _select_region_toggled_callback(), _turn_selregion_picker_off(), _turn_selregion_picker_off(), apply_autocolor(), apply_autoluma(), area_button_press(), aspect_changed(), balance_callback(), black_point_source_callback(), black_point_target_callback(), center_callback(), colorpick_color_set(), colorpicker_callback(), contrast_callback(), controls_callback(), Dmin_picker_callback(), dt_iop_gui_changed(), dt_iop_gui_update_blendif(), dt_iop_gui_update_blending(), dt_iop_levels_autoadjust_callback(), dt_iop_levels_scroll(), dt_iop_monochrome_button_press(), dt_iop_monochrome_button_release(), dt_iop_monochrome_scrolled(), dt_iop_request_focus(), frame_colorpick_color_set(), global_saturation_callback(), grey_point_source_callback(), grey_point_target_callback(), gui_changed(), gui_cleanup(), gui_reset(), gui_reset(), gui_reset(), gui_update(), gui_update(), gui_update(), interpolator_callback(), latitude_stops_callback(), leave(), notebook_button_press(), output_power_callback(), patch_callback(), position_h_changed(), position_v_changed(), preset_tune_callback(), rt_colorpick_color_set_callback(), rt_edit_masks_callback(), rt_shape_buttons_can_start(), saturation_callback(), security_threshold_callback(), show_luminance_mask_callback(), smoothing_callback(), target_callback(), temp_tint_callback(), WB_high_picker_callback(), WB_low_picker_callback(), white_point_source_callback(), and white_point_target_callback().

dt_iop_color_picker_set_cst()

void dt_iop_color_picker_set_cst	(	dt_iop_module_t *	module,
		const dt_iop_colorspace_type_t	picker_cst
	)

Definition at line 863 of file color_picker_proxy.c.

References dt_develop_t::color_picker, dt_dev_get_global(), dt_iop_color_picker_request_update(), dt_develop_t::picker, and dt_iop_color_picker_t::picker_cst.

Referenced by _blendif_change_blend_colorspace(), _blendop_blendif_tab_switch(), and _update_gradient_slider_pickers().