Blender V5.3
BKE_image.hh
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2001-2002 NaN Holding BV. All rights reserved.
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later */
4#pragma once
5
9
10#include "DNA_listBase.h"
11
12#include "BLI_compiler_attrs.hh"
13#include "BLI_function_ref.hh"
14#include "BLI_mutex.hh"
15#include "BLI_string_ref.hh"
16
17#include "IMB_imbuf_enums.h"
18
19#include <cstdint>
20#include <limits>
21#include <optional>
22
23namespace blender {
24namespace gpu {
25class Texture;
26} // namespace gpu
27
28namespace ocio {
29class ColorSpace;
30} // namespace ocio
32
33struct rcti;
35struct Depsgraph;
36struct ID;
37struct ImBuf;
38struct ImBufCache;
39struct MovieReader;
40struct Image;
41struct ImageFormatData;
42struct ImagePool;
43struct ImageTile;
44struct ImbFormatOptions;
45struct Library;
46struct Main;
47struct Object;
48struct RenderResult;
49struct RenderSlot;
50struct ReportList;
51struct Scene;
52struct StampData;
53enum eImbFileType : int8_t;
54
55#define IMA_MAX_SPACE 64
56#define IMA_UDIM_MAX 2000
57
58namespace bke {
59
61 /* Mutex used to guarantee thread-safe access to the cached ImBuf of the corresponding image ID.
62 */
64
65 ImBufCache *cache = nullptr;
66
67 /* The image's current update count. See deg::set_id_update_count for more information. */
69
70 /* Log GPU load errors once per image. */
72
73 float view_offset[2] = {};
74 float view_zoom = 1.0f;
75};
76
77} // namespace bke
84
92void BKE_image_free_buffers_ex(Image *image, bool do_lock);
98
99typedef void(StampCallback)(void *data,
100 const char *propname,
101 char *propvalue,
102 int propvalue_maxncpy);
103
105 Object *camera,
106 RenderResult *rr,
107 bool allocate_only);
116bool BKE_stamp_is_known_field(const char *field_name);
117void BKE_imbuf_stamp_info(const RenderResult *rr, ImBuf *ibuf);
120 StampData *stamp_data,
121 StampCallback callback,
122 bool noskip);
124 const Image &image,
125 StampCallback callback,
126 bool noskip);
127void BKE_render_result_stamp_data(RenderResult *rr, const char *key, const char *value);
128StampData *BKE_stamp_data_copy(const StampData *stamp_data);
129void BKE_stamp_data_free(StampData *stamp_data);
130void BKE_image_stamp_buf(Scene *scene,
131 Object *camera,
132 const StampData *stamp_data_template,
133 ImBuf *ibuf);
134bool BKE_imbuf_alpha_test(ImBuf *ibuf);
135bool BKE_imbuf_write_stamp(const Scene *scene,
136 const RenderResult *rr,
137 ImBuf *ibuf,
138 const char *filepath,
139 const ImageFormatData *imf);
143bool BKE_imbuf_write(ImBuf *ibuf, const char *filepath, const ImageFormatData *imf);
148bool BKE_imbuf_write_as(ImBuf *ibuf,
149 const char *filepath,
150 const ImageFormatData *imf,
151 bool save_copy);
152
156MovieReader *openanim(const char *filepath,
157 ImBufFlags ibuf_flags,
158 int streamindex,
159 bool keep_original_colorspace,
160 ColorManagedColorspaceSettings *colorspace_settings);
161MovieReader *openanim_noload(const char *filepath,
162 ImBufFlags flags,
163 int streamindex,
164 bool keep_original_colorspace,
165 ColorManagedColorspaceSettings *colorspace_settings);
166
167/* ********************************** NEW IMAGE API *********************** */
168
169/* ImageUser is in Texture, in Nodes, Background Image, Image Window, .... */
170/* should be used in conjunction with an ID * to Image. */
171struct ImageUser;
172struct RenderData;
173struct RenderPass;
174struct RenderResult;
175
176/* signals */
177/* reload only frees, doesn't read until image_get_ibuf() called */
178#define IMA_SIGNAL_RELOAD 0
179#define IMA_SIGNAL_FREE 1
180/* source changes, from image to sequence or movie, etc */
181#define IMA_SIGNAL_SRC_CHANGE 5
182/* image-user gets a new image, check settings */
183#define IMA_SIGNAL_USER_NEW_IMAGE 6
184#define IMA_SIGNAL_COLORMANAGE 7
185
189bool BKE_image_has_ibuf(Image *ima, ImageUser *iuser);
190
198ImBuf *BKE_image_acquire_ibuf(Image *ima, ImageUser *iuser, void **r_lock);
199
211 ImageUser *iuser,
212 void **r_lock,
213 bool *r_load_failed = nullptr,
214 bool cached_only = false);
215
228ImBuf *BKE_image_acquire_multilayer_view_ibuf(const RenderData &render_data,
229 Image &image,
230 const ImageUser &image_user,
231 const char *pass_name,
232 const char *view_name);
233
234void BKE_image_release_ibuf(Image *ima, ImBuf *ibuf, void *lock);
235
240ImBuf *BKE_image_preview(Image *ima, short max_size, short *r_width, short *r_height);
241
242ImagePool *BKE_image_pool_new();
243void BKE_image_pool_free(ImagePool *pool);
244ImBuf *BKE_image_pool_acquire_ibuf(Image *ima, ImageUser *iuser, ImagePool *pool);
245void BKE_image_pool_release_ibuf(Image *ima, ImBuf *ibuf, ImagePool *pool);
246
250char BKE_image_alpha_mode_from_extension_ex(const char *filepath);
252
263Image *BKE_image_load(Main *bmain, const char *filepath, bool check_open = true);
264Image *BKE_image_load_in_lib(Main *bmain,
265 std::optional<Library *> owner_library,
266 const char *filepath,
267 bool check_open = true);
283Image *BKE_image_load_exists(Main *bmain,
284 const char *filepath,
285 bool check_open = true,
286 bool *r_exists = nullptr);
288 std::optional<Library *> owner_library,
289 const char *filepath,
290 bool check_open = true,
291 bool *r_exists = nullptr);
292
296Image *BKE_image_add_generated(Main *bmain,
297 unsigned int width,
298 unsigned int height,
299 const char *name,
300 int depth,
301 int floatbuf,
302 short gen_type,
303 const float color[4],
304 bool stereo3d,
305 bool is_data,
306 bool tiled);
311Image *BKE_image_add_from_imbuf(Main *bmain, ImBuf *ibuf, const char *name);
312
319void BKE_image_replace_imbuf(Image *image, ImBuf *ibuf);
320
324void BKE_imageuser_default(ImageUser *iuser);
325void BKE_image_init_imageuser(Image *ima, ImageUser *iuser);
326void BKE_image_signal(Main *bmain, Image *ima, ImageUser *iuser, int signal);
327
329 const Main *mainp,
330 void *customdata,
331 void callback(Image *ima, ID *iuser_id, ImageUser *iuser, void *customdata));
332
339Image *BKE_image_ensure_viewer(Main *bmain, int type, const char *name);
344void BKE_image_ensure_viewer_views(const RenderData *rd, Image *ima, ImageUser *iuser);
345
349void BKE_image_user_frame_calc(Image *ima, ImageUser *iuser, int cfra);
350int BKE_image_user_frame_get(const ImageUser *iuser, int cfra, bool *r_is_in_range);
354bool BKE_image_user_match(const ImageUser &a, const ImageUser &b);
355void BKE_image_user_file_path(const ImageUser *iuser, const Image *ima, char *filepath);
356void BKE_image_user_file_path_ex(const Main *bmain,
357 const ImageUser *iuser,
358 const Image *ima,
359 char *filepath,
360 const bool resolve_udim,
361 const bool resolve_multiview);
362void BKE_image_editors_update_frame(const Main *bmain, int cfra);
363
368void BKE_image_user_id_eval_animation(Depsgraph *depsgraph, ID *id);
369
374RenderPass *BKE_image_multilayer_index(RenderResult *rr, ImageUser *iuser);
375
379void BKE_image_multiview_index(const Image *ima, ImageUser *iuser);
380
385bool BKE_image_is_multilayer(const Image *ima);
386bool BKE_image_is_multiview(const Image *ima);
387bool BKE_image_is_stereo(const Image *ima);
388
400RenderResult *BKE_image_acquire_renderresult(Scene *scene, Image *ima);
401void BKE_image_release_renderresult(Scene *scene, Image *ima, RenderResult *render_result);
402
406bool BKE_image_is_openexr(Image *ima);
407
411void BKE_image_backup_render(Scene *scene, Image *ima, bool free_current_slot);
412
416void BKE_image_free_all_textures(Main *bmain);
417
422void BKE_image_all_free_anim_ibufs(Main *bmain, int except_frame);
423
427void BKE_image_free_old_buffers(Main *bmain);
428
432bool BKE_image_memorypack(Image *ima);
433void BKE_image_packfiles(ReportList *reports, Image *ima, const char *basepath);
434void BKE_image_packfiles_from_mem(ReportList *reports, Image *ima, char *data, size_t data_len);
435
443 Main *bmain, Image *image, ReportList *reports, const char *data, int data_len);
444
449
456
460void BKE_image_print_memlist(Main *bmain);
461
465void BKE_image_merge(Main *bmain, Image *dest, Image *source);
466
470bool BKE_image_scale(Image *image, int width, int height, ImageUser *iuser);
471
476
481int BKE_image_get_tile_label(const Image *ima,
482 const ImageTile *tile,
483 char *label,
484 int label_maxncpy);
485
493bool BKE_image_get_tile_info(char *filepath,
494 ListBaseT<LinkData> *tiles,
495 int *r_tile_start,
496 int *r_tile_range);
497
498ImageTile *BKE_image_add_tile(Image *ima, int tile_number, const char *label);
499bool BKE_image_remove_tile(Image *ima, ImageTile *tile);
500void BKE_image_reassign_tile(Image *ima, ImageTile *tile, int new_tile_number);
501void BKE_image_sort_tiles(Image *ima);
502
503bool BKE_image_fill_tile(Image *ima, ImageTile *tile);
504
510
514bool BKE_image_is_filename_tokenized(char *filepath);
515
520void BKE_image_ensure_tile_token(char *filepath, size_t filepath_maxncpy);
521void BKE_image_ensure_tile_token_filename_only(char *filename, size_t filename_maxncpy);
522
529bool BKE_image_tile_filepath_exists(const char *filepath);
530
536char *BKE_image_get_tile_strformat(const char *filepath, eUDIM_TILE_FORMAT *r_tile_format);
537bool BKE_image_get_tile_number_from_filepath(const char *filepath,
538 const char *pattern,
539 eUDIM_TILE_FORMAT tile_format,
540 int *r_tile_number);
542 const char *pattern,
543 eUDIM_TILE_FORMAT tile_format,
544 int tile_number);
545
546ImageTile *BKE_image_get_tile(Image *ima, int tile_number);
547ImageTile *BKE_image_get_tile_from_iuser(Image *ima, const ImageUser *iuser);
548
549int BKE_image_get_tile_from_pos(Image *ima, const float uv[2], float r_uv[2], float r_ofs[2]);
550void BKE_image_get_tile_uv(const Image *ima, const int tile_number, float r_uv[2]);
551
556 const float co[2],
557 float r_uv_offset[2]) ATTR_NONNULL(2, 3);
558int BKE_image_find_nearest_tile(const Image *image, const float co[2])
560
566 const char *source_filepath_abs,
567 const char *cache_dir,
568 blender::FunctionRef<void(blender::StringRef cache_filepath)> callback);
569
570void BKE_image_get_size(Image *image, ImageUser *iuser, int *r_width, int *r_height);
571void BKE_image_get_size_fl(Image *image, ImageUser *iuser, float r_size[2]);
572void BKE_image_get_aspect(Image *image, float *r_aspx, float *r_aspy);
573
574/* `image_gen.cc` */
575
577 unsigned char *rect, float *rect_float, int width, int height, const float color[4]);
578void BKE_image_buf_fill_checker(unsigned char *rect, float *rect_float, int width, int height);
579void BKE_image_buf_fill_checker_color(unsigned char *rect,
580 float *rect_float,
581 int width,
582 int height);
583
584/* Cycles hookup */
585
586unsigned char *BKE_image_get_pixels_for_frame(Image *image, int frame, int tile);
588
589/* Image modifications */
590
593
594bool BKE_image_is_dirty_writable(Image *image, bool *r_is_writable);
595
602bool BKE_image_has_filepath(const Image *ima);
606bool BKE_image_source_is_file(const Image *ima);
621ImBuf *BKE_image_get_ibuf_with_name(Image *image, const char *filepath);
632
633RenderSlot *BKE_image_add_renderslot(Image *ima, const char *name);
634bool BKE_image_remove_renderslot(Image *ima, ImageUser *iuser, int slot);
636bool BKE_image_clear_renderslot(Image *ima, ImageUser *iuser, int slot);
637
638} // namespace blender
#define ATTR_WARN_UNUSED_RESULT
#define ATTR_NONNULL(...)
These structs are the foundation for all linked lists in the library system.
volatile int lock
Definition scene.h:133
CCL_NAMESPACE_BEGIN struct Options options
#define image(slot, qualifiers, format)
void camera(KernelGlobals &kg, const ShadingData &sd, float3 &outview, float &outdepth, float &outdist)
ccl_gpu_kernel_postfix ccl_global KernelWorkTile * tiles
const ccl_global KernelWorkTile * tile
std::string filename(const std::string_view &str, size_t pos)
BMesh Iterators.
bool BKE_image_is_multiview(const Image *ima)
char * BKE_image_get_tile_strformat(const char *filepath, eUDIM_TILE_FORMAT *r_tile_format)
int BKE_image_get_tile_from_pos(Image *ima, const float uv[2], float r_uv[2], float r_ofs[2])
void BKE_image_user_frame_calc(Image *ima, ImageUser *iuser, int cfra)
void BKE_image_buf_fill_color(unsigned char *rect, float *rect_float, int width, int height, const float color[4])
Definition image_gen.cc:28
RenderResult * BKE_image_acquire_renderresult(Scene *scene, Image *ima)
unsigned __int64 uint64_t
Definition BKE_text.h:91
bool BKE_image_is_animated(Image *image)
bool BKE_stamp_is_known_field(const char *field_name)
void BKE_image_multiview_index(const Image *ima, ImageUser *iuser)
bool BKE_image_scale(Image *image, int width, int height, ImageUser *iuser)
void BKE_image_texture_cache_filepaths_foreach(const char *source_filepath_abs, const char *cache_dir, blender::FunctionRef< void(blender::StringRef cache_filepath)> callback)
bool BKE_image_clear_renderslot(Image *ima, ImageUser *iuser, int slot)
void StampCallback(void *data, const char *propname, char *propvalue, int propvalue_maxncpy)
Definition BKE_image.hh:99
ImBuf * BKE_image_get_first_ibuf(Image *image)
void BKE_image_release_renderresult(Scene *scene, Image *ima, RenderResult *render_result)
void BKE_image_signal(Main *bmain, Image *ima, ImageUser *iuser, int signal)
void BKE_image_packfiles_from_mem(ReportList *reports, Image *ima, char *data, size_t data_len)
void BKE_image_get_size(Image *image, ImageUser *iuser, int *r_width, int *r_height)
bool BKE_image_has_loaded_ibuf(Image *image)
void BKE_render_result_stamp_info(Scene *scene, Object *camera, RenderResult *rr, bool allocate_only)
void BKE_render_result_stamp_data(RenderResult *rr, const char *key, const char *value)
bool BKE_image_has_filepath(const Image *ima)
StampData * BKE_stamp_data_copy(const StampData *stamp_data)
bool BKE_image_fill_tile(Image *ima, ImageTile *tile)
void BKE_image_walk_all_users(const Main *mainp, void *customdata, void callback(Image *ima, ID *iuser_id, ImageUser *iuser, void *customdata))
ImageTile * BKE_image_get_tile(Image *ima, int tile_number)
ImBuf * BKE_image_get_ibuf_with_name(Image *image, const char *filepath)
bool BKE_imbuf_write_stamp(const Scene *scene, const RenderResult *rr, ImBuf *ibuf, const char *filepath, const ImageFormatData *imf)
void BKE_image_user_id_eval_animation(Depsgraph *depsgraph, ID *id)
void BKE_image_stamp_buf(Scene *scene, Object *camera, const StampData *stamp_data_template, ImBuf *ibuf)
void BKE_image_all_free_anim_ibufs(Main *bmain, int except_frame)
bool BKE_image_tile_filepath_exists(const char *filepath)
void BKE_image_user_file_path(const ImageUser *iuser, const Image *ima, char *filepath)
void BKE_image_get_aspect(Image *image, float *r_aspx, float *r_aspy)
ImageTile * BKE_image_add_tile(Image *ima, int tile_number, const char *label)
void BKE_image_replace_imbuf(Image *image, ImBuf *ibuf)
Image * BKE_image_load_in_lib(Main *bmain, std::optional< Library * > owner_library, const char *filepath, bool check_open=true)
int int BKE_image_find_nearest_tile(const Image *image, const float co[2]) ATTR_NONNULL(2) ATTR_WARN_UNUSED_RESULT
ImageTile * BKE_image_get_tile_from_iuser(Image *ima, const ImageUser *iuser)
bool BKE_image_is_dirty_writable(Image *image, bool *r_is_writable)
void BKE_stamp_data_free(StampData *stamp_data)
RenderSlot * BKE_image_add_renderslot(Image *ima, const char *name)
int BKE_image_find_nearest_tile_with_offset(const Image *image, const float co[2], float r_uv_offset[2]) ATTR_NONNULL(2
ImBuf * BKE_image_acquire_ibuf_gpu(Image *ima, ImageUser *iuser, void **r_lock, bool *r_load_failed=nullptr, bool cached_only=false)
void BKE_image_set_filepath_from_tile_number(char *filepath, const char *pattern, eUDIM_TILE_FORMAT tile_format, int tile_number)
void BKE_image_editors_update_frame(const Main *bmain, int cfra)
bool BKE_image_remove_tile(Image *ima, ImageTile *tile)
unsigned char * BKE_image_get_pixels_for_frame(Image *image, int frame, int tile)
Image * BKE_image_load_exists(Main *bmain, const char *filepath, bool check_open=true, bool *r_exists=nullptr)
bool BKE_image_is_stereo(const Image *ima)
RenderPass * BKE_image_multilayer_index(RenderResult *rr, ImageUser *iuser)
ImBuf * BKE_image_acquire_multilayer_view_ibuf(const RenderData &render_data, Image &image, const ImageUser &image_user, const char *pass_name, const char *view_name)
BMesh const char void * data
void BKE_image_free_packedfiles(Image *image)
bool BKE_image_user_match(const ImageUser &a, const ImageUser &b)
void BKE_image_merge(Main *bmain, Image *dest, Image *source)
void BKE_image_packfiles(ReportList *reports, Image *ima, const char *basepath)
void BKE_image_free_buffers_ex(Image *image, bool do_lock)
RenderSlot * BKE_image_get_renderslot(Image *ima, int index)
char BKE_image_alpha_mode_from_extension_ex(const char *filepath)
MovieReader * openanim(const char *filepath, ImBufFlags ibuf_flags, int streamindex, bool keep_original_colorspace, ColorManagedColorspaceSettings *colorspace_settings)
void BKE_image_free_data(Image *image)
Image * BKE_image_add_from_imbuf(Main *bmain, ImBuf *ibuf, const char *name)
void BKE_image_free_views(Image *image)
void BKE_image_free_old_buffers(Main *bmain)
void BKE_image_pool_free(ImagePool *pool)
void BKE_image_ensure_tile_token_filename_only(char *filename, size_t filename_maxncpy)
void BKE_image_ensure_tile_token(char *filepath, size_t filepath_maxncpy)
void BKE_image_free_all_textures(Main *bmain)
void BKE_image_buf_fill_checker(unsigned char *rect, float *rect_float, int width, int height)
Definition image_gen.cc:152
Image * BKE_image_load_exists_in_lib(Main *bmain, std::optional< Library * > owner_library, const char *filepath, bool check_open=true, bool *r_exists=nullptr)
void BKE_imbuf_stamp_info(const RenderResult *rr, ImBuf *ibuf)
void BKE_image_init_imageuser(Image *ima, ImageUser *iuser)
void BKE_image_backup_render(Scene *scene, Image *ima, bool free_current_slot)
bool BKE_image_autosave_memorypack(Image *ima)
bool BKE_image_get_tile_info(char *filepath, ListBaseT< LinkData > *tiles, int *r_tile_start, int *r_tile_range)
ImBuf * BKE_image_acquire_ibuf(Image *ima, ImageUser *iuser, void **r_lock)
void BKE_image_packfile_ensure(Main *bmain, Image *image, ReportList *reports, const char *data, int data_len)
float * BKE_image_get_float_pixels_for_frame(Image *image, int frame, int tile)
void BKE_stamp_info_callback(void *data, StampData *stamp_data, StampCallback callback, bool noskip)
std::mutex Mutex
Definition BLI_mutex.hh:51
void BKE_image_ensure_viewer_views(const RenderData *rd, Image *ima, ImageUser *iuser)
Image * BKE_image_ensure_viewer(Main *bmain, int type, const char *name)
int BKE_image_get_tile_label(const Image *ima, const ImageTile *tile, char *label, int label_maxncpy)
StampData * BKE_stamp_info_from_scene_static(const Scene *scene)
bool BKE_image_has_ibuf(Image *ima, ImageUser *iuser)
bool BKE_image_is_filename_tokenized(char *filepath)
void BKE_image_alpha_mode_from_extension(Image *image)
void BKE_image_populate_cache_from_autosave(Image *ima)
bool BKE_image_source_is_file(const Image *ima)
bool BKE_image_has_multiple_ibufs(Image *image)
void BKE_image_print_memlist(Main *bmain)
void BKE_image_clear_autosave(Image *image)
int BKE_image_sequence_guess_offset(Image *image)
void BKE_image_reassign_tile(Image *ima, ImageTile *tile, int new_tile_number)
bool BKE_image_has_packedfile(const Image *image)
void BKE_image_get_size_fl(Image *image, ImageUser *iuser, float r_size[2])
void BKE_image_free_buffers(Image *image)
ImBuf * BKE_image_pool_acquire_ibuf(Image *ima, ImageUser *iuser, ImagePool *pool)
Image * BKE_image_add_generated(Main *bmain, unsigned int width, unsigned int height, const char *name, int depth, int floatbuf, short gen_type, const float color[4], bool stereo3d, bool is_data, bool tiled)
void BKE_image_file_format_set(Image *image, eImbFileType ftype, const ImbFormatOptions *options)
void BKE_imageuser_default(ImageUser *iuser)
int BKE_image_user_frame_get(const ImageUser *iuser, int cfra, bool *r_is_in_range)
void BKE_image_multilayer_stamp_info_callback(void *data, const Image &image, StampCallback callback, bool noskip)
void BKE_image_buf_fill_checker_color(unsigned char *rect, float *rect_float, int width, int height)
Definition image_gen.cc:372
bool BKE_image_remove_renderslot(Image *ima, ImageUser *iuser, int slot)
eUDIM_TILE_FORMAT
Definition BKE_image.hh:505
@ UDIM_TILE_FORMAT_UVTILE
Definition BKE_image.hh:508
@ UDIM_TILE_FORMAT_NONE
Definition BKE_image.hh:506
@ UDIM_TILE_FORMAT_UDIM
Definition BKE_image.hh:507
bool BKE_imbuf_write(ImBuf *ibuf, const char *filepath, const ImageFormatData *imf)
bool BKE_image_get_tile_number_from_filepath(const char *filepath, const char *pattern, eUDIM_TILE_FORMAT tile_format, int *r_tile_number)
ImBuf * BKE_image_preview(Image *ima, short max_size, short *r_width, short *r_height)
bool BKE_image_is_multilayer(const Image *ima)
signed char int8_t
Definition BKE_text.h:76
void BKE_image_pool_release_ibuf(Image *ima, ImBuf *ibuf, ImagePool *pool)
MovieReader * openanim_noload(const char *filepath, ImBufFlags flags, int streamindex, bool keep_original_colorspace, ColorManagedColorspaceSettings *colorspace_settings)
ocio::ColorSpace ColorSpace
Definition BLF_api.hh:42
bool BKE_imbuf_write_as(ImBuf *ibuf, const char *filepath, const ImageFormatData *imf, bool save_copy)
void BKE_stamp_info_from_imbuf(RenderResult *rr, ImBuf *ibuf)
Image * BKE_image_load(Main *bmain, const char *filepath, bool check_open=true)
bool BKE_image_buffer_format_writable(ImBuf *ibuf)
void BKE_image_get_tile_uv(const Image *ima, const int tile_number, float r_uv[2])
void BKE_image_user_file_path_ex(const Main *bmain, const ImageUser *iuser, const Image *ima, char *filepath, const bool resolve_udim, const bool resolve_multiview)
void BKE_image_release_ibuf(Image *ima, ImBuf *ibuf, void *lock)