history_merge.h

Go to the documentation of this file.

/*
    This file is part of Ansel,
    Copyright (C) 2026 Aurélien PIERRE.
 
    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/>.
*/
 
#pragma once
 
#include <glib.h>
#include <inttypes.h>
 
#ifdef __cplusplus
extern "C"
{
#endif
 
  struct dt_develop_t;
  struct dt_iop_module_t;
 
  typedef enum dt_history_merge_strategy_t
  {
    DT_HISTORY_MERGE_PREPEND = 0,   // source applied early in destination history (destination wins conflicts)
    DT_HISTORY_MERGE_APPEND = 1,   // source applied after destination (source wins conflicts)
    DT_HISTORY_MERGE_REPLACE = 2   // entirely replace history and modules order
  } dt_history_merge_strategy_t;
 
  typedef enum dt_hm_batch_decision_t
  {
    DT_HM_BATCH_UNDECIDED = 0,  // show the report dialog for each image
    DT_HM_BATCH_ACCEPT,         // silently keep the merge result
    DT_HM_BATCH_REVERT,         // silently revert the merge
  } dt_hm_batch_decision_t;
 
  typedef struct dt_hm_batch_state_t
  {
    dt_hm_batch_decision_t decision;
    // Resolved destination module order (list of owned "op|multi_name" strings) captured from the first
    // accepted image of a batch. When non-NULL, later images replay this order instead of re-solving it,
    // so a single high-level decision (and any manual reorder done in the report) applies to the whole batch.
    GList *order_ids;
  } dt_hm_batch_state_t;
 
  void dt_hm_batch_state_cleanup(dt_hm_batch_state_t *batch);
 
  int dt_history_merge(struct dt_develop_t *dev_dest, struct dt_develop_t *dev_src, const int32_t dest_imgid,
                       const GList *mod_list, const gboolean merge_iop_order,
                       const dt_history_merge_strategy_t strategy, const gboolean force_new_modules,
                       const char *source_label, dt_hm_batch_state_t *batch);
 
#ifdef __cplusplus
}
#endif
 
// 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