#include "BLI_compiler_attrs.h"
#include "BLI_mutex.hh"
#include <cstdint>
#include <optional>

Classes
struct	blender::bke::ImageRuntime
struct	ImageGPUTextures

Namespaces
namespace	blender
namespace	blender::bke

Macros
#define	IMA_MAX_SPACE 64
#define	IMA_UDIM_MAX 2000
#define	IMA_SIGNAL_RELOAD 0
#define	IMA_SIGNAL_FREE 1
#define	IMA_SIGNAL_SRC_CHANGE 5
#define	IMA_SIGNAL_USER_NEW_IMAGE 6
#define	IMA_SIGNAL_COLORMANAGE 7

Typedefs
typedef void	StampCallback(void data, const char propname, char *propvalue, int propvalue_maxncpy)

Enumerations
enum	eUDIM_TILE_FORMAT { UDIM_TILE_FORMAT_NONE = 0 , UDIM_TILE_FORMAT_UDIM = 1 , UDIM_TILE_FORMAT_UVTILE = 2 }

Functions
void	BKE_image_free_packedfiles (Image *image)
void	BKE_image_free_views (Image *image)
void	BKE_image_free_buffers (Image *image)
void	BKE_image_free_buffers_ex (Image *image, bool do_lock)
void	BKE_image_free_gputextures (Image *ima)
void	BKE_image_free_data (Image *image)
void	BKE_render_result_stamp_info (Scene scene, Object camera, RenderResult *rr, bool allocate_only)
StampData *	BKE_stamp_info_from_scene_static (const Scene *scene)
bool	BKE_stamp_is_known_field (const char *field_name)
void	BKE_imbuf_stamp_info (const RenderResult rr, ImBuf ibuf)
void	BKE_stamp_info_from_imbuf (RenderResult rr, ImBuf ibuf)
void	BKE_stamp_info_callback (void data, StampData stamp_data, StampCallback callback, bool noskip)
void	BKE_image_multilayer_stamp_info_callback (void *data, const Image &image, StampCallback callback, bool noskip)
void	BKE_render_result_stamp_data (RenderResult rr, const char key, const char *value)
StampData *	BKE_stamp_data_copy (const StampData *stamp_data)
void	BKE_stamp_data_free (StampData *stamp_data)
void	BKE_image_stamp_buf (Scene scene, Object camera, const StampData stamp_data_template, unsigned char rect, float *rectf, int width, int height)
bool	BKE_imbuf_alpha_test (ImBuf *ibuf)
bool	BKE_imbuf_write_stamp (const Scene scene, const RenderResult rr, ImBuf ibuf, const char filepath, const ImageFormatData *imf)
bool	BKE_imbuf_write (ImBuf ibuf, const char filepath, const ImageFormatData *imf)
bool	BKE_imbuf_write_as (ImBuf ibuf, const char filepath, const ImageFormatData *imf, bool save_copy)
MovieReader *	openanim (const char *filepath, int flags, int streamindex, char colorspace[IMA_MAX_SPACE])
MovieReader *	openanim_noload (const char *filepath, int flags, int streamindex, char colorspace[IMA_MAX_SPACE])
void	BKE_image_tag_time (Image *ima)
bool	BKE_image_has_ibuf (Image ima, ImageUser iuser)
ImBuf *	BKE_image_acquire_ibuf (Image ima, ImageUser iuser, void **r_lock)
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)
void	BKE_image_release_ibuf (Image ima, ImBuf ibuf, void *lock)
ImBuf *	BKE_image_preview (Image ima, short max_size, short r_width, short *r_height)
ImagePool *	BKE_image_pool_new ()
void	BKE_image_pool_free (ImagePool *pool)
ImBuf *	BKE_image_pool_acquire_ibuf (Image ima, ImageUser iuser, ImagePool *pool)
void	BKE_image_pool_release_ibuf (Image ima, ImBuf ibuf, ImagePool *pool)
char	BKE_image_alpha_mode_from_extension_ex (const char *filepath)
void	BKE_image_alpha_mode_from_extension (Image *image)
Image *	BKE_image_load (Main bmain, const char filepath)
Image *	BKE_image_load_in_lib (Main bmain, std::optional< Library > owner_library, const char *filepath)
Image *	BKE_image_load_exists (Main bmain, const char filepath, bool *r_exists=nullptr)
Image *	BKE_image_load_exists_in_lib (Main bmain, std::optional< Library > owner_library, const char filepath, bool r_exists=nullptr)
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)
Image *	BKE_image_add_from_imbuf (Main bmain, ImBuf ibuf, const char *name)
void	BKE_image_replace_imbuf (Image image, ImBuf ibuf)
void	BKE_imageuser_default (ImageUser *iuser)
void	BKE_image_init_imageuser (Image ima, ImageUser iuser)
void	BKE_image_signal (Main bmain, Image ima, ImageUser *iuser, int signal)
void	BKE_image_walk_all_users (const Main mainp, void customdata, void callback(Image ima, ID iuser_id, ImageUser iuser, void customdata))
Image *	BKE_image_ensure_viewer (Main bmain, int type, const char name)
void	BKE_image_ensure_viewer_views (const RenderData rd, Image ima, ImageUser *iuser)
void	BKE_image_user_frame_calc (Image ima, ImageUser iuser, int cfra)
int	BKE_image_user_frame_get (const ImageUser iuser, int cfra, bool r_is_in_range)
void	BKE_image_user_file_path (const ImageUser iuser, const Image ima, char *filepath)
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_editors_update_frame (const Main *bmain, int cfra)
bool	BKE_image_user_id_has_animation (ID *id)
void	BKE_image_user_id_eval_animation (Depsgraph depsgraph, ID id)
RenderPass *	BKE_image_multilayer_index (RenderResult rr, ImageUser iuser)
void	BKE_image_multiview_index (const Image ima, ImageUser iuser)
bool	BKE_image_is_multilayer (const Image *ima)
bool	BKE_image_is_multiview (const Image *ima)
bool	BKE_image_is_stereo (const Image *ima)
RenderResult *	BKE_image_acquire_renderresult (Scene scene, Image ima)
void	BKE_image_release_renderresult (Scene scene, Image ima, RenderResult *render_result)
bool	BKE_image_is_openexr (Image *ima)
void	BKE_image_backup_render (Scene scene, Image ima, bool free_current_slot)
void	BKE_image_free_all_textures (Main *bmain)
void	BKE_image_free_anim_ibufs (Image *ima, int except_frame)
void	BKE_image_all_free_anim_ibufs (Main *bmain, int cfra)
void	BKE_image_free_all_gputextures (Main *bmain)
void	BKE_image_free_anim_gputextures (Main *bmain)
void	BKE_image_free_old_gputextures (Main *bmain)
bool	BKE_image_memorypack (Image *ima)
void	BKE_image_packfiles (ReportList reports, Image ima, const char *basepath)
void	BKE_image_packfiles_from_mem (ReportList reports, Image ima, char *data, size_t data_len)
void	BKE_image_print_memlist (Main *bmain)
void	BKE_image_merge (Main bmain, Image dest, Image *source)
bool	BKE_image_scale (Image image, int width, int height, ImageUser iuser)
bool	BKE_image_has_alpha (Image *image)
bool	BKE_image_has_opengl_texture (Image *ima)
int	BKE_image_get_tile_label (const Image ima, const ImageTile tile, char *label, int label_maxncpy)
bool	BKE_image_get_tile_info (char filepath, ListBase tiles, int r_tile_start, int r_tile_range)
ImageTile *	BKE_image_add_tile (Image ima, int tile_number, const char label)
bool	BKE_image_remove_tile (Image ima, ImageTile tile)
void	BKE_image_reassign_tile (Image ima, ImageTile tile, int new_tile_number)
void	BKE_image_sort_tiles (Image *ima)
bool	BKE_image_fill_tile (Image ima, ImageTile tile)
bool	BKE_image_is_filename_tokenized (char *filepath)
void	BKE_image_ensure_tile_token (char *filepath, size_t filepath_maxncpy)
void	BKE_image_ensure_tile_token_filename_only (char *filename, size_t filename_maxncpy)
bool	BKE_image_tile_filepath_exists (const char *filepath)
char *	BKE_image_get_tile_strformat (const char filepath, eUDIM_TILE_FORMAT r_tile_format)
bool	BKE_image_get_tile_number_from_filepath (const char filepath, const char pattern, eUDIM_TILE_FORMAT tile_format, int *r_tile_number)
void	BKE_image_set_filepath_from_tile_number (char filepath, const char pattern, eUDIM_TILE_FORMAT tile_format, int tile_number)
ImageTile *	BKE_image_get_tile (Image *ima, int tile_number)
ImageTile *	BKE_image_get_tile_from_iuser (Image ima, const ImageUser iuser)
int	BKE_image_get_tile_from_pos (Image *ima, const float uv[2], float r_uv[2], float r_ofs[2])
void	BKE_image_get_tile_uv (const Image *ima, const int tile_number, float r_uv[2])
int	BKE_image_find_nearest_tile_with_offset (const Image *image, const float co[2], float r_uv_offset[2]) ATTR_NONNULL(2
int int	BKE_image_find_nearest_tile (const Image *image, const float co[2]) ATTR_NONNULL(2) ATTR_WARN_UNUSED_RESULT
void	BKE_image_get_size (Image image, ImageUser iuser, int r_width, int r_height)
void	BKE_image_get_size_fl (Image image, ImageUser iuser, float r_size[2])
void	BKE_image_get_aspect (Image image, float r_aspx, float *r_aspy)
void	BKE_image_buf_fill_color (unsigned char rect, float rect_float, int width, int height, const float color[4])
void	BKE_image_buf_fill_checker (unsigned char rect, float rect_float, int width, int height)
void	BKE_image_buf_fill_checker_color (unsigned char rect, float rect_float, int width, int height)
unsigned char *	BKE_image_get_pixels_for_frame (Image *image, int frame, int tile)
float *	BKE_image_get_float_pixels_for_frame (Image *image, int frame, int tile)
bool	BKE_image_is_dirty (Image *image)
void	BKE_image_mark_dirty (Image image, ImBuf ibuf)
bool	BKE_image_buffer_format_writable (ImBuf *ibuf)
bool	BKE_image_is_dirty_writable (Image image, bool r_is_writable)
int	BKE_image_sequence_guess_offset (Image *image)
bool	BKE_image_has_anim (Image *image)
bool	BKE_image_has_packedfile (const Image *image)
bool	BKE_image_has_filepath (const Image *ima)
bool	BKE_image_is_animated (Image *image)
bool	BKE_image_has_multiple_ibufs (Image *image)
void	BKE_image_file_format_set (Image image, int ftype, const ImbFormatOptions options)
bool	BKE_image_has_loaded_ibuf (Image *image)
ImBuf *	BKE_image_get_ibuf_with_name (Image image, const char filepath)
ImBuf *	BKE_image_get_first_ibuf (Image *image)
GPUTexture *	BKE_image_create_gpu_texture_from_ibuf (Image image, ImBuf ibuf)
void	BKE_image_ensure_gpu_texture (Image image, ImageUser iuser)
GPUTexture *	BKE_image_get_gpu_texture (Image image, ImageUser iuser)
GPUTexture *	BKE_image_get_gpu_viewer_texture (Image image, ImageUser iuser)
ImageGPUTextures	BKE_image_get_gpu_material_texture (Image image, ImageUser iuser, const bool use_tile_mapping)
ImageGPUTextures	BKE_image_get_gpu_material_texture_try (Image image, ImageUser iuser, const bool use_tile_mapping)
bool	BKE_image_has_gpu_texture_premultiplied_alpha (Image image, ImBuf ibuf)
void	BKE_image_update_gputexture (Image ima, ImageUser iuser, int x, int y, int w, int h)
void	BKE_image_update_gputexture_delayed (Image ima, ImageTile image_tile, ImBuf *ibuf, int x, int y, int w, int h)
void	BKE_image_paint_set_mipmap (Main *bmain, bool mipmap)
void	BKE_image_free_unused_gpu_textures ()
RenderSlot *	BKE_image_add_renderslot (Image ima, const char name)
bool	BKE_image_remove_renderslot (Image ima, ImageUser iuser, int slot)
RenderSlot *	BKE_image_get_renderslot (Image *ima, int index)
bool	BKE_image_clear_renderslot (Image ima, ImageUser iuser, int slot)
PartialUpdateUser *	BKE_image_partial_update_create (const Image *image)
	Create a new PartialUpdateUser. An Object that contains data to use partial updates.
void	BKE_image_partial_update_free (PartialUpdateUser *user)
	free a partial update user.
void	BKE_image_partial_update_register_free (Image *image)
void	BKE_image_partial_update_mark_region (Image image, const ImageTile image_tile, const ImBuf image_buffer, const rcti updated_region)
	Mark a region of the image to update.
void	BKE_image_partial_update_mark_full_update (Image *image)
	Mark the whole image to be updated.

Macro Definition Documentation

◆ IMA_MAX_SPACE

#define IMA_MAX_SPACE 64

Definition at line 39 of file BKE_image.hh.

Referenced by openanim(), and openanim_noload().

◆ IMA_SIGNAL_COLORMANAGE

#define IMA_SIGNAL_COLORMANAGE 7

Definition at line 167 of file BKE_image.hh.

Referenced by BKE_image_save(), and BKE_image_signal().

◆ IMA_SIGNAL_FREE

#define IMA_SIGNAL_FREE 1

Definition at line 162 of file BKE_image.hh.

Referenced by BKE_image_signal(), blender::render::Context::output_to_render_result(), screen_opengl_render_init(), screen_render_exec(), and screen_render_invoke().

◆ IMA_SIGNAL_RELOAD

#define IMA_SIGNAL_RELOAD 0

Definition at line 161 of file BKE_image.hh.

Referenced by BKE_image_signal(), BKE_packedfile_unpack_image(), image_foreach_path(), image_open_exec(), image_reload_exec(), image_replace_exec(), and blender::ed::space_node::node_add_image_exec().

◆ IMA_SIGNAL_SRC_CHANGE

#define IMA_SIGNAL_SRC_CHANGE 5

Definition at line 164 of file BKE_image.hh.

Referenced by BKE_image_signal(), and image_replace_exec().

◆ IMA_SIGNAL_USER_NEW_IMAGE

#define IMA_SIGNAL_USER_NEW_IMAGE 6

Definition at line 166 of file BKE_image.hh.

Referenced by BKE_image_signal(), ED_space_image_auto_set(), ED_space_image_set(), image_clipboard_paste_exec(), image_new_exec(), and proj_paint_add_slot().

◆ IMA_UDIM_MAX

#define IMA_UDIM_MAX 2000

Definition at line 40 of file BKE_image.hh.

Referenced by BKE_image_add_tile(), BKE_image_get_tile(), BKE_image_get_tile_info(), BKE_image_reassign_tile(), BKE_image_tile_filepath_exists(), IMAGE_OT_tile_add(), and tile_add_exec().

Typedef Documentation

◆ StampCallback

typedef void StampCallback(void *data, const char *propname, char *propvalue, int propvalue_maxncpy)

Definition at line 79 of file BKE_image.hh.

Enumeration Type Documentation

◆ eUDIM_TILE_FORMAT

enum eUDIM_TILE_FORMAT

Enumerator
UDIM_TILE_FORMAT_NONE
UDIM_TILE_FORMAT_UDIM
UDIM_TILE_FORMAT_UVTILE

Definition at line 446 of file BKE_image.hh.

Function Documentation

◆ BKE_image_acquire_ibuf()

ImBuf * BKE_image_acquire_ibuf	(	Image *	ima,
		ImageUser *	iuser,
		void **	r_lock )

Return image buffer for given image and user:

will lock render result if image type is render result and lock is not NULL
will return NULL if image is NULL or image type is render or composite result and lock is NULL

References the result, BKE_image_release_ibuf should be used to de-reference.

Definition at line 4823 of file source/blender/blenkernel/intern/image.cc.

References image_acquire_ibuf(), lock, and Image::runtime.

◆ BKE_image_acquire_multilayer_view_ibuf()

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 )

