view.h

Go to the documentation of this file.

/*
    This file is part of darktable,
    Copyright (C) 2009-2011, 2013, 2015 johannes hanika.
    Copyright (C) 2010-2012, 2014 Henrik Andersson.
    Copyright (C) 2011 Omari Stephens.
    Copyright (C) 2011 Robert Bieber.
    Copyright (C) 2011 Simon Spannagel.
    Copyright (C) 2011-2017 Tobias Ellinghaus.
    Copyright (C) 2012-2013 José Carlos García Sogo.
    Copyright (C) 2012, 2014-2015 Jérémy Rosen.
    Copyright (C) 2012 Mika Boström.
    Copyright (C) 2012 Richard Wonka.
    Copyright (C) 2013 Benjamin Cahill.
    Copyright (C) 2013 Gaspard Jankowiak.
    Copyright (C) 2013-2015, 2018-2021 Pascal Obry.
    Copyright (C) 2013-2014 Ronny Kahl.
    Copyright (C) 2016 Roman Lebedev.
    Copyright (C) 2017 luzpaz.
    Copyright (C) 2018 Rikard Öxler.
    Copyright (C) 2019-2022 Aldric Renaudin.
    Copyright (C) 2019, 2022-2023, 2025 Aurélien PIERRE.
    Copyright (C) 2019 Edgardo Hoszowski.
    Copyright (C) 2019 Marcello Mamino.
    Copyright (C) 2019 vacaboja.
    Copyright (C) 2020-2021 Diederik Ter Rahe.
    Copyright (C) 2020 Hanno Schwalm.
    Copyright (C) 2020-2021 Philippe Weyland.
    Copyright (C) 2021 Ralf Brown.
    Copyright (C) 2022 Chris Elston.
    Copyright (C) 2022 Martin Bařinka.
    Copyright (C) 2025 Guillaume Stutin.
    
    darktable is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.
    
    darktable is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
    
    You should have received a copy of the GNU General Public License
    along with darktable.  If not, see <http://www.gnu.org/licenses/>.
*/
 
#ifndef DT_VIEWS_VIEW_H
#define DT_VIEWS_VIEW_H
 
#include "common/image.h"   // dt_view_image_over_t
 
#include "system/atomic.h"
#include "system/dtpthread.h"
 
#include "history/history.h"
#ifdef HAVE_PRINT
#include "common/cups_print.h"
#include "common/printing.h"
#endif
#ifdef HAVE_MAP
#include "metadata/geo.h"
#include "metadata/map_locations.h"
#include <osm-gps-map.h>
#endif
#include <cairo.h>
#include <gmodule.h>
#include <inttypes.h>
#include <sqlite3.h>
 
typedef enum
{
  DT_VIEW_LIGHTTABLE = 1 << 0,
  DT_VIEW_STUDIO_CAPTURE = 1 << 1,
  DT_VIEW_DARKROOM = 1 << 2,
  DT_VIEW_MAP = 1 << 3,
  DT_VIEW_SLIDESHOW = 1 << 4,
  DT_VIEW_PRINT = 1 << 5,
} dt_view_type_flags_t;
 
// flags that a view can set in flags()
typedef enum dt_view_flags_t
{
  VIEW_FLAGS_NONE = 0,
  VIEW_FLAGS_HIDDEN = 1 << 0,       // Hide the view from userinterface
  VIEW_FLAGS_PAINTS_WHOLE_AREA = 1 << 1,   // its expose paints every pixel of the centre: no background fill needed
} dt_view_flags_t;
 
typedef enum dt_darkroom_layout_t
{
  DT_DARKROOM_LAYOUT_FIRST = -1,
  DT_DARKROOM_LAYOUT_EDITING = 0,
  DT_DARKROOM_LAYOUT_COLOR_ASSESMENT = 1,
  DT_DARKROOM_LAYOUT_LAST = 3
} dt_darkroom_layout_t;
 
 
// flags that a view can set in flags()
typedef enum dt_view_surface_value_t
{
  DT_VIEW_SURFACE_OK = 0,
  DT_VIEW_SURFACE_KO,
} dt_view_surface_value_t;
 
typedef struct _dt_job_t dt_job_t;
 
typedef struct dt_view_image_surface_fetcher_t
{
  dt_pthread_mutex_t lock;
  pthread_cond_t cond;
  GWeakRef widget_ref;
  cairo_surface_t **target;
  int32_t imgid;
  int width;
  int height;
  int zoom;
  int32_t cached_imgid;
  int cached_width;
  int cached_height;
  int cached_zoom;
  dt_atomic_int shutdown;
  guint request_id;
  guint queued_request_id;
  gboolean commit_pending;
  gboolean job_queued;
  gboolean destroying;
} dt_view_image_surface_fetcher_t;
 
