#include <algorithm>
#include <cstdlib>
#include "BLI_math_base.h"
#include "BLI_math_color.h"
#include "BLI_math_color_blend.h"
#include "BLI_math_vector.h"
#include "BLI_rect.h"
#include "BLI_task.hh"
#include "BLI_utildefines.h"
#include "IMB_imbuf.hh"
#include "IMB_imbuf_types.hh"
#include "IMB_colormanagement.hh"
#include "MEM_guardedalloc.h"
#include <cstring>

Typedefs
using	IMB_blend_func = void ()(uchar dst, const uchar src1, const uchar src2)
using	IMB_blend_func_float = void ()(float dst, const float src1, const float src2)

Functions
void	IMB_blend_color_byte (uchar dst[4], const uchar src1[4], const uchar src2[4], IMB_BlendMode mode)
void	IMB_blend_color_float (float dst[4], const float src1[4], const float src2[4], IMB_BlendMode mode)
void	IMB_rectclip (ImBuf dbuf, const ImBuf sbuf, int destx, int desty, int srcx, int srcy, int width, int height)
static void	imb_rectclip3 (ImBuf dbuf, const ImBuf obuf, const ImBuf sbuf, int destx, int desty, int origx, int origy, int srcx, int srcy, int width, int *height)
void	IMB_rectcpy (ImBuf dbuf, const ImBuf sbuf, int destx, int desty, int srcx, int srcy, int width, int height)
void	IMB_rectblend (ImBuf dbuf, const ImBuf obuf, const ImBuf sbuf, ushort dmask, const ushort curvemask, const ushort texmask, float mask_max, int destx, int desty, int origx, int origy, int srcx, int srcy, int width, int height, IMB_BlendMode mode, bool accumulate)
void	IMB_rectblend_threaded (ImBuf dbuf, const ImBuf obuf, const ImBuf sbuf, ushort dmask, const ushort curvemask, const ushort texmask, float mask_max, int destx, int desty, int origx, int origy, int srcx, int srcy, int width, int height, IMB_BlendMode mode, bool accumulate)
void	IMB_rectfill (ImBuf *drect, const float col[4])
void	IMB_rectfill_area_replace (const ImBuf *ibuf, const float col[4], int x1, int y1, int x2, int y2)
void	buf_rectfill_area (uchar rect, float rectf, int width, int height, const float col[4], const ColorManagedDisplay *display, int x1, int y1, int x2, int y2)
void	IMB_rectfill_area (ImBuf ibuf, const float col[4], int x1, int y1, int x2, int y2, const ColorManagedDisplay display)
void	IMB_rectfill_alpha (ImBuf *ibuf, const float value)
Crop
static void	rect_crop_4bytes (void *buf_p, const int size_src[2], const rcti crop)
static void	rect_crop_16bytes (void *buf_p, const int size_src[2], const rcti crop)
void	IMB_rect_crop (ImBuf ibuf, const rcti crop)
static void	rect_realloc_4bytes (void **buf_p, const uint size[2])
static void	rect_realloc_16bytes (void **buf_p, const uint size[2])
void	IMB_rect_size_set (ImBuf *ibuf, const uint size[2])

Typedef Documentation

◆ IMB_blend_func

using IMB_blend_func = void (*)(uchar *dst, const uchar *src1, const uchar *src2)

Definition at line 473 of file rectop.cc.

◆ IMB_blend_func_float

using IMB_blend_func_float = void (*)(float *dst, const float *src1, const float *src2)

Definition at line 474 of file rectop.cc.

Function Documentation

◆ buf_rectfill_area()

void buf_rectfill_area	(	unsigned char *	rect,
		float *	rectf,
		int	width,
		int	height,
		const float	col[4],
		const ColorManagedDisplay *	display,
		int	x1,
		int	y1,
		int	x2,
		int	y2 )

This should not be here, really, we needed it for operating on render data, IMB_rectfill_area calls it.

Definition at line 1058 of file rectop.cc.

References BLI_assert, CLAMP, col, copy_v4_v4(), fb(), i, IMB_colormanagement_display_to_scene_linear_v3(), srgb_to_linearrgb_v4(), and unit_float_to_uchar_clamp().

Referenced by BKE_image_stamp_buf(), and IMB_rectfill_area().

◆ IMB_blend_color_byte()

void IMB_blend_color_byte	(	uchar	dst[4],
		const uchar	src1[4],
		const uchar	src2[4],
		IMB_BlendMode	mode )

