#include "common/darktable.h"
#include "common/act_on.h"
#include "common/debug.h"
#include "common/collection.h"
#include "common/selection.h"
#include "control/conf.h"
#include "develop/develop.h"
#include "gui/gtk.h"
#include "views/view.h"
#include "math.h"
#include "menu.h"

Include dependency graph for menu.c:

Typedefs
typedef struct dt_masks_form_gui_t	dt_masks_form_gui_t

Functions
static void	_activate_callback_to_action_callback (GtkMenuItem *menu_item, gpointer user_data)

static gboolean	_menu_icon_draw (GtkWidget widget, cairo_t cr, gpointer user_data)

GtkWidget *	ctx_gtk_menu_item_new_with_icon (const char label, GtkWidget menu, void(activate_callback)(GtkWidget widget, gpointer user_data), gpointer user_data, dt_menu_icon_t icon)

GtkWidget *	ctx_gtk_menu_item_new_with_icon_and_shortcut (const char label, const char shortcut, GtkWidget menu, void(activate_callback)(GtkWidget *widget, gpointer user_data), gpointer user_data, dt_menu_icon_t icon)

GtkWidget *	ctx_gtk_menu_item_new_with_markup (const char label, GtkWidget menu, void(activate_callback)(GtkWidget widget, gpointer user_data), gpointer user_data)

GtkWidget *	ctx_gtk_menu_item_new_with_markup_and_shortcut (const char label, const char shortcut, GtkWidget menu, void(activate_callback)(GtkWidget *widget, gpointer user_data), gpointer user_data)

GtkWidget *	ctx_gtk_menu_item_new_with_markup_and_pixbuf (const char label, GdkPixbuf icon, GtkWidget menu, void(activate_callback)(GtkWidget *widget, gpointer user_data), gpointer user_data)

GtkWidget *	ctx_gtk_check_menu_item_new_with_markup (const char label, GtkWidget menu, void(activate_callback)(GtkWidget widget, gpointer user_data), gpointer user_data, const gboolean checked, const gboolean show_checkbox)

GtkWidget *	ctx_gtk_check_menu_item_new_with_markup_and_pixbuf (const char label, GdkPixbuf icon, GtkWidget menu, void(activate_callback)(GtkWidget *widget, gpointer user_data), gpointer user_data, const gboolean checked, const gboolean show_checkbox)

dt_menu_entry_t *	set_menu_entry (GtkWidget menus, GList items_list, const gchar label, dt_menus_t menu_index, GtkMenu parent, void data, gboolean(action_callback)(GtkAccelGroup group, GObject acceleratable, guint keyval, GdkModifierType mods, gpointer user_data), gboolean(checked_callback)(GtkWidget widget), gboolean(active_callback)(GtkWidget widget), gboolean(sensitive_callback)(GtkWidget widget), guint key_val, GdkModifierType mods, GtkAccelGroup *accel_group)

void	update_entry (dt_menu_entry_t *entry)

void	update_menu_entries (GtkWidget *widget, gpointer user_data)

void	add_generic_top_menu_entry (GtkWidget menu_bar, GtkWidget menus, GList lists, const dt_menus_t index, gchar label, GtkAccelGroup accel_group, const char accel_path_prefix)

void	add_top_menu_entry (GtkWidget menu_bar, GtkWidget menus, GList lists, const dt_menus_t index, gchar label)

void	add_generic_top_submenu_entry (GtkWidget menus, GList lists, const gchar label, const dt_menus_t index, GtkAccelGroup accel_group)

void	add_top_submenu_entry (GtkWidget menus, GList lists, const gchar *label, const dt_menus_t index)

void	add_generic_sub_menu_entry (GtkWidget menus, GList lists, const gchar label, const dt_menus_t index, void data, gboolean(action_callback)(GtkAccelGroup group, GObject acceleratable, guint keyval, GdkModifierType mods, gpointer user_data), gboolean(checked_callback)(GtkWidget widget), gboolean(active_callback)(GtkWidget widget), gboolean(sensitive_callback)(GtkWidget widget), guint key_val, GdkModifierType mods, GtkAccelGroup accel_group)

