accelerators.c File Reference

#include "accelerators.h"
#include "common/darktable.h"
#include "control/control.h"
#include "control/conf.h"
#include "gui/gtk.h"
#include "gui/gtkentry.h"
#include "gui/gdkkeys.h"
#include "dtgtk/icon_cell_renderer.h"
#include <assert.h>
#include <glib.h>

Include dependency graph for accelerators.c:

Go to the source code of this file.

Data Structures
struct	PayloadClosure
struct	_accel_removal_t
struct	_accel_lookup_t
struct	_accel_treeview_t
struct	_accel_window_params_t
struct	dt_accels_search_state_t
struct	dt_accels_dispatch_state_t

Macros
#define	DT_ACCEL_SEARCH_INLINE_SEPARATOR   " > "
#define	DT_ACCEL_SEARCH_DISPATCH_RETRY_DELAY_MS   50
#define	DT_ACCEL_SEARCH_RECENT_KEY   "plugins/accel_search/recent_entries"
#define	DT_ACCEL_SEARCH_RECENT_MAX   20

Typedefs
typedef struct _accel_removal_t	_accel_removal_t
typedef struct _accel_lookup_t	_accel_lookup_t
typedef struct _accel_treeview_t	_accel_treeview_t
typedef struct _accel_window_params_t	_accel_window_params_t
typedef struct dt_accels_search_state_t	dt_accels_search_state_t
typedef struct dt_accels_dispatch_state_t	dt_accels_dispatch_state_t

Enumerations
enum	{   COL_NAME ,   COL_KEYS ,   COL_CLEAR ,   COL_DESCRIPTION ,   COL_PATH ,   COL_SHORTCUT ,   COL_KEYVAL ,   COL_MODS ,   NUM_COLUMNS }

Functions
static void	_g_list_closure_unref (gpointer data)
static void	_shortcut_set_widget_data (GtkWidget *widget, dt_shortcut_t *shortcut)
static gboolean	_accels_tooltip_query_hook (GSignalInvocationHint *hint, guint n_param_values, const GValue *param_values, gpointer data)
static void	_accels_install_tooltip_hook (void)
static void	_clean_shortcut (gpointer data)
PayloadClosure *	dt_shortcut_get_payload_closure (dt_shortcut_t *shortcut)
GClosure *	dt_shortcut_get_closure (dt_shortcut_t *shortcut)
void	dt_shortcut_remove_closure (dt_shortcut_t *shortcut, gpointer data)
static void	_find_parent_hashtable (gpointer _key, gpointer value, gpointer user_data)
static void	_insert_parent_data_into_children (dt_shortcut_t *shortcut)
void	dt_shortcut_set_closure (dt_shortcut_t *shortcut, gboolean(*action_callback)(GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data), gpointer data)
dt_accels_t *	dt_accels_init (char *config_file, GtkAccelFlags flags)
void	dt_accels_cleanup (dt_accels_t *accels)
void	dt_accels_connect_active_group (dt_accels_t *accels, const gchar *group)
	Connect the contextual active accels group to the window. Views can declare their own set of contextual accels, which can override the global accels, in case they use the same keys.
void	dt_accels_disconnect_active_group (dt_accels_t *accels)
	Disconnect the contextual active accels group from the window.
static gboolean	_update_shortcut_state (dt_shortcut_t *shortcut, GtkAccelKey *key, gboolean init)
static void	_add_widget_accel (dt_shortcut_t *shortcut, GtkAccelFlags flags)
static void	_remove_widget_accel (dt_shortcut_t *shortcut, const GtkAccelKey *old_key)
static void	_remove_generic_accel (dt_shortcut_t *shortcut)
static void	_add_generic_accel (dt_shortcut_t *shortcut, GtkAccelFlags flags)
static void	_insert_accel (dt_accels_t *accels, dt_shortcut_t *shortcut)
static gboolean	_virtual_shortcut_callback (GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)
void	dt_accels_new_virtual_shortcut (dt_accels_t *accels, GtkAccelGroup *accel_group, const gchar *accel_path, GtkWidget *widget, guint key_val, GdkModifierType accel_mods)
	Add a new virtual shortcut. Virtual shortcuts are immutable, read-only and don't trigger any action. They are meant to serve as placeholders, in a purely declarative way, for key combinations hardcoded in the key-pressed events handlers of widgets able to capture focus. Once declared here, they will prevent users from declaring their own shortcuts using hardcoded combinations for the corresponding accel_group.
void	dt_accels_new_virtual_instance_shortcut (dt_accels_t *accels, gboolean(*action_callback)(GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data), gpointer data, GtkAccelGroup *accel_group, const gchar *action_scope, const gchar *action_name)
void	dt_accels_new_widget_shortcut (dt_accels_t *accels, GtkWidget *widget, const gchar *signal, GtkAccelGroup *accel_group, const gchar *accel_path, guint key_val, GdkModifierType accel_mods, const gboolean lock)
	Register a new shortcut for a widget, setting up its path, default keys and accel group. This does everything but connecting it, so exists only as a defined slot to be connected later.
void	dt_accels_new_action_shortcut (dt_accels_t *accels, gboolean(*action_callback)(GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data), gpointer data, GtkAccelGroup *accel_group, const gchar *action_scope, const gchar *action_name, guint key_val, GdkModifierType accel_mods, const gboolean lock, const char *description)
	Register a new shortcut for a generic action, setting up its path, default keys and accel group. This does everything but connecting it, so exists only as a defined slot to be connected later.
void	dt_accels_load_user_config (dt_accels_t *accels)
	Loads keyboardrc.lang from config dir. This needs to run after we inited the accel map from widgets creation.
static void	_connect_accel (dt_shortcut_t *shortcut)
static void	_connect_accel_hashtable (gpointer _key, gpointer value, gpointer user_data)
void	dt_accels_connect_accels (dt_accels_t *accels)
	Actually enable accelerators after having loaded user config.
static void	_remove_accel_hashtable (gpointer _key, gpointer value, gpointer user_data)
void	dt_accels_remove_accel (dt_accels_t *accels, const char *path, gpointer data)
	Recursively remove all accels for all shortcuts containing path. This is unneeded for accels attached to Gtk widgets through dt_accels_new_widget_shortcut because Gtk will handle that internally when deleting a widget. But for our own widget-less dt_accels_new_action_shortcut, we need to handle that ourselves.
void	dt_accels_remove_shortcut (dt_accels_t *accels, const char *path)
	Remove the shortcut object identified by path and all its accels.
gchar *	dt_accels_build_path (const gchar *scope, const gchar *feature)
static void	_accels_keys_decode (dt_accels_t *accels, GdkEvent *event, guint *keyval, GdkModifierType *mods)
static guint	_normalize_keyval (const guint keyval)
static void	_for_each_accel (gpointer key, gpointer value, gpointer user_data)
static const char *	_find_path_for_keys (dt_accels_t *accels, guint key, GdkModifierType modifier, GtkAccelGroup *group)
static void	_for_each_non_virtual_accel (gpointer key, gpointer value, gpointer user_data)
static dt_shortcut_t *	_find_non_virtual_shortcut (dt_accels_t *accels, GtkAccelGroup *group, guint keyval, GdkModifierType mods)
static gboolean	_call_shortcut_cclosure (dt_shortcut_t *shortcut, GtkWindow *main_window, GClosure *closure)
static gboolean	_key_pressed (GtkWidget *w, GdkEvent *event, dt_accels_t *accels, guint keyval, GdkModifierType mods)
gboolean	dt_accels_dispatch (GtkWidget *w, GdkEvent *event, gpointer user_data)
	Force our listener for all key strokes to bypass reserved Gtk keys.
