Ansel 0.0
A darktable fork - bloat + design vision
Loading...
Searching...
No Matches
control.c File Reference
#include "widgets/bauhaus.h"
#include "darktable.h"
#include "common/logging.h"
#include "common/selection.h"
#include "control/control.h"
#include "develop/develop.h"
#include "gui/application.h"
#include "views/view.h"
#include <assert.h>
#include <gdk/gdkkeysyms.h>
#include <glib/gstdio.h>
#include <stdlib.h>
#include <string.h>
#include "gui/screen_metrics.h"
#include "control/signal.h"
+ Include dependency graph for control.c:

Go to the source code of this file.

Data Structures

struct  dt_control_redraw_widget_t
 

Typedefs

typedef struct dt_control_redraw_widget_t dt_control_redraw_widget_t
 

Functions

void dt_control_set_pointer_input (const dt_control_pointer_input_t *input)
 
void dt_control_get_pointer_input (dt_control_pointer_input_t *input)
 
void dt_control_init (dt_control_t *s)
 
static const char * _get_cursor_name (dt_cursor_t cursor)
 Human-readable name of a GDK cursor shape, for debug output.
 
void dt_control_forbid_change_cursor ()
 
void dt_control_allow_change_cursor ()
 
static void _control_set_cursor_on_widget (GtkWidget *widget, GdkCursor *cursor)
 
static void _control_apply_cursor (GdkCursor *cursor)
 
static void _control_store_current_cursor (const dt_cursor_t shape, const char *shape_str)
 
void dt_control_change_cursor_by_name (const char *curs_str)
 Apply a GTK named cursor without changing the queued cursor.
 
void dt_control_change_cursor_by_name_and_flush (const char *curs_str)
 Apply a named cursor immediatelly and flush display updates for immediate feedback.
 
void dt_control_commit_cursor ()
 
void dt_control_change_cursor_EXT (dt_cursor_t cursor, const char *file, int line)
 
void dt_control_queue_cursor_EXT (dt_cursor_t cursor, const char *file, int line)
 
void dt_control_queue_cursor_by_name (const char *curs_str)
 Queue a GTK named cursor for the next cursor commit.
 
void dt_control_set_cursor_visible_EXT (gboolean visible, const char *file, int line)
 Set whether the cursor should be visible or not.
 
void dt_control_mouse_is_dragging (gboolean state)
 
void dt_control_mouse_is_painting (gboolean state)
 
int dt_control_running ()
 
void dt_control_quit ()
 
void dt_control_set_shutdown_wait_handler (dt_control_shutdown_wait_t handler)
 
void dt_control_shutdown (dt_control_t *s)
 
void dt_control_cleanup (dt_control_t *s)
 
gboolean dt_control_configure (GtkWidget *da, GdkEventConfigure *event, gpointer user_data)
 
static GdkRGBA lookup_color (GtkStyleContext *context, const char *name)
 
void dt_control_draw_busy_msg (cairo_t *cr, int width, int height)
 
gboolean dt_control_button_down (int which)
 Is mouse button which currently held down?
 
void dt_control_expose (cairo_t *cr, const int width, const int height)
 
void dt_control_mouse_leave ()
 
void dt_control_mouse_enter ()
 
void dt_control_mouse_moved (double x, double y, double pressure, int which)
 
void dt_control_key_pressed (GdkEventKey *event)
 
void dt_control_button_released (double x, double y, int which, uint32_t state)
 
static void _dt_ctl_switch_mode_prepare ()
 
static gboolean _dt_ctl_switch_mode_to (gpointer user_data)
 
static gboolean _dt_ctl_switch_mode_to_by_view (gpointer user_data)
 
void dt_ctl_switch_mode_to (const char *mode)
 
void dt_ctl_switch_mode_to_by_view (const dt_view_t *view)
 
static gboolean _dt_ctl_open_image_in_darkroom (gpointer user_data)
 
void dt_ctl_open_image_in_darkroom (const int32_t imgid)
 open one specific image in the darkroom, from any view and any thread.
 
static gboolean _dt_ctl_log_message_timeout_callback (gpointer data)
 
static gboolean _dt_ctl_toast_message_timeout_callback (gpointer data)
 