void	add_sub_menu_entry (GtkWidget menus, GList lists, const gchar label, const dt_menus_t index, void data, gboolean(action_callback)(GtkAccelGroup group, GObject acceleratable, guint keyval, GdkModifierType mods, gpointer user_data), gboolean(checked_callback)(GtkWidget widget), gboolean(active_callback)(GtkWidget widget), gboolean(sensitive_callback)(GtkWidget *widget), guint key_val, GdkModifierType mods)

void	add_no_accel_sub_menu_entry (GtkWidget menus, GList lists, const gchar label, const dt_menus_t index, void data, gboolean(action_callback)(GtkAccelGroup group, GObject acceleratable, guint keyval, GdkModifierType mods, gpointer user_data), gboolean(checked_callback)(GtkWidget widget), gboolean(active_callback)(GtkWidget widget), gboolean(sensitive_callback)(GtkWidget *widget), guint key_val, GdkModifierType mods)

void	add_generic_sub_sub_menu_entry (GtkWidget *menus, GtkWidget parent, GList *lists, const gchar label, const dt_menus_t index, void data, gboolean(action_callback)(GtkAccelGroup group, GObject acceleratable, guint keyval, GdkModifierType mods, gpointer user_data), gboolean(checked_callback)(GtkWidget widget), gboolean(active_callback)(GtkWidget widget), gboolean(sensitive_callback)(GtkWidget widget), guint key_val, GdkModifierType mods, GtkAccelGroup *accel_group)

void	add_sub_sub_menu_entry (GtkWidget *menus, GtkWidget parent, GList *lists, const gchar label, const dt_menus_t index, void data, gboolean(action_callback)(GtkAccelGroup group, GObject acceleratable, guint keyval, GdkModifierType mods, gpointer user_data), gboolean(checked_callback)(GtkWidget widget), gboolean(active_callback)(GtkWidget widget), gboolean(sensitive_callback)(GtkWidget widget), guint key_val, GdkModifierType mods)

void	add_menu_separator (GtkWidget *menu)

void	add_sub_menu_separator (GtkWidget *parent)

void *	get_custom_data (GtkWidget *widget)

GtkWidget *	get_last_widget (GList **list)

gboolean	has_selection ()

gboolean	has_active_images ()

gboolean	_is_lighttable ()

gboolean	_is_darkroom ()

gboolean	has_active_image_in_lighttable ()

gboolean	dt_menu_is_image_in_dev (GList *imgs)

void	dt_menu_apply_dev_history_update (dt_develop_t *dev, const gboolean history_inited)

Typedef Documentation

◆ dt_masks_form_gui_t

typedef struct dt_masks_form_gui_t dt_masks_form_gui_t

Function Documentation

◆ _activate_callback_to_action_callback()

static void _activate_callback_to_action_callback	(	GtkMenuItem *	menu_item,
		gpointer	user_data
	)

static

How to use:

write callback functions returning a gboolean that will check the context to decide if the menu item should be insensitive, checked, active. These should only use the content of globally accessible structures like darktable.gui since they take no arguments.
re-use the action callback functions already used for global keyboard shortcuts (actions/accels). Again, all inputs and internal functions should be globally accessible, for example using proxies.
wire everything with the set_menu_entry function below. GUI states of the children menu items will be updated automatically everytime a top-level menu is opened.

References dt_menu_entry_t::accel_group, and dt_menu_entry_t::action_callback.

Referenced by set_menu_entry(), and update_entry().

◆ _is_darkroom()

gboolean _is_darkroom ( )

References darktable, dt_view_manager_get_current_view(), dt_view_t::module_name, and darktable_t::view_manager.

◆ _is_lighttable()

gboolean _is_lighttable ( )

References darktable, dt_view_manager_get_current_view(), dt_view_t::module_name, and darktable_t::view_manager.

Referenced by _can_be_rotated(), clear_selection_sensitive_callback(), has_active_image_in_lighttable(), and select_all_sensitive_callback().

◆ _menu_icon_draw()

