io.h

Go to the documentation of this file.

/*
    This file is part of the Ansel project.
    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 <limits.h>
#include <stddef.h>
#include <stdint.h>
 
#define DT_DRAWLAYER_IO_NAME_SIZE 64
#define DT_DRAWLAYER_IO_PROFILE_SIZE 256
 
typedef struct dt_drawlayer_io_patch_t
{
  int x;          
  int y;          
  int width;      
  int height;     
  float *pixels;  
} dt_drawlayer_io_patch_t;
 
typedef struct dt_drawlayer_io_layer_info_t
{
  gboolean found;                                   
  int index;                                        
  int count;                                        
  uint32_t width;                                   
  uint32_t height;                                  
  char name[DT_DRAWLAYER_IO_NAME_SIZE];             
  char work_profile[DT_DRAWLAYER_IO_PROFILE_SIZE];  
} dt_drawlayer_io_layer_info_t;
 
typedef struct _dt_job_t dt_job_t;
 
typedef struct dt_drawlayer_io_background_job_params_t
{
  int32_t imgid;
  int layer_width;
  int layer_height;
  int dst_x;
  int dst_y;
  int insert_after_order;
  char sidecar_path[PATH_MAX];
  char work_profile[DT_DRAWLAYER_IO_PROFILE_SIZE];
  char requested_bg_name[DT_DRAWLAYER_IO_NAME_SIZE];
  char filter[64];
  char initiator_layer_name[DT_DRAWLAYER_IO_NAME_SIZE];
  int initiator_layer_order;
  GSourceFunc done_idle;
} dt_drawlayer_io_background_job_params_t;
 
typedef struct dt_drawlayer_io_background_job_result_t
{
  gboolean success;
  int32_t imgid;
  int64_t sidecar_timestamp;
  char created_bg_name[DT_DRAWLAYER_IO_NAME_SIZE];
  char initiator_layer_name[DT_DRAWLAYER_IO_NAME_SIZE];
  int initiator_layer_order;
  char message[256];
} dt_drawlayer_io_background_job_result_t;
 
gboolean dt_drawlayer_io_sidecar_path(int32_t imgid, char *path, size_t path_size);
gboolean dt_drawlayer_io_find_layer(const char *path, const char *target_name, int target_order,
                                    dt_drawlayer_io_layer_info_t *info);
gboolean dt_drawlayer_io_load_layer(const char *path, const char *target_name, int target_order, int layer_width,
                                    int layer_height, dt_drawlayer_io_patch_t *patch);
gboolean dt_drawlayer_io_store_layer(const char *path, const char *target_name, int target_order,
                                     const char *work_profile, const dt_drawlayer_io_patch_t *patch, int layer_width,
                                     int layer_height, gboolean delete_target, int *final_order);
gboolean dt_drawlayer_io_insert_layer(const char *path, const char *target_name, int insert_after_order,
                                      const char *work_profile, const dt_drawlayer_io_patch_t *patch, int layer_width,
                                      int layer_height, int *final_order);
gboolean dt_drawlayer_io_rename_layer(const char *path, const char *current_name, const char *new_name,
                                      const char *work_profile, int layer_width, int layer_height,
                                      dt_drawlayer_io_layer_info_t *info);
gboolean dt_drawlayer_io_delete_layer(const char *path, const char *target_name, int layer_width, int layer_height);
gboolean dt_drawlayer_io_load_flat_rgba(const char *path, float **pixels, int *width, int *height);
gboolean dt_drawlayer_io_layer_name_exists(const char *path, const char *candidate, int ignore_index);
void dt_drawlayer_io_make_unique_name(const char *path, const char *requested, const char *fallback_name, char *name,
                                      size_t name_size);
void dt_drawlayer_io_make_unique_name_plain(const char *path, const char *requested, char *name, size_t name_size);
gboolean dt_drawlayer_io_list_layer_names(const char *path, char ***names, int *count);
void dt_drawlayer_io_free_layer_names(char ***names, int *count);
int32_t dt_drawlayer_io_background_layer_job_run(dt_job_t *job);