blender::imbuf Namespace Reference

Namespaces
namespace	transform
namespace	tests

Classes
class	ImBufMemWriter
struct	ReadContext
struct	WriteContext

Functions
uchar4uchar4	interpolate_nearest_border_byte (const ImBuf *in, float u, float v)
float4	interpolate_nearest_border_fl (const ImBuf *in, float u, float v)
void	interpolate_nearest_border_byte (const ImBuf *in, uchar output[4], float u, float v)
void	interpolate_nearest_border_fl (const ImBuf *in, float output[4], float u, float v)
uchar4uchar4	interpolate_nearest_wrap_byte (const ImBuf *in, float u, float v)
float4	interpolate_nearest_wrap_fl (const ImBuf *in, float u, float v)
uchar4uchar4	interpolate_bilinear_byte (const ImBuf *in, float u, float v)
float4	interpolate_bilinear_fl (const ImBuf *in, float u, float v)
void	interpolate_bilinear_byte (const ImBuf *in, uchar output[4], float u, float v)
void	interpolate_bilinear_fl (const ImBuf *in, float output[4], float u, float v)
uchar4uchar4	interpolate_bilinear_border_byte (const ImBuf *in, float u, float v)
float4	interpolate_bilinear_border_fl (const ImBuf *in, float u, float v)
void	interpolate_bilinear_border_byte (const ImBuf *in, uchar output[4], float u, float v)
void	interpolate_bilinear_border_fl (const ImBuf *in, float output[4], float u, float v)
uchar4uchar4	interpolate_bilinear_wrap_byte (const ImBuf *in, float u, float v)
float4	interpolate_bilinear_wrap_fl (const ImBuf *in, float u, float v)
uchar4uchar4	interpolate_cubic_bspline_byte (const ImBuf *in, float u, float v)
float4	interpolate_cubic_bspline_fl (const ImBuf *in, float u, float v)
void	interpolate_cubic_bspline_byte (const ImBuf *in, uchar output[4], float u, float v)
void	interpolate_cubic_bspline_fl (const ImBuf *in, float output[4], float u, float v)
uchar4uchar4	interpolate_cubic_mitchell_byte (const ImBuf *in, float u, float v)
void	interpolate_cubic_mitchell_byte (const ImBuf *in, uchar output[4], float u, float v)
template<typename T>
static void	fill_all_channels (T *pixels, int width, int height, int components, T alpha)
template<typename T>
static ImBuf *	load_pixels (ImageInput *in, int width, int height, int channels, int flags, bool use_all_planes)
static void	set_file_colorspace (ImFileColorSpace &r_colorspace, const ReadContext &ctx, const ImageSpec &spec, bool is_float)
static ImBuf *	get_oiio_ibuf (ImageInput *in, const ReadContext &ctx, ImFileColorSpace &r_colorspace)
static unique_ptr< ImageInput >	get_oiio_reader (const char *format, const ImageSpec &config, Filesystem::IOMemReader &mem_reader, ImageSpec &r_newspec)
bool	imb_oiio_check (const uchar *mem, size_t mem_size, const char *file_format)
ImBuf *	imb_oiio_read (const ReadContext &ctx, const ImageSpec &config, ImFileColorSpace &r_colorspace, ImageSpec &r_newspec)
bool	imb_oiio_write (const WriteContext &ctx, const char *filepath, const ImageSpec &file_spec)
WriteContext	imb_create_write_context (const char *file_format, ImBuf *ibuf, int flags, bool prefer_float)
ImageSpec	imb_create_write_spec (const WriteContext &ctx, int file_channels, TypeDesc data_format)
ImBuf *	imb_oiio_read (const ReadContext &ctx, const OIIO::ImageSpec &config, ImFileColorSpace &r_colorspace, OIIO::ImageSpec &r_newspec)
bool	imb_oiio_write (const WriteContext &ctx, const char *filepath, const OIIO::ImageSpec &file_spec)
OIIO::ImageSpec	imb_create_write_spec (const WriteContext &ctx, int file_channels, OIIO::TypeDesc data_format)