void	dt_accels_attach_scroll_handler (dt_accels_t *accels, gboolean(*callback)(GdkEventScroll event, void *data), void *data)
	Attach a new global scroll event callback. So far this is used in darkroom to redirect scroll events to a Bauhaus widget when the focusing shortcut of that widget is held down on keyboard.
void	dt_accels_detach_scroll_handler (dt_accels_t *accels)
static void	_make_column_editable (GtkTreeViewColumn *col, GtkCellRenderer *renderer, GtkTreeModel *model, GtkTreeIter *iter, gpointer data)
static void	_make_column_clearable (GtkTreeViewColumn *col, GtkCellRenderer *renderer, GtkTreeModel *model, GtkTreeIter *iter, gpointer data)
static int	guess_key_group (dt_accels_t *accels, guint keyval, guint hardware_keycode)
static void	_shortcut_edited (GtkCellRenderer *cell, const gchar *path_string, guint key, GdkModifierType mods, guint hardware_key, gpointer user_data)
static void	_shortcut_cleared (GtkCellRendererAccel *renderer, const gchar *path_string, gpointer user_data)
static gboolean	_icon_activate (GtkCellRenderer *cell, GdkEvent *event, GtkWidget *treeview, const gchar *path_str, GdkRectangle *background, GdkRectangle *cell_area, GtkCellRendererState flags, gpointer user_data)
static void	_create_main_row (GtkTreeStore *store, GtkTreeIter *iter, const char *label, const char *path, dt_shortcut_t *shortcut)
void	_for_each_accel_create_treeview_row (gpointer key, gpointer value, gpointer user_data)
static gchar *	_shortcut_search_trim_display_path (const gchar *path)
void	_for_each_path_create_treeview_row (gpointer key, gpointer value, gpointer user_data)
static gint	_sort_model_by_relevance_func (GtkTreeModel *model, GtkTreeIter *a, GtkTreeIter *b, gpointer data)
static gint	_sort_model_func (GtkTreeModel *model, GtkTreeIter *a, GtkTreeIter *b, gpointer data)
static gboolean	filter_callback (GtkTreeModel *model, GtkTreeIter *iter, gpointer user_data)
static void	search_changed (GtkEntry *entry, gpointer user_data)
void	dt_accels_window (dt_accels_t *accels, GtkWindow *main_window)
	Show the modal dialog listing all available keyboard shortcuts and letting user to set them.
static int	_match_text (GtkTreeModel *model, GtkTreeIter *iter, const char *needle)
static void	_find_and_rank_matches (GtkTreeModel *model, GtkWidget *search_entry)
static void	_shortcut_search_load_recent_entries (GtkListStore *store)
static gint	_shortcut_search_recent_sort_func (GtkTreeModel *model, GtkTreeIter *a, GtkTreeIter *b, gpointer user_data)
static void	_shortcut_search_save_recent_entry (const char *query, const dt_shortcut_t *shortcut)
static gboolean	_dispatch_selected_shortcut_idle (gpointer data)
static void	_search_entry_changed (GtkWidget *widget, gpointer user_data)
static gboolean	_shortcut_search_recent_match_selected (GtkEntryCompletion *completion, GtkTreeModel *model, GtkTreeIter *iter, gpointer user_data)
static gboolean	_shortcut_search_recent_insert_prefix (GtkEntryCompletion *completion, gchar *prefix, gpointer user_data)
static void	_dispatch_selected_shortcut (dt_accels_dispatch_state_t *state)
static gboolean	_shortcut_search_visible (GtkTreeModel *model, GtkTreeIter *iter, gpointer user_data)
static gboolean	_shortcut_search_recent_completion_match (GtkEntryCompletion *completion, const gchar *key, GtkTreeIter *iter, gpointer user_data)
static gboolean	_queue_action_from_shortcut (dt_shortcut_t *shortcut, GtkWidget *window, dt_accels_search_state_t *state)
static void	_shortcut_search_selection_changed (GtkTreeSelection *selection, gpointer user_data)
static gboolean	_shortcut_search_row_activated (GtkTreeView *tree_view, GtkTreePath *path, GtkTreeViewColumn *column, gpointer user_data)
static gboolean	_shortcut_search_move_selection (dt_accels_search_state_t *state, const gboolean forward)
static gboolean	_search_entry_restore_space_idle (gpointer user_data)
static gboolean	_search_entry_key_pressed (GtkWidget *widget __attribute__((unused)), GdkEventKey *event, gpointer user_data)
static gboolean	_search_entry_button_pressed (GtkWidget *widget, GdkEventButton *event, gpointer user_data)
static gboolean	_shortcut_search_window_key_pressed (GtkWidget *widget, GdkEventKey *event, gpointer user_data)
static gboolean	_shortcut_search_button_press (GtkWidget *widget, GdkEventButton *event, gpointer user_data)
static void	_shortcut_search_destroy (GtkWidget *widget, gpointer user_data)
void	dt_accels_search (dt_accels_t *accels, GtkWindow *main_window, GtkWidget *anchor)

Variables
static dt_accels_t *	accels_global_ref = NULL

Macro Definition Documentation

DT_ACCEL_SEARCH_DISPATCH_RETRY_DELAY_MS

#define DT_ACCEL_SEARCH_DISPATCH_RETRY_DELAY_MS   50

Definition at line 62 of file accelerators.c.

DT_ACCEL_SEARCH_INLINE_SEPARATOR

#define DT_ACCEL_SEARCH_INLINE_SEPARATOR   " > "

Definition at line 61 of file accelerators.c.

DT_ACCEL_SEARCH_RECENT_KEY

#define DT_ACCEL_SEARCH_RECENT_KEY   "plugins/accel_search/recent_entries"

Definition at line 1923 of file accelerators.c.

DT_ACCEL_SEARCH_RECENT_MAX

#define DT_ACCEL_SEARCH_RECENT_MAX   20

Definition at line 1924 of file accelerators.c.

Typedef Documentation

_accel_lookup_t

typedef struct _accel_lookup_t _accel_lookup_t

_accel_removal_t

typedef struct _accel_removal_t _accel_removal_t

_accel_treeview_t

typedef struct _accel_treeview_t _accel_treeview_t

_accel_window_params_t

typedef struct _accel_window_params_t _accel_window_params_t

dt_accels_dispatch_state_t

typedef struct dt_accels_dispatch_state_t dt_accels_dispatch_state_t

dt_accels_search_state_t

typedef struct dt_accels_search_state_t dt_accels_search_state_t

Enumeration Type Documentation

anonymous enum

anonymous enum

Enumerator
COL_NAME
COL_KEYS
COL_CLEAR
COL_DESCRIPTION
COL_PATH
COL_SHORTCUT
COL_KEYVAL
COL_MODS
NUM_COLUMNS

Definition at line 1171 of file accelerators.c.

Function Documentation

_accels_install_tooltip_hook()