Return image buffer for given image, user, pass, and view. Is thread-safe, so another thread can be changing image while this function is executed.

If the image is single-layer then the pass name is completely ignored.

If the image is multi-layer then this function does all needed internal configurations to read the pass. There is no need to acquire a temporary ImBuf prior to this call (which is what some legacy code had to do to ensure proper type and RenderResult).

References the result, BKE_image_release_ibuf should be used to de-reference.

Definition at line 4860 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_is_multilayer(), BKE_image_multilayer_index(), BKE_scene_multiview_view_id_get(), BLI_assert, BLI_findlink(), BLI_findstringindex(), get_multilayer_view_index(), image_acquire_ibuf(), IMB_freeImBuf(), ImageUser::layer, RenderResult::layers, lock, ImageUser::multi_index, offsetof, ImageUser::pass, RenderLayer::passes, Image::rr, Image::runtime, and ImageUser::view.

◆ BKE_image_acquire_renderresult()

RenderResult * BKE_image_acquire_renderresult	(	Scene *	scene,
		Image *	ima )

Acquire render result associated with the give image.

The returned render result is user-counted It is then required to call * BKE_image_release_renderresult with the non-null render result returned by this function.

It is possible to use ibuf acquire/release API while a render result is held.

It is allowed to call BKE_image_release_renderresult with render_result of nullptr, but it is not required.

Definition at line 3883 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_get_renderslot(), BKE_image_partial_update_mark_full_update(), IMA_TYPE_R_RESULT, image_init_multilayer_multiview(), Image::last_render_slot, lock, RE_AcquireResultRead(), RE_GetSceneRender(), RE_ReferenceRenderResult(), RenderSlot::render, Image::render_slot, Image::rr, Image::runtime, and Image::type.

Referenced by blender::compositor::CachedImage::CachedImage(), draw_render_info(), blender::nodes::node_composite_cryptomatte_cc::CryptoMatteOperation::get_layers_from_image(), image_save_single(), ui_imageuser_layer_menu(), ui_imageuser_layer_menu_step(), ui_imageuser_pass_menu(), ui_imageuser_pass_menu_step(), ui_imageuser_view_menu_rr(), uiTemplateImage(), and uiTemplateImageLayers().

◆ BKE_image_add_from_imbuf()

Image * BKE_image_add_from_imbuf	(	Main *	bmain,
		ImBuf *	ibuf,
		const char *	name )

Create an image from ibuf. The reference-count of ibuf is increased, caller should take care to drop its reference by calling IMB_freeImBuf if needed.

Definition at line 1332 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_replace_imbuf(), BLI_path_basename(), ImBuf::filepath, IMA_SRC_FILE, IMA_SRC_GENERATED, IMA_TYPE_IMAGE, and image_alloc().

Referenced by image_clipboard_paste_exec(), blender::ed::greasepencil::image_render::image_render_end(), new_image_from_plane_marker_exec(), and texture_paint_image_from_view_exec().

◆ BKE_image_add_generated()

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 )

Adds new image block, creates ImBuf and initializes color.

Definition at line 1241 of file source/blender/blenkernel/intern/image.cc.

References add_ibuf_for_tile(), COLOR_ROLE_DATA, Image::colorspace_settings, copy_v4_v4(), ListBase::first, IMA_GEN_FLOAT, IMA_NO_INDEX, IMA_SRC_GENERATED, IMA_SRC_TILED, IMA_TYPE_IMAGE, IMA_TYPE_UV_TEST, image_add_view(), image_alloc(), image_assign_ibuf(), IMB_colormanagement_role_colorspace_name_get(), IMB_freeImBuf(), ColorManagedColorspaceSettings::name, STEREO_LEFT_NAME, STEREO_RIGHT_NAME, STRNCPY(), tile, and Image::tiles.

Referenced by blender::io::fbx::create_placeholder_image(), blender::io::obj::create_placeholder_image(), image_new_exec(), and proj_paint_image_create().

◆ BKE_image_add_renderslot()

RenderSlot * BKE_image_add_renderslot	(	Image *	ima,
		const char *	name )

Definition at line 5675 of file source/blender/blenkernel/intern/image.cc.

References BLI_addtail(), BLI_listbase_count(), DATA_, MEM_callocN(), RenderSlot::name, Image::renderslots, SNPRINTF, and STRNCPY_UTF8.

Referenced by BKE_image_backup_render(), image_add_render_slot_exec(), and image_init().

◆ BKE_image_add_tile()

ImageTile * BKE_image_add_tile	(	Image *	ima,
		int	tile_number,
		const char *	label )

Definition at line 3484 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_partial_update_mark_full_update(), BLI_addtail(), BLI_insertlinkbefore(), ListBase::first, GPU_texture_free(), Image::gputexture, IMA_SRC_TILED, IMA_UDIM_MAX, imagetile_alloc(), ImageTile::next, Image::source, STRNCPY(), TEXTARGET_2D_ARRAY, TEXTARGET_TILE_MAPPING, tile, ImageTile::tile_number, and Image::tiles.