Function Documentation

fill_all_channels()

template<typename T>

void blender::imbuf::fill_all_channels ( T * pixels, int width, int height, int components, T alpha )

static

Definition at line 75 of file openimageio_support.cc.

References i, and T.

Referenced by load_pixels().

get_oiio_ibuf()

ImBuf * blender::imbuf::get_oiio_ibuf ( ImageInput * in, const ReadContext & ctx, ImFileColorSpace & r_colorspace )

static

Get an ImBuf filled in with pixel data and associated metadata using the provided ImageInput.

Definition at line 161 of file openimageio_support.cc.

References ELEM, blender::imbuf::ReadContext::file_type, ImbFormatOptions::flag, blender::imbuf::ReadContext::flags, ImBuf::flags, ImBuf::foptions, ImBuf::ftype, IB_metadata, IMB_metadata_ensure(), IMB_metadata_set_field(), in, load_pixels(), ImBuf::metadata, IDProperty::name, OPENEXR_HALF, ImBuf::ppm, set_file_colorspace(), and blender::imbuf::ReadContext::use_all_planes.

Referenced by imb_oiio_read().

get_oiio_reader()

unique_ptr< ImageInput > blender::imbuf::get_oiio_reader ( const char * format, const ImageSpec & config, Filesystem::IOMemReader & mem_reader, ImageSpec & r_newspec )

static

Returns an #ImageInput for the precise format requested using the provided #IOMemReader. If successful, the #ImageInput will be opened and ready for operations. Null will be returned if the format was not found or if the open call fails.

Definition at line 235 of file openimageio_support.cc.

References in.

Referenced by imb_oiio_read().

imb_create_write_context()

WriteContext blender::imbuf::imb_create_write_context	(	const char *	file_format,
		ImBuf *	ibuf,
		int	flags,
		bool	prefer_float = true )

Create a WriteContext based on the provided ImBuf and format information.

If the provided ImBuf contains both byte and float buffers, the prefer_float flag controls which buffer to use. By default, if a float buffer exists it will be used.

Definition at line 365 of file openimageio_support.cc.

References ImBuf::byte_buffer, ImBuf::channels, ImBufByteBuffer::data, ImBufFloatBuffer::data, blender::imbuf::WriteContext::file_format, blender::imbuf::WriteContext::flags, ImBuf::float_buffer, blender::imbuf::WriteContext::ibuf, blender::imbuf::WriteContext::mem_spec, blender::imbuf::WriteContext::mem_start, blender::imbuf::WriteContext::mem_xstride, blender::imbuf::WriteContext::mem_ystride, ImBuf::x, and ImBuf::y.

Referenced by imb_save_bmp(), imb_save_dpx(), imb_save_hdr(), imb_save_png(), imb_save_tga(), and imb_save_tiff().

imb_create_write_spec() [1/2]

OIIO::ImageSpec blender::imbuf::imb_create_write_spec	(	const WriteContext &	ctx,
		int	file_channels,
		OIIO::TypeDesc	data_format )

Returns an #ImageSpec filled in with all common attributes associated with the ImBuf provided as part of the WriteContext.

This includes optional metadata that has been attached to the ImBuf and which should be written to the new file as necessary.

imb_create_write_spec() [2/2]

ImageSpec blender::imbuf::imb_create_write_spec	(	const WriteContext &	ctx,
		int	file_channels,
		TypeDesc	data_format )

Definition at line 399 of file openimageio_support.cc.

References IDProperty::data, blender::imbuf::WriteContext::file_format, IDPropertyData::group, blender::imbuf::WriteContext::ibuf, IDP_STRING, IDP_String, LISTBASE_FOREACH, ImBuf::metadata, ImBuf::ppm, round, STREQ, ImBuf::x, and ImBuf::y.