static void _accels_install_tooltip_hook ( void  )

static

Definition at line 191 of file accelerators.c.

References _accels_tooltip_query_hook().

Referenced by dt_accels_init().

_accels_keys_decode()

static void _accels_keys_decode ( dt_accels_t *  accels, GdkEvent *  event, guint *  keyval, GdkModifierType *  mods  )

static

Definition at line 897 of file accelerators.c.

References darktable, dt_accels_t::default_mod_mask, DT_DEBUG_SHORTCUTS, dt_free, dt_keys_mainpad_alternatives(), dt_print(), IS_NULL_PTR, dt_accels_t::keymap, and darktable_t::unmuted.

Referenced by _shortcut_edited(), and dt_accels_dispatch().

_accels_tooltip_query_hook()

static gboolean _accels_tooltip_query_hook ( GSignalInvocationHint *  hint, guint  n_param_values, const GValue *  param_values, gpointer  data  )

static

Definition at line 91 of file accelerators.c.

References dt_accels_t::acceleratables, dt_gui_gtk_t::accels, darktable, dt_shortcut_t::description, DT_ACCELS_WIDGET_SHORTCUT_KEY, DT_ACCELS_WIDGET_TOOLTIP_DISABLED_KEY, dt_free, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), darktable_t::gui, IS_NULL_PTR, dt_shortcut_t::key, dt_accels_t::lock, dt_shortcut_t::mods, TRUE, and void().

Referenced by _accels_install_tooltip_hook().

_add_generic_accel()

static void _add_generic_accel ( dt_shortcut_t *  shortcut, GtkAccelFlags  flags  )

static

Definition at line 531 of file accelerators.c.

References dt_shortcut_t::accel_group, dt_shortcut_get_closure(), flags, dt_shortcut_t::key, and dt_shortcut_t::mods.

Referenced by _connect_accel(), _remove_accel_hashtable(), and dt_accels_new_action_shortcut().

_add_widget_accel()

static void _add_widget_accel ( dt_shortcut_t *  shortcut, GtkAccelFlags  flags  )

static

For native Gtk widget accels, we create alternatives for numpad keys, in case we fail to decode them ourselves and defer to native Gtk. Otherwise, numpad keys are also converted at input event handling.

Definition at line 495 of file accelerators.c.

References dt_shortcut_t::accel_group, dt_keys_numpad_alternatives(), flags, dt_shortcut_t::key, dt_shortcut_t::mods, dt_shortcut_t::signal, and dt_shortcut_t::widget.

Referenced by _connect_accel(), and dt_accels_new_widget_shortcut().

_call_shortcut_cclosure()

static gboolean _call_shortcut_cclosure ( dt_shortcut_t *  shortcut, GtkWindow *  main_window, GClosure *  closure  )

static

Definition at line 2449 of file accelerators.c.

References dt_shortcut_t::accel_group, dt_shortcut_get_closure(), FALSE, IS_NULL_PTR, k, dt_shortcut_t::key, and dt_shortcut_t::mods.

Referenced by _dispatch_selected_shortcut(), and _key_pressed().

_clean_shortcut()

static void _clean_shortcut ( gpointer  data )

static

Definition at line 203 of file accelerators.c.

References _g_list_closure_unref(), dt_shortcut_t::closure, dt_free, and dt_shortcut_t::path.

Referenced by dt_accels_init().

_connect_accel()

static void _connect_accel ( dt_shortcut_t *  shortcut )

static

Definition at line 782 of file accelerators.c.

References _add_generic_accel(), _add_widget_accel(), _remove_generic_accel(), _remove_widget_accel(), _update_shortcut_state(), dt_shortcut_t::accels, dt_shortcut_get_closure(), DT_SHORTCUT_UNSET, dt_accels_t::flags, dt_accels_t::init, key, dt_shortcut_t::key, dt_shortcut_t::mods, dt_shortcut_t::path, dt_shortcut_t::type, and dt_shortcut_t::widget.

Referenced by _connect_accel_hashtable(), and _shortcut_edited().

_connect_accel_hashtable()

static void _connect_accel_hashtable ( gpointer  _key, gpointer  value, gpointer  user_data  )

static

Definition at line 821 of file accelerators.c.

References _connect_accel(), and value.

Referenced by dt_accels_connect_accels().

_create_main_row()

static void _create_main_row ( GtkTreeStore *  store, GtkTreeIter *  iter, const char *  label, const char *  path, dt_shortcut_t *  shortcut  )

static

Definition at line 1350 of file accelerators.c.

References COL_DESCRIPTION, COL_KEYVAL, COL_MODS, COL_NAME, COL_PATH, COL_SHORTCUT, dt_shortcut_t::description, dt_shortcut_t::key, dt_shortcut_t::mods, and store().

Referenced by _for_each_accel_create_treeview_row().

_dispatch_selected_shortcut()

static void _dispatch_selected_shortcut ( dt_accels_dispatch_state_t *  state )

static

Definition at line 2490 of file accelerators.c.

References _call_shortcut_cclosure(), _dispatch_selected_shortcut_idle(), dt_accels_dispatch_state_t::accels, PayloadClosure::base, dt_shortcut_t::closure, darktable, dt_shortcut_t::description, DT_ACCEL_SEARCH_DISPATCH_RETRY_DELAY_MS, DT_DEBUG_SHORTCUTS, dt_gui_refocus_center(), dt_print(), dt_shortcut_get_closure(), dt_shortcut_get_payload_closure(), FALSE, darktable_t::gui, dt_gui_gtk_t::has_scroll_focus, IS_NULL_PTR, dt_accels_dispatch_state_t::main_window, dt_accels_dispatch_state_t::path, dt_accels_dispatch_state_t::retries, state, and dt_shortcut_t::widget.

Referenced by _dispatch_selected_shortcut_idle().

_dispatch_selected_shortcut_idle()

static gboolean _dispatch_selected_shortcut_idle ( gpointer  data )

static

Definition at line 2648 of file accelerators.c.

References _dispatch_selected_shortcut(), dt_free, and state.

Referenced by _dispatch_selected_shortcut(), and dt_accels_search().

_find_and_rank_matches()

static void _find_and_rank_matches ( GtkTreeModel *  model, GtkWidget *  search_entry  )

static

Definition at line 1872 of file accelerators.c.

References _match_text(), DT_ACCEL_SEARCH_INLINE_SEPARATOR, dt_free, IS_NULL_PTR, and model.

Referenced by _search_entry_changed().

_find_non_virtual_shortcut()

static dt_shortcut_t * _find_non_virtual_shortcut ( dt_accels_t *  accels, GtkAccelGroup *  group, guint  keyval, GdkModifierType  mods  )

static

Definition at line 1034 of file accelerators.c.

References _for_each_non_virtual_accel(), dt_accels_t::acceleratables, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), IS_NULL_PTR, dt_accels_t::lock, and _accel_lookup_t::results.

Referenced by _key_pressed().

_find_parent_hashtable()

static void _find_parent_hashtable ( gpointer  _key, gpointer  value, gpointer  user_data  )

static

Definition at line 273 of file accelerators.c.

References dt_free, dt_shortcut_get_closure(), dt_shortcut_get_payload_closure(), n, PayloadClosure::parent_data, dt_shortcut_t::path, and value.