void dt_control_button_pressed (double x, double y, double pressure, int which, int type, uint32_t state)
 
static gboolean _redraw_center (gpointer user_data)
 
void dt_control_log (const char *msg,...)
 
void dt_control_set_alert_handler (dt_control_alert_handler_t handler)
 Install the alert handler; NULL restores the fallback to dt_control_log().
 
static void _alert (const char *title, const char *message, const char *item, const int once)
 
void dt_control_alert (const char *title, const char *message, const char *item)
 Tell the user something that must not go unseen: what it says stays true after a toast would have faded – a module failed, a file was not written, an export will not come.
 
void dt_control_alert_once (const char *title, const char *message, const char *item)
 dt_control_alert() for a failure that repeats as long as its cause lasts – memory running short, where every new request fails again. Its window lists every item while it is up, like any other; once closed, it does not open again this session for the same title and message. Without a GUI, printed on stderr each time, as dt_control_alert().
 
static void _toast_log (const gboolean markup, const char *msg, va_list ap)
 
void dt_toast_log (const char *msg,...)
 
void dt_toast_markup_log (const char *msg,...)
 
void dt_control_log_busy_enter ()
 
void dt_control_toast_busy_enter ()
 
void dt_control_log_busy_leave ()
 
void dt_control_toast_busy_leave ()
 
void dt_control_queue_redraw ()
 Request a redraw of the whole workspace.
 
void dt_control_queue_redraw_center ()
 Request a redraw of the centre view.
 
void dt_control_navigation_redraw ()
 Request a redraw of the navigation module's widget.
 
void dt_control_log_redraw ()
 Request a redraw of the log message label.
 
void dt_control_toast_redraw ()
 Request a redraw of the toast message label.
 
static int _widget_queue_draw (void *widget_data)
 
static void _widget_queue_draw_cleanup (void *widget_data)
 
void dt_control_queue_redraw_widget (GtkWidget *widget)
 threadsafe request of redraw of specific widget. Use this function if you need to redraw a specific widget if your current thread context is not gtk main thread.
 
void dt_control_hinter_message (const struct dt_control_t *s, const char *message)
 
int32_t dt_control_get_mouse_over_id ()
 
void dt_control_set_mouse_over_id (int32_t value)
 
int32_t dt_control_get_keyboard_over_id ()
 
void dt_control_set_keyboard_over_id (int32_t value)
 

Variables

static dt_control_pointer_input_t _pointer_input = { 0 }
 
static dt_control_shutdown_wait_t _shutdown_wait = NULL
 
static dt_control_alert_handler_t _alert_handler = NULL
 

Typedef Documentation

◆ dt_control_redraw_widget_t

Function Documentation

◆ _alert()

static void _alert ( const char *  title,
const char *  message,
const char *  item,
const int  once 
)
static

Definition at line 872 of file control.c.

References _alert_handler, and IS_NULL_PTR.

Referenced by dt_control_alert(), and dt_control_alert_once().

◆ _control_apply_cursor()

static void _control_apply_cursor ( GdkCursor *  cursor)
static

◆ _control_set_cursor_on_widget()

static void _control_set_cursor_on_widget ( GtkWidget *  widget,
GdkCursor *  cursor 
)
static

Definition at line 243 of file control.c.

References IS_NULL_PTR, and window.

Referenced by _control_apply_cursor().

◆ _control_store_current_cursor()

static void _control_store_current_cursor ( const dt_cursor_t  shape,
const char *  shape_str 
)
static

◆ _dt_ctl_log_message_timeout_callback()

◆ _dt_ctl_open_image_in_darkroom()

◆ _dt_ctl_switch_mode_prepare()

static void _dt_ctl_switch_mode_prepare ( )
static

◆ _dt_ctl_switch_mode_to()

static gboolean _dt_ctl_switch_mode_to ( gpointer  user_data)
static

◆ _dt_ctl_switch_mode_to_by_view()

static gboolean _dt_ctl_switch_mode_to_by_view ( gpointer  user_data)
static

◆ _dt_ctl_toast_message_timeout_callback()

◆ _get_cursor_name()

static const char * _get_cursor_name ( dt_cursor_t  cursor)
static

Human-readable name of a GDK cursor shape, for debug output.