Referenced by imb_save_bmp(), imb_save_dpx(), imb_save_hdr(), imb_save_png(), imb_save_tga(), and imb_save_tiff().

imb_oiio_check()

bool blender::imbuf::imb_oiio_check	(	const uchar *	mem,
		size_t	mem_size,
		const char *	file_format )

Check to see if we can load and open the given file format.

Definition at line 256 of file openimageio_support.cc.

References in.

Referenced by imb_is_a_bmp(), imb_is_a_dds(), imb_is_a_dpx(), imb_is_a_hdr(), imb_is_a_png(), imb_is_a_psd(), imb_is_a_tga(), and imb_is_a_tiff().

imb_oiio_read() [1/2]

ImBuf * blender::imbuf::imb_oiio_read	(	const ReadContext &	ctx,
		const ImageSpec &	config,
		ImFileColorSpace &	r_colorspace,
		ImageSpec &	r_newspec )

Definition at line 266 of file openimageio_support.cc.

References blender::imbuf::ReadContext::file_format, get_oiio_ibuf(), get_oiio_reader(), in, blender::imbuf::ReadContext::mem_size, and blender::imbuf::ReadContext::mem_start.

Referenced by imb_load_bmp(), imb_load_dds(), imb_load_dpx(), imb_load_hdr(), imb_load_png(), imb_load_psd(), imb_load_tga(), and imb_load_tiff().

imb_oiio_read() [2/2]

ImBuf * blender::imbuf::imb_oiio_read	(	const ReadContext &	ctx,
		const OIIO::ImageSpec &	config,
		ImFileColorSpace &	r_colorspace,
		OIIO::ImageSpec &	r_newspec )

The primary method for reading data into an ImBuf.

During the IB_test phase of loading, the colorspace parameter will be populated with the appropriate colorspace name.

Upon return, the r_newspec parameter will contain image format information which can be inspected afterwards if necessary.

imb_oiio_write() [1/2]

bool blender::imbuf::imb_oiio_write	(	const WriteContext &	ctx,
		const char *	filepath,
		const ImageSpec &	file_spec )

Definition at line 281 of file openimageio_support.cc.

References blender::imbuf::WriteContext::file_format, blender::imbuf::WriteContext::flags, i, IB_mem, blender::imbuf::WriteContext::ibuf, imb_addencodedbufferImBuf(), IMB_colormanagement_get_luminance_coefficients(), blender::imbuf::WriteContext::mem_spec, blender::imbuf::WriteContext::mem_start, blender::imbuf::WriteContext::mem_xstride, blender::imbuf::WriteContext::mem_ystride, and out.

Referenced by imb_save_bmp(), imb_save_dpx(), imb_save_hdr(), imb_save_png(), imb_save_tga(), and imb_save_tiff().

imb_oiio_write() [2/2]

bool blender::imbuf::imb_oiio_write	(	const WriteContext &	ctx,
		const char *	filepath,
		const OIIO::ImageSpec &	file_spec )

The primary method for writing data from an ImBuf to either a physical or in-memory destination.

The file_spec parameter will typically come from imb_create_write_spec.

interpolate_bilinear_border_byte() [1/2]

uchar4uchar4 blender::imbuf::interpolate_bilinear_border_byte ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 74 of file IMB_interp.hh.

References in, blender::math::interpolate_bilinear_border_byte(), and v.

Referenced by blender::render::texturemargin::TextureMarginMap::lookup_pixels(), tracking_stabilize_frame_interpolation_cb(), and blender::seq::transform_image().

interpolate_bilinear_border_byte() [2/2]

void blender::imbuf::interpolate_bilinear_border_byte ( const ImBuf * in, uchar output[4], float u, float v )

inline

Definition at line 82 of file IMB_interp.hh.

References col, in, blender::math::interpolate_bilinear_border_byte(), output, and v.

interpolate_bilinear_border_fl() [1/2]