Referenced by _insert_parent_data_into_children().

_find_path_for_keys()

static const char * _find_path_for_keys ( dt_accels_t *  accels, guint  key, GdkModifierType  modifier, GtkAccelGroup *  group  )

static

Definition at line 989 of file accelerators.c.

References _for_each_accel(), dt_accels_t::acceleratables, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), key, dt_accels_t::lock, and _accel_lookup_t::results.

Referenced by _shortcut_edited().

_for_each_accel()

static void _for_each_accel ( gpointer  key, gpointer  value, gpointer  user_data  )

inlinestatic

Definition at line 959 of file accelerators.c.

References _normalize_keyval(), dt_shortcut_t::accel_group, DT_DEBUG_SHORTCUTS, dt_print(), _accel_lookup_t::group, key, _accel_lookup_t::key, dt_shortcut_t::key, _accel_lookup_t::modifier, dt_shortcut_t::mods, dt_shortcut_t::path, _accel_lookup_t::results, and value.

Referenced by _find_path_for_keys().

_for_each_accel_create_treeview_row()

void _for_each_accel_create_treeview_row	(	gpointer	key,
		gpointer	value,
		gpointer	user_data
	)

Definition at line 1362 of file accelerators.c.

References _create_main_row(), COL_KEYS, COL_NAME, COL_PATH, dt_free, i, IS_NULL_PTR, key, _accel_treeview_t::node_cache, _accel_treeview_t::store, store(), and value.

Referenced by dt_accels_window().

_for_each_non_virtual_accel()

static void _for_each_non_virtual_accel ( gpointer  key, gpointer  value, gpointer  user_data  )

inlinestatic

Definition at line 1006 of file accelerators.c.

References _normalize_keyval(), dt_shortcut_t::accel_group, DT_DEBUG_SHORTCUTS, dt_print(), _accel_lookup_t::group, key, _accel_lookup_t::key, dt_shortcut_t::key, _accel_lookup_t::modifier, dt_shortcut_t::mods, dt_shortcut_t::path, _accel_lookup_t::results, value, and dt_shortcut_t::virtual_shortcut.

Referenced by _find_non_virtual_shortcut().

_for_each_path_create_treeview_row()

void _for_each_path_create_treeview_row	(	gpointer	key,
		gpointer	value,
		gpointer	user_data
	)

Definition at line 1449 of file accelerators.c.

References _shortcut_search_trim_display_path(), dt_shortcut_t::accel_group, dt_shortcut_t::accels, dt_accels_t::active_group, dt_shortcut_t::description, dt_free, dt_accels_t::global_accels, IS_NULL_PTR, key, dt_shortcut_t::key, dt_shortcut_t::mods, store(), and value.

Referenced by dt_accels_search().

_g_list_closure_unref()

static void _g_list_closure_unref ( gpointer  data )

static

Definition at line 76 of file accelerators.c.

References PayloadClosure::base, and dt_free.

Referenced by _clean_shortcut().

_icon_activate()

static gboolean _icon_activate ( GtkCellRenderer *  cell, GdkEvent *  event, GtkWidget *  treeview, const gchar *  path_str, GdkRectangle *  background, GdkRectangle *  cell_area, GtkCellRendererState  flags, gpointer  user_data  )

static

Definition at line 1340 of file accelerators.c.

References _shortcut_edited(), and TRUE.

Referenced by dt_accels_window().

_insert_accel()

static void _insert_accel ( dt_accels_t *  accels, dt_shortcut_t *  shortcut  )

static

Definition at line 539 of file accelerators.c.

References dt_accels_t::acceleratables, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), dt_accels_t::lock, and dt_shortcut_t::path.

Referenced by dt_accels_new_action_shortcut(), dt_accels_new_virtual_shortcut(), and dt_accels_new_widget_shortcut().

_insert_parent_data_into_children()

static void _insert_parent_data_into_children ( dt_shortcut_t *  shortcut )

static

Definition at line 307 of file accelerators.c.

References _find_parent_hashtable(), dt_accels_t::acceleratables, and dt_shortcut_t::accels.

Referenced by dt_shortcut_set_closure().

_key_pressed()

static gboolean _key_pressed ( GtkWidget *  w, GdkEvent *  event, dt_accels_t *  accels, guint  keyval, GdkModifierType  mods  )

static

Definition at line 1054 of file accelerators.c.

References _call_shortcut_cclosure(), _find_non_virtual_shortcut(), dt_accels_t::active_group, DT_DEBUG_SHORTCUTS, dt_free, dt_print(), FALSE, dt_accels_t::global_accels, IS_NULL_PTR, and TRUE.

Referenced by dt_accels_dispatch().

_make_column_clearable()

static void _make_column_clearable ( GtkTreeViewColumn *  col, GtkCellRenderer *  renderer, GtkTreeModel *  model, GtkTreeIter *  iter, gpointer  data  )

static

Definition at line 1203 of file accelerators.c.

References COL_SHORTCUT, IS_NULL_PTR, dt_shortcut_t::key, dt_shortcut_t::locked, and model.

Referenced by dt_accels_window().

_make_column_editable()

static void _make_column_editable ( GtkTreeViewColumn *  col, GtkCellRenderer *  renderer, GtkTreeModel *  model, GtkTreeIter *  iter, gpointer  data  )

static

Definition at line 1191 of file accelerators.c.

References COL_SHORTCUT, IS_NULL_PTR, dt_shortcut_t::locked, and model.

Referenced by dt_accels_window().

_match_text()

static int _match_text ( GtkTreeModel *  model, GtkTreeIter *  iter, const char *  needle  )

static

Definition at line 1811 of file accelerators.c.

References dt_free, FALSE, i, IS_NULL_PTR, model, t, and TRUE.

Referenced by _find_and_rank_matches().

_normalize_keyval()

static guint _normalize_keyval ( const guint  keyval )

inlinestatic

Definition at line 953 of file accelerators.c.

Referenced by _for_each_accel(), _for_each_non_virtual_accel(), and filter_callback().

_queue_action_from_shortcut()

static gboolean _queue_action_from_shortcut ( dt_shortcut_t *  shortcut, GtkWidget *  window, dt_accels_search_state_t *  state  )

static

Definition at line 2705 of file accelerators.c.

References _shortcut_search_save_recent_entry(), dt_shortcut_t::description, DT_ACCEL_SEARCH_INLINE_SEPARATOR, DT_DEBUG_SHORTCUTS, dt_free, dt_print(), IS_NULL_PTR, dt_shortcut_t::path, state, and TRUE.

Referenced by _search_entry_key_pressed(), and _shortcut_search_row_activated().

_remove_accel_hashtable()

static void _remove_accel_hashtable ( gpointer  _key, gpointer  value, gpointer  user_data  )

static

Definition at line 836 of file accelerators.c.

References _add_generic_accel(), _remove_generic_accel(), dt_shortcut_t::accels, dt_shortcut_get_closure(), dt_shortcut_remove_closure(), dt_accels_t::flags, dt_shortcut_t::key, dt_shortcut_t::path, and value.

Referenced by dt_accels_remove_accel().

_remove_generic_accel()

static void _remove_generic_accel ( dt_shortcut_t *  shortcut )

static

Definition at line 519 of file accelerators.c.

References dt_shortcut_t::accel_group, dt_shortcut_get_closure(), and IS_NULL_PTR.