Referenced by add_udim_tiles(), BKE_image_signal(), image_open_single(), and tile_add_exec().

◆ BKE_image_all_free_anim_ibufs()

void BKE_image_all_free_anim_ibufs	(	Main *	bmain,
		int	cfra )

Does all images with type MOVIE or SEQUENCE.

Definition at line 1669 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_free_anim_ibufs(), BKE_image_is_animated(), ListBase::first, Image::id, Main::images, and ID::next.

Referenced by do_render_full_pipeline().

◆ BKE_image_alpha_mode_from_extension()

void BKE_image_alpha_mode_from_extension ( Image * image )

Definition at line 1021 of file source/blender/blenkernel/intern/image.cc.

References Image::alpha_mode, BKE_image_alpha_mode_from_extension_ex(), and Image::filepath.

Referenced by blo_do_versions_260().

◆ BKE_image_alpha_mode_from_extension_ex()

char BKE_image_alpha_mode_from_extension_ex ( const char * filepath )

Set an alpha mode based on file extension.

Definition at line 1012 of file source/blender/blenkernel/intern/image.cc.

References BLI_path_extension_check_n(), IMA_ALPHA_PREMUL, and IMA_ALPHA_STRAIGHT.

Referenced by blender::seq::alpha_mode_from_file_extension(), and BKE_image_alpha_mode_from_extension().

◆ BKE_image_backup_render()

void BKE_image_backup_render	(	Scene *	scene,
		Image *	ima,
		bool	free_current_slot )

For multiple slot render, call this before render.

Definition at line 3942 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_add_renderslot(), BKE_image_clear_renderslot(), BKE_image_get_renderslot(), BLI_listbase_count(), ListBase::first, Image::last_render_slot, RE_GetSceneRender(), RE_SwapResult(), RenderSlot::render, Image::render_slot, and Image::renderslots.

Referenced by ED_node_composite_job(), screen_opengl_render_init(), screen_render_exec(), and screen_render_invoke().

◆ BKE_image_buf_fill_checker()

void BKE_image_buf_fill_checker	(	unsigned char *	rect,
		float *	rect_float,
		int	width,
		int	height )

Definition at line 150 of file image_gen.cc.

References IndexRange::first(), image_buf_fill_checker_slice(), blender::threading::parallel_for(), and IndexRange::size().

Referenced by BKE_image_find_nearest_tile_with_offset(), and image_buf_fill_isolated().

◆ BKE_image_buf_fill_checker_color()

void BKE_image_buf_fill_checker_color	(	unsigned char *	rect,
		float *	rect_float,
		int	width,
		int	height )

Definition at line 375 of file image_gen.cc.

References checker_board_color_prepare_slice(), checker_board_text(), IndexRange::first(), IB_PROFILE_LINEAR_RGB, IB_PROFILE_SRGB, IMB_buffer_float_from_float_threaded(), blender::threading::parallel_for(), and IndexRange::size().

Referenced by BKE_image_find_nearest_tile_with_offset(), and image_buf_fill_isolated().

◆ BKE_image_buf_fill_color()

void BKE_image_buf_fill_color	(	unsigned char *	rect,
		float *	rect_float,
		int	width,
		int	height,
		const float	color[4] )

Definition at line 25 of file image_gen.cc.

References copy_v4_v4(), IndexRange::first(), i, blender::threading::parallel_for(), and rgba_float_to_uchar().

Referenced by BKE_image_find_nearest_tile_with_offset(), and image_buf_fill_isolated().

◆ BKE_image_buffer_format_writable()

bool BKE_image_buffer_format_writable ( ImBuf * ibuf )

Definition at line 5503 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_format_from_imbuf(), BKE_imtype_to_ftype(), ImBuf::ftype, and ImageFormatData::imtype.

Referenced by BKE_image_find_nearest_tile_with_offset(), BKE_image_is_dirty_writable(), and image_file_format_writable().

◆ BKE_image_clear_renderslot()

bool BKE_image_clear_renderslot	(	Image *	ima,
		ImageUser *	iuser,
		int	slot )

Definition at line 5757 of file source/blender/blenkernel/intern/image.cc.

References BLI_findlink(), G, Image::last_render_slot, RE_ClearResult(), RE_FreeRenderResult(), RE_GetSceneRender(), RenderSlot::render, Image::renderslots, and ImageUser::scene.

Referenced by BKE_image_backup_render(), and image_clear_render_slot_exec().

◆ BKE_image_create_gpu_texture_from_ibuf()

GPUTexture * BKE_image_create_gpu_texture_from_ibuf	(	Image *	image,
		ImBuf *	ibuf )

Not to be use directly.

References BKE_image_create_gpu_texture_from_ibuf(), BKE_image_ensure_gpu_texture(), BKE_image_get_gpu_texture(), and BKE_image_get_gpu_viewer_texture().

Referenced by BKE_image_create_gpu_texture_from_ibuf().

◆ BKE_image_editors_update_frame()

void BKE_image_editors_update_frame	(	const Main *	bmain,
		int	cfra )

Definition at line 5204 of file source/blender/blenkernel/intern/image.cc.

References ListBase::first, wmWindowManager::id, image_editors_update_frame(), image_walk_id_all_users(), and Main::wm.

Referenced by BKE_scene_graph_update_for_newframe_ex().

◆ BKE_image_ensure_gpu_texture()

void BKE_image_ensure_gpu_texture	(	Image *	image,
		ImageUser *	iuser )

Ensure that the cached GPU texture inside the image matches the pass, layer, and view of the given image user, if not, invalidate the cache such that the next call to the GPU texture retrieval functions such as BKE_image_get_gpu_texture updates the cache with an image that matches the give image user.

This is provided as a separate function and not implemented as part of the GPU texture retrieval functions because the current cache system only allows a single pass, layer, and stereo view to be cached, so possible frequent cache invalidation can have performance implications, and making invalidation explicit by calling this function will help make that clear and pave the way for a more complete cache system in the future.

Definition at line 338 of file image_gpu.cc.

References BKE_image_partial_update_mark_full_update(), ELEM, IMAGE_GPU_LAYER_NONE, IMAGE_GPU_PASS_NONE, IMAGE_GPU_VIEW_NONE, ImageUser::layer, ImageUser::multi_index, and ImageUser::pass.

Referenced by BKE_image_create_gpu_texture_from_ibuf().

◆ BKE_image_ensure_tile_token()

void BKE_image_ensure_tile_token	(	char *	filepath,
		size_t	filepath_maxncpy )

Ensures that filename contains a UDIM token if we find a supported format pattern.

Note: This must only be the name component (without slashes).

Definition at line 3659 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_ensure_tile_token_filename_only(), and BLI_path_basename().

Referenced by BKE_image_signal(), BKE_packedfile_unpack_image(), do_versions_after_linking_300(), and image_file_browse_exec().

◆ BKE_image_ensure_tile_token_filename_only()

void BKE_image_ensure_tile_token_filename_only	(	char *	filename,
		size_t	filename_maxncpy )

Definition at line 3630 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_is_filename_tokenized(), BLI_assert_msg, BLI_path_slash_find(), and BLI_strncpy().

Referenced by BKE_image_ensure_tile_token(), BKE_image_get_tile_info(), and blender::bke::tests::TEST().

◆ BKE_image_ensure_viewer()

Image * BKE_image_ensure_viewer	(	Main *	bmain,
		int	type,
		const char *	name )

Ensures an Image exists for viewing nodes or render forces existence of 1 Image for render-output or nodes, returns Image.

Parameters

name	Only for default, when making new one.

Definition at line 2754 of file source/blender/blenkernel/intern/image.cc.

References ListBase::first, Image::id, id_us_ensure_real(), IMA_SRC_VIEWER, image_alloc(), Main::images, ID::next, Image::source, Image::type, and ID::us.

◆ BKE_image_ensure_viewer_views()

void BKE_image_ensure_viewer_views	(	const RenderData *	rd,
		Image *	ima,
		ImageUser *	iuser )

Ensures the view node cache is compatible with the scene views. Reset the image cache and views when the Viewer Nodes views don't match the scene views.

Definition at line 2838 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_free_views(), BKE_scene_multiview_is_stereo3d(), BLI_thread_lock(), BLI_thread_unlock(), ImageUser::flag, IMA_SHOW_STEREO, image_free_cached_frames(), image_viewer_create_views(), image_views_match_render_views(), lock, LOCK_DRAW_IMAGE, and Image::runtime.

Referenced by blender::render::Context::viewer_output_to_viewer_image().

◆ BKE_image_file_format_set()

void BKE_image_file_format_set	(	Image *	image,
		int	ftype,
		const ImbFormatOptions *	options )

Definition at line 5511 of file source/blender/blenkernel/intern/image.cc.

References Image::cache, ImBuf::foptions, ImBuf::ftype, IMB_moviecacheIter_done(), IMB_moviecacheIter_free(), IMB_moviecacheIter_getImBuf(), IMB_moviecacheIter_new(), IMB_moviecacheIter_step(), lock, options, and Image::runtime.

Referenced by BKE_image_find_nearest_tile_with_offset().

◆ BKE_image_fill_tile()

bool BKE_image_fill_tile	(	Image *	ima,
		ImageTile *	tile )

Definition at line 3606 of file source/blender/blenkernel/intern/image.cc.

References add_ibuf_for_tile(), BKE_image_release_ibuf(), IMA_SRC_TILED, image_assign_ibuf(), image_free_tile(), Image::source, and tile.

Referenced by do_fill_tile().

◆ BKE_image_find_nearest_tile()

int int BKE_image_find_nearest_tile	(	const Image *	image,
		const float	co[2] )

Definition at line 977 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_find_nearest_tile_with_offset().

◆ BKE_image_find_nearest_tile_with_offset()

int BKE_image_find_nearest_tile_with_offset	(	const Image *	image,
		const float	co[2],
		float	r_uv_offset[2] )

Return the tile_number for the closest UDIM tile to co.

References ATTR_WARN_UNUSED_RESULT, BKE_image_buf_fill_checker(), BKE_image_buf_fill_checker_color(), BKE_image_buf_fill_color(), BKE_image_buffer_format_writable(), BKE_image_file_format_set(), BKE_image_get_aspect(), BKE_image_get_first_ibuf(), BKE_image_get_float_pixels_for_frame(), BKE_image_get_ibuf_with_name(), BKE_image_get_pixels_for_frame(), BKE_image_get_size(), BKE_image_get_size_fl(), BKE_image_has_anim(), BKE_image_has_filepath(), BKE_image_has_loaded_ibuf(), BKE_image_has_multiple_ibufs(), BKE_image_has_packedfile(), BKE_image_is_animated(), BKE_image_is_dirty(), BKE_image_is_dirty_writable(), BKE_image_mark_dirty(), BKE_image_sequence_guess_offset(), options, and tile.