Definition at line 29 of file rectop.cc.

Referenced by do_projectpaint_clone(), do_projectpaint_draw(), do_projectpaint_mask(), do_projectpaint_thread(), paint_2d_bucket_fill(), and paint_2d_gradient_fill().

◆ IMB_blend_color_float()

void IMB_blend_color_float	(	float	dst[4],
		const float	src1[4],
		const float	src2[4],
		IMB_BlendMode	mode )

Definition at line 117 of file rectop.cc.

Referenced by blender::ed::sculpt_paint::expand::colors_update_task(), blender::ed::sculpt_paint::color::do_paint_brush_task(), do_projectpaint_clone_f(), do_projectpaint_draw_f(), do_projectpaint_mask_f(), do_projectpaint_thread(), blender::ed::sculpt_paint::paint::image::PaintingKernel< ImageBuffer >::paint(), paint_2d_bucket_fill(), and paint_2d_gradient_fill().

◆ IMB_rect_crop()

void IMB_rect_crop	(	ImBuf *	ibuf,
		const rcti *	crop )

In-place image crop.

Definition at line 242 of file rectop.cc.

References BLI_assert, BLI_rcti_size_x(), BLI_rcti_size_y(), ImBuf::byte_buffer, ImBufByteBuffer::data, ImBufFloatBuffer::data, ImBuf::float_buffer, rect_crop_16bytes(), rect_crop_4bytes(), ImBuf::x, rcti::xmax, rcti::xmin, ImBuf::y, rcti::ymax, and rcti::ymin.

Referenced by py_imbuf_crop(), screenshot_exec(), blender::ed::asset::screenshot_preview_exec(), and blender::ed::asset::take_screenshot_crop().

◆ IMB_rect_size_set()

void IMB_rect_size_set	(	ImBuf *	ibuf,
		const uint	size[2] )

In-place size setting (caller must fill in buffer contents).

Definition at line 289 of file rectop.cc.

References BLI_assert, ImBuf::byte_buffer, ImBufByteBuffer::data, ImBufFloatBuffer::data, ImBuf::float_buffer, rect_realloc_16bytes(), rect_realloc_4bytes(), size(), ImBuf::x, and ImBuf::y.

Referenced by blender::bke::node_preview_verify(), and ubuf_ensure_compat_ibuf().

◆ IMB_rectblend()

void IMB_rectblend	(	ImBuf *	dbuf,
		const ImBuf *	obuf,
		const ImBuf *	sbuf,
		ushort *	dmask,
		const ushort *	curvemask,
		const ushort *	texmask,
		float	mask_max,
		int	destx,
		int	desty,
		int	origx,
		int	origy,
		int	srcx,
		int	srcy,
		int	width,
		int	height,
		IMB_BlendMode	mode,
		bool	accumulate )

Definition at line 476 of file rectop.cc.

Referenced by IMB_rectblend_threaded(), IMB_rectcpy(), paint_2d_do_making_brush(), paint_2d_lift_clone(), and paint_2d_lift_smear().

◆ IMB_rectblend_threaded()

void IMB_rectblend_threaded	(	ImBuf *	dbuf,
		const ImBuf *	obuf,
		const ImBuf *	sbuf,
		ushort *	dmask,
		const ushort *	curvemask,
		const ushort *	texmask,
		float	mask_max,
		int	destx,
		int	desty,
		int	origx,
		int	origy,
		int	srcx,
		int	srcy,
		int	width,
		int	height,
		IMB_BlendMode	mode,
		bool	accumulate )

Definition at line 939 of file rectop.cc.

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

Referenced by paint_2d_op().

◆ IMB_rectclip()

void IMB_rectclip	(	ImBuf *	dbuf,
		const ImBuf *	sbuf,
		int *	destx,
		int *	desty,
		int *	srcx,
		int *	srcy,
		int *	width,
		int *	height )

Definition at line 308 of file rectop.cc.

References ImBuf::x, and ImBuf::y.

Referenced by brush_painter_imbuf_partial_update(), brush_painter_mask_imbuf_partial_update(), ED_imapaint_dirty_region(), imapaint_region_tiles(), paint_2d_lift_clone(), paint_2d_lift_soften(), paint_2d_torus_split_region(), and blender::ed::sculpt_paint::paint::image::undo_region_tiles().

◆ imb_rectclip3()