Referenced by _connect_accel(), _remove_accel_hashtable(), and dt_accels_new_action_shortcut().

_remove_widget_accel()

static void _remove_widget_accel ( dt_shortcut_t *  shortcut, const GtkAccelKey *  old_key  )

static

Definition at line 508 of file accelerators.c.

References dt_shortcut_t::accel_group, dt_keys_numpad_alternatives(), and dt_shortcut_t::widget.

Referenced by _connect_accel(), and dt_accels_new_widget_shortcut().

_search_entry_button_pressed()

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

static

Definition at line 2944 of file accelerators.c.

References DT_ACCEL_SEARCH_INLINE_SEPARATOR, dt_free, FALSE, IS_NULL_PTR, state, and TRUE.

Referenced by dt_accels_search().

_search_entry_changed()

static void _search_entry_changed ( GtkWidget *  widget, gpointer  user_data  )

static

Definition at line 2180 of file accelerators.c.

References _find_and_rank_matches(), FALSE, IS_NULL_PTR, dt_shortcut_t::path, dt_accels_search_state_t::selected, state, and TRUE.

Referenced by dt_accels_search().

_search_entry_key_pressed()

static gboolean _search_entry_key_pressed ( GtkWidget *widget   __attribute__(unused), GdkEventKey *  event, gpointer  user_data  )

static

Definition at line 2809 of file accelerators.c.

References _queue_action_from_shortcut(), _search_entry_restore_space_idle(), _shortcut_search_move_selection(), _shortcut_search_trim_display_path(), DT_ACCEL_SEARCH_INLINE_SEPARATOR, dt_free, dt_keys_mainpad_alternatives(), FALSE, has_selection(), IS_NULL_PTR, key, MIN, dt_shortcut_t::path, position(), state, and TRUE.

Referenced by _shortcut_search_window_key_pressed(), and dt_accels_search().

_search_entry_restore_space_idle()

static gboolean _search_entry_restore_space_idle ( gpointer  user_data )

static

Definition at line 2792 of file accelerators.c.

References dt_free, IS_NULL_PTR, dt_accels_search_state_t::pending_space_idle_id, and state.

Referenced by _search_entry_key_pressed().

_shortcut_cleared()

static void _shortcut_cleared ( GtkCellRendererAccel *  renderer, const gchar *  path_string, gpointer  user_data  )

static

Definition at line 1334 of file accelerators.c.

References _shortcut_edited().

Referenced by dt_accels_window().

_shortcut_edited()

static void _shortcut_edited ( GtkCellRenderer *  cell, const gchar *  path_string, guint  key, GdkModifierType  mods, guint  hardware_key, gpointer  user_data  )

static

Definition at line 1241 of file accelerators.c.

References _accels_keys_decode(), _connect_accel(), _find_path_for_keys(), dt_shortcut_t::accel_group, dt_shortcut_t::accels, accels_global_ref, COL_KEYVAL, COL_MODS, COL_SHORTCUT, dt_free, dt_keys_mainpad_alternatives(), FALSE, guess_key_group(), IS_NULL_PTR, key, dt_shortcut_t::path, state, and store().

Referenced by _icon_activate(), _shortcut_cleared(), and dt_accels_window().

_shortcut_search_button_press()

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

static

Definition at line 2970 of file accelerators.c.

References FALSE, IS_NULL_PTR, state, and TRUE.

Referenced by dt_accels_search().

_shortcut_search_destroy()

static void _shortcut_search_destroy ( GtkWidget *  widget, gpointer  user_data  )

static

Definition at line 3002 of file accelerators.c.

References dt_free, IS_NULL_PTR, and state.

Referenced by dt_accels_search().

_shortcut_search_load_recent_entries()

static void _shortcut_search_load_recent_entries ( GtkListStore *  store )

static

Definition at line 1926 of file accelerators.c.

References _shortcut_search_trim_display_path(), DT_ACCEL_SEARCH_INLINE_SEPARATOR, DT_ACCEL_SEARCH_RECENT_KEY, DT_ACCEL_SEARCH_RECENT_MAX, dt_conf_get_string(), dt_conf_key_exists(), dt_free, i, IS_NULL_PTR, and store().

Referenced by dt_accels_search().

_shortcut_search_move_selection()

static gboolean _shortcut_search_move_selection ( dt_accels_search_state_t *  state, const gboolean  forward  )

static

Definition at line 2752 of file accelerators.c.

References FALSE, IS_NULL_PTR, state, and TRUE.

Referenced by _search_entry_key_pressed().

_shortcut_search_recent_completion_match()

static gboolean _shortcut_search_recent_completion_match ( GtkEntryCompletion *  completion, const gchar *  key, GtkTreeIter *  iter, gpointer  user_data  )

static

Definition at line 2664 of file accelerators.c.

References DT_ACCEL_SEARCH_INLINE_SEPARATOR, dt_free, FALSE, IS_NULL_PTR, key, and model.

Referenced by dt_accels_search().

_shortcut_search_recent_insert_prefix()

static gboolean _shortcut_search_recent_insert_prefix ( GtkEntryCompletion *  completion, gchar *  prefix, gpointer  user_data  )

static

Definition at line 2254 of file accelerators.c.

References _shortcut_search_trim_display_path(), DT_ACCEL_SEARCH_INLINE_SEPARATOR, dt_free, FALSE, IS_NULL_PTR, MAX, model, dt_shortcut_t::path, state, and TRUE.

Referenced by dt_accels_search().

_shortcut_search_recent_match_selected()

static gboolean _shortcut_search_recent_match_selected ( GtkEntryCompletion *  completion, GtkTreeModel *  model, GtkTreeIter *  iter, gpointer  user_data  )

static

Definition at line 2227 of file accelerators.c.

References dt_free, IS_NULL_PTR, model, state, and TRUE.

Referenced by dt_accels_search().

_shortcut_search_recent_sort_func()

static gint _shortcut_search_recent_sort_func ( GtkTreeModel *  model, GtkTreeIter *  a, GtkTreeIter *  b, gpointer  user_data  )

static

Definition at line 1986 of file accelerators.c.

References DT_ACCEL_SEARCH_INLINE_SEPARATOR, dt_free, IS_NULL_PTR, model, and state.

Referenced by dt_accels_search().

_shortcut_search_row_activated()

static gboolean _shortcut_search_row_activated ( GtkTreeView *  tree_view, GtkTreePath *  path, GtkTreeViewColumn *  column, gpointer  user_data  )

static

Definition at line 2740 of file accelerators.c.

References _queue_action_from_shortcut(), FALSE, and state.

Referenced by dt_accels_search().

_shortcut_search_save_recent_entry()

static void _shortcut_search_save_recent_entry ( const char *  query, const dt_shortcut_t *  shortcut  )

static

Definition at line 2070 of file accelerators.c.

References DT_ACCEL_SEARCH_RECENT_KEY, DT_ACCEL_SEARCH_RECENT_MAX, dt_conf_get_string(), dt_conf_key_exists(), dt_conf_set_string(), dt_free, FALSE, i, IS_NULL_PTR, k, dt_shortcut_t::path, and TRUE.

Referenced by _queue_action_from_shortcut().

_shortcut_search_selection_changed()