#define DT_VIEW_ALL                                                                                   \
  (DT_VIEW_LIGHTTABLE | DT_VIEW_STUDIO_CAPTURE | DT_VIEW_DARKROOM | DT_VIEW_MAP | DT_VIEW_SLIDESHOW | \
   DT_VIEW_PRINT)
 
/* maximum zoom factor for the lighttable */
#define DT_LIGHTTABLE_MAX_ZOOM 12
 
typedef struct dt_view_t
{
#define INCLUDE_API_FROM_MODULE_H
#include "views/view_api.h"
 
  char module_name[64];
  // dlopened module
  GModule *module;
  // custom data for module
  void *data;
  // width and height of allocation
  uint32_t width, height;
  // scroll bar control
  float vscroll_size, vscroll_lower, vscroll_viewport_size, vscroll_pos;
  float hscroll_size, hscroll_lower, hscroll_viewport_size, hscroll_pos;
} dt_view_t;
 
/* dt_view_image_over_t now lives in common/image.h: it is the value stored in
 * dt_image_t.rating (0-5 stars, 6 = rejected) plus the other per-thumbnail overlay
 * states, and it was consumed 8x from common/, 3x from caches/ and 5x from gui/ against
 * exactly ONE use in views/ -- an enum defined at the top layer and read from the
 * bottom. */
 
char* dt_view_extend_modes_str(const char * name, const gboolean is_hdr, const gboolean is_bw, const gboolean is_bw_flow);
dt_view_surface_value_t dt_view_image_get_surface(int32_t imgid, int width, int height, cairo_surface_t **surface,
                                                  int zoom);
void dt_view_image_surface_fetcher_init(dt_view_image_surface_fetcher_t *fetcher);
void dt_view_image_surface_fetcher_cleanup(dt_view_image_surface_fetcher_t *fetcher);
void dt_view_image_surface_fetcher_invalidate(dt_view_image_surface_fetcher_t *fetcher, cairo_surface_t **target);
dt_view_surface_value_t dt_view_image_get_surface_async(dt_view_image_surface_fetcher_t *fetcher, int32_t imgid,
                                                        int width, int height, cairo_surface_t **target,
                                                        GtkWidget *widget, int zoom);
 
 
typedef struct dt_view_manager_t
{
  GList *views;
  dt_view_t *current_view;
 
  // images currently active in the main view (there can be more than 1 in culling)
  GList *active_images;
 
  // the copy/paste history clipboard used to live here; the view manager never touched
  // it, so it is now file-static in common/history_actions.c behind
  // dt_history_copy_paste_get(), and that file no longer includes views/view.h
 
  // The imgid of the image for which we currently show the image info
  int32_t image_info_id;
 
  struct
  {
    GPid audio_player_pid;   // the pid of the child process
    int32_t audio_player_id; // the imgid of the image the audio is played for
    guint audio_player_event_source;
  } audio;
 
  // toggle button for guides (in the module toolbox)
  GtkWidget *guides_toggle, *guides, *guides_colors, *guides_contrast, *guides_popover;
 
  /*
   * Proxy
   */
  struct
  {
    /* module toolbox proxy object */
    struct
    {
      struct dt_lib_module_t *module;
      void (*add)(struct dt_lib_module_t *, GtkWidget *, dt_view_type_flags_t);
    } module_toolbox;
 
    /* module collection proxy object */
    struct
    {
      struct dt_lib_module_t *module;
      void (*update)(struct dt_lib_module_t *);
    } module_collect;
 
    /* darkroom view proxy object */
    struct
    {
      struct dt_view_t *view;
      dt_darkroom_layout_t (*get_layout)(struct dt_view_t *view);
      void (*set_default_cursor)(struct dt_view_t *view, double x, double y);
    } darkroom;
 
/* map view proxy object */
#ifdef HAVE_MAP
    struct
    {
      struct dt_view_t *view;
      void (*center_on_location)(const dt_view_t *view, gdouble lon, gdouble lat, double zoom);
      void (*center_on_bbox)(const dt_view_t *view, gdouble lon1, gdouble lat1, gdouble lon2, gdouble lat2);
      void (*show_osd)(const dt_view_t *view);
      void (*set_map_source)(const dt_view_t *view, OsmGpsMapSource_t map_source);
      GObject *(*add_marker)(const dt_view_t *view, dt_geo_map_display_t type, GList *points);
      gboolean (*remove_marker)(const dt_view_t *view, dt_geo_map_display_t type, GObject *marker);
      void (*add_location)(const dt_view_t *view, dt_map_location_data_t *p, const guint posid);
      void (*location_action)(const dt_view_t *view, const int action);
      gboolean (*redraw)(gpointer user_data);
    } map;
#endif
 
    /* map view proxy object */
#ifdef HAVE_PRINT
    struct
    {
      struct dt_view_t *view;
      void (*print_settings)(const dt_view_t *view, dt_print_info_t *pinfo, dt_images_box *imgs);
    } print;
#endif
  } proxy;
 
 
} dt_view_manager_t;
 
