![]() |
Ansel 0.0
A darktable fork - bloat + design vision
|
#include "system/atomic.h"#include "common/image.h"#include "imageio/imageio_module.h"#include "caches/mipmap_cache.h"#include <glib.h>#include <stdio.h>#include <inttypes.h>Go to the source code of this file.
Macros | |
| #define | FILTERS_ARE_CYGM(filters) |
| #define | FILTERS_ARE_RGBE(filters) |
| #define | FILTERS_ARE_4BAYER(filters) |
| #define | ADOBE_COEFF_FACTOR 10000 |
Typedefs | |
| typedef enum dt_imageio_levels_t | dt_imageio_levels_t |
Enumerations | |
| enum | dt_imageio_levels_t { IMAGEIO_INT8 = 0x0 , IMAGEIO_INT12 = 0x1 , IMAGEIO_INT16 = 0x2 , IMAGEIO_INT32 = 0x3 , IMAGEIO_FLOAT = 0x4 , IMAGEIO_BW = 0x5 , IMAGEIO_PREC_MASK = 0xFF , IMAGEIO_RGB = 0x100 , IMAGEIO_GRAY = 0x200 , IMAGEIO_CHANNEL_MASK = 0xFF00 } |
Functions | |
| gboolean | dt_imageio_is_ldr (const char *filename) |
| gboolean | dt_imageio_has_mono_preview (const char *filename) |
| dt_imageio_retval_t | dt_imageio_open_hdr (dt_image_t *img, const char *filename, dt_mipmap_buffer_t *buf) |
| dt_imageio_retval_t | dt_imageio_open_raster (dt_image_t *img, const char *filename, dt_mipmap_buffer_t *buf) |
| dt_imageio_retval_t | dt_imageio_open (dt_image_t *img, const char *filename, dt_mipmap_buffer_t *buf) |
| dt_imageio_retval_t | dt_imageio_open_standalone (dt_image_t *img, const char *filename, dt_mipmap_buffer_t *buf) |
| Decode a file into a buffer the CALLER owns, with no cache involvement. | |
| void | dt_imageio_close_standalone (dt_mipmap_buffer_t *buf) |
| Release a buffer from dt_imageio_open_standalone(). NULL-safe, and safe to call on a buffer whose open failed. | |
| int | dt_imageio_export (const int32_t imgid, const char *filename, struct dt_imageio_module_format_t *format, struct dt_imageio_module_data_t *format_params, const double scale_factor, const gboolean high_quality, const gboolean copy_metadata, const gboolean export_masks, dt_colorspaces_color_profile_type_t icc_type, const gchar *icc_filename, dt_iop_color_intent_t icc_intent, dt_imageio_module_storage_t *storage, dt_imageio_module_data_t *storage_params, int num, int total, dt_export_metadata_t *metadata) |
| dt_imageio_retval_t | dt_imageio_export_with_flags (const int32_t imgid, const char *filename, struct dt_imageio_module_format_t *format, struct dt_imageio_module_data_t *format_params, const gboolean ignore_exif, const gboolean display_byteorder, const gboolean high_quality, const double scale_factor, const gboolean thumbnail_export, const gboolean ignore_history, const char *filter, const gboolean copy_metadata, const gboolean export_masks, dt_colorspaces_color_profile_type_t icc_type, const gchar *icc_filename, dt_iop_color_intent_t icc_intent, dt_imageio_module_storage_t *storage, dt_imageio_module_data_t *storage_params, int num, int total, dt_export_metadata_t *metadata, dt_atomic_int *shutdown) |
| void | dt_imageio_flip_buffers (char *out, const char *in, const size_t bpp, const int wd, const int ht, const int fwd, const int fht, const int stride, const dt_image_orientation_t orientation) |
| void | dt_imageio_flip_buffers_ui8_to_float (float *out, const uint8_t *in, const float black, const float white, const int ch, const int wd, const int ht, const int fwd, const int fht, const int stride, const dt_image_orientation_t orientation) |
| int | dt_imageio_large_thumbnail (const char *filename, uint8_t **buffer, int32_t *th_width, int32_t *th_height, dt_colorspaces_color_profile_type_t *color_space, const int width, const int height) |
| Load the thumbnail embedded into a RAW file having at least the size MAX(width, height) x MAX(width, height). | |
| gboolean | dt_imageio_crop_thumbnail (const dt_boundingbox_t box, uint8_t *const buffer, int32_t *width, int32_t *height) |
| Crop an 8-bit RGBA preview buffer in place to a normalized bounding box. | |
| gboolean | dt_imageio_lookup_makermodel (const char *maker, const char *model, char *mk, int mk_len, char *md, int md_len, char *al, int al_len) |
| #define ADOBE_COEFF_FACTOR 10000 |
Definition at line 59 of file imageio_core.h.
Referenced by dt_imageio_dng_write_tiff_header().
| #define FILTERS_ARE_4BAYER | ( | filters | ) |
Definition at line 56 of file imageio_core.h.
Referenced by dt_imageio_open_rawspeed(), and vng_interpolate().
| #define FILTERS_ARE_CYGM | ( | filters | ) |
Definition at line 49 of file imageio_core.h.
Referenced by gui_sliders_update().
| #define FILTERS_ARE_RGBE | ( | filters | ) |
Definition at line 52 of file imageio_core.h.
| typedef enum dt_imageio_levels_t dt_imageio_levels_t |
| enum dt_imageio_levels_t |
| Enumerator | |
|---|---|
| IMAGEIO_INT8 | |
| IMAGEIO_INT12 | |
| IMAGEIO_INT16 | |
| IMAGEIO_INT32 | |
| IMAGEIO_FLOAT | |
| IMAGEIO_BW | |
| IMAGEIO_PREC_MASK | |
| IMAGEIO_RGB | |
| IMAGEIO_GRAY | |
| IMAGEIO_CHANNEL_MASK | |
Definition at line 61 of file imageio_core.h.
| void dt_imageio_close_standalone | ( | dt_mipmap_buffer_t * | buf | ) |
Release a buffer from dt_imageio_open_standalone(). NULL-safe, and safe to call on a buffer whose open failed.
Definition at line 1204 of file imageio_core.c.
References dt_mipmap_buffer_t::buf, dt_mipmap_buffer_t::cache_entry, dt_cache_entry_free_detached(), and IS_NULL_PTR.
Referenced by _import_get_thumbnail(), and dt_imageio_open_standalone().
| gboolean dt_imageio_crop_thumbnail | ( | const dt_boundingbox_t | box, |
| uint8_t *const | buffer, | ||
| int32_t * | width, | ||
| int32_t * | height ) |
Crop an 8-bit RGBA preview buffer in place to a normalized bounding box.
Cameras that record selected framing (DNG DefaultUserCrop) still render their embedded previews from the full default-crop rectangle, so a preview taken straight out of the raw shows more than the photographer framed. This trims it back.
The box must be expressed in the buffer's own orientation. For previews read from a raw that is the un-oriented sensor frame (dt_image_get_usercrop()), because Ansel applies the EXIF rotation afterwards, when downscaling.
Only ever apply this to a preview embedded in the raw itself: a companion/sidecar JPEG is written by the camera at the framing it displayed and is already cropped.
| box | normalized (top, left, bottom, right); an identity box is a no-op |
| buffer | 8-bit RGBA pixels, compacted in place |
| width | in/out buffer width, updated to the cropped width |
| height | in/out buffer height, updated to the cropped height |
Definition at line 195 of file imageio_core.c.
References FALSE, height, IS_NULL_PTR, top, TRUE, and width.
Referenced by _import_get_thumbnail(), and _init_8().
| int dt_imageio_export | ( | const int32_t | imgid, |
| const char * | filename, | ||
| struct dt_imageio_module_format_t * | format, | ||
| struct dt_imageio_module_data_t * | format_params, | ||
| const double | scale_factor, | ||
| const gboolean | high_quality, | ||
| const gboolean | copy_metadata, | ||
| const gboolean | export_masks, | ||
| dt_colorspaces_color_profile_type_t | icc_type, | ||
| const gchar * | icc_filename, | ||
| dt_iop_color_intent_t | icc_intent, | ||
| dt_imageio_module_storage_t * | storage, | ||
| dt_imageio_module_data_t * | storage_params, | ||
| int | num, | ||
| int | total, | ||
| dt_export_metadata_t * | metadata ) |
Output size, for both functions below: with scale_factor > 0 the image is reduced by that factor (capped at 1); otherwise it is fitted in format_params->max_width x max_height, 0 x 0 meaning full size. Nothing is read from the export module's configuration: the size is the caller's, resolved once, so an export queued before a settings change keeps its own.
Definition at line 608 of file imageio_core.c.
References dt_imageio_export_with_flags(), FALSE, dt_imageio_module_format_t::mime, TRUE, and dt_imageio_module_format_t::write_image.
| dt_imageio_retval_t dt_imageio_export_with_flags | ( | const int32_t | imgid, |
| const char * | filename, | ||
| struct dt_imageio_module_format_t * | format, | ||
| struct dt_imageio_module_data_t * | format_params, | ||
| const gboolean | ignore_exif, | ||
| const gboolean | display_byteorder, | ||
| const gboolean | high_quality, | ||
| const double | scale_factor, | ||
| const gboolean | thumbnail_export, | ||
| const gboolean | ignore_history, | ||
| const char * | filter, | ||
| const gboolean | copy_metadata, | ||
| const gboolean | export_masks, | ||
| dt_colorspaces_color_profile_type_t | icc_type, | ||
| const gchar * | icc_filename, | ||
| dt_iop_color_intent_t | icc_intent, | ||
| dt_imageio_module_storage_t * | storage, | ||
| dt_imageio_module_data_t * | storage_params, | ||
| int | num, | ||
| int | total, | ||
| dt_export_metadata_t * | metadata, | ||
| dt_atomic_int * | shutdown ) |
| ignore_history | render the input image as no edit has touched it – history end 0, so every module with its default params and enabled state – instead of the image's history. |
Definition at line 850 of file imageio_core.c.
References _apply_style_before_export(), _export_convert_output(), _filter_pipeline(), _get_export_size(), _print_export_debug(), bpp, dt_imageio_module_format_t::bpp, dt_mipmap_buffer_t::buf, data, dev, DT_COLORSPACE_SRGB, dt_colorspaces_get_output_profile(), dt_control_signal_get_global(), DT_DEBUG_CONTROL_SIGNAL_RAISE, DT_DEBUG_IMAGEIO, dt_dev_backbuf_get_hash(), dt_dev_cleanup(), dt_dev_init(), dt_dev_load_image(), dt_dev_pixelpipe_cache_rdlock_entry(), dt_dev_pixelpipe_cache_ref_count_entry(), dt_dev_pixelpipe_cache_ref_entry_by_hash(), dt_dev_pixelpipe_cleanup(), dt_dev_pixelpipe_create_nodes(), dt_dev_pixelpipe_get_roi_out(), dt_dev_pixelpipe_has_shutdown(), dt_dev_pixelpipe_init_export(), dt_dev_pixelpipe_init_thumbnail(), dt_dev_pixelpipe_process(), dt_dev_pixelpipe_propagate_formats(), dt_dev_pixelpipe_set_icc(), dt_dev_pixelpipe_set_input(), dt_dev_pixelpipe_synch_all, dt_dev_set_history_end_ext(), dt_exif_read_blob(), dt_exif_xmp_attach_export(), dt_free, dt_get_times(), dt_image_full_path(), DT_IMAGEIO_ABORTED, DT_IMAGEIO_CACHE_FULL, DT_IMAGEIO_IOERROR, DT_IMAGEIO_OK, DT_IMAGEIO_PROCESSING_FAILED, dt_ioppr_resync_modules_order(), DT_MIPMAP_BLOCKING, dt_mipmap_cache_get, dt_mipmap_cache_release, DT_MIPMAP_FULL, DT_PATH_MAX, dt_pixelpipe_cache_alloc_align_cache, dt_pixelpipe_cache_free_align, dt_pixelpipe_cache_get_alloc_refusals(), dt_print(), dt_pthread_rwlock_unlock(), dt_pthread_rwlock_wrlock(), dt_show_times(), DT_SIGNAL_IMAGE_EXPORT_TMPFILE, error(), FALSE, dt_imageio_module_format_t::flags, FORMAT_FLAGS_NO_TMPFILE, FORMAT_FLAGS_SUPPORT_XMP, dt_imageio_module_data_t::height, dt_mipmap_buffer_t::height, height, IS_NULL_PTR, dt_mipmap_buffer_t::iscale, dt_imageio_module_format_t::levels, MAX, dt_imageio_module_data_t::max_height, dt_imageio_module_data_t::max_width, dt_imageio_module_format_t::mime, pipe, processed_height, processed_width, res, size, sRGB, dt_mipmap_buffer_t::status, status, dt_imageio_module_data_t::style, TRUE, dt_imageio_module_data_t::width, dt_mipmap_buffer_t::width, width, and dt_imageio_module_format_t::write_image.
Referenced by _export_image(), _export_pre_module_fullres_to_tiff(), _init_8(), dt_control_merge_hdr_job_run(), and dt_imageio_export().
| void dt_imageio_flip_buffers | ( | char * | out, |
| const char * | in, | ||
| const size_t | bpp, | ||
| const int | wd, | ||
| const int | ht, | ||
| const int | fwd, | ||
| const int | fht, | ||
| const int | stride, | ||
| const dt_image_orientation_t | orientation ) |
Definition at line 265 of file imageio_core.c.
References __OMP_PARALLEL_FOR__, bpp, i, in, memcpy(), ORIENTATION_FLIP_X, ORIENTATION_FLIP_Y, ORIENTATION_SWAP_XY, and out.
Referenced by _orient_scope_buf(), distort_mask(), dt_imageio_open_rawspeed(), and process().
| void dt_imageio_flip_buffers_ui8_to_float | ( | float * | out, |
| const uint8_t * | in, | ||
| const float | black, | ||
| const float | white, | ||
| const int | ch, | ||
| const int | wd, | ||
| const int | ht, | ||
| const int | fwd, | ||
| const int | fht, | ||
| const int | stride, | ||
| const dt_image_orientation_t | orientation ) |
Definition at line 306 of file imageio_core.c.
References __OMP_PARALLEL_FOR__, ch, i, in, k, ORIENTATION_FLIP_X, ORIENTATION_FLIP_Y, ORIENTATION_SWAP_XY, and out.
Referenced by dt_imageio_open_jpeg().
| gboolean dt_imageio_has_mono_preview | ( | const char * | filename | ) |
Definition at line 231 of file imageio_core.c.
References cleanup(), color_space, DT_DEBUG_IMAGEIO, dt_imageio_large_thumbnail(), dt_pixelpipe_cache_free_align, dt_print(), FALSE, in, IS_NULL_PTR, TRUE, and x.
| gboolean dt_imageio_is_ldr | ( | const char * | filename | ) |
| int dt_imageio_large_thumbnail | ( | const char * | filename, |
| uint8_t ** | buffer, | ||
| int32_t * | th_width, | ||
| int32_t * | th_height, | ||
| dt_colorspaces_color_profile_type_t * | color_space, | ||
| const int | width, | ||
| const int | height ) |
Load the thumbnail embedded into a RAW file having at least the size MAX(width, height) x MAX(width, height).
| filename | |
| buffer | returned image buffer (allocated) |
| th_width | returned actual width of the thumbnail |
| th_height | returned actual height of the thumbnail |
| color_space | returned color space found for the thumbnail |
| width | input target width. th_width will be at least this. |
| height | input target height th_height will be at least this. |
Definition at line 128 of file imageio_core.c.
References color_space, DT_COLORSPACE_SRGB, dt_exif_get_thumbnail(), dt_free, dt_imageio_jpeg_decompress(), dt_imageio_jpeg_decompress_header(), dt_imageio_tiff_decode_blob(), dt_pixelpipe_cache_alloc_align_cache, dt_pixelpipe_cache_free_align, error(), dt_imageio_jpeg_t::height, height, IS_NULL_PTR, MAX, res, dt_imageio_jpeg_t::width, and width.
Referenced by _get_image_buffer(), _import_get_thumbnail(), _init_8(), and dt_imageio_has_mono_preview().
| gboolean dt_imageio_lookup_makermodel | ( | const char * | maker, |
| const char * | model, | ||
| char * | mk, | ||
| int | mk_len, | ||
| char * | md, | ||
| int | md_len, | ||
| char * | al, | ||
| int | al_len ) |
Definition at line 1212 of file imageio_core.c.
References dt_libraw_lookup_makermodel(), dt_rawspeed_lookup_makermodel(), FALSE, maker, and model.
Referenced by dt_collection_get_makermodel(), and dt_image_refresh_makermodel().
| dt_imageio_retval_t dt_imageio_open | ( | dt_image_t * | img, |
| const char * | filename, | ||
| dt_mipmap_buffer_t * | buf ) |
Definition at line 1114 of file imageio_core.c.
References _decoder_reason(), dt_image_t::crop_height, dt_image_t::crop_width, dt_image_t::crop_x, dt_image_t::crop_y, dt_control_alert_once(), dt_control_log(), dt_image_buffer_resolve_flags(), DT_IMAGEIO_CACHE_FULL, DT_IMAGEIO_FILE_CORRUPTED, dt_imageio_is_hdr(), dt_imageio_is_raster(), dt_imageio_is_raw(), DT_IMAGEIO_OK, dt_imageio_open_hdr(), dt_imageio_open_raster(), dt_imageio_open_raw(), dt_image_t::height, dt_image_t::loader, LOADER_UNKNOWN, dt_image_t::p_height, dt_image_t::p_width, and dt_image_t::width.
Referenced by _generate_blocking(), and dt_imageio_open_standalone().
| dt_imageio_retval_t dt_imageio_open_hdr | ( | dt_image_t * | img, |
| const char * | filename, | ||
| dt_mipmap_buffer_t * | buf ) |
Definition at line 372 of file imageio_core.c.
References _decoder_reason(), DT_IMAGEIO_CACHE_FULL, DT_IMAGEIO_FILE_CORRUPTED, DT_IMAGEIO_OK, dt_imageio_open_avif(), dt_imageio_open_exr(), dt_imageio_open_heif(), dt_imageio_open_pfm(), dt_imageio_open_rgbe(), and IS_NULL_PTR.
Referenced by dt_imageio_open().
| dt_imageio_retval_t dt_imageio_open_raster | ( | dt_image_t * | img, |
| const char * | filename, | ||
| dt_mipmap_buffer_t * | buf ) |
Definition at line 505 of file imageio_core.c.
References _decoder_reason(), DT_IMAGEIO_CACHE_FULL, DT_IMAGEIO_FILE_CORRUPTED, DT_IMAGEIO_OK, dt_imageio_open_j2k(), dt_imageio_open_jpeg(), dt_imageio_open_png(), dt_imageio_open_pnm(), dt_imageio_open_tiff(), dt_imageio_open_webp(), and IS_NULL_PTR.
Referenced by dt_imageio_open().
| dt_imageio_retval_t dt_imageio_open_standalone | ( | dt_image_t * | img, |
| const char * | filename, | ||
| dt_mipmap_buffer_t * | buf ) |
Decode a file into a buffer the CALLER owns, with no cache involvement.
dt_imageio_open() writes into a dt_mipmap_buffer_t whose cache_entry the mipmap cache supplies and owns. A caller that just wants one image decoded once – the import dialog's preview, say – has no cache entry to give it, and used to fabricate a zeroed dt_cache_entry_t on its own stack, hand over its address, and free cache_entry.data itself. That is a caller assembling the cache's internal bookkeeping by hand in order to borrow the decoder, and it is why gui/import.c had to include the cache's substrate header.
This pair owns that bookkeeping instead. Nothing outside src/caches needs to know what a dt_cache_entry_t is.
| img | image metadata, filled by the decoder as with dt_imageio_open(). |
| filename | file to decode. |
| buf | receives the decoded image. Zeroed first; release with dt_imageio_close_standalone() whether this succeeds or fails. |
Definition at line 1186 of file imageio_core.c.
References dt_mipmap_buffer_t::cache_entry, dt_cache_entry_new_detached(), DT_IMAGEIO_CACHE_FULL, dt_imageio_close_standalone(), DT_IMAGEIO_LOAD_FAILED, DT_IMAGEIO_OK, dt_imageio_open(), DT_MIPMAP_FULL, IS_NULL_PTR, and dt_mipmap_buffer_t::size.
Referenced by _import_get_thumbnail().