static void _shortcut_search_selection_changed ( GtkTreeSelection *  selection, gpointer  user_data  )

static

Definition at line 2726 of file accelerators.c.

References state.

Referenced by dt_accels_search().

_shortcut_search_trim_display_path()

static gchar * _shortcut_search_trim_display_path ( const gchar *  path )

static

Definition at line 1432 of file accelerators.c.

References IS_NULL_PTR.

Referenced by _for_each_path_create_treeview_row(), _search_entry_key_pressed(), _shortcut_search_load_recent_entries(), and _shortcut_search_recent_insert_prefix().

_shortcut_search_visible()

static gboolean _shortcut_search_visible ( GtkTreeModel *  model, GtkTreeIter *  iter, gpointer  user_data  )

static

Definition at line 2657 of file accelerators.c.

References model.

Referenced by dt_accels_search().

_shortcut_search_window_key_pressed()

static gboolean _shortcut_search_window_key_pressed ( GtkWidget *  widget, GdkEventKey *  event, gpointer  user_data  )

static

Definition at line 2965 of file accelerators.c.

References _search_entry_key_pressed().

Referenced by dt_accels_search().

_shortcut_set_widget_data()

static void _shortcut_set_widget_data ( GtkWidget *  widget, dt_shortcut_t *  shortcut  )

inlinestatic

Definition at line 83 of file accelerators.c.

References DT_ACCELS_WIDGET_SHORTCUT_KEY, DT_ACCELS_WIDGET_TOOLTIP_DISABLED_KEY, IS_NULL_PTR, and TRUE.

Referenced by dt_accels_new_virtual_shortcut(), and dt_accels_new_widget_shortcut().

_sort_model_by_relevance_func()

static gint _sort_model_by_relevance_func ( GtkTreeModel *  model, GtkTreeIter *  a, GtkTreeIter *  b, gpointer  data  )

static

Definition at line 1491 of file accelerators.c.

References dt_free, i, IS_NULL_PTR, and model.

Referenced by dt_accels_search().

_sort_model_func()

static gint _sort_model_func ( GtkTreeModel *  model, GtkTreeIter *  a, GtkTreeIter *  b, gpointer  data  )

static

Definition at line 1548 of file accelerators.c.

References dt_free, and model.

Referenced by dt_accels_window().

_update_shortcut_state()

static gboolean _update_shortcut_state ( dt_shortcut_t *  shortcut, GtkAccelKey *  key, gboolean  init  )

static

Definition at line 435 of file accelerators.c.

References DT_SHORTCUT_DEFAULT, DT_SHORTCUT_UNSET, DT_SHORTCUT_USER, FALSE, init(), key, dt_shortcut_t::key, dt_shortcut_t::locked, dt_shortcut_t::mods, dt_shortcut_t::path, TRUE, and dt_shortcut_t::type.

Referenced by _connect_accel().

_virtual_shortcut_callback()

static gboolean _virtual_shortcut_callback ( GtkAccelGroup *  group, GObject *  acceleratable, guint  keyval, GdkModifierType  mods, gpointer  user_data  )

static

Definition at line 549 of file accelerators.c.

References dt_free, FALSE, IS_NULL_PTR, dt_shortcut_t::key, dt_shortcut_t::mods, n, TRUE, and dt_shortcut_t::widget.

Referenced by dt_accels_new_virtual_shortcut().

dt_accels_attach_scroll_handler()

void dt_accels_attach_scroll_handler	(	dt_accels_t *	accels,
		gboolean(*)(GdkEventScroll event, void *data)	callback,
		void *	data
	)

Attach a new global scroll event callback. So far this is used in darkroom to redirect scroll events to a Bauhaus widget when the focusing shortcut of that widget is held down on keyboard.

Parameters

callback
data

Definition at line 1152 of file accelerators.c.

References dt_accels_t::scroll::callback, dt_accels_t::scroll::data, and dt_accels_t::scroll.

Referenced by enter().

dt_accels_build_path()

gchar * dt_accels_build_path	(	const gchar *	scope,
		const gchar *	feature
	)

Definition at line 889 of file accelerators.c.

Referenced by _iop_panel_label(), _styles_get_submenu(), add_generic_top_menu_entry(), add_generic_top_submenu_entry(), dt_accels_new_action_shortcut(), dt_accels_new_virtual_instance_shortcut(), dt_bauhaus_init(), dt_bauhaus_widget_set_label(), dt_iop_gui_cleanup_module(), dt_iop_gui_init(), dt_lib_unload_module(), dt_thumbtable_new(), gui_cleanup(), gui_init(), gui_init(), and set_menu_entry().

dt_accels_cleanup()

void dt_accels_cleanup

(

dt_accels_t *

accels

)

Definition at line 361 of file accelerators.c.

References dt_accels_t::acceleratables, dt_accels_t::active_group, dt_accels_t::config_file, dt_accels_t::darkroom_accels, dt_free, dt_pthread_mutex_destroy(), dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), dt_accels_t::global_accels, dt_accels_t::lighttable_accels, dt_accels_t::lock, dt_accels_t::map_accels, dt_accels_t::print_accels, and dt_accels_t::slideshow_accels.

Referenced by dt_cleanup().

dt_accels_connect_accels()

void dt_accels_connect_accels

(

dt_accels_t *

accels

)

Actually enable accelerators after having loaded user config.

Parameters

accels

Definition at line 828 of file accelerators.c.

References _connect_accel_hashtable(), dt_accels_t::acceleratables, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), and dt_accels_t::lock.

Referenced by dt_init(), and enter().

dt_accels_connect_active_group()

void dt_accels_connect_active_group	(	dt_accels_t *	accels,
		const gchar *	group
	)

Connect the contextual active accels group to the window. Views can declare their own set of contextual accels, which can override the global accels, in case they use the same keys.

Parameters

accels
group	any of the following: "darkroom", "lighttable", "map", "print", "slideshow".

Definition at line 391 of file accelerators.c.

References dt_accels_t::active_group, dt_accels_t::darkroom_accels, IS_NULL_PTR, dt_accels_t::lighttable_accels, dt_accels_t::map_accels, dt_accels_t::print_accels, dt_accels_t::reset, and dt_accels_t::slideshow_accels.

Referenced by enter().

dt_accels_detach_scroll_handler()

void dt_accels_detach_scroll_handler

(

dt_accels_t *

accels

)

Definition at line 1158 of file accelerators.c.

References dt_accels_t::scroll::callback, dt_accels_t::scroll::data, and dt_accels_t::scroll.

Referenced by leave().

dt_accels_disconnect_active_group()

void dt_accels_disconnect_active_group

(

dt_accels_t *

accels

)

Disconnect the contextual active accels group from the window.

Parameters

accels

Definition at line 427 of file accelerators.c.

References dt_accels_t::active_group, IS_NULL_PTR, and dt_accels_t::reset.

Referenced by leave().

dt_accels_dispatch()

gboolean dt_accels_dispatch	(	GtkWidget *	w,
		GdkEvent *	event,
		gpointer	user_data
	)

Force our listener for all key strokes to bypass reserved Gtk keys.

Parameters

w
event
user_data

Returns

gboolean

Definition at line 1081 of file accelerators.c.