struct dt_view_manager_t *dt_view_manager_get_global(void);
 
void dt_view_manager_init(dt_view_manager_t *vm);
void dt_view_manager_gui_init(dt_view_manager_t *vm);
void dt_view_manager_cleanup(dt_view_manager_t *vm);
 
const char *dt_view_manager_name(dt_view_manager_t *vm);
int dt_view_manager_switch(dt_view_manager_t *vm, const char *view_name);
int dt_view_manager_switch_by_view(dt_view_manager_t *vm, const dt_view_t *new_view);
uint32_t dt_view_manager_current_flags(const dt_view_manager_t *vm);
 
void dt_view_manager_expose(dt_view_manager_t *vm, cairo_t *cr, int32_t width, int32_t height,
                            int32_t pointerx, int32_t pointery);
void dt_view_manager_reset(dt_view_manager_t *vm);
const dt_view_t *dt_view_manager_get_current_view(dt_view_manager_t *vm);
 
void dt_view_manager_mouse_enter(dt_view_manager_t *vm);
void dt_view_manager_mouse_leave(dt_view_manager_t *vm);
void dt_view_manager_mouse_moved(dt_view_manager_t *vm, double x, double y, double pressure, int which);
int dt_view_manager_button_released(dt_view_manager_t *vm, double x, double y, int which, uint32_t state);
int dt_view_manager_button_pressed(dt_view_manager_t *vm, double x, double y, double pressure, int which,
                                   int type, uint32_t state);
int dt_view_manager_key_pressed(dt_view_manager_t *vm, GdkEventKey *event);
void dt_view_manager_configure(dt_view_manager_t *vm, int width, int height);
int dt_view_manager_scrolled(dt_view_manager_t *vm, double x, double y, int up, int state, int delta_y);
 
void dt_view_manager_module_toolbox_add(dt_view_manager_t *vm, GtkWidget *tool, dt_view_type_flags_t view);
 
void dt_view_image_info_update(const int32_t imgid);
 
// active images functions
void dt_view_active_images_reset(gboolean raise);
void dt_view_active_images_set(GList *images, gboolean raise);
void dt_view_active_images_add(int32_t imgid, gboolean raise);
void dt_view_active_images_remove(int32_t imgid, gboolean raise);
gboolean dt_view_active_images_has_imgid(int32_t imgid);
 
GList *dt_view_active_images_get_all();
int32_t dt_view_active_images_get_first();
 
cairo_surface_t *dt_cairo_rescale_surface(cairo_surface_t *src, int dst_w, int dst_h);
void dt_cairo_sharpen_surface_rgb24(cairo_surface_t *surface);
 
dt_darkroom_layout_t dt_view_darkroom_get_layout(dt_view_manager_t *vm);
 
/* audio */
void dt_view_audio_start(dt_view_manager_t *vm, int32_t imgid);
void dt_view_audio_stop(dt_view_manager_t *vm);
 
/*
 * Map View Proxy
 */
#ifdef HAVE_MAP
void dt_view_map_center_on_location(const dt_view_manager_t *vm, gdouble lon, gdouble lat, gdouble zoom);
void dt_view_map_center_on_bbox(const dt_view_manager_t *vm, gdouble lon1, gdouble lat1, gdouble lon2, gdouble lat2);
void dt_view_map_show_osd(const dt_view_manager_t *vm);
void dt_view_map_set_map_source(const dt_view_manager_t *vm, OsmGpsMapSource_t map_source);
GObject *dt_view_map_add_marker(const dt_view_manager_t *vm, dt_geo_map_display_t type, GList *points);
gboolean dt_view_map_remove_marker(const dt_view_manager_t *vm, dt_geo_map_display_t type, GObject *marker);
void dt_view_map_add_location(const dt_view_manager_t *vm, dt_map_location_data_t *p, const guint posid);
void dt_view_map_location_action(const dt_view_manager_t *vm, const int action);
void dt_view_map_redraw(const dt_view_manager_t *vm);
#endif
 
/*
 * Print View Proxy
 */
#ifdef HAVE_PRINT
void dt_view_print_settings(const dt_view_manager_t *vm, dt_print_info_t *pinfo, dt_images_box *imgs);
#endif
 
#endif // DT_VIEWS_VIEW_H
 
// clang-format off
// modelines: These editor modelines have been set for all relevant files by tools/update_modelines.py
// vim: shiftwidth=2 expandtab tabstop=2 cindent
// kate: tab-indents: off; indent-width 2; replace-tabs on; indent-mode cstyle; remove-trailing-spaces modified;
// clang-format on