filemanager.c File Reference

FILEMANAGER frontend of the thumbtable: the lighttable grid layout, its layout-ops vtable, and the grid-only public API (zoom + grid reconfiguration). The shared engine lives in thumbtable.c; see thumbtable_internal.h for the ops contract. More...

#include "common/darktable.h"
#include "common/collection.h"
#include "common/selection.h"
#include "control/control.h"
#include "dtgtk/thumbtable.h"
#include "dtgtk/thumbtable_internal.h"
#include "dtgtk/thumbnail.h"
#include "gui/accelerators.h"
#include "gui/gtk.h"
#include <math.h>

Include dependency graph for filemanager.c:

Go to the source code of this file.

Functions
static GtkWidget *	_grid_create_content_widget (void)
static void	_grid_configure_dims (dt_thumbtable_t *table, int *new_width, int *new_height, int *per_row, int *thumb_width, int *thumb_height)
static void	_grid_rowid_to_position (dt_thumbtable_t *table, int rowid, int *x, int *y)
static int	_grid_position_to_rowid (dt_thumbtable_t *table, const double x, const double y)
static void	_grid_get_row_ids (dt_thumbtable_t *table, int *rowid_min, int *rowid_max)
static gboolean	_grid_is_rowid_visible (dt_thumbtable_t *table, int rowid)
static void	_grid_update_content_size (dt_thumbtable_t *table)
static void	_grid_group_borders (dt_thumbtable_t *table, dt_thumbnail_t *thumb, dt_thumbnail_border_t *borders)
static void	_grid_place_child (dt_thumbtable_t *table, dt_thumbnail_t *thumb)
static void	_grid_move_child (dt_thumbtable_t *table, dt_thumbnail_t *thumb)
static gboolean	_grid_wants_scroll_value (dt_thumbtable_t *table, GtkAdjustment *adjustment)
static gboolean	_grid_wants_page_size_notify (dt_thumbtable_t *table, GObject *object)
static gboolean	_grid_relevant_scrollbar_changed (dt_thumbtable_t *table, GtkWidget *widget, GtkAllocation *allocation)
static gboolean	_grid_is_thumb_highlighted (dt_thumbtable_t *table, int32_t imgid)
static void	_grid_on_thumbnail_added (dt_thumbtable_t *table, dt_thumbnail_t *thumb)
static void	_grid_on_drag_begin (dt_thumbtable_t *table, int32_t imgid)
static void	_grid_setup_parent (dt_thumbtable_t *table)
static void	_grid_grab_focus (dt_thumbtable_t *table)
static gboolean	_grid_handle_key (dt_thumbtable_t *table, GdkEventKey *event, guint key, int32_t imgid)
static void	_grid_pre_activate (dt_thumbtable_t *table, int32_t imgid)
const dt_thumbtable_layout_ops_t *	dt_thumbtable_grid_ops (void)
void	dt_thumbtable_set_zoom (dt_thumbtable_t *table, dt_thumbtable_zoom_t level)
dt_thumbtable_zoom_t	dt_thumbtable_get_zoom (dt_thumbtable_t *table)
void	dt_thumbtable_offset_zoom (dt_thumbtable_t *table, const double delta_x, const double delta_y)
static gboolean	_thumbtable_idle_apply_grid_configuration (gpointer user_data)
	Idle callback for applying grid configuration.
void	dt_thumbtable_apply_grid_configuration (dt_thumbtable_t *table)
	Apply grid configuration changes with proper event synchronization.

Detailed Description

FILEMANAGER frontend of the thumbtable: the lighttable grid layout, its layout-ops vtable, and the grid-only public API (zoom + grid reconfiguration). The shared engine lives in thumbtable.c; see thumbtable_internal.h for the ops contract.

Definition in file filemanager.c.

Function Documentation

_grid_configure_dims()

static void _grid_configure_dims ( dt_thumbtable_t *  table, int *  new_width, int *  new_height, int *  per_row, int *  thumb_width, int *  thumb_height  )