static gboolean _menu_icon_draw	(	GtkWidget *	widget,
		cairo_t *	cr,
		gpointer	user_data
	)

static

References double(), DT_MENU_ICON_CIRCLE, DT_MENU_ICON_NONE, DT_MENU_ICON_SQUARE, FALSE, h, M_PI, MAX, dt_menu_icon_data_t::shape, size, and x.

Referenced by ctx_gtk_menu_item_new_with_icon(), and ctx_gtk_menu_item_new_with_icon_and_shortcut().

◆ add_generic_sub_menu_entry()

void add_generic_sub_menu_entry	(	GtkWidget **	menus,
		GList **	lists,
		const gchar *	label,
		const dt_menus_t	index,
		void *	data,
		gboolean()(GtkAccelGroup group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)	action_callback,
		gboolean()(GtkWidget widget)	checked_callback,
		gboolean()(GtkWidget widget)	active_callback,
		gboolean()(GtkWidget widget)	sensitive_callback,
		guint	key_val,
		GdkModifierType	mods,
		GtkAccelGroup *	accel_group
	)

References set_menu_entry(), TRUE, and dt_menu_entry_t::widget.

Referenced by add_no_accel_sub_menu_entry(), add_sub_menu_entry(), and append_thumbnails().

◆ add_generic_sub_sub_menu_entry()

void add_generic_sub_sub_menu_entry	(	GtkWidget **	menus,
		GtkWidget *	parent,
		GList **	lists,
		const gchar *	label,
		const dt_menus_t	index,
		void *	data,
		gboolean()(GtkAccelGroup group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)	action_callback,
		gboolean()(GtkWidget widget)	checked_callback,
		gboolean()(GtkWidget widget)	active_callback,
		gboolean()(GtkWidget widget)	sensitive_callback,
		guint	key_val,
		GdkModifierType	mods,
		GtkAccelGroup *	accel_group
	)

References set_menu_entry(), and dt_menu_entry_t::widget.

Referenced by add_sub_sub_menu_entry(), and append_thumbnails().

◆ add_generic_top_menu_entry()

void add_generic_top_menu_entry	(	GtkWidget *	menu_bar,
		GtkWidget **	menus,
		GList **	lists,
		const dt_menus_t	index,
		gchar *	label,
		GtkAccelGroup *	accel_group,
		const char *	accel_path_prefix
	)

References dt_accels_build_path(), dt_free, dt_gui_add_class(), strip_markup(), and update_menu_entries().

Referenced by add_top_menu_entry(), and gui_init().

◆ add_generic_top_submenu_entry()

void add_generic_top_submenu_entry	(	GtkWidget **	menus,
		GList **	lists,
		const gchar *	label,
		const dt_menus_t	index,
		GtkAccelGroup *	accel_group
	)

References dt_accels_build_path(), dt_free, set_menu_entry(), strip_markup(), and dt_menu_entry_t::widget.

Referenced by add_top_submenu_entry(), and append_thumbnails().

◆ add_menu_separator()

void add_menu_separator ( GtkWidget * menu )

Referenced by append_display(), append_edit(), append_file(), append_help(), append_image(), append_run(), append_select(), and append_styles().

◆ add_no_accel_sub_menu_entry()

void add_no_accel_sub_menu_entry	(	GtkWidget **	menus,
		GList **	lists,
		const gchar *	label,
		const dt_menus_t	index,
		void *	data,
		gboolean()(GtkAccelGroup group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)	action_callback,
		gboolean()(GtkWidget widget)	checked_callback,
		gboolean()(GtkWidget widget)	active_callback,
		gboolean()(GtkWidget widget)	sensitive_callback,
		guint	key_val,
		GdkModifierType	mods
	)

References add_generic_sub_menu_entry().

Referenced by append_file(), and append_views().

◆ add_sub_menu_entry()