The returned string is a static literal owned by this table: it must NOT be freed, and it stays valid for the lifetime of the process. This used to g_strdup() its result from a 90-case switch, and neither of the two call sites freed it – one of them could not, because it selected between the allocated name and a plain literal with a ternary. Static storage removes both the leak and the question.

Parameters
cursorthe shape to name.
Returns
the enum constant's spelling, never NULL. Unknown values – GDK gained a shape, or the value is garbage – give "GDK_CURSOR_UNKNOWN" rather than NULL, because every caller feeds this straight to a "%s" and passing NULL there is undefined behaviour.

Definition at line 138 of file control.c.

References i, and name.

Referenced by dt_control_change_cursor_EXT(), and dt_control_queue_cursor_EXT().

◆ _redraw_center()

static gboolean _redraw_center ( gpointer  user_data)
static

Definition at line 832 of file control.c.

References dt_control_log_redraw(), dt_control_toast_redraw(), and FALSE.

Referenced by _toast_log(), and dt_control_log().

◆ _toast_log()

◆ _widget_queue_draw()

static int _widget_queue_draw ( void *  widget_data)
static

Definition at line 995 of file control.c.

References FALSE, IS_NULL_PTR, and dt_control_redraw_widget_t::widget_ref.

Referenced by dt_control_queue_redraw_widget().

◆ _widget_queue_draw_cleanup()

static void _widget_queue_draw_cleanup ( void *  widget_data)
static

Definition at line 1008 of file control.c.

References dt_free, and dt_control_redraw_widget_t::widget_ref.

Referenced by dt_control_queue_redraw_widget().

◆ dt_control_alert()

void dt_control_alert ( const char *  title,
const char *  message,
const char *  item 
)

Tell the user something that must not go unseen: what it says stays true after a toast would have faded – a module failed, a file was not written, an export will not come.

The GUI shows it in an alert window with one OK button (gui/alert.h): one window per title and message, which shows the message once and lists the items it was raised for under it, in a list that scrolls. A failure that repeats over a batch – the thumbnails of a film roll, an export, sidecar files – so stays one window that lists which items it hit, not only the last one. Without a GUI – ansel-cli, or before dt_gui_gtk_init() – it is printed on stderr: the title, the message, and the item on the line under them. Any thread.

The message is the kind of failure: the same text at every call from one place, with no value in it, or every value would open a window of its own. What changes from one call to the next – the file, the module, the profile – goes in item; an item of several values is built with g_strdup_printf() by the caller, and freed after this returns.

Parameters
titlealready translated, one line; also what names the kind of failure
messagealready translated; plain text, not markup; no value in it
itemone line of the list under the message – the full path of the image a module failed on, prefixed with the module's name; plain text. NULL when there is nothing to list.

Definition at line 883 of file control.c.

References _alert(), and FALSE.

Referenced by _apply_style_before_export(), _darkroom_log_image_load_error(), _default_process_tiling_ptp(), _default_process_tiling_roi(), _dt_dev_raster_mask_check(), _enqueue_input(), _export_image(), _export_list_save(), _generic_dt_control_fileop_images_job_run(), _import_image(), _import_preset_from_file(), _print_job_run(), _refine_with_detail_mask(), _refine_with_detail_mask_cl(), _save_and_render(), commit_params(), commit_params(), dt_configure_runtime_performance(), dt_control_export(), dt_control_merge_hdr_process(), dt_control_remove_images_job_run(), dt_control_save_xmps_job_run(), dt_develop_blend_process(), dt_develop_blend_process_cl(), dt_drawlayer_runtime_manager_update(), dt_gui_preferences_show(), dt_image_local_copy_reset(), dt_image_local_copy_set(), dt_image_rename(), dt_print_file(), dual_demosaic(), find_coeffs(), gui_update(), gui_update(), legacy_params(), prepare_matrices(), process(), store(), workicc_changed(), and write_image().

◆ dt_control_alert_once()

void dt_control_alert_once ( const char *  title,
const char *  message,
const char *  item 
)

dt_control_alert() for a failure that repeats as long as its cause lasts – memory running short, where every new request fails again. Its window lists every item while it is up, like any other; once closed, it does not open again this session for the same title and message. Without a GUI, printed on stderr each time, as dt_control_alert().