void blender::imbuf::interpolate_bilinear_border_fl ( const ImBuf * in, float output[4], float u, float v )

inline

Definition at line 87 of file IMB_interp.hh.

References col, in, blender::math::interpolate_bilinear_border_fl(), output, and v.

interpolate_bilinear_border_fl() [2/2]

float4 blender::imbuf::interpolate_bilinear_border_fl ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 78 of file IMB_interp.hh.

References in, blender::math::interpolate_bilinear_border_fl(), and v.

Referenced by blender::render::texturemargin::TextureMarginMap::lookup_pixels(), tracking_stabilize_frame_interpolation_cb(), and blender::seq::transform_image().

interpolate_bilinear_byte() [1/2]

uchar4uchar4 blender::imbuf::interpolate_bilinear_byte ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 53 of file IMB_interp.hh.

References in, blender::math::interpolate_bilinear_byte(), and v.

Referenced by blender::imbuf::transform::sample_image(), and scale_bilinear_func().

interpolate_bilinear_byte() [2/2]

void blender::imbuf::interpolate_bilinear_byte ( const ImBuf * in, uchar output[4], float u, float v )

inline

Definition at line 61 of file IMB_interp.hh.

References col, in, blender::math::interpolate_bilinear_byte(), output, and v.

interpolate_bilinear_fl() [1/2]

void blender::imbuf::interpolate_bilinear_fl ( const ImBuf * in, float output[4], float u, float v )

inline

Definition at line 66 of file IMB_interp.hh.

References col, in, blender::math::interpolate_bilinear_fl(), output, and v.

interpolate_bilinear_fl() [2/2]

float4 blender::imbuf::interpolate_bilinear_fl ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 57 of file IMB_interp.hh.

References in, blender::math::interpolate_bilinear_fl(), and v.

Referenced by blender::imbuf::transform::sample_image().

interpolate_bilinear_wrap_byte()

uchar4uchar4 blender::imbuf::interpolate_bilinear_wrap_byte ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 95 of file IMB_interp.hh.

References in, blender::math::interpolate_bilinear_wrap_byte(), and v.

Referenced by paint_sample_color(), project_face_pixel(), and project_paint_PickColor().

interpolate_bilinear_wrap_fl()

float4 blender::imbuf::interpolate_bilinear_wrap_fl ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 99 of file IMB_interp.hh.

References in, blender::math::interpolate_bilinear_wrap_fl(), and v.

Referenced by paint_sample_color(), project_face_pixel(), and project_paint_PickColor().

interpolate_cubic_bspline_byte() [1/2]

uchar4uchar4 blender::imbuf::interpolate_cubic_bspline_byte ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 106 of file IMB_interp.hh.

References in, blender::math::interpolate_cubic_bspline_byte(), and v.

Referenced by do_projectpaint_thread(), blender::imbuf::transform::sample_image(), tracking_stabilize_frame_interpolation_cb(), and blender::seq::transform_image().

interpolate_cubic_bspline_byte() [2/2]

void blender::imbuf::interpolate_cubic_bspline_byte ( const ImBuf * in, uchar output[4], float u, float v )

inline

Definition at line 114 of file IMB_interp.hh.

References col, in, blender::math::interpolate_cubic_bspline_byte(), output, and v.

interpolate_cubic_bspline_fl() [1/2]

void blender::imbuf::interpolate_cubic_bspline_fl ( const ImBuf * in, float output[4], float u, float v )

inline

Definition at line 119 of file IMB_interp.hh.

References col, in, blender::math::interpolate_cubic_bspline_fl(), output, and v.

interpolate_cubic_bspline_fl() [2/2]

float4 blender::imbuf::interpolate_cubic_bspline_fl ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 110 of file IMB_interp.hh.

References in, blender::math::interpolate_cubic_bspline_fl(), and v.