Referenced by blender::ed::transform::clip_uv_transform_resize(), blender::ed::transform::clip_uv_transform_translation(), uv_nearest_image_tile_distance(), and uv_sculpt_stroke_init().

◆ BKE_image_free_all_gputextures()

void BKE_image_free_all_gputextures ( Main * bmain )

Definition at line 575 of file image_gpu.cc.

References BKE_image_free_gputextures(), Main::images, and LISTBASE_FOREACH.

Referenced by ED_object_texture_paint_mode_enter_ex(), and ED_object_texture_paint_mode_exit_ex().

◆ BKE_image_free_all_textures()

void BKE_image_free_all_textures ( Main * bmain )

Goes over all textures that use images.

Definition at line 1607 of file source/blender/blenkernel/intern/image.cc.

References Image::cache, ListBase::first, Image::id, Tex::id, ID_TAG_DOIT, Tex::ima, image_mem_size(), imagecache_check_dirty(), Main::images, IMB_moviecache_cleanup(), ID::next, printf, ID::tag, and Main::textures.

◆ BKE_image_free_anim_gputextures()

void BKE_image_free_anim_gputextures ( Main * bmain )

Same as BKE_image_free_all_gputextures but only free animated images.

Definition at line 584 of file image_gpu.cc.

References BKE_image_free_gputextures(), BKE_image_is_animated(), Main::images, and LISTBASE_FOREACH.

Referenced by ED_view3d_draw_offscreen().

◆ BKE_image_free_anim_ibufs()

void BKE_image_free_anim_ibufs	(	Image *	ima,
		int	except_frame )

Operates on one image only!

Parameters

except_frame This is weak, only works for sequences without offset.

Definition at line 1661 of file source/blender/blenkernel/intern/image.cc.

References Image::cache, imagecache_check_free_anim(), IMB_moviecache_cleanup(), lock, and Image::runtime.

Referenced by BKE_image_all_free_anim_ibufs().

◆ BKE_image_free_buffers()

void BKE_image_free_buffers ( Image * image )

Definition at line 634 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_free_buffers_ex().

◆ BKE_image_free_buffers_ex()

void BKE_image_free_buffers_ex	(	Image *	image,
		bool	do_lock )

Simply free the image data from memory, on display the image can load again (except for render buffers).

Definition at line 613 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_free_gputextures(), image_free_anims(), image_free_cached_frames(), RE_FreeRenderResult(), Image::rr, and Image::runtime.

Referenced by BKE_image_free_buffers(), and BlenderImageLoader::load_pixels().

◆ BKE_image_free_data()

void BKE_image_free_data ( Image * image )

Free (or release) any data used by this image (does not free the image itself).

Note: Call from library.

Definition at line 639 of file source/blender/blenkernel/intern/image.cc.

References Image::id, and image_free_data().

◆ BKE_image_free_gputextures()

void BKE_image_free_gputextures ( Image * ima )

Definition at line 570 of file image_gpu.cc.

References BLI_thread_is_main(), and image_free_gpu().

Referenced by blender::ed::object::bake_targets_refresh(), BKE_image_free_all_gputextures(), BKE_image_free_anim_gputextures(), BKE_image_free_buffers_ex(), BKE_image_free_old_gputextures(), BKE_image_paint_set_mipmap(), paint_2d_redraw(), ptile_restore_runtime_map(), and texture_paint_camera_project_exec().

◆ BKE_image_free_old_gputextures()

void BKE_image_free_old_gputextures ( Main * bmain )

Definition at line 595 of file image_gpu.cc.

References BKE_image_free_buffers, BKE_image_free_gputextures(), BKE_image_has_opengl_texture(), BLI_time_now_seconds(), G, IMA_NOCOLLECT, Main::images, LISTBASE_FOREACH, and U.

Referenced by view3d_main_region_draw().

◆ BKE_image_free_packedfiles()

void BKE_image_free_packedfiles ( Image * image )

Definition at line 590 of file source/blender/blenkernel/intern/image.cc.

References image_free_packedfiles().

Referenced by image_save_as_exec().

◆ BKE_image_free_unused_gpu_textures()

void BKE_image_free_unused_gpu_textures ( )

Delayed free of OpenGL buffers by main thread.

Definition at line 536 of file image_gpu.cc.

References BLI_thread_is_main(), and gpu_free_unused_buffers().

Referenced by wm_draw_update(), and WM_exit_ex().

◆ BKE_image_free_views()

void BKE_image_free_views ( Image * image )

Definition at line 595 of file source/blender/blenkernel/intern/image.cc.

References BLI_freelistN(), and Image::views.

Referenced by BKE_image_ensure_viewer_views(), image_free_data(), image_init_multilayer_multiview(), image_open_single(), and image_update_views_format().

◆ BKE_image_get_aspect()

void BKE_image_get_aspect	(	Image *	image,
		float *	r_aspx,
		float *	r_aspy )

Definition at line 5360 of file source/blender/blenkernel/intern/image.cc.

References Image::aspx, and Image::aspy.

Referenced by BKE_image_find_nearest_tile_with_offset(), BKE_mask_coord_from_image(), BKE_mask_coord_to_image(), ED_image_get_uv_aspect(), and ED_space_image_get_aspect().

◆ BKE_image_get_first_ibuf()

ImBuf * BKE_image_get_first_ibuf ( Image * image )

References the result, BKE_image_release_ibuf is to be called to de-reference. Use lock=NULL when calling BKE_image_release_ibuf().

TODO(sergey): This is actually "get first item from the cache", which is not so much predictable. But using first loaded image buffer was also malicious logic and all the areas which uses this function are to be re-considered.

Definition at line 5575 of file source/blender/blenkernel/intern/image.cc.

References Image::cache, IMB_moviecacheIter_done(), IMB_moviecacheIter_free(), IMB_moviecacheIter_getImBuf(), IMB_moviecacheIter_new(), IMB_refImBuf(), lock, and Image::runtime.

Referenced by BKE_image_find_nearest_tile_with_offset().

◆ BKE_image_get_float_pixels_for_frame()

float * BKE_image_get_float_pixels_for_frame	(	Image *	image,
		int	frame,
		int	tile )

Definition at line 5403 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_acquire_ibuf(), BKE_image_release_ibuf(), BKE_imageuser_default(), ImBufFloatBuffer::data, ImBuf::float_buffer, ImageUser::framenr, lock, MEM_dupallocN(), ImageUser::tile, and tile.

Referenced by BKE_image_find_nearest_tile_with_offset().

◆ BKE_image_get_gpu_material_texture()

ImageGPUTextures BKE_image_get_gpu_material_texture	(	Image *	image,
		ImageUser *	iuser,
		const bool	use_tile_mapping )

Definition at line 496 of file image_gpu.cc.

References image_get_gpu_texture().

Referenced by blender::draw::detail::PassBase< DrawCommandBufType >::material_set(), blender::workbench::MaterialTexture::MaterialTexture(), and blender::workbench::MaterialTexture::MaterialTexture().

◆ BKE_image_get_gpu_material_texture_try()

ImageGPUTextures BKE_image_get_gpu_material_texture_try	(	Image *	image,
		ImageUser *	iuser,
		const bool	use_tile_mapping )

Definition at line 503 of file image_gpu.cc.

References image_get_gpu_texture().

Referenced by blender::draw::detail::PassBase< DrawCommandBufType >::material_set().

◆ BKE_image_get_gpu_texture()

GPUTexture * BKE_image_get_gpu_texture	(	Image *	image,
		ImageUser *	iuser )

Get the #GPUTexture for a given Image.

The requested GPU texture will be cached for subsequent calls, but only a single layer, pass, and view can be cached at a time, so the cache should be invalidated in operators and RNA callbacks that change the layer, pass, or view of the image to maintain a correct cache state. However, in some cases, multiple layers, passes, or views might be needed at the same time, like is the case for the compositor. This is currently not supported, so the caller should ensure that the requested layer is indeed the cached one and invalidated the cached otherwise by calling BKE_image_ensure_gpu_texture. This is a workaround until image can support a more complete caching system.

Definition at line 486 of file image_gpu.cc.

References image_get_gpu_texture(), and ImageGPUTextures::texture.

Referenced by blender::draw::overlay::Paints::begin_sync(), BKE_image_create_gpu_texture_from_ibuf(), blender::draw::overlay::MeshUVs::end_sync(), blender::draw::gpencil::gpencil_image_texture_get(), blender::eevee::LookdevWorld::LookdevWorld(), and pygpu_texture_from_image().

◆ BKE_image_get_gpu_viewer_texture()

GPUTexture * BKE_image_get_gpu_viewer_texture	(	Image *	image,
		ImageUser *	iuser )

Definition at line 491 of file image_gpu.cc.

References image_get_gpu_texture(), and ImageGPUTextures::texture.

Referenced by BKE_image_create_gpu_texture_from_ibuf().

◆ BKE_image_get_ibuf_with_name()

ImBuf * BKE_image_get_ibuf_with_name	(	Image *	image,
		const char *	filepath )

References the result, BKE_image_release_ibuf is to be called to de-reference. Use lock=NULL when calling BKE_image_release_ibuf().

Definition at line 5551 of file source/blender/blenkernel/intern/image.cc.

References BLI_assert, BLI_path_is_rel(), Image::cache, ImBuf::filepath, IMB_moviecacheIter_done(), IMB_moviecacheIter_free(), IMB_moviecacheIter_getImBuf(), IMB_moviecacheIter_new(), IMB_moviecacheIter_step(), IMB_refImBuf(), lock, Image::runtime, and STREQ.

Referenced by BKE_image_find_nearest_tile_with_offset().

◆ BKE_image_get_pixels_for_frame()

unsigned char * BKE_image_get_pixels_for_frame	(	Image *	image,
		int	frame,
		int	tile )

Definition at line 5373 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_acquire_ibuf(), BKE_image_release_ibuf(), BKE_imageuser_default(), ImBuf::byte_buffer, ImBufByteBuffer::data, ImageUser::framenr, lock, MEM_dupallocN(), ImageUser::tile, and tile.

Referenced by BKE_image_find_nearest_tile_with_offset().