static

Definition at line 50 of file filemanager.c.

References dt_conf_get_int(), dt_thumbtable_thumb_cell_decoration(), height, MAX, dt_thumbtable_t::parent_overlay, dt_thumbtable_t::scroll_window, and width.

Referenced by dt_thumbtable_grid_ops().

_grid_create_content_widget()

static GtkWidget * _grid_create_content_widget ( void  )

static

Definition at line 40 of file filemanager.c.

Referenced by dt_thumbtable_grid_ops().

_grid_get_row_ids()

static void _grid_get_row_ids ( dt_thumbtable_t *  table, int *  rowid_min, int *  rowid_max  )

static

Definition at line 98 of file filemanager.c.

References position(), dt_thumbtable_t::thumb_height, dt_thumbtable_t::thumbs_per_row, and dt_thumbtable_t::v_scrollbar.

Referenced by dt_thumbtable_grid_ops().

_grid_grab_focus()

static void _grid_grab_focus ( dt_thumbtable_t *  table )

static

Definition at line 256 of file filemanager.c.

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

Referenced by dt_thumbtable_grid_ops().

_grid_group_borders()

static void _grid_group_borders ( dt_thumbtable_t *  table, dt_thumbnail_t *  thumb, dt_thumbnail_border_t *  borders  )

static

Definition at line 148 of file filemanager.c.

References CLAMP_ROW, DT_THUMBNAIL_BORDER_BOTTOM, DT_THUMBNAIL_BORDER_LEFT, DT_THUMBNAIL_BORDER_RIGHT, DT_THUMBNAIL_BORDER_TOP, dt_image_t::group_id, dt_image_t::group_members, dt_thumbtable_cache_t::groupid, dt_thumbnail_t::info, IS_COLLECTION_EDGE, dt_thumbtable_t::lut, dt_thumbnail_t::rowid, dt_thumbtable_cache_t::thumb, and dt_thumbtable_t::thumbs_per_row.

Referenced by dt_thumbtable_grid_ops().

_grid_handle_key()

static gboolean _grid_handle_key ( dt_thumbtable_t *  table, GdkEventKey *  event, guint  key, int32_t  imgid  )

static

Definition at line 280 of file filemanager.c.

References darktable, dt_modifier_is(), dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), dt_selection_select_single(), dt_selection_toggle(), dt_thumbtable_find_rowid_from_imgid(), dt_thumbtable_move_in_grid(), dt_thumbtable_select_range(), DT_TT_MOVE_DOWN, DT_TT_MOVE_UP, FALSE, key, dt_thumbtable_t::lock, darktable_t::selection, and TRUE.

Referenced by dt_thumbtable_grid_ops().

_grid_is_rowid_visible()

static gboolean _grid_is_rowid_visible ( dt_thumbtable_t *  table, int  rowid  )

static

Definition at line 116 of file filemanager.c.

References position(), dt_thumbtable_t::thumb_height, dt_thumbtable_t::thumbs_per_row, and dt_thumbtable_t::v_scrollbar.

Referenced by dt_thumbtable_grid_ops().

_grid_is_thumb_highlighted()

static gboolean _grid_is_thumb_highlighted ( dt_thumbtable_t *  table, int32_t  imgid  )

static

Definition at line 223 of file filemanager.c.

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

Referenced by _grid_on_thumbnail_added(), and dt_thumbtable_grid_ops().

_grid_move_child()

static void _grid_move_child ( dt_thumbtable_t *  table, dt_thumbnail_t *  thumb  )

static

Definition at line 188 of file filemanager.c.

References dt_thumbtable_t::grid, dt_thumbnail_t::widget, dt_thumbnail_t::x, and dt_thumbnail_t::y.

Referenced by dt_thumbtable_grid_ops().

_grid_on_drag_begin()

static void _grid_on_drag_begin ( dt_thumbtable_t *  table, int32_t  imgid  )

static

Definition at line 234 of file filemanager.c.