void add_sub_menu_entry	(	GtkWidget **	menus,
		GList **	lists,
		const gchar *	label,
		const dt_menus_t	index,
		void *	data,
		gboolean()(GtkAccelGroup group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)	action_callback,
		gboolean()(GtkWidget widget)	checked_callback,
		gboolean()(GtkWidget widget)	active_callback,
		gboolean()(GtkWidget widget)	sensitive_callback,
		guint	key_val,
		GdkModifierType	mods
	)

References dt_gui_gtk_t::accels, add_generic_sub_menu_entry(), darktable, dt_accels_t::global_accels, and darktable_t::gui.

Referenced by append_display(), append_edit(), append_file(), append_help(), append_image(), append_run(), append_select(), and append_styles().

◆ add_sub_menu_separator()

void add_sub_menu_separator ( GtkWidget * parent )

Referenced by append_image().

◆ add_sub_sub_menu_entry()

void add_sub_sub_menu_entry	(	GtkWidget **	menus,
		GtkWidget *	parent,
		GList **	lists,
		const gchar *	label,
		const dt_menus_t	index,
		void *	data,
		gboolean()(GtkAccelGroup group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)	action_callback,
		gboolean()(GtkWidget widget)	checked_callback,
		gboolean()(GtkWidget widget)	active_callback,
		gboolean()(GtkWidget widget)	sensitive_callback,
		guint	key_val,
		GdkModifierType	mods
	)

References dt_gui_gtk_t::accels, add_generic_sub_sub_menu_entry(), darktable, dt_accels_t::global_accels, and darktable_t::gui.

Referenced by append_display(), append_edit(), append_file(), and append_image().

◆ add_top_menu_entry()

void add_top_menu_entry	(	GtkWidget *	menu_bar,
		GtkWidget **	menus,
		GList **	lists,
		const dt_menus_t	index,
		gchar *	label
	)

References dt_gui_gtk_t::accels, add_generic_top_menu_entry(), darktable, dt_accels_t::global_accels, and darktable_t::gui.

Referenced by dt_ui_init_global_menu().

◆ add_top_submenu_entry()

void add_top_submenu_entry	(	GtkWidget **	menus,
		GList **	lists,
		const gchar *	label,
		const dt_menus_t	index
	)

References dt_gui_gtk_t::accels, add_generic_top_submenu_entry(), darktable, dt_accels_t::global_accels, and darktable_t::gui.

Referenced by _styles_get_submenu(), append_display(), append_edit(), append_file(), and append_image().

◆ ctx_gtk_check_menu_item_new_with_markup()

GtkWidget * ctx_gtk_check_menu_item_new_with_markup	(	const char *	label,
		GtkWidget *	menu,
		void()(GtkWidget widget, gpointer user_data)	activate_callback,
		gpointer	user_data,
		const gboolean	checked,
		const gboolean	show_checkbox
	)

References FALSE, and TRUE.

Referenced by populate_masks_context_menu().

◆ ctx_gtk_check_menu_item_new_with_markup_and_pixbuf()

GtkWidget * ctx_gtk_check_menu_item_new_with_markup_and_pixbuf	(	const char *	label,
		GdkPixbuf *	icon,
		GtkWidget *	menu,
		void()(GtkWidget widget, gpointer user_data)	activate_callback,
		gpointer	user_data,
		const gboolean	checked,
		const gboolean	show_checkbox
	)

References FALSE, and TRUE.

Referenced by _blendop_masks_group_ctx_menu().

◆ ctx_gtk_menu_item_new_with_icon()

GtkWidget * ctx_gtk_menu_item_new_with_icon	(	const char *	label,
		GtkWidget *	menu,
		void()(GtkWidget widget, gpointer user_data)	activate_callback,
		gpointer	user_data,
		dt_menu_icon_t	icon
	)

References _menu_icon_draw(), DT_MENU_ICON_NONE, FALSE, and dt_menu_icon_data_t::shape.

◆ ctx_gtk_menu_item_new_with_icon_and_shortcut()

GtkWidget * ctx_gtk_menu_item_new_with_icon_and_shortcut	(	const char *	label,
		const char *	shortcut,
		GtkWidget *	menu,
		void()(GtkWidget widget, gpointer user_data)	activate_callback,
		gpointer	user_data,
		dt_menu_icon_t	icon
	)