◆ BKE_image_get_renderslot()

RenderSlot * BKE_image_get_renderslot	(	Image *	ima,
		int	index )

Definition at line 5785 of file source/blender/blenkernel/intern/image.cc.

References BLI_findlink(), and Image::renderslots.

Referenced by BKE_image_acquire_renderresult(), BKE_image_backup_render(), ED_image_slot_cycle(), image_cycle_render_slot_exec(), image_get_render_result(), and uiblock_layer_pass_buttons().

◆ BKE_image_get_size()

void BKE_image_get_size	(	Image *	image,
		ImageUser *	iuser,
		int *	r_width,
		int *	r_height )

Definition at line 5323 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_acquire_ibuf(), BKE_image_release_ibuf(), BKE_render_resolution(), IMA_TYPE_R_RESULT, IMG_SIZE_FALLBACK, lock, Scene::r, ImageUser::scene, Image::type, ImBuf::x, and ImBuf::y.

Referenced by BKE_image_find_nearest_tile_with_offset(), BKE_image_get_size_fl(), ED_image_get_uv_aspect(), and blender::io::usd::process_usdz_textures().

◆ BKE_image_get_size_fl()

void BKE_image_get_size_fl	(	Image *	image,
		ImageUser *	iuser,
		float	r_size[2] )

Definition at line 5351 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_get_size().

Referenced by BKE_image_find_nearest_tile_with_offset(), BKE_mask_coord_from_image(), BKE_mask_coord_to_image(), blender::draw::overlay::MeshUVs::end_sync(), and WIDGETGROUP_empty_image_refresh().

◆ BKE_image_get_tile()

ImageTile * BKE_image_get_tile	(	Image *	ima,
		int	tile_number )

Definition at line 820 of file source/blender/blenkernel/intern/image.cc.

References ELEM, ListBase::first, IMA_SRC_TILED, IMA_UDIM_MAX, LISTBASE_FOREACH, Image::source, tile, and Image::tiles.

◆ BKE_image_get_tile_from_iuser()

ImageTile * BKE_image_get_tile_from_iuser	(	Image *	ima,
		const ImageUser *	iuser )

Definition at line 846 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_get_tile, and image_get_tile_number_from_iuser().

◆ BKE_image_get_tile_from_pos()

int BKE_image_get_tile_from_pos	(	Image *	ima,
		const float	uv[2],
		float	r_uv[2],
		float	r_ofs[2] )

Definition at line 851 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_get_tile, copy_v2_v2(), IMA_SRC_TILED, Image::source, sub_v2_v2(), and zero_v2().

Referenced by ED_space_image_color_sample(), image_sample_apply(), image_sample_line_exec(), imagewrap(), paint_2d_bucket_fill(), paint_2d_gradient_fill(), and paint_sample_color().

◆ BKE_image_get_tile_info()

bool BKE_image_get_tile_info	(	char *	filepath,
		ListBase *	tiles,
		int *	r_tile_start,
		int *	r_tile_range )

Checks whether the given filepath refers to a UDIM tiled texture. If yes, the range from the lowest to the highest tile is returned.

Parameters

filepath	may be modified to ensure a UDIM token is present.
tiles	may be filled even if the result ultimately is false!

Definition at line 3433 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_ensure_tile_token_filename_only(), BKE_image_get_tile_number_from_filepath(), BKE_image_get_tile_strformat(), BKE_image_is_filename_tokenized(), BLI_addtail(), BLI_filelist_dir_contents(), BLI_filelist_free(), BLI_genericNodeN(), BLI_path_join, BLI_path_split_dir_file(), dirname(), FILE_MAX, FILE_MAXDIR, FILE_MAXFILE, i, IMA_UDIM_MAX, max_ii(), MEM_SAFE_FREE, min_ii(), POINTER_FROM_INT, and tiles.

Referenced by BKE_image_signal(), get_udim_tiles(), and image_detect_frame_range().

◆ BKE_image_get_tile_label()

int BKE_image_get_tile_label	(	const Image *	ima,
		const ImageTile *	tile,
		char *	label,
		int	label_maxncpy )

Get tile index for tiled images.

Returns: The string length.

Definition at line 3417 of file source/blender/blenkernel/intern/image.cc.

References BLI_snprintf_rlen(), BLI_strncpy_rlen(), and tile.

◆ BKE_image_get_tile_number_from_filepath()

bool BKE_image_get_tile_number_from_filepath	(	const char *	filepath,
		const char *	pattern,
		eUDIM_TILE_FORMAT	tile_format,
		int *	r_tile_number )

Definition at line 3720 of file source/blender/blenkernel/intern/image.cc.

References result, UDIM_TILE_FORMAT_UDIM, UDIM_TILE_FORMAT_UVTILE, and v.

Referenced by BKE_image_get_tile_info(), BKE_image_tile_filepath_exists(), and blender::bke::tests::TEST().

◆ BKE_image_get_tile_strformat()

char * BKE_image_get_tile_strformat	(	const char *	filepath,
		eUDIM_TILE_FORMAT *	r_tile_format )

Retrieves the UDIM token format and returns the pattern from the provided filepath. The returned pattern is typically passed to either BKE_image_get_tile_number_from_filepath or BKE_image_set_filepath_from_tile_number.

Definition at line 3701 of file source/blender/blenkernel/intern/image.cc.

References BLI_string_replaceN(), UDIM_TILE_FORMAT_NONE, UDIM_TILE_FORMAT_UDIM, and UDIM_TILE_FORMAT_UVTILE.

Referenced by BKE_image_get_tile_info(), BKE_image_save(), BKE_image_signal(), BKE_image_tile_filepath_exists(), BKE_image_user_file_path_ex(), blender::io::usd::copy_tiled_textures(), blender::io::usd::export_in_memory_texture(), image_foreach_path(), blender::bke::tests::TEST(), blender::bke::tests::TEST(), and blender::bke::tests::TEST().

◆ BKE_image_get_tile_uv()

void BKE_image_get_tile_uv	(	const Image *	ima,
		const int	tile_number,
		float	r_uv[2] )

Definition at line 879 of file source/blender/blenkernel/intern/image.cc.

References IMA_SRC_TILED, Image::source, tile_index, and zero_v2().

Referenced by blender::ed::object::bake_targets_init_internal(), BKE_image_find_nearest_tile_with_offset(), do_multires_bake(), and finish_images().

◆ BKE_image_has_alpha()

bool BKE_image_has_alpha ( Image * image )

Check if texture has alpha planes == 32 || planes == 16.

Definition at line 5309 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_acquire_ibuf(), BKE_image_release_ibuf(), ELEM, lock, and ImBuf::planes.

Referenced by uiTemplateImage().

◆ BKE_image_has_anim()

bool BKE_image_has_anim ( Image * image )

Definition at line 5438 of file source/blender/blenkernel/intern/image.cc.

References Image::anims, and BLI_listbase_is_empty().

Referenced by BKE_image_find_nearest_tile_with_offset(), BKE_image_load_exists_in_lib(), image_match_len_exec(), ui_tooltip_from_image(), and uiTemplateImageInfo().

◆ BKE_image_has_filepath()

bool BKE_image_has_filepath ( const Image * ima )

Definition at line 5448 of file source/blender/blenkernel/intern/image.cc.

References Image::filepath.

Referenced by BKE_image_find_nearest_tile_with_offset(), blender::io::obj::get_image_filepath(), image_save_invoke(), image_should_pack_during_save_all(), and uiTemplateImage().

◆ BKE_image_has_gpu_texture_premultiplied_alpha()

bool BKE_image_has_gpu_texture_premultiplied_alpha	(	Image *	image,
		ImBuf *	ibuf )

Is the alpha of the GPUTexture for a given image/ibuf premultiplied.

Definition at line 43 of file image_gpu.cc.

References ImBufFloatBuffer::data, ELEM, ImBuf::float_buffer, IMA_ALPHA_PREMUL, IMA_ALPHA_STRAIGHT, IMA_TYPE_COMPOSITE, IMA_TYPE_R_RESULT, and IMA_TYPE_UV_TEST.

Referenced by gpu_texture_create_tile_array(), gpu_texture_update_from_ibuf(), image_get_gpu_texture(), and blender::image_engine::ShaderParameters::update().

◆ BKE_image_has_ibuf()

bool BKE_image_has_ibuf	(	Image *	ima,
		ImageUser *	iuser )

Checks whether there's an image buffer for given image and user.

Definition at line 4920 of file source/blender/blenkernel/intern/image.cc.

References image_acquire_ibuf(), image_get_cached_ibuf(), image_quick_test(), IMB_freeImBuf(), lock, and Image::runtime.

Referenced by draw_plane_marker_ex(), image_from_context_editable_has_data_poll_active_tile(), palette_extract_img_poll(), project_paint_prepare_all_faces(), tile_add_poll(), and tile_fill_poll().

◆ BKE_image_has_loaded_ibuf()

bool BKE_image_has_loaded_ibuf ( Image * image )

Definition at line 5529 of file source/blender/blenkernel/intern/image.cc.

References Image::cache, IMB_moviecacheIter_done(), IMB_moviecacheIter_free(), IMB_moviecacheIter_getImBuf(), IMB_moviecacheIter_new(), IMB_moviecacheIter_step(), lock, and Image::runtime.

Referenced by BKE_image_find_nearest_tile_with_offset(), BlenderImageLoader::BlenderImageLoader(), imagewrap(), imagewraposa(), and imagewraposa_aniso().

◆ BKE_image_has_multiple_ibufs()

bool BKE_image_has_multiple_ibufs ( Image * image )

Checks whether the image consists of multiple buffers.

Definition at line 5460 of file source/blender/blenkernel/intern/image.cc.

References ELEM, IMA_SRC_MOVIE, IMA_SRC_SEQUENCE, IMA_SRC_TILED, and Image::source.

Referenced by BKE_image_find_nearest_tile_with_offset(), and image_get_multiview_index().

◆ BKE_image_has_opengl_texture()

bool BKE_image_has_opengl_texture ( Image * ima )

Check if texture has GPU texture code.

Definition at line 801 of file source/blender/blenkernel/intern/image.cc.

References Image::gputexture, i, and TEXTARGET_COUNT.

Referenced by BKE_image_free_old_gputextures(), and BKE_image_paint_set_mipmap().

◆ BKE_image_has_packedfile()

bool BKE_image_has_packedfile ( const Image * image )

Definition at line 5443 of file source/blender/blenkernel/intern/image.cc.

References BLI_listbase_is_empty(), and Image::packedfiles.