References _accels_keys_decode(), _key_pressed(), dt_accels_t::active_group, dt_accels_t::active_key, dt_accels_t::scroll::callback, dt_accels_t::scroll::data, dt_accels_t::disable_accels, FALSE, IS_NULL_PTR, dt_accels_t::reset, and dt_accels_t::scroll.

Referenced by dt_gui_gtk_init().

dt_accels_init()

dt_accels_t * dt_accels_init	(	char *	config_file,
		GtkAccelFlags	flags
	)

Definition at line 332 of file accelerators.c.

References _accels_install_tooltip_hook(), _clean_shortcut(), dt_accels_t::acceleratables, dt_accels_t::active_group, dt_accels_t::active_key, dt_accels_t::scroll::callback, dt_accels_t::config_file, dt_accels_t::darkroom_accels, dt_accels_t::scroll::data, dt_accels_t::default_mod_mask, dt_accels_t::disable_accels, dt_pthread_mutex_init(), FALSE, flags, dt_accels_t::flags, dt_accels_t::global_accels, dt_accels_t::init, dt_accels_t::keymap, dt_accels_t::lighttable_accels, dt_accels_t::lock, dt_accels_t::map_accels, dt_accels_t::print_accels, dt_accels_t::reset, dt_accels_t::scroll, and dt_accels_t::slideshow_accels.

Referenced by dt_gui_gtk_init().

dt_accels_load_user_config()

void dt_accels_load_user_config

(

dt_accels_t *

accels

)

Loads keyboardrc.lang from config dir. This needs to run after we inited the accel map from widgets creation.

Parameters

accels

Definition at line 776 of file accelerators.c.

References dt_accels_t::config_file.

Referenced by dt_init().

dt_accels_new_action_shortcut()

void dt_accels_new_action_shortcut	(	dt_accels_t *	accels,
		gboolean(*)(GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)	action_callback,
		gpointer	data,
		GtkAccelGroup *	accel_group,
		const gchar *	action_scope,
		const gchar *	action_name,
		guint	key_val,
		GdkModifierType	accel_mods,
		const gboolean	lock,
		const char *	description
	)

Register a new shortcut for a generic action, setting up its path, default keys and accel group. This does everything but connecting it, so exists only as a defined slot to be connected later.

The callback should have the following signature:

gboolean action_callback(GtkAccelGroup *accel_group, GObject *accelerable, guint keyval, GdkModifierType
modifier, gpointer data)

Parameters

accels
data
accel_group
action_scope	Human-readable, translated, category or scope of the action. Will be turned into path internally
action_name	Human-readable, translated, name or description of the action. Will be turned into path internally
key_val
accel_mods
lock	prevent user edition

Definition at line 718 of file accelerators.c.

References _add_generic_accel(), _insert_accel(), _remove_generic_accel(), dt_shortcut_t::accel_group, dt_accels_t::acceleratables, dt_shortcut_t::accels, dt_shortcut_t::closure, dt_shortcut_t::description, description(), dt_accels_build_path(), dt_free, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), dt_shortcut_get_closure(), dt_shortcut_set_closure(), DT_SHORTCUT_UNSET, FALSE, dt_accels_t::flags, dt_shortcut_t::key, dt_accels_t::lock, dt_shortcut_t::locked, dt_shortcut_t::mods, dt_shortcut_t::path, dt_shortcut_t::signal, dt_shortcut_t::type, dt_shortcut_t::virtual_shortcut, and dt_shortcut_t::widget.

Referenced by dt_lib_init_module(), gui_init(), and set_menu_entry().

dt_accels_new_virtual_instance_shortcut()

void dt_accels_new_virtual_instance_shortcut	(	dt_accels_t *	accels,
		gboolean(*)(GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)	action_callback,
		gpointer	data,
		GtkAccelGroup *	accel_group,
		const gchar *	action_scope,
		const gchar *	action_name
	)

Definition at line 623 of file accelerators.c.

References dt_shortcut_t::accel_group, dt_accels_t::acceleratables, dt_shortcut_t::accels, dt_shortcut_t::closure, dt_shortcut_t::description, dt_accels_build_path(), dt_free, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), DT_SHORTCUT_DEFAULT, dt_shortcut_set_closure(), IS_NULL_PTR, dt_shortcut_t::key, dt_accels_t::lock, dt_shortcut_t::locked, dt_shortcut_t::mods, dt_shortcut_t::path, dt_shortcut_t::signal, TRUE, dt_shortcut_t::type, dt_shortcut_t::virtual_shortcut, and dt_shortcut_t::widget.

Referenced by _iop_panel_label().

dt_accels_new_virtual_shortcut()

void dt_accels_new_virtual_shortcut	(	dt_accels_t *	accels,
		GtkAccelGroup *	accel_group,
		const gchar *	accel_path,
		GtkWidget *	widget,
		guint	key_val,
		GdkModifierType	accel_mods
	)

Add a new virtual shortcut. Virtual shortcuts are immutable, read-only and don't trigger any action. They are meant to serve as placeholders, in a purely declarative way, for key combinations hardcoded in the key-pressed events handlers of widgets able to capture focus. Once declared here, they will prevent users from declaring their own shortcuts using hardcoded combinations for the corresponding accel_group.

Parameters

accel_group
accel_path
key_val
accel_mods

Definition at line 588 of file accelerators.c.

References _insert_accel(), _shortcut_set_widget_data(), _virtual_shortcut_callback(), dt_shortcut_t::accel_group, dt_accels_t::acceleratables, dt_shortcut_t::accels, dt_shortcut_t::closure, dt_shortcut_t::description, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), dt_shortcut_set_closure(), DT_SHORTCUT_UNSET, IS_NULL_PTR, dt_shortcut_t::key, dt_accels_t::lock, dt_shortcut_t::locked, dt_shortcut_t::mods, dt_shortcut_t::path, dt_shortcut_t::signal, TRUE, dt_shortcut_t::type, dt_shortcut_t::virtual_shortcut, and dt_shortcut_t::widget.

Referenced by dt_bauhaus_init(), dt_thumbtable_new(), and gui_init().

dt_accels_new_widget_shortcut()

void dt_accels_new_widget_shortcut	(	dt_accels_t *	accels,
		GtkWidget *	widget,
		const gchar *	signal,
		GtkAccelGroup *	accel_group,
		const gchar *	accel_path,
		guint	key_val,
		GdkModifierType	accel_mods,
		const gboolean	lock
	)

Register a new shortcut for a widget, setting up its path, default keys and accel group. This does everything but connecting it, so exists only as a defined slot to be connected later.

Parameters

accels
widget
signal
accel_group
accel_path
key_val
accel_mods
lock	prevent user edition

Definition at line 663 of file accelerators.c.

References _add_widget_accel(), _insert_accel(), _remove_widget_accel(), _shortcut_set_widget_data(), dt_shortcut_t::accel_group, dt_accels_t::acceleratables, dt_shortcut_t::accels, dt_shortcut_t::closure, dt_shortcut_t::description, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), DT_SHORTCUT_UNSET, FALSE, dt_accels_t::flags, key, dt_shortcut_t::key, dt_accels_t::lock, dt_shortcut_t::locked, dt_shortcut_t::mods, dt_shortcut_t::path, dt_shortcut_t::signal, dt_shortcut_t::type, dt_shortcut_t::virtual_shortcut, and dt_shortcut_t::widget.