Definition at line 888 of file control.c.

References _alert(), and TRUE.

Referenced by _dt_dev_mipmap_prefetch_full(), _view_image_get_surface_internal(), and dt_imageio_open().

◆ dt_control_allow_change_cursor()

void dt_control_allow_change_cursor ( )

◆ dt_control_button_down()

gboolean dt_control_button_down ( int  which)

Is mouse button which currently held down?

Parameters
which1 = left, 2 = middle, 3 = right, as in GdkEventButton.button.
Returns
TRUE while the button is physically down. Asked of GDK on every call, so it cannot be stale; FALSE when there is no display, no seat or no pointer (headless included).

This reports the DEVICE's state, not "a drag we started". A button pressed over another window and still held when the pointer enters ours reads TRUE here, where the old stored flag – set only by our own press handler – read FALSE. Every current caller pairs it with its own grab or hover test, so the distinction does not reach behaviour; a new caller that needs "did the press land on us" wants a press handler, not this.

Definition at line 578 of file control.c.

References dt_gui_center_widget(), FALSE, IS_NULL_PTR, and window.

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

◆ dt_control_button_pressed()

◆ dt_control_button_released()

void dt_control_button_released ( double  x,
double  y,
int  which,
uint32_t  state 
)

Definition at line 687 of file control.c.

References darktable, dt_view_manager_button_released(), state, darktable_t::view_manager, and x.

Referenced by _button_released().

◆ dt_control_change_cursor_by_name()

void dt_control_change_cursor_by_name ( const char *  curs_str)

Apply a GTK named cursor without changing the queued cursor.

Apply a GTK named cursor immediately without replacing the queued cursor state.

Named cursors report GDK_CURSOR_IS_PIXMAP as their type, which is only a marker for GTK's cursor cache. The queued cursor state is owned by dt_control_queue_cursor_by_name(), so temporary named cursors such as the busy cursor do not overwrite the cursor that should be restored later.

Definition at line 283 of file control.c.

References _control_apply_cursor(), _control_store_current_cursor(), darktable_t::control, dt_control_t::current_shape, dt_control_t::current_shape_str, dt_control_t::cursor, darktable, dt_control_queue_cursor_by_name(), DT_DEBUG_CONTROL, DT_DEBUG_VERBOSE, dt_get_debug_flags(), dt_print(), dt_control_t::hide, IS_NULL_PTR, and dt_control_t::lock.

Referenced by dt_control_change_cursor_by_name_and_flush(), dt_control_commit_cursor(), and dt_control_expose().

◆ dt_control_change_cursor_by_name_and_flush()

void dt_control_change_cursor_by_name_and_flush ( const char *  curs_str)

Apply a named cursor immediatelly and flush display updates for immediate feedback.

Apply a GTK named cursor immediately and flush display updates.

Some synchronous UI-thread operations perform heavy work right after cursor setup. Without an explicit display flush, GTK may delay painting and the busy cursor can remain invisible until the computation already finished.

Parameters
curs_strGTK cursor name (for example "progress").

Definition at line 335 of file control.c.

References dt_control_change_cursor_by_name(), and IS_NULL_PTR.

Referenced by _cache_wait_cursor_progress(), _lib_duplicate_thumb_press_callback(), _lib_snapshot_capture_state(), _undo_announce(), and dt_iop_autoset_advance().

◆ dt_control_change_cursor_EXT()

◆ dt_control_cleanup()

◆ dt_control_commit_cursor()

◆ dt_control_configure()

gboolean dt_control_configure ( GtkWidget *  da,
GdkEventConfigure *  event,
gpointer  user_data 
)

Definition at line 530 of file control.c.

References darktable, dt_view_manager_configure(), TRUE, and darktable_t::view_manager.

Referenced by _configure().

◆ dt_control_draw_busy_msg()

void dt_control_draw_busy_msg ( cairo_t *  cr,
int  width,
int  height 
)

◆ dt_control_expose()

◆ dt_control_forbid_change_cursor()

void dt_control_forbid_change_cursor ( )

◆ dt_control_get_keyboard_over_id()

◆ dt_control_get_mouse_over_id()

◆ dt_control_get_pointer_input()

