blender::imbuf Namespace Reference

Namespaces
namespace	tests
namespace	transform

Classes
class	ImBufMemWriter
struct	ReadContext
struct	WriteContext

Functions
uchar4	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)
uchar4	interpolate_nearest_wrap_byte (const ImBuf *in, float u, float v)
float4	interpolate_nearest_wrap_fl (const ImBuf *in, float u, float v)
uchar4	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)
uchar4	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)
uchar4	interpolate_bilinear_wrap_byte (const ImBuf *in, float u, float v)
float4	interpolate_bilinear_wrap_fl (const ImBuf *in, float u, float v)
uchar4	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)
uchar4	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_colorspace_name (char colorspace[IM_MAX_SPACE], const ReadContext &ctx, const ImageSpec &spec, bool is_float)
static ImBuf *	get_oiio_ibuf (ImageInput *in, const ReadContext &ctx, char colorspace[IM_MAX_SPACE])
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, char colorspace[IM_MAX_SPACE], 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, char colorspace[IM_MAX_SPACE], 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 >

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

static

Definition at line 73 of file openimageio_support.cc.

Referenced by load_pixels().

get_oiio_ibuf()

static ImBuf * blender::imbuf::get_oiio_ibuf ( ImageInput * in, const ReadContext & ctx, char colorspace[IM_MAX_SPACE] )

static

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

Definition at line 178 of file openimageio_support.cc.

References ELEM, blender::imbuf::ReadContext::file_type, blender::imbuf::ReadContext::flags, ImBuf::flags, ImBuf::ftype, IB_halffloat, IB_metadata, IMB_metadata_ensure(), IMB_metadata_set_field(), load_pixels(), ImBuf::metadata, IDProperty::name, ImBuf::ppm, set_colorspace_name(), and blender::imbuf::ReadContext::use_all_planes.

Referenced by imb_oiio_read().

get_oiio_reader()

static 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 246 of file openimageio_support.cc.

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 351 of file openimageio_support.cc.

References ImBuf::byte_buffer, ImBuf::channels, ImBufByteBuffer::data, ImBufFloatBuffer::data, blender::imbuf::WriteContext::file_format, ImBuf::flags, float, ImBuf::float_buffer, 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.

Definition at line 385 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, 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_create_write_spec() [2/2]

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.

Definition at line 385 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, 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 267 of file openimageio_support.cc.

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,
		char	colorspace[IM_MAX_SPACE],
		ImageSpec &	r_newspec )

Definition at line 277 of file openimageio_support.cc.

References blender::imbuf::ReadContext::file_format, get_oiio_ibuf(), get_oiio_reader(), 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,
		char	colorspace[IM_MAX_SPACE],
		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 292 of file openimageio_support.cc.

References ImBuf::channels, blender::imbuf::WriteContext::file_format, blender::imbuf::WriteContext::flags, 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, and blender::imbuf::WriteContext::mem_ystride.

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]

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

inlinenodiscard

Definition at line 74 of file IMB_interp.hh.

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

Referenced by blender::render::texturemargin::TextureMarginMap::lookup_pixels(), and 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, blender::math::interpolate_bilinear_border_byte(), 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, blender::math::interpolate_bilinear_border_fl(), 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 blender::math::interpolate_bilinear_border_fl(), and v.

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

interpolate_bilinear_byte() [1/2]

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

inlinenodiscard

Definition at line 53 of file IMB_interp.hh.

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

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

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, blender::math::interpolate_bilinear_byte(), 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, blender::math::interpolate_bilinear_fl(), 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 blender::math::interpolate_bilinear_fl(), and v.

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

interpolate_bilinear_wrap_byte()

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

inlinenodiscard

Definition at line 95 of file IMB_interp.hh.

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

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 blender::math::interpolate_bilinear_wrap_fl(), and v.

interpolate_cubic_bspline_byte() [1/2]

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

inlinenodiscard

Definition at line 106 of file IMB_interp.hh.

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

Referenced by do_projectpaint_thread(), blender::imbuf::transform::sample_image(), and 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, blender::math::interpolate_cubic_bspline_byte(), 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, blender::math::interpolate_cubic_bspline_fl(), 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 blender::math::interpolate_cubic_bspline_fl(), and v.

Referenced by do_projectpaint_thread(), and transform_image().

interpolate_cubic_mitchell_byte() [1/2]

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

inlinenodiscard

Definition at line 127 of file IMB_interp.hh.

References 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, blender::math::interpolate_cubic_mitchell_byte(), and v.

interpolate_nearest_border_byte() [1/2]

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

inlinenodiscard

Definition at line 23 of file IMB_interp.hh.

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

Referenced by blender::imbuf::transform::sample_image(), and 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 blender::math::interpolate_nearest_border_byte(), 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 blender::math::interpolate_nearest_border_fl(), 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 blender::math::interpolate_nearest_border_fl(), and v.

Referenced by studiolight_calculate_radiance(), and transform_image().

interpolate_nearest_wrap_byte()

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

inlinenodiscard

Definition at line 42 of file IMB_interp.hh.

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

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 blender::math::interpolate_nearest_wrap_fl(), and v.

load_pixels()

template<typename T >

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

static

Definition at line 98 of file openimageio_support.cc.

References ImBuf::byte_buffer, channels(), ImBufByteBuffer::data, ImBufFloatBuffer::data, fill_all_channels(), ImBuf::float_buffer, IB_rect, IB_rectfloat, IB_test, IB_uninitialized_pixels, IMB_allocImBuf(), IMB_freeImBuf(), and T.

Referenced by get_oiio_ibuf().

set_colorspace_name()

static void blender::imbuf::set_colorspace_name ( char colorspace[IM_MAX_SPACE], const ReadContext & ctx, const ImageSpec & spec, bool is_float )

static

Definition at line 141 of file openimageio_support.cc.

References BLI_strncpy(), COLOR_ROLE_DEFAULT_BYTE, COLOR_ROLE_DEFAULT_FLOAT, colormanage_colorspace_get_named(), colorspace_set_default_role(), IM_MAX_SPACE, STRNCPY, blender::imbuf::ReadContext::use_colorspace_role, and blender::imbuf::ReadContext::use_embedded_colorspace.

Referenced by get_oiio_ibuf().