Referenced by gui_init().

dt_accels_remove_accel()

void dt_accels_remove_accel	(	dt_accels_t *	accels,
		const char *	path,
		gpointer	data
	)

Recursively remove all accels for all shortcuts containing path. This is unneeded for accels attached to Gtk widgets through dt_accels_new_widget_shortcut because Gtk will handle that internally when deleting a widget. But for our own widget-less dt_accels_new_action_shortcut, we need to handle that ourselves.

Accels are typically added at gui_init() time of their attached GUI object, and the typical use case of this API assumes those objects live until the app is closed. But IOP modules can be added/removed at runtime (instances), so we need to destroy accels when their target object (user_data pointer/callback) is destroyed. If some accels are left dangling with a reference to a non-existing callback/data/closure, the app will crash with segfault upon shortcut activation.

This will remove in one shot all accels attached to a parent and to all of its children, assuming that children will share their path root with their parent, and that rule is entirely up to the developer to enforce.

This does not remove the shortcut object.

Parameters

accels
path	accel path
data	the user-data used by the initial callback, if any

Definition at line 866 of file accelerators.c.

References _remove_accel_hashtable(), dt_accels_t::acceleratables, dt_free, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), IS_NULL_PTR, and dt_accels_t::lock.

Referenced by _widget_finalize(), dt_iop_gui_cleanup_module(), and gui_cleanup().

dt_accels_remove_shortcut()

void dt_accels_remove_shortcut	(	dt_accels_t *	accels,
		const char *	path
	)

Remove the shortcut object identified by path and all its accels.

Parameters

accels
path

Definition at line 881 of file accelerators.c.

References dt_accels_t::acceleratables, dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), and dt_accels_t::lock.

Referenced by _iop_panel_label(), dt_iop_gui_cleanup_module(), dt_lib_unload_module(), and gui_cleanup().

dt_accels_search()

void dt_accels_search	(	dt_accels_t *	accels,
		GtkWindow *	main_window,
		GtkWidget *	anchor
	)

Definition at line 3020 of file accelerators.c.

References _dispatch_selected_shortcut_idle(), _for_each_path_create_treeview_row(), _search_entry_button_pressed(), _search_entry_changed(), _search_entry_key_pressed(), _shortcut_search_button_press(), _shortcut_search_destroy(), _shortcut_search_load_recent_entries(), _shortcut_search_recent_completion_match(), _shortcut_search_recent_insert_prefix(), _shortcut_search_recent_match_selected(), _shortcut_search_recent_sort_func(), _shortcut_search_row_activated(), _shortcut_search_selection_changed(), _shortcut_search_visible(), _shortcut_search_window_key_pressed(), _sort_model_by_relevance_func(), dt_accels_t::acceleratables, dt_accels_dispatch_state_t::accels, dt_gui_gtk_t::accels, darktable, description(), dt_free, dt_gui_add_class(), dt_osx_disallow_fullscreen(), DT_UI_PANEL_TOP, FALSE, darktable_t::gui, IS_NULL_PTR, dt_accels_dispatch_state_t::main_window, MAX, dt_ui_t::panels, dt_accels_dispatch_state_t::path, scrolled(), state, dt_accels_search_state_t::store, store(), TRUE, and dt_gui_gtk_t::ui.

Referenced by _open_accel_search_callback(), and search_accels_callback().

dt_accels_window()

void dt_accels_window	(	dt_accels_t *	accels,
		GtkWindow *	main_window
	)

Show the modal dialog listing all available keyboard shortcuts and letting user to set them.

Parameters

accels
main_window	The main Ansel application window (for modal/transient)

Definition at line 1680 of file accelerators.c.

References _for_each_accel_create_treeview_row(), _icon_activate(), _make_column_clearable(), _make_column_editable(), _shortcut_cleared(), _shortcut_edited(), _sort_model_func(), dt_accels_t::acceleratables, accels_global_ref, COL_CLEAR, COL_DESCRIPTION, COL_KEYS, COL_KEYVAL, COL_MODS, COL_NAME, COL_PATH, dt_free, dt_free_gpointer(), dt_gtkentry_setup_completion(), dt_gui_add_class(), DT_GUI_BOX_SPACING, dt_osx_disallow_fullscreen(), dtgtk_cell_renderer_button_new(), FALSE, filter_callback(), i, NUM_COLUMNS, search_changed(), _accel_treeview_t::store, store(), and TRUE.

Referenced by shortcuts_callback().

dt_shortcut_get_closure()

GClosure * dt_shortcut_get_closure

(

dt_shortcut_t *

shortcut

)

Definition at line 223 of file accelerators.c.

References PayloadClosure::base, and dt_shortcut_get_payload_closure().

Referenced by _add_generic_accel(), _call_shortcut_cclosure(), _connect_accel(), _dispatch_selected_shortcut(), _find_parent_hashtable(), _remove_accel_hashtable(), _remove_generic_accel(), and dt_accels_new_action_shortcut().

dt_shortcut_get_payload_closure()

PayloadClosure * dt_shortcut_get_payload_closure

(

dt_shortcut_t *

shortcut

)

Definition at line 214 of file accelerators.c.

References dt_shortcut_t::closure.

Referenced by _dispatch_selected_shortcut(), _find_parent_hashtable(), and dt_shortcut_get_closure().

dt_shortcut_remove_closure()

void dt_shortcut_remove_closure	(	dt_shortcut_t *	shortcut,
		gpointer	data
	)

Definition at line 237 of file accelerators.c.

References PayloadClosure::base, dt_shortcut_t::closure, dt_free, IS_NULL_PTR, and PayloadClosure::parent_data.

Referenced by _remove_accel_hashtable().

dt_shortcut_set_closure()

void dt_shortcut_set_closure	(	dt_shortcut_t *	shortcut,
		gboolean(*)(GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)	action_callback,
		gpointer	data
	)

Definition at line 314 of file accelerators.c.

References _insert_parent_data_into_children(), PayloadClosure::base, dt_shortcut_t::closure, and PayloadClosure::parent_data.

Referenced by dt_accels_new_action_shortcut(), dt_accels_new_virtual_instance_shortcut(), and dt_accels_new_virtual_shortcut().

filter_callback()

static gboolean filter_callback ( GtkTreeModel *  model, GtkTreeIter *  iter, gpointer  user_data  )

static

Definition at line 1581 of file accelerators.c.

References _normalize_keyval(), COL_KEYVAL, COL_MODS, COL_PATH, dt_free, FALSE, filter_callback(), IS_NULL_PTR, model, and TRUE.

Referenced by dt_accels_window(), and filter_callback().

guess_key_group()

static int guess_key_group ( dt_accels_t *  accels, guint  keyval, guint  hardware_keycode  )

static

Definition at line 1216 of file accelerators.c.

References dt_free, i, and dt_accels_t::keymap.

Referenced by _shortcut_edited().

search_changed()

static void search_changed ( GtkEntry *  entry, gpointer  user_data  )

static

Definition at line 1662 of file accelerators.c.

References IS_NULL_PTR.

Referenced by dt_accels_window().

Variable Documentation

accels_global_ref

dt_accels_t* accels_global_ref = NULL

static

Definition at line 1169 of file accelerators.c.

Referenced by _shortcut_edited(), and dt_accels_window().