Referenced by BKE_image_find_nearest_tile_with_offset(), BKE_image_signal(), BKE_packedfile_count_all(), BKE_packedfile_id_check(), BKE_packedfile_id_unpack(), BKE_packedfile_pack_all(), BKE_packedfile_unpack_all(), blender::io::hydra::cache_or_get_image_file(), ED_image_save_all_modified(), ED_image_save_all_modified_info(), blender::io::obj::get_image_filepath(), blender::io::usd::get_in_memory_texture_filename(), image_foreach_path(), image_load_image_file(), image_save_exec(), image_save_invoke(), image_unpack_exec(), image_unpack_invoke(), blender::io::usd::is_packed_texture(), blender::io::usd::load_image(), blender::io::usd::USDMaterialReader::load_tex_image(), blender::io::fbx::load_texture_image(), paint_2d_new_stroke(), and uiTemplateImage().

◆ BKE_image_init_imageuser()

void BKE_image_init_imageuser	(	Image *	ima,
		ImageUser *	iuser )

Definition at line 3110 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_multilayer_index(), ImageUser::layer, ImageUser::multi_index, ImageUser::pass, Image::rr, and ImageUser::view.

Referenced by BKE_image_signal(), and image_open_exec().

◆ BKE_image_is_animated()

bool BKE_image_is_animated ( Image * image )

Checks the image buffer changes with time (not keyframed values).

Definition at line 5455 of file source/blender/blenkernel/intern/image.cc.

References ELEM, IMA_SRC_MOVIE, IMA_SRC_SEQUENCE, and Image::source.

Referenced by BKE_image_all_free_anim_ibufs(), BKE_image_find_nearest_tile_with_offset(), BKE_image_free_anim_gputextures(), BKE_image_user_frame_calc(), BKE_texture_dependsOnTime(), image_editors_update_frame(), image_tag_frame_recalc(), image_user_id_eval_animation(), image_user_id_has_animation(), MOD_init_texture(), blender::nodes::node_geo_image_info_cc::node_geo_exec(), blender::nodes::node_geo_image_texture_cc::node_geo_exec(), and uiTemplateImage().

◆ BKE_image_is_dirty()

bool BKE_image_is_dirty ( Image * image )

Definition at line 5493 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_is_dirty_writable().

Referenced by BKE_image_find_nearest_tile_with_offset(), blender::io::usd::get_in_memory_texture_filename(), image_foreach_path(), image_pack_exec(), blender::io::usd::is_in_memory_texture(), blender::ed::space_node::node_buts_image_user(), pack_all_invoke(), and uiTemplateImage().

◆ BKE_image_is_dirty_writable()

bool BKE_image_is_dirty_writable	(	Image *	image,
		bool *	r_is_writable )

Definition at line 5465 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_buffer_format_writable(), Image::cache, IB_BITMAPDIRTY, IMB_moviecacheIter_done(), IMB_moviecacheIter_free(), IMB_moviecacheIter_getImBuf(), IMB_moviecacheIter_new(), IMB_moviecacheIter_step(), lock, Image::runtime, and ImBuf::userflags.

Referenced by BKE_image_find_nearest_tile_with_offset(), BKE_image_is_dirty(), and image_should_be_saved().

◆ BKE_image_is_filename_tokenized()

bool BKE_image_is_filename_tokenized ( char * filepath )

Checks if the filename portion of the path contains a UDIM token.

Definition at line 3624 of file source/blender/blenkernel/intern/image.cc.

References BLI_path_basename().

Referenced by BKE_image_ensure_tile_token_filename_only(), BKE_image_get_tile_info(), BKE_image_signal(), and blender::io::usd::get_in_memory_texture_filename().

◆ BKE_image_is_multilayer()

bool BKE_image_is_multilayer ( const Image * ima )

For multi-layer images as well as for render-viewer and because rendered results use fake layer/passes, don't correct for wrong indices here.

Definition at line 3823 of file source/blender/blenkernel/intern/image.cc.

References ELEM, IMA_SRC_FILE, IMA_SRC_SEQUENCE, IMA_SRC_TILED, IMA_SRC_VIEWER, IMA_TYPE_MULTILAYER, IMA_TYPE_R_RESULT, Image::source, and Image::type.

Referenced by BKE_image_acquire_multilayer_view_ibuf(), blender::compositor::compute_image_user_for_pass(), and image_get_multiview_index().

◆ BKE_image_is_multiview()

bool BKE_image_is_multiview ( const Image * ima )

Definition at line 3841 of file source/blender/blenkernel/intern/image.cc.

References ListBase::first, view, and Image::views.

Referenced by BKE_image_is_stereo(), BKE_image_memorypack(), BKE_image_reassign_tile(), BKE_image_save_options_init(), BKE_image_user_file_path_ex(), image_free_tile(), image_get_multiview_index(), image_load_image_file(), image_load_movie_file(), image_num_viewfiles(), image_save_as_init(), image_save_single(), image_update_views_format(), and uiblock_layer_pass_buttons().

◆ BKE_image_is_openexr()

bool BKE_image_is_openexr ( Image * ima )

For multi-layer images as well as for single-layer.

Definition at line 3930 of file source/blender/blenkernel/intern/image.cc.

References BLI_path_extension_check(), ELEM, Image::filepath, IMA_SRC_FILE, IMA_SRC_SEQUENCE, IMA_SRC_TILED, Image::source, and UNUSED_VARS.

◆ BKE_image_is_stereo()

bool BKE_image_is_stereo ( const Image * ima )

Definition at line 3847 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_is_multiview(), BLI_findstring(), offsetof, STEREO_LEFT_NAME, STEREO_RIGHT_NAME, and Image::views.

Referenced by BKE_image_multiview_index(), ED_screen_stereo3d_required(), image_get_multiview_index(), image_get_render_result(), image_load_image_file(), image_load_movie_file(), image_save_single(), blender::draw::overlay::Images::stereo_setup(), and uiblock_layer_pass_buttons().

◆ BKE_image_load()

Image * BKE_image_load	(	Main *	bmain,
		const char *	filepath )

Returns a new image or NULL if it can't load.

Note: : The _in_lib version allows to add a new image in a given library. It also affects the root path used for relative filepaths. See also BKE_id_new and BKE_id_new_in_lib documentation for more details.

Definition at line 1040 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_load_in_lib().

Referenced by blender::bke::tests::ImageTest::load_image(), and blender::io::usd::process_usdz_textures().

◆ BKE_image_load_exists()

Image * BKE_image_load_exists	(	Main *	bmain,
		const char *	filepath,
		bool *	r_exists = nullptr )

Returns existing Image when filename/type is same.

Checks if image was already loaded, then returns same image otherwise creates new (does not load ibuf itself).

Note: : The _in_lib version allows to find an existing (or add a new) image in a given library. It also affects the root path used for relative filepaths. See also BKE_id_new and BKE_id_new_in_lib documentation for more details.

Definition at line 1082 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_load_exists_in_lib().

Referenced by blender::io::usd::load_image(), blender::io::obj::load_image_at_path(), blender::io::usd::USDMaterialReader::load_tex_image(), blender::io::fbx::load_texture_image(), WM_operator_drop_load_path(), and DocumentImporter::writeImage().

◆ BKE_image_load_exists_in_lib()

Image * BKE_image_load_exists_in_lib	(	Main *	bmain,
		std::optional< Library * >	owner_library,
		const char *	filepath,
		bool *	r_exists = nullptr )

Definition at line 1087 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_has_anim(), BKE_image_load_in_lib(), BLI_path_abs(), BLI_path_cmp, Main::curlib, ELEM, FILE_MAX, Image::filepath, ListBase::first, Image::id, ID_BLEND_PATH, id_us_plus(), IMA_SRC_GENERATED, IMA_SRC_VIEWER, image_abs_path(), Main::images, ID::lib, ID::next, Image::source, STRNCPY(), and ID::us.

Referenced by BKE_image_load_exists(), and image_open_single().

◆ BKE_image_load_in_lib()

Image * BKE_image_load_in_lib	(	Main *	bmain,
		std::optional< Library * >	owner_library,
		const char *	filepath )

Definition at line 1045 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_tile_filepath_exists(), BLI_open(), BLI_path_basename(), BLI_path_extension_check_array(), Main::curlib, FILE_MAX, Image::filepath, IMA_SRC_FILE, IMA_SRC_MOVIE, IMA_TYPE_IMAGE, image_abs_path(), image_alloc(), image_init_color_management(), imb_ext_movie, O_BINARY, Image::source, and STRNCPY().

Referenced by BKE_image_load(), and BKE_image_load_exists_in_lib().

◆ BKE_image_mark_dirty()

void BKE_image_mark_dirty	(	Image *	image,
		ImBuf *	ibuf )

Definition at line 5498 of file source/blender/blenkernel/intern/image.cc.

References IB_BITMAPDIRTY, and ImBuf::userflags.

Referenced by BKE_image_find_nearest_tile_with_offset(), BKE_image_replace_imbuf(), BKE_image_scale(), ED_imapaint_dirty_region(), finish_images(), image_flip_exec(), image_invert_exec(), image_rotate_orthogonal_exec(), image_scale_exec(), project_paint_undo_subtiles(), uhandle_restore_list(), and blender::ed::object::write_internal_bake_pixels().

◆ BKE_image_memorypack()

bool BKE_image_memorypack ( Image * ima )

◆ BKE_image_merge()

void BKE_image_merge	(	Main *	bmain,
		Image *	dest,
		Image *	source )

Merge source into dest, and free source.

Definition at line 757 of file source/blender/blenkernel/intern/image.cc.

References BKE_id_free(), Image::cache, imagecache_put(), IMB_moviecacheIter_done(), IMB_moviecacheIter_free(), IMB_moviecacheIter_getImBuf(), IMB_moviecacheIter_getUserKey(), IMB_moviecacheIter_new(), IMB_moviecacheIter_step(), ImageCacheKey::index, and Image::runtime.

Referenced by local_merge().

◆ BKE_image_multilayer_index()

RenderPass * BKE_image_multilayer_index	(	RenderResult *	rr,
		ImageUser *	iuser )

Sets index offset for multi-layer files and because rendered results use fake layer/passes, don't correct for wrong indices here.

Definition at line 3767 of file source/blender/blenkernel/intern/image.cc.

References BLI_listbase_count(), ListBase::first, ImageUser::flag, IMA_SHOW_STEREO, image_render_pass_get(), ImageUser::layer, RenderResult::layers, ImageUser::multi_index, ImageUser::multiview_eye, RenderLayer::next, ImageUser::pass, RenderLayer::passes, RE_HasCombinedLayer(), RE_RenderResult_is_stereo(), and ImageUser::view.