References darktable, dt_selection_select(), darktable_t::selection, and UNKNOWN_IMAGE.

Referenced by dt_thumbtable_grid_ops().

_grid_on_thumbnail_added()

static void _grid_on_thumbnail_added ( dt_thumbtable_t *  table, dt_thumbnail_t *  thumb  )

static

Definition at line 228 of file filemanager.c.

References _grid_is_thumb_highlighted(), dt_thumbnail_t::disable_actions, dt_thumbnail_update_selection(), FALSE, dt_image_t::id, and dt_thumbnail_t::info.

Referenced by dt_thumbtable_grid_ops().

_grid_place_child()

static void _grid_place_child ( dt_thumbtable_t *  table, dt_thumbnail_t *  thumb  )

static

Definition at line 183 of file filemanager.c.

References dt_thumbtable_t::grid, dt_thumbnail_t::widget, dt_thumbnail_t::x, and dt_thumbnail_t::y.

Referenced by dt_thumbtable_grid_ops().

_grid_position_to_rowid()

static int _grid_position_to_rowid ( dt_thumbtable_t *  table, const double  x, const double  y  )

static

Definition at line 91 of file filemanager.c.

References dt_thumbtable_t::thumb_height, dt_thumbtable_t::thumbs_per_row, and dt_thumbtable_t::view_height.

Referenced by dt_thumbtable_grid_ops().

_grid_pre_activate()

static void _grid_pre_activate ( dt_thumbtable_t *  table, int32_t  imgid  )

static

Definition at line 318 of file filemanager.c.

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

Referenced by dt_thumbtable_grid_ops().

_grid_relevant_scrollbar_changed()

static gboolean _grid_relevant_scrollbar_changed ( dt_thumbtable_t *  table, GtkWidget *  widget, GtkAllocation *  allocation  )

static

Definition at line 209 of file filemanager.c.

References FALSE, dt_thumbtable_t::last_v_scrollbar_width, dt_thumbtable_t::scroll_window, and TRUE.

Referenced by dt_thumbtable_grid_ops().

_grid_rowid_to_position()

static void _grid_rowid_to_position ( dt_thumbtable_t *  table, int  rowid, int *  x, int *  y  )

static

Definition at line 83 of file filemanager.c.

References row, dt_thumbtable_t::thumb_height, dt_thumbtable_t::thumb_width, dt_thumbtable_t::thumbs_per_row, and x.

Referenced by dt_thumbtable_grid_ops().

_grid_setup_parent()

static void _grid_setup_parent ( dt_thumbtable_t *  table )

static

Definition at line 244 of file filemanager.c.

References dt_get_help_url(), dt_gui_add_help_link(), dt_thumbtable_t::grid, dt_thumbtable_t::parent_overlay, and dt_thumbtable_t::scroll_window.

Referenced by dt_thumbtable_grid_ops().

_grid_update_content_size()

static void _grid_update_content_size ( dt_thumbtable_t *  table )

static

Definition at line 128 of file filemanager.c.

References dt_thumbtable_t::collection_count, DT_DEBUG_LIGHTTABLE, dt_print(), dt_thumbtable_t::grid, height, dt_thumbtable_t::thumb_height, dt_thumbtable_t::thumbs_per_row, and dt_thumbtable_t::view_width.

Referenced by dt_thumbtable_grid_ops().

_grid_wants_page_size_notify()

static gboolean _grid_wants_page_size_notify ( dt_thumbtable_t *  table, GObject *  object  )

static

Definition at line 201 of file filemanager.c.

References dt_thumbtable_t::v_scrollbar.

Referenced by dt_thumbtable_grid_ops().

_grid_wants_scroll_value()

static gboolean _grid_wants_scroll_value ( dt_thumbtable_t *  table, GtkAdjustment *  adjustment  )

static

Definition at line 196 of file filemanager.c.

References dt_thumbtable_t::v_scrollbar.

Referenced by dt_thumbtable_grid_ops().

_thumbtable_idle_apply_grid_configuration()