References _menu_icon_draw(), DT_MENU_ICON_NONE, FALSE, dt_menu_icon_data_t::shape, and TRUE.

Referenced by _brush_populate_context_menu(), and _polygon_populate_context_menu().

◆ ctx_gtk_menu_item_new_with_markup()

GtkWidget * ctx_gtk_menu_item_new_with_markup	(	const char *	label,
		GtkWidget *	menu,
		void()(GtkWidget widget, gpointer user_data)	activate_callback,
		gpointer	user_data
	)

References FALSE.

Referenced by _brush_populate_context_menu(), _polygon_populate_context_menu(), dt_masks_create_menu(), and populate_masks_context_menu().

◆ ctx_gtk_menu_item_new_with_markup_and_pixbuf()

GtkWidget * ctx_gtk_menu_item_new_with_markup_and_pixbuf	(	const char *	label,
		GdkPixbuf *	icon,
		GtkWidget *	menu,
		void()(GtkWidget widget, gpointer user_data)	activate_callback,
		gpointer	user_data
	)

References FALSE, and TRUE.

Referenced by dt_masks_create_menu().

◆ ctx_gtk_menu_item_new_with_markup_and_shortcut()

GtkWidget * ctx_gtk_menu_item_new_with_markup_and_shortcut	(	const char *	label,
		const char *	shortcut,
		GtkWidget *	menu,
		void()(GtkWidget widget, gpointer user_data)	activate_callback,
		gpointer	user_data
	)

References FALSE, and TRUE.

Referenced by _brush_populate_context_menu(), and _polygon_populate_context_menu().

◆ dt_menu_apply_dev_history_update()

void dt_menu_apply_dev_history_update	(	dt_develop_t *	dev,
		const gboolean	history_inited
	)

References darktable, DT_DEBUG_CONTROL_SIGNAL_RAISE, dt_dev_history_gui_update(), dt_dev_history_notify_change(), dt_dev_history_pixelpipe_update(), dt_dev_reload_history_items(), DT_SIGNAL_DEVELOP_HISTORY_CHANGE, dt_image_t::id, dt_develop_t::image_storage, darktable_t::signals, and TRUE.

Referenced by _styles_apply_callback(), compress_history_callback(), delete_history_callback(), and load_xmp_callback().

◆ dt_menu_is_image_in_dev()

gboolean dt_menu_is_image_in_dev ( GList * imgs )

References darktable, darktable_t::develop, dt_image_t::id, and dt_develop_t::image_storage.

Referenced by _styles_apply_callback(), compress_history_callback(), copy_callback(), copy_parts_callback(), delete_history_callback(), load_xmp_callback(), paste_all_callback(), and paste_parts_callback().

◆ get_custom_data()

void * get_custom_data ( GtkWidget * widget )

Referenced by _jpg_checked(), _jpg_combobox_changed(), _styles_apply_callback(), _zoom_checked(), _zoom_combobox_changed(), init_collection_line(), intent_callback(), intent_checked_callback(), profile_callback(), profile_checked_callback(), update_collection_callback(), views_active_callback(), and views_sensitive_callback().

◆ get_last_widget()

GtkWidget * get_last_widget ( GList ** list )

References dt_menu_entry_t::widget.

Referenced by _styles_get_submenu(), append_display(), append_edit(), append_file(), append_image(), and append_thumbnails().

◆ has_active_image_in_lighttable()

gboolean has_active_image_in_lighttable ( )

References _is_lighttable(), and has_active_images().

Referenced by append_file().

◆ has_active_images()

gboolean has_active_images ( )

References dt_act_on_get_images_nb(), and FALSE.

Referenced by _can_be_rotated(), _styles_add_menu_entry(), append_edit(), append_file(), append_image(), append_run(), delete_history_callback(), duplicate_callback(), has_active_image_in_lighttable(), and new_history_callback().

◆ has_selection()

gboolean has_selection ( )

References darktable, dt_selection_get_length(), and darktable_t::selection.

Referenced by append_edit().