Referenced by BKE_image_acquire_multilayer_view_ibuf(), BKE_image_init_imageuser(), blender::compositor::compute_image_user_for_pass(), image_get_ibuf_multilayer(), image_load_sequence_multilayer(), image_multi_cb(), image_save_single(), blender::image_engine::Instance::image_sync(), ui_imageuser_layer_menu_step(), and ui_imageuser_pass_menu_step().

◆ BKE_image_multilayer_stamp_info_callback()

void BKE_image_multilayer_stamp_info_callback	(	void *	data,
		const Image &	image,
		StampCallback	callback,
		bool	noskip )

Definition at line 2512 of file source/blender/blenkernel/intern/image.cc.

References BKE_stamp_info_callback(), data, lock, Image::rr, Image::runtime, and RenderResult::stamp_data.

◆ BKE_image_multiview_index()

void BKE_image_multiview_index	(	const Image *	ima,
		ImageUser *	iuser )

Sets index offset for multi-view files.

Definition at line 3803 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_is_stereo(), BLI_listbase_count_at_most(), ImageUser::flag, IMA_SHOW_STEREO, ImageUser::multi_index, ImageUser::multiview_eye, ImageUser::view, and Image::views.

Referenced by blender::compositor::compute_image_user_for_pass(), image_multiview_cb(), image_save_single(), blender::image_engine::Instance::image_sync(), and blender::draw::overlay::Images::stereo_setup().

◆ BKE_image_packfiles()

void BKE_image_packfiles	(	ReportList *	reports,
		Image *	ima,
		const char *	basepath )

◆ BKE_image_packfiles_from_mem()

void BKE_image_packfiles_from_mem	(	ReportList *	reports,
		Image *	ima,
		char *	data,
		size_t	data_len )

◆ BKE_image_paint_set_mipmap()

void BKE_image_paint_set_mipmap	(	Main *	bmain,
		bool	mipmap )

Called on entering and exiting texture paint mode, temporary disabling/enabling mipmapping on all images for quick texture updates with glTexSubImage2D. images that didn't change don't have to be re-uploaded to OpenGL.

Definition at line 920 of file image_gpu.cc.

References BKE_image_free_gputextures(), BKE_image_has_opengl_texture(), ELEM, GPU_texture_mipmap_mode(), IMA_GPU_MIPMAP_COMPLETE, Main::images, LISTBASE_FOREACH, TEXTARGET_2D, TEXTARGET_2D_ARRAY, and TEXTARGET_COUNT.

Referenced by ED_object_texture_paint_mode_enter_ex(), and ED_object_texture_paint_mode_exit_ex().

◆ BKE_image_partial_update_create()

PartialUpdateUser * BKE_image_partial_update_create ( const Image * image )

Create a new PartialUpdateUser. An Object that contains data to use partial updates.

Definition at line 544 of file image_partial_update.cc.

References UNUSED_VARS, and blender::bke::image::partial_update::wrap().

Referenced by image_get_gpu_texture(), and blender::bke::image::partial_update::ImagePartialUpdateTest::SetUp().

◆ BKE_image_partial_update_free()

void BKE_image_partial_update_free ( PartialUpdateUser * user )

free a partial update user.

Definition at line 559 of file image_partial_update.cc.

References blender::bke::image::partial_update::unwrap().

Referenced by image_runtime_free_data(), and blender::bke::image::partial_update::ImagePartialUpdateTest::TearDown().

◆ BKE_image_partial_update_mark_full_update()

void BKE_image_partial_update_mark_full_update ( Image * image )

Mark the whole image to be updated.

Definition at line 587 of file image_partial_update.cc.

References blender::bke::image::partial_update::image_partial_update_register_ensure(), blender::bke::image::partial_update::PartialUpdateRegisterImpl::mark_full_update(), and blender::bke::image::partial_update::unwrap().

Referenced by blender::bke::pbvh::pixels::apply_watertight_check(), blender::ed::object::bake_targets_refresh(), BKE_image_acquire_renderresult(), BKE_image_add_tile(), BKE_image_ensure_gpu_texture(), BKE_image_reassign_tile(), BKE_image_signal(), BKE_image_update_gputexture_delayed(), BKE_image_user_frame_calc(), current_scene_update(), ED_image_slot_cycle(), image_flip_exec(), image_free_tile(), image_invert_exec(), image_listener(), image_rotate_orthogonal_exec(), image_scale_exec(), image_tag_reload(), imapaint_image_update(), blender::bke::pbvh::pixels::NodeData::mark_region(), blender::ed::object::multiresbake_freejob(), blender::render::Context::output_to_render_result(), screen_opengl_render_apply(), blender::bke::image::partial_update::TEST_F(), uhandle_restore_list(), update_image_from_plane_marker_exec(), and blender::render::Context::viewer_output_to_viewer_image().

◆ BKE_image_partial_update_mark_region()

void BKE_image_partial_update_mark_region	(	Image *	image,
		const ImageTile *	image_tile,
		const ImBuf *	image_buffer,
		const rcti *	updated_region )

Mark a region of the image to update.

Definition at line 577 of file image_partial_update.cc.

References blender::bke::image::partial_update::image_partial_update_register_ensure(), blender::bke::image::partial_update::PartialUpdateRegisterImpl::mark_region(), blender::bke::image::partial_update::unwrap(), and blender::bke::image::partial_update::PartialUpdateRegisterImpl::update_resolution().

Referenced by BKE_image_update_gputexture_delayed(), blender::bke::pbvh::pixels::NodeData::mark_region(), blender::bke::image::partial_update::TEST_F(), blender::bke::image::partial_update::TEST_F(), blender::bke::image::partial_update::TEST_F(), blender::bke::image::partial_update::TEST_F(), blender::bke::image::partial_update::TEST_F(), blender::bke::image::partial_update::TEST_F(), and blender::bke::image::partial_update::TEST_F().

◆ BKE_image_partial_update_register_free()

void BKE_image_partial_update_register_free ( Image * image )

Definition at line 567 of file image_partial_update.cc.

References blender::bke::image::partial_update::unwrap().

Referenced by image_runtime_free_data().

◆ BKE_image_pool_acquire_ibuf()

ImBuf * BKE_image_pool_acquire_ibuf	(	Image *	ima,
		ImageUser *	iuser,
		ImagePool *	pool )

◆ BKE_image_pool_free()

void BKE_image_pool_free ( ImagePool * pool )

Definition at line 4994 of file source/blender/blenkernel/intern/image.cc.

References BLI_mempool_destroy(), ListBase::first, ImagePool::image_buffers, IMB_freeImBuf(), lock, ImagePool::memory_pool, ImagePool::mutex, and ImagePoolItem::next.

Referenced by brush_painter_2d_refresh_cache(), displaceModifier_do(), dynamicPaint_setInitialColor(), blender::ed::sculpt_paint::load_tex(), project_paint_op(), shader_preview_texture(), and SculptSession::~SculptSession().

◆ BKE_image_pool_new()

ImagePool * BKE_image_pool_new ( )

Definition at line 4987 of file source/blender/blenkernel/intern/image.cc.

References BLI_mempool_create(), BLI_MEMPOOL_NOP, and ImagePool::memory_pool.

Referenced by brush_init_tex(), brush_painter_2d_refresh_cache(), blender::compositor::CachedTexture::CachedTexture(), displaceModifier_do(), blender::ed::sculpt_paint::expand::ensure_sculptsession_data(), blender::ed::sculpt_paint::load_tex(), project_paint_op(), and shader_preview_texture().

◆ BKE_image_pool_release_ibuf()

void BKE_image_pool_release_ibuf	(	Image *	ima,
		ImBuf *	ibuf,
		ImagePool *	pool )

Definition at line 5080 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_release_ibuf().

Referenced by image_sample(), imagewrap(), imagewraposa(), imagewraposa_aniso(), blender::ed::sculpt_paint::load_tex_task_cb_ex(), multitex_nodes_intern(), and blender::ed::sculpt_paint::paint_stroke_new().

◆ BKE_image_preview()

ImBuf * BKE_image_preview	(	Image *	ima,
		short	max_size,
		short *	r_width,
		short *	r_height )

Return image buffer of preview for given image r_width & r_height are optional and return the original size of the image.

Definition at line 4942 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_acquire_ibuf(), BKE_image_release_ibuf(), Box, IMB_byte_from_float(), IMB_dupImBuf(), IMB_scale(), lock, ImBuf::x, and ImBuf::y.

Referenced by ui_tooltip_from_image().

◆ BKE_image_print_memlist()

void BKE_image_print_memlist ( Main * bmain )

Prints memory statistics for images.

Definition at line 1575 of file source/blender/blenkernel/intern/image.cc.

References ListBase::first, Image::id, image_mem_size(), Main::images, ID::name, ID::next, printf, and size().

◆ BKE_image_reassign_tile()

void BKE_image_reassign_tile	(	Image *	ima,
		ImageTile *	tile,
		int	new_tile_number )

Definition at line 3547 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_is_multiview(), BKE_image_partial_update_mark_full_update(), BLI_listbase_count(), GPU_texture_free(), Image::gputexture, i, IMA_SRC_TILED, IMA_UDIM_MAX, image_assign_ibuf(), image_get_cached_ibuf_for_index_entry(), image_remove_ibuf(), IMB_freeImBuf(), Image::source, TEXTARGET_2D_ARRAY, TEXTARGET_TILE_MAPPING, tile, and Image::views.

◆ BKE_image_release_ibuf()

void BKE_image_release_ibuf	(	Image *	ima,
		ImBuf *	ibuf,
		void *	lock )

Definition at line 4901 of file source/blender/blenkernel/intern/image.cc.

References BLI_thread_unlock(), IMB_freeImBuf(), lock, LOCK_VIEWER, RE_ReleaseResultImage(), and Image::runtime.

◆ BKE_image_release_renderresult()

void BKE_image_release_renderresult	(	Scene *	scene,
		Image *	ima,
		RenderResult *	render_result )

◆ BKE_image_remove_renderslot()

bool BKE_image_remove_renderslot	(	Image *	ima,
		ImageUser *	iuser,
		int	slot )

Definition at line 5689 of file source/blender/blenkernel/intern/image.cc.

References BLI_findindex(), BLI_findlink(), BLI_listbase_count(), BLI_remlink(), G, Image::last_render_slot, MEM_freeN(), RE_FreeRenderResult(), RE_GetSceneRender(), RE_SwapResult(), RenderSlot::render, Image::render_slot, Image::renderslots, and ImageUser::scene.