void dt_control_get_pointer_input ( dt_control_pointer_input_t *  input)

Definition at line 83 of file control.c.

References _pointer_input, and IS_NULL_PTR.

Referenced by _build_raw_input_event(), button_pressed(), button_released(), and gui_post_expose().

◆ dt_control_hinter_message()

◆ dt_control_init()

◆ dt_control_key_pressed()

void dt_control_key_pressed ( GdkEventKey *  event)

Definition at line 682 of file control.c.

References darktable, dt_view_manager_key_pressed(), and darktable_t::view_manager.

Referenced by _key_pressed().

◆ dt_control_log()

void dt_control_log ( const char *  msg,
  ... 
)

Definition at line 839 of file control.c.

References _dt_ctl_log_message_timeout_callback(), _redraw_center(), darktable_t::control, darktable, DT_CTL_LOG_MSG_SIZE, DT_CTL_LOG_SIZE, DT_CTL_LOG_TIMEOUT, dt_free, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), dt_control_t::log_ack, dt_control_t::log_message, dt_control_t::log_message_timeout_id, dt_control_t::log_mutex, and dt_control_t::log_pos.

Referenced by __attribute__(), __attribute__(), _act_folders_relocate(), _background_layer_job_done_idle(), _channelmixerrgb_mixer_mode_callback(), _channelmixerrgb_primaries_slider_callback(), _channelmixerrgb_reject_mixer_mode(), _channelmixerrgb_white_preserving_slider_callback(), _click_on_view(), _control_import_job_run(), _create_background_clicked(), _create_dir(), _create_layer_clicked(), _deflicker_prepare_histogram(), _delete_tagids(), _display_mask_callback(), _dnd_folder_import_job_run(), _do_get_structure_auto(), _drop_move_to_folder(), _dt_collection_changed_callback(), _edit_preset(), _edit_preset_response(), _enqueue_stroke_end(), _event_aspect_presets_changed(), _export_button_clicked(), _export_button_clicked(), _export_image(), _export_source_available(), _extract_patches(), _fill_black_clicked(), _fill_transparent_clicked(), _fill_white_clicked(), _film_import1(), _folder_survey_job_run(), _gui_styles_dialog_run(), _gui_styles_edit_style_response(), _gui_styles_new_style_response(), _history_notify(), _image_import_internal(), _import_button_clicked(), _lib_tagging_tag_show_accel(), _main_do_event_help(), _masks_operation_callback(), _menuitem_delete_preset(), _metadata_notify(), _mixer_mode_callback(), _modchooser_run(), _name_editing_done(), _noiseprofile_load(), _open_uri(), _page_new_area_clicked(), _paper_size(), _pipeline_message(), _pixelpipe_cache_warn(), _pop_menu_dictionary_delete_node(), _pop_menu_dictionary_set_as_tag(), _pop_undo(), _primaries_slider_callback(), _print_button_clicked(), _process_file_list(), _rename_layer_clicked(), _reset_form_creation(), _save_clut_callback(), _set_paper_size(), _set_test_path(), _slideshow_slow_down_accel(), _slideshow_speed_up_accel(), _slideshow_start_stop_accel(), _slideshow_step_back_accel(), _slideshow_step_forward_accel(), _step_state(), _studio_dev_setup(), _studio_style_apply_callback(), _thumbtable_dnd_import(), _undo_announce(), _update_point_gui(), _updates_notify(), _white_preserving_slider_callback(), aspect_presets_changed(), button_clicked(), button_pressed(), button_pressed(), button_released(), calculate_clut_3dl(), calculate_clut_cube(), calculate_clut_haldclut(), commit_params(), copy_callback(), copy_parts_callback(), do_crop(), do_fit(), dt_control_datetime_job_run(), dt_control_delete_image(), dt_control_delete_images(), dt_control_export_job_run(), dt_control_gpx_apply_job_run(), dt_control_local_copy_images_job_run(), dt_control_merge_hdr_job_run(), dt_control_merge_hdr_process(), dt_control_remove_images(), dt_dev_pixelpipe_propagate_formats(), dt_drawlayer_layers_log_errors(), dt_drawlayer_runtime_manager_update(), dt_film_remove(), dt_folder_survey_halt(), dt_folder_survey_start(), dt_gui_hist_dialog_new(), dt_gui_preferences_show(), dt_image_check_camera_missing_sample(), dt_image_local_copy_synch(), dt_imageio_open(), dt_iop_gui_update_blending(), dt_lib_presets_apply(), dt_lightroom_import(), dt_load_from_string(), dt_masks_group_add_form_with_state(), dt_preview_window_spawn(), dt_print_file(), dt_styles_create_from_list(), dt_thumbtable_select_all(), dt_thumbtable_select_range(), duplicate_callback(), enter(), export_clicked(), fast_surface_blur(), finalize_store(), gui_changed(), gui_init(), key_pressed(), lmmse_demosaic(), new_history_callback(), paste_all_callback(), paste_parts_callback(), process(), process(), process_cl(), process_drago(), process_internal(), rcd_demosaic(), rt_display_wavelet_scale_callback(), rt_select_algorithm_callback(), rt_showmask_callback(), set_new_params_interactive(), smoothing_callback(), store(), store(), try_enter(), write_image(), write_image(), and write_image().