◆ set_menu_entry()

dt_menu_entry_t * set_menu_entry	(	GtkWidget **	menus,
		GList **	items_list,
		const gchar *	label,
		dt_menus_t	menu_index,
		GtkMenu *	parent,
		void *	data,
		gboolean()(GtkAccelGroup group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data)	action_callback,
		gboolean()(GtkWidget widget)	checked_callback,
		gboolean()(GtkWidget widget)	active_callback,
		gboolean()(GtkWidget widget)	sensitive_callback,
		guint	key_val,
		GdkModifierType	mods,
		GtkAccelGroup *	accel_group
	)

How to use:

write callback functions returning a gboolean that will check the context to decide if the menu item should be insensitive, checked, active. These should only use the content of globally accessible structures like darktable.gui since they take no arguments.
re-use the action callback functions already used for global keyboard shortcuts (actions/accels). Again, all inputs and internal functions should be globally accessible, for example using proxies.
wire everything with the set_menu_entry function below. GUI states of the children menu items will be updated automatically everytime a top-level menu is opened.

References _activate_callback_to_action_callback(), dt_menu_entry_t::accel_group, dt_gui_gtk_t::accels, dt_menu_entry_t::action_callback, dt_menu_entry_t::active_callback, dt_menu_entry_t::checked_callback, darktable, dt_accels_build_path(), dt_accels_new_action_shortcut(), dt_free, DT_MENU_ENTRY_CHECKBUTTON, DT_MENU_ENTRY_DEFAULT, FALSE, darktable_t::gui, dt_menu_entry_t::menu, dt_menu_entry_t::sensitive_callback, strip_markup(), dt_menu_entry_t::style, and dt_menu_entry_t::widget.

Referenced by _styles_add_menu_entry(), add_generic_sub_menu_entry(), add_generic_sub_sub_menu_entry(), and add_generic_top_submenu_entry().

◆ update_entry()

void update_entry ( dt_menu_entry_t * entry )

References _activate_callback_to_action_callback(), dt_menu_entry_t::active_callback, dt_menu_entry_t::checked_callback, dt_gui_add_class(), dt_gui_remove_class(), DT_MENU_ENTRY_DEFAULT, dt_menu_entry_t::sensitive_callback, dt_menu_entry_t::style, and dt_menu_entry_t::widget.

Referenced by update_menu_entries().

◆ update_menu_entries()

void update_menu_entries	(	GtkWidget *	widget,
		gpointer	user_data
	)

References update_entry().

Referenced by add_generic_top_menu_entry().

Typedefs

Functions

Typedef Documentation

◆ dt_masks_form_gui_t

Function Documentation

◆ _activate_callback_to_action_callback()

◆ _is_darkroom()

◆ _is_lighttable()

◆ _menu_icon_draw()

◆ add_generic_sub_menu_entry()

◆ add_generic_sub_sub_menu_entry()

◆ add_generic_top_menu_entry()

◆ add_generic_top_submenu_entry()

◆ add_menu_separator()

◆ add_no_accel_sub_menu_entry()

◆ add_sub_menu_entry()

◆ add_sub_menu_separator()

◆ add_sub_sub_menu_entry()

◆ add_top_menu_entry()

◆ add_top_submenu_entry()

◆ ctx_gtk_check_menu_item_new_with_markup()

◆ ctx_gtk_check_menu_item_new_with_markup_and_pixbuf()

◆ ctx_gtk_menu_item_new_with_icon()

◆ ctx_gtk_menu_item_new_with_icon_and_shortcut()

◆ ctx_gtk_menu_item_new_with_markup()

◆ ctx_gtk_menu_item_new_with_markup_and_pixbuf()

◆ ctx_gtk_menu_item_new_with_markup_and_shortcut()

◆ dt_menu_apply_dev_history_update()

◆ dt_menu_is_image_in_dev()

◆ get_custom_data()

◆ get_last_widget()

◆ has_active_image_in_lighttable()

◆ has_active_images()

◆ has_selection()

◆ set_menu_entry()

◆ update_entry()

◆ update_menu_entries()