Referenced by image_remove_render_slot_exec().

◆ BKE_image_remove_tile()

bool BKE_image_remove_tile	(	Image *	ima,
		ImageTile *	tile )

Definition at line 3538 of file source/blender/blenkernel/intern/image.cc.

References IMA_SRC_TILED, image_remove_tile(), Image::source, and tile.

Referenced by BKE_image_signal(), and tile_remove_exec().

◆ BKE_image_replace_imbuf()

void BKE_image_replace_imbuf	(	Image *	image,
		ImBuf *	ibuf )

For a non-viewer single-buffer image (single frame file, or generated image) replace its image buffer with the given one. If an unsupported image type (multi-layer, image sequence, ...) the function will assert in the debug mode and will have an undefined behavior in the release mode.

Definition at line 1354 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_free_buffers, BKE_image_mark_dirty(), BLI_assert, ImBufFloatBuffer::data, ELEM, ImBuf::float_buffer, IMA_GEN_FLOAT, IMA_NO_INDEX, IMA_SRC_FILE, IMA_SRC_GENERATED, IMA_TYPE_IMAGE, image_assign_ibuf(), image_colorspace_from_imbuf(), Image::source, Image::type, ImBuf::x, and ImBuf::y.

Referenced by BKE_image_add_from_imbuf(), and update_image_from_plane_marker_exec().

◆ BKE_image_scale()

bool BKE_image_scale	(	Image *	image,
		int	width,
		int	height,
		ImageUser *	iuser )

Scale the image.

Definition at line 781 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_acquire_ibuf(), BKE_image_mark_dirty(), BKE_image_release_ibuf(), Box, IMB_scale(), and lock.

Referenced by blender::io::usd::process_usdz_textures().

◆ BKE_image_sequence_guess_offset()

int BKE_image_sequence_guess_offset ( Image * image )

Guess offset for the first frame in the sequence.

Definition at line 5433 of file source/blender/blenkernel/intern/image.cc.

References BLI_path_sequence_decode(), and Image::filepath.

Referenced by BKE_image_find_nearest_tile_with_offset(), cmp_node_image_create_outputs(), and cryptomatte_init_from_node_image().

◆ BKE_image_set_filepath_from_tile_number()

void BKE_image_set_filepath_from_tile_number	(	char *	filepath,
		const char *	pattern,
		eUDIM_TILE_FORMAT	tile_format,
		int	tile_number )

Definition at line 3748 of file source/blender/blenkernel/intern/image.cc.

References BLI_snprintf(), FILE_MAX, UDIM_TILE_FORMAT_UDIM, UDIM_TILE_FORMAT_UVTILE, and v.

Referenced by BKE_image_save(), BKE_image_signal(), BKE_image_user_file_path_ex(), blender::io::usd::copy_tiled_textures(), blender::io::usd::export_in_memory_texture(), image_foreach_path(), and blender::bke::tests::TEST().

◆ BKE_image_signal()

void BKE_image_signal	(	Main *	bmain,
		Image *	ima,
		ImageUser *	iuser,
		int	signal )

Definition at line 3173 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_add_tile(), BKE_image_ensure_tile_token(), BKE_image_free_buffers, BKE_image_get_tile, BKE_image_get_tile_info(), BKE_image_get_tile_strformat(), BKE_image_has_packedfile(), BKE_image_init_imageuser(), BKE_image_is_filename_tokenized(), BKE_image_packfiles(), BKE_image_partial_update_mark_full_update(), BKE_image_remove_tile(), BKE_image_set_filepath_from_tile_number(), BKE_image_walk_all_users(), BKE_ntree_update(), BKE_ntree_update_tag_id_changed(), BKE_packedfile_free(), BKE_packedfile_new(), BLI_freelistN(), BLI_listbase_count(), BLI_listbase_count_is_equal_to(), BLI_path_abs(), BLI_path_is_rel(), BLI_path_rel(), ELEM, FILE_MAX, Image::filepath, ImageTile::gen_flag, ImageTile::gen_x, ImageTile::gen_y, Image::id, ID_BLEND_PATH, ID_BLEND_PATH_FROM_GLOBAL, IMA_GEN_TILE, IMA_NO_INDEX, IMA_SIGNAL_COLORMANAGE, IMA_SIGNAL_FREE, IMA_SIGNAL_RELOAD, IMA_SIGNAL_SRC_CHANGE, IMA_SIGNAL_USER_NEW_IMAGE, IMA_SRC_FILE, IMA_SRC_GENERATED, IMA_SRC_SEQUENCE, IMA_SRC_TILED, IMA_TYPE_IMAGE, IMA_TYPE_MULTILAYER, IMA_TYPE_UV_TEST, image_free_packedfiles(), image_get_cached_ibuf_for_index_entry(), image_num_viewfiles(), image_remove_all_tiles(), image_tag_frame_recalc(), image_tag_reload(), image_update_views_format(), IMB_freeImBuf(), LISTBASE_FOREACH, MEM_freeN(), Image::packedfiles, pf, POINTER_AS_INT, printf, result, Image::runtime, ImageUser::scene, Image::source, STRNCPY(), ImageTile::tile_number, Image::tiles, Image::type, ImBuf::x, and ImBuf::y.

Referenced by BKE_image_save(), BKE_packedfile_unpack_image(), ED_space_image_auto_set(), ED_space_image_set(), image_clipboard_paste_exec(), image_foreach_path(), image_new_exec(), image_open_exec(), image_reload_exec(), image_replace_exec(), blender::ed::space_node::node_add_image_exec(), blender::render::Context::output_to_render_result(), proj_paint_add_slot(), screen_opengl_render_init(), screen_render_exec(), and screen_render_invoke().

◆ BKE_image_sort_tiles()

void BKE_image_sort_tiles ( Image * ima )

Definition at line 3597 of file source/blender/blenkernel/intern/image.cc.

References BLI_listbase_sort(), IMA_SRC_TILED, Image::source, tile_sort_cb(), and Image::tiles.

Referenced by gpu_texture_create_tile_mapping(), and tile_add_exec().

◆ BKE_image_stamp_buf()

void BKE_image_stamp_buf	(	Scene *	scene,
		Object *	camera,
		const StampData *	stamp_data_template,
		unsigned char *	rect,
		float *	rectf,
		int	width,
		int	height )

Definition at line 2004 of file source/blender/blenkernel/intern/image.cc.

References RenderData::bg_stamp, BLF_buffer(), BLF_buffer_col(), BLF_descender(), BLF_disable(), BLF_draw_buffer(), BLF_enable(), BLF_height_max(), blf_mono_font_render, BLF_position(), BLF_size(), BLF_width_max(), BLF_WORD_WRAP, BLF_wordwrap(), buf_rectfill_area(), BUFF_MARGIN_X, BUFF_MARGIN_Y, StampData::camera, StampData::cameralens, StampData::date, ColorManagedDisplaySettings::display_device, Scene::display_settings, RenderData::fg_stamp, StampData::file, StampData::frame, StampData::frame_range, StampData::hostname, IMB_colormanagement_display_get_named(), StampData::marker, StampData::memory, StampData::note, pad, Scene::r, R_STAMP_HIDE_LABELS, StampData::rendertime, StampData::scene, RenderData::stamp, RenderData::stamp_font_id, stampdata(), stampdata_from_template(), StampData::strip, TEXT_SIZE_CHECK, TEXT_SIZE_CHECK_WORD_WRAP, StampData::time, w(), wrap(), x, and y.

Referenced by renderresult_stampinfo(), and screen_opengl_render_doit().

◆ BKE_image_tag_time()

void BKE_image_tag_time ( Image * ima )

Definition at line 1536 of file source/blender/blenkernel/intern/image.cc.

References BLI_time_now_seconds_i(), and Image::lastused.

Referenced by image_acquire_ibuf(), image_get_gpu_texture(), image_init_after_load(), and multitex().

◆ BKE_image_tile_filepath_exists()

bool BKE_image_tile_filepath_exists ( const char * filepath )

When provided with an absolute virtual filepath, check to see if at least one concrete file exists. NOTE: This function requires directory traversal and may be inefficient in time-critical, or iterative, code paths.

Definition at line 3665 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_get_tile_number_from_filepath(), BKE_image_get_tile_strformat(), BLI_assert, BLI_filelist_dir_contents(), BLI_filelist_free(), BLI_path_is_rel(), BLI_path_split_dir_part(), dirname(), FILE_MAXDIR, i, IMA_UDIM_MAX, and MEM_SAFE_FREE.

Referenced by BKE_image_load_in_lib().

◆ BKE_image_update_gputexture()

void BKE_image_update_gputexture	(	Image *	ima,
		ImageUser *	iuser,
		int	x,
		int	y,
		int	w,
		int	h )

Partial update of texture for texture painting. This is often much quicker than fully updating the texture for high resolution images.

Definition at line 896 of file image_gpu.cc.

References BKE_image_acquire_ibuf(), BKE_image_get_tile_from_iuser, BKE_image_release_ibuf(), BKE_image_update_gputexture_delayed(), w(), x, and y.

Referenced by imapaint_image_update().

◆ BKE_image_update_gputexture_delayed()

void BKE_image_update_gputexture_delayed	(	Image *	ima,
		ImageTile *	image_tile,
		ImBuf *	ibuf,
		int	x,
		int	y,
		int	w,
		int	h )

Mark areas on the #GPUTexture that needs to be updated. The areas are marked in chunks. The next time the #GPUTexture is used these tiles will be refreshes. This saves time when writing to the same place multiple times This happens for during foreground rendering.

Definition at line 904 of file image_gpu.cc.

References BKE_image_partial_update_mark_full_update(), BKE_image_partial_update_mark_region(), BLI_rcti_init(), IMA_SRC_TILED, Image::source, w(), ImBuf::x, x, ImBuf::y, and y.

Referenced by BKE_image_update_gputexture(), and image_rect_update().

◆ BKE_image_user_file_path()

void BKE_image_user_file_path	(	const ImageUser *	iuser,
		const Image *	ima,
		char *	filepath )

Definition at line 5261 of file source/blender/blenkernel/intern/image.cc.

References BKE_image_user_file_path_ex(), and G_MAIN.

Referenced by BKE_image_memorypack(), BKE_image_packfiles(), image_file_browse_invoke(), image_init_color_management(), load_image_single(), and load_movie_single().

◆ BKE_image_user_file_path_ex()

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 )