◆ dt_control_log_busy_enter()

◆ dt_control_log_busy_leave()

◆ dt_control_log_redraw()

void dt_control_log_redraw ( )

Request a redraw of the log message label.

Definition at line 980 of file control.c.

References dt_control_signal_get_global(), DT_DEBUG_CONTROL_SIGNAL_RAISE, and DT_SIGNAL_CONTROL_LOG_REDRAW.

Referenced by _dt_ctl_log_message_timeout_callback(), and _redraw_center().

◆ dt_control_mouse_enter()

void dt_control_mouse_enter ( )

Definition at line 672 of file control.c.

References darktable, dt_view_manager_mouse_enter(), and darktable_t::view_manager.

Referenced by _center_enter().

◆ dt_control_mouse_is_dragging()

void dt_control_mouse_is_dragging ( gboolean  state)

◆ dt_control_mouse_is_painting()

void dt_control_mouse_is_painting ( gboolean  state)

◆ dt_control_mouse_leave()

void dt_control_mouse_leave ( )

Definition at line 667 of file control.c.

References darktable, dt_view_manager_mouse_leave(), and darktable_t::view_manager.

Referenced by _center_leave().

◆ dt_control_mouse_moved()

void dt_control_mouse_moved ( double  x,
double  y,
double  pressure,
int  which 
)

Definition at line 677 of file control.c.

References darktable, dt_view_manager_mouse_moved(), darktable_t::view_manager, and x.

Referenced by _mouse_moved().

◆ dt_control_navigation_redraw()

void dt_control_navigation_redraw ( )

Request a redraw of the navigation module's widget.

Definition at line 975 of file control.c.

References dt_control_signal_get_global(), DT_DEBUG_CONTROL_SIGNAL_RAISE, and DT_SIGNAL_CONTROL_NAVIGATION_REDRAW.

Referenced by _enter_edit_mode(), dt_dev_pixelpipe_change_zoom_main(), and gui_changed().

◆ dt_control_queue_cursor_by_name()

void dt_control_queue_cursor_by_name ( const char *  curs_str)

Queue a GTK named cursor for the next cursor commit.

The cursor object is created only to validate the theme name. The queued ownership remains the string because GTK exposes named cursors as GDK_CURSOR_IS_PIXMAP, which cannot be passed back to gdk_cursor_new_for_display().

Definition at line 407 of file control.c.

References darktable_t::control, dt_control_t::cursor, darktable, IS_NULL_PTR, and dt_control_t::shape_str.

Referenced by _darkroom_set_default_cursor(), _set_cursor_shape(), _switch_cursors(), _switch_preview_cursor(), dt_control_change_cursor_by_name(), gui_post_expose(), mouse_leave(), and mouse_moved().

◆ dt_control_queue_cursor_EXT()

void dt_control_queue_cursor_EXT ( dt_cursor_t  cursor,
const char *  file,
int  line 
)

◆ dt_control_queue_redraw()

◆ dt_control_queue_redraw_center()

void dt_control_queue_redraw_center ( )

Request a redraw of the centre view.

Definition at line 970 of file control.c.

