doc_screenshot.h

Go to the documentation of this file.

/*
    This file is part of Ansel.
    Copyright (C) 2026 Guillaume Stutin.
 
    Ansel 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.
 
    Ansel 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 Ansel.  If not, see <http://www.gnu.org/licenses/>.
*/
 
#ifndef DT_GUI_ACTIONS_DOC_SCREENSHOT_H
#define DT_GUI_ACTIONS_DOC_SCREENSHOT_H
 
#include <gtk/gtk.h>
 
void dt_gui_doc_screenshot_enable(void);
 
gboolean dt_gui_doc_screenshot_enabled(void);
 
void dt_gui_doc_screenshot_set_directory(const char *path);
 
void dt_gui_doc_screenshot_window_show(void);
 
/* Where the module inventories come from.
 *
 * The panel lists tool modules and darkroom modules by name, which are `dt_lib_module_t`
 * and `dt_iop_module_t` -- and those live two and three layers ABOVE gui/. Reading them
 * from here inverted the dependency graph four times over (tools/check_layering.sh), so the
 * panel no longer knows what a module is: it asks for (widget, name) pairs and whoever
 * knows how to produce them hands them over.
 *
 * src/darktable.c is where they are supplied from. That is not a fallback: the orchestrator
 * is the one place that sits above every module by construction, so it is the only place
 * that may legally see both lists. */
 
void dt_gui_doc_screenshot_add_target(void *inventory, GtkWidget *widget, const char *name);
 
typedef void (*dt_gui_doc_screenshot_source_t)(void *inventory);
 
void dt_gui_doc_screenshot_register_source(const char *section, dt_gui_doc_screenshot_source_t source);
 
#endif // DT_GUI_ACTIONS_DOC_SCREENSHOT_H