static gboolean _thumbtable_idle_apply_grid_configuration ( gpointer  user_data )

static

Idle callback for applying grid configuration.

This handler is used when grid configuration changes (like column count). It handles the grid reconfiguration and thumbnail updates, then schedules a follow-up idle callback for scrolling to ensure proper GTK widget state.

Definition at line 395 of file filemanager.c.

References dt_thumbtable_configure(), dt_thumbtable_refresh_thumbnail, dt_thumbtable_schedule_focus(), dt_thumbtable_update(), dt_thumbtable_t::grid, dt_thumbtable_t::idle_update_id, IS_NULL_PTR, dt_thumbtable_t::thumb_nb, TRUE, and UNKNOWN_IMAGE.

Referenced by dt_thumbtable_apply_grid_configuration().

dt_thumbtable_apply_grid_configuration()

void dt_thumbtable_apply_grid_configuration

(

dt_thumbtable_t *

table

)

Apply grid configuration changes with proper event synchronization.

Parameters

table

The thumbnail table

This function should be called when grid properties like column count change. It properly coalesces and orders the necessary updates:

1. Configures the grid based on current column settings
2. Updates and resizes all visible thumbnails
3. Scrolls to maintain the active selection in view

Unlike calling the functions separately, this ensures all operations happen together in the correct order within a single idle callback, preventing partial updates or out-of-sync scroll positions.

Definition at line 421 of file filemanager.c.

References _thumbtable_idle_apply_grid_configuration(), dt_thumbtable_set_active_rowid(), dt_thumbtable_t::idle_update_id, IS_NULL_PTR, and dt_thumbtable_t::scroll_window.

Referenced by _set_columns().

dt_thumbtable_get_zoom()

dt_thumbtable_zoom_t dt_thumbtable_get_zoom

(

dt_thumbtable_t *

table

)

Definition at line 367 of file filemanager.c.

References dt_thumbtable_t::zoom.

Referenced by _zoom_checked().

dt_thumbtable_grid_ops()

const dt_thumbtable_layout_ops_t * dt_thumbtable_grid_ops

(

void

)

Definition at line 329 of file filemanager.c.

References _grid_configure_dims(), _grid_create_content_widget(), _grid_get_row_ids(), _grid_grab_focus(), _grid_group_borders(), _grid_handle_key(), _grid_is_rowid_visible(), _grid_is_thumb_highlighted(), _grid_move_child(), _grid_on_drag_begin(), _grid_on_thumbnail_added(), _grid_place_child(), _grid_position_to_rowid(), _grid_pre_activate(), _grid_relevant_scrollbar_changed(), _grid_rowid_to_position(), _grid_setup_parent(), _grid_update_content_size(), _grid_wants_page_size_notify(), _grid_wants_scroll_value(), and dt_thumbtable_layout_ops_t::create_content_widget.

Referenced by _ops_for_mode().

dt_thumbtable_offset_zoom()

void dt_thumbtable_offset_zoom	(	dt_thumbtable_t *	table,
		const double	delta_x,
		const double	delta_y
	)

Definition at line 372 of file filemanager.c.

References dt_pthread_mutex_lock(), dt_pthread_mutex_unlock(), dt_thumbtable_t::list, dt_thumbtable_t::lock, value, dt_thumbnail_t::w_image, dt_thumbnail_t::zoomx, and dt_thumbnail_t::zoomy.

Referenced by _event_image_motion().

dt_thumbtable_set_zoom()

void dt_thumbtable_set_zoom	(	dt_thumbtable_t *	table,
		dt_thumbtable_zoom_t	level
	)

Definition at line 359 of file filemanager.c.

References dt_thumbtable_refresh_thumbnail, dt_thumbtable_schedule_focus(), dt_thumbtable_set_active_rowid(), TRUE, UNKNOWN_IMAGE, and dt_thumbtable_t::zoom.

Referenced by _dt_collection_changed_callback(), and _zoom_combobox_changed().