References dt_control_signal_get_global(), DT_DEBUG_CONTROL_SIGNAL_RAISE, and DT_SIGNAL_CONTROL_REDRAW_CENTER.

Referenced by _add_shape(), _area_button_press_callback(), _area_motion_notify_callback(), _blendop_masks_apply_and_commit(), _button_clicked(), _cache_wait_cursor_restore(), _cacheline_ready_callback(), _channel_tabs_switch_callback(), _color_picker_callback_button_press(), _darkroom_image_loaded_callback(), _dev_backbuf_restart_cache_wait(), _display_brightness_callback(), _display_samples_changed(), _do_get_structure_lines(), _do_get_structure_quad(), _drag_and_drop_received(), _drag_motion_received(), _drop_move_to_folder(), _edit_masks(), _enter_edit_mode(), _event_process_after_preview_callback(), _event_process_after_ui_callback(), _event_structure_auto_clicked(), _film_import1(), _film_strip_activated(), _generic_dt_control_fileop_images_job_run(), _grid_callback(), _grid_horizontal_changed(), _grid_size_changed(), _grid_subdiv_changed(), _grid_vertical_changed(), _gui_delete_callback(), _gui_set_single_expanded(), _guides_quickbutton_clicked(), _height_changed(), _key_scroll(), _lib_duplicate_preview_updated_callback(), _lib_duplicate_thumb_press_callback(), _lib_duplicate_thumb_revert_callback(), _lib_snapshots_delete_button_clicked_callback(), _lib_snapshots_toggled_callback(), _live_sample_button(), _masks_shape_button_pressed(), _page_clear_area_clicked(), _page_delete_area(), _pipeline_busy(), _preview_cache_wait_restart(), _print_settings_activate_or_update_callback(), _publish_backend_progress(), _recompute_job_run(), _refresh_active_picker(), _refresh_display(), _remove_sample_cb(), _ring_tabs_switch_callback(), _sample_enter_callback(), _sample_leave_callback(), _set_orientation(), _settings_colors_changed(), _settings_contrast_changed(), _settings_flip_changed(), _settings_guides_changed(), _shape_manager_handler_callback(), _snap_grid_callback(), _studio_deferred_refresh(), _studio_history_changed_callback(), _studio_set_image(), _studio_toggle_zoom(), _switch_cursors(), _tree_add_shape(), _tree_apply_operation(), _tree_selection_change(), _view_surface_commit_main(), _width_changed(), _x_changed(), _y_changed(), aspect_presets_changed(), auto_advance(), button_pressed(), button_pressed(), button_pressed(), button_pressed(), button_released(), button_released(), button_released(), checker_changed_callback(), checker_color_changed_callback(), color_picker_apply(), delete_history_callback(), dt_control_delete_images_job_run(), dt_control_duplicate_images_job_run(), dt_control_flip_images_job_run(), dt_control_local_copy_images_job_run(), dt_control_log_busy_enter(), dt_control_log_busy_leave(), dt_control_merge_hdr_job_run(), dt_control_monochrome_images_job_run(), dt_control_refresh_exif_run(), dt_control_remove_images_job_run(), dt_control_toast_busy_enter(), dt_control_toast_busy_leave(), dt_dev_darkroom_pipeline(), dt_dev_snapshot_request(), dt_drawlayer_commit_dabs(), dt_drawlayer_conf_apply_display_brush_color(), dt_drawlayer_runtime_manager_update(), dt_film_open(), dt_image_local_copy_reset(), dt_image_local_copy_set(), dt_iop_request_focus(), dt_masks_set_edit_mode(), entry_activated(), expose(), gui_changed(), gui_focus(), gui_reset(), gui_update(), key_pressed(), key_swap_callback(), keystone_type_changed(), load_xmp_callback(), mouse_leave(), mouse_leave(), mouse_moved(), mouse_moved(), mouse_moved(), mouse_moved(), paste_parts_callback(), row_activated(), rt_select_algorithm_callback(), rt_show_forms_for_current_scale(), safety_changed_callback(), scrolled(), scrolled(), set_params(), start_profiling_callback(), sync_pipe(), and ungroup_images_callback().

◆ dt_control_queue_redraw_widget()

◆ dt_control_quit()