Referenced by do_projectpaint_thread(), tracking_stabilize_frame_interpolation_cb(), and blender::seq::transform_image().

interpolate_cubic_mitchell_byte() [1/2]

uchar4uchar4 blender::imbuf::interpolate_cubic_mitchell_byte ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 127 of file IMB_interp.hh.

References in, blender::math::interpolate_cubic_mitchell_byte(), and v.

Referenced by blender::imbuf::transform::sample_image().

interpolate_cubic_mitchell_byte() [2/2]

void blender::imbuf::interpolate_cubic_mitchell_byte ( const ImBuf * in, uchar output[4], float u, float v )

inline

Definition at line 131 of file IMB_interp.hh.

References col, in, blender::math::interpolate_cubic_mitchell_byte(), output, and v.

interpolate_nearest_border_byte() [1/2]

uchar4uchar4 blender::imbuf::interpolate_nearest_border_byte ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 23 of file IMB_interp.hh.

References in, blender::math::interpolate_nearest_border_byte(), and v.

Referenced by IMB_sampleImageAtLocation(), blender::imbuf::transform::sample_image(), tracking_stabilize_frame_interpolation_cb(), and blender::seq::transform_image().

interpolate_nearest_border_byte() [2/2]

void blender::imbuf::interpolate_nearest_border_byte ( const ImBuf * in, uchar output[4], float u, float v )

inline

Definition at line 31 of file IMB_interp.hh.

References in, blender::math::interpolate_nearest_border_byte(), output, and v.

interpolate_nearest_border_fl() [1/2]

void blender::imbuf::interpolate_nearest_border_fl ( const ImBuf * in, float output[4], float u, float v )

inline

Definition at line 35 of file IMB_interp.hh.

References in, blender::math::interpolate_nearest_border_fl(), output, and v.

interpolate_nearest_border_fl() [2/2]

float4 blender::imbuf::interpolate_nearest_border_fl ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 27 of file IMB_interp.hh.

References in, blender::math::interpolate_nearest_border_fl(), and v.

Referenced by IMB_sampleImageAtLocation(), studiolight_calculate_radiance(), studiolight_matcap_preview(), tracking_stabilize_frame_interpolation_cb(), and blender::seq::transform_image().

interpolate_nearest_wrap_byte()

uchar4uchar4 blender::imbuf::interpolate_nearest_wrap_byte ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 42 of file IMB_interp.hh.

References in, blender::math::interpolate_nearest_wrap_byte(), and v.

Referenced by paint_sample_color(), and project_paint_PickColor().

interpolate_nearest_wrap_fl()

float4 blender::imbuf::interpolate_nearest_wrap_fl ( const ImBuf * in, float u, float v )

inlinenodiscard

Definition at line 46 of file IMB_interp.hh.

References in, blender::math::interpolate_nearest_wrap_fl(), and v.

Referenced by paint_sample_color(), and project_paint_PickColor().

load_pixels()

template<typename T>

ImBuf * blender::imbuf::load_pixels ( ImageInput * in, int width, int height, int channels, int flags, bool use_all_planes )

static

Definition at line 100 of file openimageio_support.cc.

References ImBuf::byte_buffer, ImBufByteBuffer::data, ImBufFloatBuffer::data, fill_all_channels(), ImBuf::float_buffer, IB_byte_data, IB_float_data, IB_test, IB_uninitialized_pixels, IMB_allocImBuf(), IMB_freeImBuf(), in, and T.

Referenced by get_oiio_ibuf().

set_file_colorspace()

void blender::imbuf::set_file_colorspace ( ImFileColorSpace & r_colorspace, const ReadContext & ctx, const ImageSpec & spec, bool is_float )

static

Definition at line 143 of file openimageio_support.cc.

References ImFileColorSpace::is_hdr_float, ImFileColorSpace::metadata_colorspace, STRNCPY(), and blender::imbuf::ReadContext::use_metadata_colorspace.

Referenced by get_oiio_ibuf().