void imb_rectclip3	(	ImBuf *	dbuf,
		const ImBuf *	obuf,
		const ImBuf *	sbuf,
		int *	destx,
		int *	desty,
		int *	origx,
		int *	origy,
		int *	srcx,
		int *	srcy,
		int *	width,
		int *	height )

static

Definition at line 362 of file rectop.cc.

References ImBuf::x, and ImBuf::y.

Referenced by IMB_rectblend().

◆ IMB_rectcpy()

void IMB_rectcpy	(	ImBuf *	dbuf,
		const ImBuf *	sbuf,
		int	destx,
		int	desty,
		int	srcx,
		int	srcy,
		int	width,
		int	height )

Definition at line 445 of file rectop.cc.

References IMB_BLEND_COPY, and IMB_rectblend().

Referenced by accessor_get_ibuf(), BKE_tracking_get_search_imbuf(), ED_image_paint_tile_push(), ptile_restore_runtime_map(), RE_layer_load_from_file(), utile_init_from_imbuf(), and utile_restore().

◆ IMB_rectfill()

void IMB_rectfill	(	ImBuf *	drect,
		const float	col[4] )

Replace pixels of entire image with solid color.

Parameters

drect	An image to be filled with color. It must be 4 channel image.
col	RGBA color, which is assigned directly to both byte (via scaling) and float buffers.

Definition at line 979 of file rectop.cc.

References ImBuf::byte_buffer, col, ImBufByteBuffer::data, ImBufFloatBuffer::data, ImBuf::float_buffer, IMB_get_pixel_count(), and num.

Referenced by blender::io::usd::cache_image_color(), blender::ed::object::clear_single_image(), blender::seq::create_missing_media_image(), IMB_font_preview(), IMB_thumb_load_font(), and RE_bake_ibuf_clear().

◆ IMB_rectfill_alpha()

void IMB_rectfill_alpha	(	ImBuf *	ibuf,
		const float	value )

Definition at line 1195 of file rectop.cc.

References ImBuf::byte_buffer, ImBuf::channels, ImBufByteBuffer::data, ImBufFloatBuffer::data, ImBuf::float_buffer, i, and IMB_get_pixel_count().

Referenced by bake_ibuf_filter(), imb_handle_colorspace_and_alpha(), and RE_bake_margin().

◆ IMB_rectfill_area()

void IMB_rectfill_area	(	ImBuf *	ibuf,
		const float	col[4],
		int	x1,
		int	y1,
		int	x2,
		int	y2,
		const ColorManagedDisplay *	display )

Blend pixels of image area with solid color.

For images with uchar buffer use color matching image color-space. For images with float buffer use color display color-space. If display color-space can not be referenced, use color in SRGB color-space.

Parameters

ibuf	an image to be filled with color. It must be 4 channel image.
col	RGBA color.
x1,y1,x2,y2	(x1, y1) defines starting point of the rectangular area to be filled, (x2, y2) is the end point. Note that values are allowed to be loosely ordered, which means that x2 is allowed to be lower than x1, as well as y2 is allowed to be lower than y1. No matter the order the area between x1 and x2, and y1 and y2 is filled.
display	color-space reference for display space.

Definition at line 1172 of file rectop.cc.

References buf_rectfill_area(), ImBuf::byte_buffer, col, ImBufByteBuffer::data, ImBufFloatBuffer::data, ImBuf::float_buffer, ImBuf::x, and ImBuf::y.

Referenced by ui_tooltip_data_from_button_or_extra_icon().

◆ IMB_rectfill_area_replace()

void IMB_rectfill_area_replace	(	const ImBuf *	ibuf,
		const float	col[4],
		int	x1,
		int	y1,
		int	x2,
		int	y2 )

Replace pixels of image area with solid color.

Parameters

ibuf	an image to be filled with color. It must be 4 channel image.
col	RGBA color, which is assigned directly to both byte (via scaling) and float buffers.
x1,y1,x2,y2	(x1, y1) defines starting point of the rectangular area to be filled, (x2, y2) is the end point. Note that values are allowed to be loosely ordered, which means that x2 is allowed to be lower than x1, as well as y2 is allowed to be lower than y1. No matter the order the area between x1 and x2, and y1 and y2 is filled.

Definition at line 1011 of file rectop.cc.

References BLI_assert, ImBuf::byte_buffer, ImBuf::channels, CLAMP, col, ImBufByteBuffer::data, ImBufFloatBuffer::data, ImBuf::float_buffer, ImBuf::x, x, ImBuf::y, and y.