◆ dt_control_running()

◆ dt_control_set_alert_handler()

void dt_control_set_alert_handler ( dt_control_alert_handler_t  handler)

Install the alert handler; NULL restores the fallback to dt_control_log().

Definition at line 866 of file control.c.

References _alert_handler.

Referenced by dt_gui_gtk_init().

◆ dt_control_set_cursor_visible_EXT()

void dt_control_set_cursor_visible_EXT ( gboolean  visible,
const char *  file,
int  line 
)

Set whether the cursor should be visible or not.

Cursor visibility changes are routed through a macro so the implementation can log the exact call site that requested the state transition.

Definition at line 425 of file control.c.

References darktable_t::control, dt_control_t::cursor, darktable, DT_DEBUG_CONTROL, DT_DEBUG_VERBOSE, dt_get_debug_flags(), dt_print(), and dt_control_t::hide.

◆ dt_control_set_keyboard_over_id()

◆ dt_control_set_mouse_over_id()

◆ dt_control_set_pointer_input()

void dt_control_set_pointer_input ( const dt_control_pointer_input_t *  input)

Definition at line 77 of file control.c.

References _pointer_input, and IS_NULL_PTR.

Referenced by _button_pressed(), _button_released(), and _mouse_moved().

◆ dt_control_set_shutdown_wait_handler()

void dt_control_set_shutdown_wait_handler ( dt_control_shutdown_wait_t  handler)

Install the handler dt_control_shutdown() waits in. NULL removes it.

Definition at line 470 of file control.c.

References _shutdown_wait.

Referenced by dt_gui_gtk_init().

◆ dt_control_shutdown()

◆ dt_control_toast_busy_enter()

◆ dt_control_toast_busy_leave()

◆ dt_control_toast_redraw()

void dt_control_toast_redraw ( )

Request a redraw of the toast message label.

Definition at line 985 of file control.c.

References dt_control_signal_get_global(), DT_DEBUG_CONTROL_SIGNAL_RAISE, and DT_SIGNAL_CONTROL_TOAST_REDRAW.

Referenced by _dt_ctl_toast_message_timeout_callback(), and _redraw_center().

◆ dt_ctl_open_image_in_darkroom()

void dt_ctl_open_image_in_darkroom ( const int32_t  imgid)

open one specific image in the darkroom, from any view and any thread.

The darkroom picks the image it opens from the mouse-over id, falling back on the selection. Both are volatile: a pointer motion rewrites the mouse-over id, and leaving the darkroom restores the selection to the image it was editing. A caller that knows which image it wants – an import job, a background task – must therefore not publish the target and request the view switch separately: it has to happen in one go on the GUI thread, which is what this does.

Parameters
imgidthe image to open. The caller owns this contract: an id that names no image only gets the darkroom to refuse the switch and log "No image to open".

Definition at line 760 of file control.c.

References _dt_ctl_open_image_in_darkroom().

Referenced by _dt_collection_change_view_after_import().

◆ dt_ctl_switch_mode_to()

◆ dt_ctl_switch_mode_to_by_view()

void dt_ctl_switch_mode_to_by_view ( const dt_view_t *  view)

◆ dt_toast_log()

◆ dt_toast_markup_log()

void dt_toast_markup_log ( const char *  msg,
  ... 
)

Definition at line 925 of file control.c.

References _toast_log(), and TRUE.

◆ lookup_color()

static GdkRGBA lookup_color ( GtkStyleContext *  context,
const char *  name 
)
static

Definition at line 537 of file control.c.

References color, and name.

Referenced by dt_control_expose().

Variable Documentation

◆ _alert_handler

dt_control_alert_handler_t _alert_handler = NULL
static

Definition at line 864 of file control.c.

Referenced by _alert(), and dt_control_set_alert_handler().

◆ _pointer_input

dt_control_pointer_input_t _pointer_input = { 0 }
static

Definition at line 75 of file control.c.

Referenced by dt_control_get_pointer_input(), and dt_control_set_pointer_input().

◆ _shutdown_wait

dt_control_shutdown_wait_t _shutdown_wait = NULL
static

Definition at line 468 of file control.c.

Referenced by dt_control_set_shutdown_wait_handler(), and dt_control_shutdown().