Blender V4.3
IMB_colormanagement.hh File Reference

Go to the source code of this file.

Macros

#define BCM_CONFIG_FILE   "config.ocio"
 

Functions

Generic Functions
void IMB_colormanagement_check_file_config (Main *bmain)
 
void IMB_colormanagement_validate_settings (const ColorManagedDisplaySettings *display_settings, ColorManagedViewSettings *view_settings)
 
const char * IMB_colormanagement_role_colorspace_name_get (int role)
 
void IMB_colormanagement_check_is_data (ImBuf *ibuf, const char *name)
 
void IMB_colormanagegent_copy_settings (ImBuf *ibuf_src, ImBuf *ibuf_dst)
 
void IMB_colormanagement_assign_float_colorspace (ImBuf *ibuf, const char *name)
 
void IMB_colormanagement_assign_byte_colorspace (ImBuf *ibuf, const char *name)
 
const char * IMB_colormanagement_get_float_colorspace (ImBuf *ibuf)
 
const char * IMB_colormanagement_get_rect_colorspace (ImBuf *ibuf)
 
bool IMB_colormanagement_space_is_data (ColorSpace *colorspace)
 
bool IMB_colormanagement_space_is_scene_linear (ColorSpace *colorspace)
 
bool IMB_colormanagement_space_is_srgb (ColorSpace *colorspace)
 
bool IMB_colormanagement_space_name_is_data (const char *name)
 
bool IMB_colormanagement_space_name_is_scene_linear (const char *name)
 
bool IMB_colormanagement_space_name_is_srgb (const char *name)
 
BLI_INLINE void IMB_colormanagement_get_luminance_coefficients (float r_rgb[3])
 
BLI_INLINE float IMB_colormanagement_get_luminance (const float rgb[3])
 
BLI_INLINE unsigned char IMB_colormanagement_get_luminance_byte (const unsigned char[3])
 
BLI_INLINE void IMB_colormanagement_xyz_to_scene_linear (float scene_linear[3], const float xyz[3])
 
BLI_INLINE void IMB_colormanagement_scene_linear_to_xyz (float xyz[3], const float scene_linear[3])
 
BLI_INLINE void IMB_colormanagement_rec709_to_scene_linear (float scene_linear[3], const float rec709[3])
 
BLI_INLINE void IMB_colormanagement_scene_linear_to_rec709 (float rec709[3], const float scene_linear[3])
 
BLI_INLINE void IMB_colormanagement_aces_to_scene_linear (float scene_linear[3], const float aces[3])
 
BLI_INLINE void IMB_colormanagement_scene_linear_to_aces (float aces[3], const float scene_linear[3])
 
blender::float3x3 IMB_colormanagement_get_xyz_to_scene_linear ()
 
blender::float3x3 IMB_colormanagement_get_scene_linear_to_xyz ()
 
void IMB_colormanagement_get_whitepoint (const float temperature, const float tint, float whitepoint[3])
 
bool IMB_colormanagement_set_whitepoint (const float whitepoint[3], float &temperature, float &tint)
 
Color Space Transformation Functions
void IMB_colormanagement_transform (float *buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace, bool predivide)
 
void IMB_colormanagement_transform_threaded (float *buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace, bool predivide)
 
void IMB_colormanagement_transform_byte (unsigned char *buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace)
 
void IMB_colormanagement_transform_byte_threaded (unsigned char *buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace)
 
void IMB_colormanagement_transform_from_byte (float *float_buffer, unsigned char *byte_buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace)
 
void IMB_colormanagement_transform_from_byte_threaded (float *float_buffer, unsigned char *byte_buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace)
 
void IMB_colormanagement_transform_v4 (float pixel[4], const char *from_colorspace, const char *to_colorspace)
 
void IMB_colormanagement_colorspace_to_scene_linear_v3 (float pixel[3], ColorSpace *colorspace)
 
void IMB_colormanagement_colorspace_to_scene_linear_v4 (float pixel[4], bool predivide, ColorSpace *colorspace)
 
void IMB_colormanagement_scene_linear_to_colorspace_v3 (float pixel[3], ColorSpace *colorspace)
 
void IMB_colormanagement_colorspace_to_scene_linear (float *buffer, int width, int height, int channels, ColorSpace *colorspace, bool predivide)
 
void IMB_colormanagement_scene_linear_to_colorspace (float *buffer, int width, int height, int channels, ColorSpace *colorspace)
 
void IMB_colormanagement_imbuf_to_byte_texture (unsigned char *out_buffer, int offset_x, int offset_y, int width, int height, const ImBuf *ibuf, bool store_premultiplied)
 
void IMB_colormanagement_imbuf_to_float_texture (float *out_buffer, int offset_x, int offset_y, int width, int height, const ImBuf *ibuf, bool store_premultiplied)
 
void IMB_colormanagement_scene_linear_to_color_picking_v3 (float color_picking[3], const float scene_linear[3])
 
void IMB_colormanagement_color_picking_to_scene_linear_v3 (float scene_linear[3], const float color_picking[3])
 
BLI_INLINE void IMB_colormanagement_scene_linear_to_srgb_v3 (float srgb[3], const float scene_linear[3])
 
BLI_INLINE void IMB_colormanagement_srgb_to_scene_linear_v3 (float scene_linear[3], const float srgb[3])
 
void IMB_colormanagement_scene_linear_to_display_v3 (float pixel[3], ColorManagedDisplay *display)
 
void IMB_colormanagement_display_to_scene_linear_v3 (float pixel[3], ColorManagedDisplay *display)
 
void IMB_colormanagement_pixel_to_display_space_v4 (float result[4], const float pixel[4], const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings)
 
void IMB_colormanagement_pixel_to_display_space_v3 (float result[3], const float pixel[3], const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings)
 
void IMB_colormanagement_imbuf_make_display_space (ImBuf *ibuf, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings)
 
ImBufIMB_colormanagement_imbuf_for_write (ImBuf *ibuf, bool save_as_render, bool allocate_result, const ImageFormatData *image_format)
 
Public Display Buffers Interfaces
void IMB_colormanagement_display_settings_from_ctx (const bContext *C, ColorManagedViewSettings **r_view_settings, ColorManagedDisplaySettings **r_display_settings)
 
unsigned char * IMB_display_buffer_acquire (ImBuf *ibuf, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, void **cache_handle)
 
unsigned char * IMB_display_buffer_acquire_ctx (const bContext *C, ImBuf *ibuf, void **cache_handle)
 
void IMB_display_buffer_transform_apply (unsigned char *display_buffer, float *linear_buffer, int width, int height, int channels, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, bool predivide)
 
void IMB_display_buffer_transform_apply_float (float *float_display_buffer, float *linear_buffer, int width, int height, int channels, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, bool predivide)
 
void IMB_display_buffer_release (void *cache_handle)
 
Display Functions
int IMB_colormanagement_display_get_named_index (const char *name)
 
const char * IMB_colormanagement_display_get_indexed_name (int index)
 
const char * IMB_colormanagement_display_get_default_name ()
 
ColorManagedDisplayIMB_colormanagement_display_get_named (const char *name)
 
const char * IMB_colormanagement_display_get_none_name ()
 
const char * IMB_colormanagement_display_get_default_view_transform_name (ColorManagedDisplay *display)
 
View Functions
int IMB_colormanagement_view_get_named_index (const char *name)
 
const char * IMB_colormanagement_view_get_indexed_name (int index)
 
Look Functions
int IMB_colormanagement_look_get_named_index (const char *name)
 
const char * IMB_colormanagement_look_get_indexed_name (int index)
 
const char * IMB_colormanagement_look_get_default_name ()
 
const char * IMB_colormanagement_look_validate_for_view (const char *view_name, const char *look_name)
 
Color Space Functions
int IMB_colormanagement_colorspace_get_named_index (const char *name)
 
const char * IMB_colormanagement_colorspace_get_indexed_name (int index)
 
const char * IMB_colormanagement_colorspace_get_name (const ColorSpace *colorspace)
 
const char * IMB_colormanagement_view_get_default_name (const char *display_name)
 
const char * IMB_colormanagement_view_get_raw_or_default_name (const char *display_name)
 
void IMB_colormanagement_colorspace_from_ibuf_ftype (ColorManagedColorspaceSettings *colorspace_settings, ImBuf *ibuf)
 
RNA Helper Functions
void IMB_colormanagement_display_items_add (EnumPropertyItem **items, int *totitem)
 
void IMB_colormanagement_view_items_add (EnumPropertyItem **items, int *totitem, const char *display_name)
 
void IMB_colormanagement_look_items_add (EnumPropertyItem **items, int *totitem, const char *view_name)
 
void IMB_colormanagement_colorspace_items_add (EnumPropertyItem **items, int *totitem)
 
Tile-based Buffer Management
void IMB_partial_display_buffer_update (ImBuf *ibuf, const float *linear_buffer, const unsigned char *byte_buffer, int stride, int offset_x, int offset_y, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, int xmin, int ymin, int xmax, int ymax)
 
void IMB_partial_display_buffer_update_threaded (ImBuf *ibuf, const float *linear_buffer, const unsigned char *byte_buffer, int stride, int offset_x, int offset_y, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, int xmin, int ymin, int xmax, int ymax)
 
void IMB_partial_display_buffer_update_delayed (ImBuf *ibuf, int xmin, int ymin, int xmax, int ymax)
 
Pixel Processor Functions
ColormanageProcessorIMB_colormanagement_display_processor_new (const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings)
 
ColormanageProcessorIMB_colormanagement_colorspace_processor_new (const char *from_colorspace, const char *to_colorspace)
 
bool IMB_colormanagement_processor_is_noop (ColormanageProcessor *cm_processor)
 
void IMB_colormanagement_processor_apply_v4 (ColormanageProcessor *cm_processor, float pixel[4])
 
void IMB_colormanagement_processor_apply_v4_predivide (ColormanageProcessor *cm_processor, float pixel[4])
 
void IMB_colormanagement_processor_apply_v3 (ColormanageProcessor *cm_processor, float pixel[3])
 
void IMB_colormanagement_processor_apply_pixel (ColormanageProcessor *cm_processor, float *pixel, int channels)
 
void IMB_colormanagement_processor_apply (ColormanageProcessor *cm_processor, float *buffer, int width, int height, int channels, bool predivide)
 
void IMB_colormanagement_processor_apply_byte (ColormanageProcessor *cm_processor, unsigned char *buffer, int width, int height, int channels)
 
void IMB_colormanagement_processor_free (ColormanageProcessor *cm_processor)
 
OpenGL Drawing Routines Using GLSL for Color Space Transform
bool IMB_colormanagement_support_glsl_draw (const ColorManagedViewSettings *view_settings)
 
bool IMB_colormanagement_setup_glsl_draw (const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, float dither, bool predivide)
 
bool IMB_colormanagement_setup_glsl_draw_from_space (const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, ColorSpace *from_colorspace, float dither, bool predivide, bool do_overlay_merge)
 
bool IMB_colormanagement_setup_glsl_draw_ctx (const bContext *C, float dither, bool predivide)
 
bool IMB_colormanagement_setup_glsl_draw_from_space_ctx (const bContext *C, ColorSpace *from_colorspace, float dither, bool predivide)
 
void IMB_colormanagement_finish_glsl_draw ()
 
Rendering Tables
void IMB_colormanagement_blackbody_temperature_to_rgb (float r_dest[4], float value)
 
void IMB_colormanagement_blackbody_temperature_to_rgb_table (float *r_table, int width, float min, float max)
 
void IMB_colormanagement_wavelength_to_rgb (float r_dest[4], float value)
 
void IMB_colormanagement_wavelength_to_rgb_table (float *r_table, int width)
 

View Transform

enum  {
  COLOR_ROLE_SCENE_LINEAR = 0 , COLOR_ROLE_COLOR_PICKING , COLOR_ROLE_TEXTURE_PAINTING , COLOR_ROLE_DEFAULT_SEQUENCER ,
  COLOR_ROLE_DEFAULT_BYTE , COLOR_ROLE_DEFAULT_FLOAT , COLOR_ROLE_DATA
}
 
void IMB_colormanagement_init_default_view_settings (ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings)
 

Macro Definition Documentation

◆ BCM_CONFIG_FILE

#define BCM_CONFIG_FILE   "config.ocio"

Definition at line 16 of file IMB_colormanagement.hh.

Referenced by colormanagement_init().

Enumeration Type Documentation

◆ anonymous enum

anonymous enum
Enumerator
COLOR_ROLE_SCENE_LINEAR 
COLOR_ROLE_COLOR_PICKING 
COLOR_ROLE_TEXTURE_PAINTING 
COLOR_ROLE_DEFAULT_SEQUENCER 
COLOR_ROLE_DEFAULT_BYTE 
COLOR_ROLE_DEFAULT_FLOAT 
COLOR_ROLE_DATA 

Definition at line 526 of file IMB_colormanagement.hh.

Function Documentation

◆ IMB_colormanagegent_copy_settings()

◆ IMB_colormanagement_aces_to_scene_linear()

BLI_INLINE void IMB_colormanagement_aces_to_scene_linear ( float scene_linear[3],
const float aces[3] )

Definition at line 70 of file colormanagement_inline.h.

References imbuf_aces_to_scene_linear, and mul_v3_m3v3().

Referenced by Color_from_aces_to_scene_linear().

◆ IMB_colormanagement_assign_byte_colorspace()

◆ IMB_colormanagement_assign_float_colorspace()

◆ IMB_colormanagement_blackbody_temperature_to_rgb()

◆ IMB_colormanagement_blackbody_temperature_to_rgb_table()

void IMB_colormanagement_blackbody_temperature_to_rgb_table ( float * r_table,
int width,
float min,
float max )

◆ IMB_colormanagement_check_file_config()

◆ IMB_colormanagement_check_is_data()

void IMB_colormanagement_check_is_data ( ImBuf * ibuf,
const char * name )

◆ IMB_colormanagement_color_picking_to_scene_linear_v3()

◆ IMB_colormanagement_colorspace_from_ibuf_ftype()

◆ IMB_colormanagement_colorspace_get_indexed_name()

const char * IMB_colormanagement_colorspace_get_indexed_name ( int index)

Definition at line 3385 of file colormanagement.cc.

References colormanage_colorspace_get_indexed(), and ColorSpace::name.

◆ IMB_colormanagement_colorspace_get_name()

const char * IMB_colormanagement_colorspace_get_name ( const ColorSpace * colorspace)

Definition at line 3396 of file colormanagement.cc.

References ColorSpace::name.

Referenced by image_colorspace_from_imbuf().

◆ IMB_colormanagement_colorspace_get_named_index()

int IMB_colormanagement_colorspace_get_named_index ( const char * name)

◆ IMB_colormanagement_colorspace_items_add()

◆ IMB_colormanagement_colorspace_processor_new()

◆ IMB_colormanagement_colorspace_to_scene_linear()

void IMB_colormanagement_colorspace_to_scene_linear ( float * buffer,
int width,
int height,
int channels,
ColorSpace * colorspace,
bool predivide )

Converts a (width)x(height) block of float pixels from given color space to scene linear space. This is much higher performance than converting pixels one by one.

Definition at line 2311 of file colormanagement.cc.

References colorspace_to_scene_linear_cpu_processor(), OCIO_cpuProcessorApply(), OCIO_cpuProcessorApply_predivide(), OCIO_createOCIO_PackedImageDesc(), OCIO_PackedImageDescRelease(), and printf.

Referenced by blender::compositor::colorspace_to_scene_linear(), IMB_float_from_rect_ex(), pixels_to_scene_linear_byte(), and pixels_to_scene_linear_float().

◆ IMB_colormanagement_colorspace_to_scene_linear_v3()

void IMB_colormanagement_colorspace_to_scene_linear_v3 ( float pixel[3],
ColorSpace * colorspace )

◆ IMB_colormanagement_colorspace_to_scene_linear_v4()

◆ IMB_colormanagement_display_get_default_name()

const char * IMB_colormanagement_display_get_default_name ( )

◆ IMB_colormanagement_display_get_default_view_transform_name()

const char * IMB_colormanagement_display_get_default_view_transform_name ( ColorManagedDisplay * display)

◆ IMB_colormanagement_display_get_indexed_name()

const char * IMB_colormanagement_display_get_indexed_name ( int index)

Definition at line 3092 of file colormanagement.cc.

References colormanage_display_get_indexed().

◆ IMB_colormanagement_display_get_named()

◆ IMB_colormanagement_display_get_named_index()

int IMB_colormanagement_display_get_named_index ( const char * name)

◆ IMB_colormanagement_display_get_none_name()

const char * IMB_colormanagement_display_get_none_name ( )

◆ IMB_colormanagement_display_items_add()

◆ IMB_colormanagement_display_processor_new()

◆ IMB_colormanagement_display_settings_from_ctx()

◆ IMB_colormanagement_display_to_scene_linear_v3()

void IMB_colormanagement_display_to_scene_linear_v3 ( float pixel[3],
ColorManagedDisplay * display )

◆ IMB_colormanagement_finish_glsl_draw()

void IMB_colormanagement_finish_glsl_draw ( )

◆ IMB_colormanagement_get_float_colorspace()

◆ IMB_colormanagement_get_luminance()

◆ IMB_colormanagement_get_luminance_byte()

BLI_INLINE unsigned char IMB_colormanagement_get_luminance_byte ( const unsigned char rgb[3])

◆ IMB_colormanagement_get_luminance_coefficients()

◆ IMB_colormanagement_get_rect_colorspace()

◆ IMB_colormanagement_get_scene_linear_to_xyz()

◆ IMB_colormanagement_get_whitepoint()

void IMB_colormanagement_get_whitepoint ( const float temperature,
const float tint,
float whitepoint[3] )

Functions for converting between color temperature/tint and RGB white points.

Definition at line 1529 of file colormanagement.cc.

References IMB_colormanagement_xyz_to_scene_linear(), and blender::math::whitepoint_from_temp_tint().

◆ IMB_colormanagement_get_xyz_to_scene_linear()

◆ IMB_colormanagement_imbuf_for_write()

ImBuf * IMB_colormanagement_imbuf_for_write ( ImBuf * ibuf,
bool save_as_render,
bool allocate_result,
const ImageFormatData * image_format )

Prepare image buffer to be saved on disk, applying color management if needed color management would be applied if image is saving as render result and if file format is not expecting float buffer to be in linear space (currently JPEG2000 and TIFF are such formats – they're storing image as float but file itself stores applied color space).

Both byte and float buffers would contain applied color space, and result's float_colorspace would be set to display color space. This should be checked in image format write callback and if float_colorspace is not NULL, no color space transformation should be applied on this buffer.

Definition at line 2679 of file colormanagement.cc.

References BKE_image_format_is_byte(), BKE_imtype_requires_linear_float(), ImBuf::byte_buffer, ImBuf::channels, colormanage_colorspace_get_named(), colormanagement_imbuf_make_display_space(), ImBufByteBuffer::colorspace, ImBufFloatBuffer::colorspace, ImBufByteBuffer::data, ImBufFloatBuffer::data, ImageFormatData::display_settings, display_transform_get_colorspace(), ImBuf::float_buffer, global_role_default_byte, global_role_scene_linear, IB_DISPLAY_BUFFER_INVALID, IB_RECT_INVALID, IMB_alpha_under_color_byte(), IMB_alpha_under_color_float(), IMB_colormanagement_transform(), IMB_colormanagement_transform_byte_threaded(), IMB_float_from_rect(), imb_freerectImBuf(), IMB_rect_from_float(), imbuf_ensure_editable(), ImageFormatData::imtype, ImageFormatData::linear_colorspace_settings, ColorManagedColorspaceSettings::name, ColorSpace::name, ImageFormatData::planes, R_IMF_PLANES_RGBA, STREQ, ImBuf::userflags, ImageFormatData::view_settings, ImBuf::x, and ImBuf::y.

Referenced by BKE_image_render_write(), image_save_single(), and RE_WriteRenderViewsMovie().

◆ IMB_colormanagement_imbuf_make_display_space()

void IMB_colormanagement_imbuf_make_display_space ( ImBuf * ibuf,
const ColorManagedViewSettings * view_settings,
const ColorManagedDisplaySettings * display_settings )

◆ IMB_colormanagement_imbuf_to_byte_texture()

void IMB_colormanagement_imbuf_to_byte_texture ( unsigned char * out_buffer,
int offset_x,
int offset_y,
int width,
int height,
const ImBuf * ibuf,
bool store_premultiplied )

◆ IMB_colormanagement_imbuf_to_float_texture()

◆ IMB_colormanagement_init_default_view_settings()

◆ IMB_colormanagement_look_get_default_name()

const char * IMB_colormanagement_look_get_default_name ( )

◆ IMB_colormanagement_look_get_indexed_name()

const char * IMB_colormanagement_look_get_indexed_name ( int index)

Definition at line 3482 of file colormanagement.cc.

References colormanage_look_get_indexed(), and ColorManagedLook::name.

◆ IMB_colormanagement_look_get_named_index()

int IMB_colormanagement_look_get_named_index ( const char * name)

◆ IMB_colormanagement_look_items_add()

◆ IMB_colormanagement_look_validate_for_view()

const char * IMB_colormanagement_look_validate_for_view ( const char * view_name,
const char * look_name )

◆ IMB_colormanagement_pixel_to_display_space_v3()

void IMB_colormanagement_pixel_to_display_space_v3 ( float result[3],
const float pixel[3],
const ColorManagedViewSettings * view_settings,
const ColorManagedDisplaySettings * display_settings )

◆ IMB_colormanagement_pixel_to_display_space_v4()

void IMB_colormanagement_pixel_to_display_space_v4 ( float result[4],
const float pixel[4],
const ColorManagedViewSettings * view_settings,
const ColorManagedDisplaySettings * display_settings )

◆ IMB_colormanagement_processor_apply()

◆ IMB_colormanagement_processor_apply_byte()

void IMB_colormanagement_processor_apply_byte ( ColormanageProcessor * cm_processor,
unsigned char * buffer,
int width,
int height,
int channels )

◆ IMB_colormanagement_processor_apply_pixel()

◆ IMB_colormanagement_processor_apply_v3()

◆ IMB_colormanagement_processor_apply_v4()

◆ IMB_colormanagement_processor_apply_v4_predivide()

◆ IMB_colormanagement_processor_free()

◆ IMB_colormanagement_processor_is_noop()

bool IMB_colormanagement_processor_is_noop ( ColormanageProcessor * cm_processor)

◆ IMB_colormanagement_rec709_to_scene_linear()

BLI_INLINE void IMB_colormanagement_rec709_to_scene_linear ( float scene_linear[3],
const float rec709[3] )

◆ IMB_colormanagement_role_colorspace_name_get()

const char * IMB_colormanagement_role_colorspace_name_get ( int role)

Definition at line 1356 of file colormanagement.cc.

References BLI_assert, COLOR_ROLE_COLOR_PICKING, COLOR_ROLE_DATA, COLOR_ROLE_DEFAULT_BYTE, COLOR_ROLE_DEFAULT_FLOAT, COLOR_ROLE_DEFAULT_SEQUENCER, COLOR_ROLE_SCENE_LINEAR, COLOR_ROLE_TEXTURE_PAINTING, G, global_role_color_picking, global_role_data, global_role_default_byte, global_role_default_float, global_role_default_sequencer, global_role_scene_linear, global_role_texture_painting, and printf.

Referenced by add_ibuf_for_tile(), assign_render_pass_ibuf_colorspace(), BKE_image_add_generated(), BKE_image_format_color_management_copy_from_scene(), BKE_image_format_init_for_write(), BKE_image_format_update_color_space_for_type(), BKE_image_save_options_init(), colormanage_colorspace_get_roled(), colorspace_set_default_role(), image_colorspace_from_imbuf(), image_exr_from_scene_linear_to_output(), image_node_colorspace(), IMB_colormanagement_colorspace_from_ibuf_ftype(), IMB_colormanagement_get_float_colorspace(), IMB_colormanagement_get_rect_colorspace(), IMB_rect_from_float(), blender::ed::sculpt_paint::paint::image::PaintingKernel< ImageBuffer >::init_brush_color(), blender::nodes::node_composite_convert_color_space_cc::node_composit_init_convert_colorspace(), RE_render_result_rect_to_ibuf(), render_result_exr_file_cache_read(), render_result_new_from_exr(), scene_init_data(), seq_add_set_view_transform(), SEQ_render_imbuf_from_sequencer_space(), SEQ_render_pixel_from_sequencer_space_v4(), wm_main_playanim_intern(), blender::ed::object::write_external_bake_pixels(), and blender::ed::object::write_internal_bake_pixels().

◆ IMB_colormanagement_scene_linear_to_aces()

BLI_INLINE void IMB_colormanagement_scene_linear_to_aces ( float aces[3],
const float scene_linear[3] )

Definition at line 75 of file colormanagement_inline.h.

References imbuf_scene_linear_to_aces, and mul_v3_m3v3().

Referenced by Color_from_scene_linear_to_aces().

◆ IMB_colormanagement_scene_linear_to_color_picking_v3()

void IMB_colormanagement_scene_linear_to_color_picking_v3 ( float color_picking[3],
const float scene_linear[3] )

Conversion between color picking role. Typically we would expect such a requirements:

  • It is approximately perceptually linear, so that the HSV numbers and the HSV cube/circle have an intuitive distribution.
  • It has the same gamut as the scene linear color space.
  • Color picking values 0..1 map to scene linear values in the 0..1 range, so that picked albedo values are energy conserving.

Definition at line 2526 of file colormanagement.cc.

References BLI_mutex_lock(), BLI_mutex_unlock(), copy_v3_v3(), global_color_picking_state::cpu_processor_to, create_colorspace_transform_processor(), global_color_picking_state::failed, global_role_color_picking, global_role_scene_linear, OCIO_cpuProcessorApplyRGB(), OCIO_processorGetCPUProcessor(), OCIO_processorRelease(), and processor_lock.

Referenced by ui_scene_linear_to_perceptual_space().

◆ IMB_colormanagement_scene_linear_to_colorspace()

void IMB_colormanagement_scene_linear_to_colorspace ( float * buffer,
int width,
int height,
int channels,
ColorSpace * colorspace )

Converts a (width)x(height) block of float pixels from scene linear space to given color space. This is much higher performance than converting pixels one by one.

Definition at line 2341 of file colormanagement.cc.

References colorspace_from_scene_linear_cpu_processor(), OCIO_cpuProcessorApply(), OCIO_createOCIO_PackedImageDesc(), OCIO_PackedImageDescRelease(), and printf.

Referenced by scene_linear_to_image_chunk_byte(), and scene_linear_to_image_chunk_float().

◆ IMB_colormanagement_scene_linear_to_colorspace_v3()

void IMB_colormanagement_scene_linear_to_colorspace_v3 ( float pixel[3],
ColorSpace * colorspace )

Convert pixel from scene linear space to specified color space. For performance, use IMB_colormanagement_scene_linear_to_colorspace when converting an array of pixels.

Definition at line 2278 of file colormanagement.cc.

References colorspace_from_scene_linear_cpu_processor(), OCIO_cpuProcessorApplyRGB(), and printf.

◆ IMB_colormanagement_scene_linear_to_display_v3()

void IMB_colormanagement_scene_linear_to_display_v3 ( float pixel[3],
ColorManagedDisplay * display )

Convert pixel from scene linear to display space using default view used by performance-critical areas such as color-related widgets where we want to reduce amount of per-widget allocations.

Definition at line 2586 of file colormanagement.cc.

References display_from_scene_linear_processor(), and OCIO_cpuProcessorApplyRGB().

Referenced by brush_painter_imbuf_new(), brush_painter_imbuf_update(), eyedropper_color_set(), blender::ui::greasepencil::eyedropper_grease_pencil_color_set(), ui_block_cm_to_display_space_v3(), ui_draw_but_COLORBAND(), and ui_draw_colorband_handle().

◆ IMB_colormanagement_scene_linear_to_rec709()

BLI_INLINE void IMB_colormanagement_scene_linear_to_rec709 ( float rec709[3],
const float scene_linear[3] )

◆ IMB_colormanagement_scene_linear_to_srgb_v3()

BLI_INLINE void IMB_colormanagement_scene_linear_to_srgb_v3 ( float srgb[3],
const float scene_linear[3] )

Conversion between sRGB, for rare cases like hex color or copy/pasting between UI theme and scene linear colors.

Definition at line 58 of file colormanagement_inline.h.

References imbuf_scene_linear_to_rec709, linearrgb_to_srgb_v3_v3(), and mul_v3_m3v3().

Referenced by Color_from_scene_linear_to_srgb(), drop_color_invoke(), paint_brush_color_get(), blender::ed::sculpt_paint::sample_color_invoke(), ui_block_colorpicker(), ui_do_but_COLOR(), and ui_update_color_picker_buts_rgba().

◆ IMB_colormanagement_scene_linear_to_xyz()

BLI_INLINE void IMB_colormanagement_scene_linear_to_xyz ( float xyz[3],
const float scene_linear[3] )

◆ IMB_colormanagement_set_whitepoint()

bool IMB_colormanagement_set_whitepoint ( const float whitepoint[3],
float & temperature,
float & tint )

◆ IMB_colormanagement_setup_glsl_draw()

bool IMB_colormanagement_setup_glsl_draw ( const ColorManagedViewSettings * view_settings,
const ColorManagedDisplaySettings * display_settings,
float dither,
bool predivide )

Configures GLSL shader for conversion from scene linear to display space.

Definition at line 4388 of file colormanagement.cc.

References IMB_colormanagement_setup_glsl_draw_from_space().

Referenced by ED_draw_imbuf_clipping(), and ocio_transform_ibuf().

◆ IMB_colormanagement_setup_glsl_draw_ctx()

bool IMB_colormanagement_setup_glsl_draw_ctx ( const bContext * C,
float dither,
bool predivide )

Same as setup_glsl_draw, but color management settings are guessing from a given context.

Definition at line 4411 of file colormanagement.cc.

References IMB_colormanagement_setup_glsl_draw_from_space_ctx().

Referenced by sequencer_OCIO_transform_ibuf().

◆ IMB_colormanagement_setup_glsl_draw_from_space()

bool IMB_colormanagement_setup_glsl_draw_from_space ( const ColorManagedViewSettings * view_settings,
const ColorManagedDisplaySettings * display_settings,
ColorSpace * from_colorspace,
float dither,
bool predivide,
bool do_overlay_merge )
Note
Same as IMB_colormanagement_setup_glsl_draw, but display space conversion happens from a specified space.

Configures GLSL shader for conversion from specified to display color space

Will create appropriate OCIO processor and setup GLSL shader, so further 2D texture usage will use this conversion.

When there's no need to apply transform on 2D textures, use IMB_colormanagement_finish_glsl_draw().

This is low-level function, use ED_draw_imbuf_ctx if you only need to display given image buffer

Definition at line 4321 of file colormanagement.cc.

References colormanage_use_look(), COLORMANAGE_VIEW_USE_HDR, COLORMANAGE_VIEW_USE_WHITE_BALANCE, ColorManagedDisplaySettings::display_device, ColorManagedViewSettings::exposure, ColorManagedViewSettings::flag, ColorManagedViewSettings::gamma, global_role_scene_linear, GPU_hdr_support(), global_gpu_state::gpu_shader_bound, IMB_colormanagement_init_default_view_settings(), ColorManagedViewSettings::look, max_ff(), ColorSpace::name, OCIO_configRelease(), OCIO_getCurrentConfig(), OCIO_gpuDisplayShaderBind(), powf, ColorManagedViewSettings::temperature, ColorManagedViewSettings::tint, update_glsl_curve_mapping(), and ColorManagedViewSettings::view_transform.

Referenced by ED_draw_imbuf_clipping(), gpu_viewport_draw_colormanaged(), IMB_colormanagement_setup_glsl_draw(), IMB_colormanagement_setup_glsl_draw_from_space_ctx(), and ocio_transform_ibuf().

◆ IMB_colormanagement_setup_glsl_draw_from_space_ctx()

bool IMB_colormanagement_setup_glsl_draw_from_space_ctx ( const bContext * C,
ColorSpace * from_colorspace,
float dither,
bool predivide )

Same as setup_glsl_draw_from_space, but color management settings are guessing from a given context.

Definition at line 4397 of file colormanagement.cc.

References IMB_colormanagement_display_settings_from_ctx(), and IMB_colormanagement_setup_glsl_draw_from_space().

Referenced by IMB_colormanagement_setup_glsl_draw_ctx(), and sequencer_OCIO_transform_ibuf().

◆ IMB_colormanagement_space_is_data()

◆ IMB_colormanagement_space_is_scene_linear()

◆ IMB_colormanagement_space_is_srgb()

◆ IMB_colormanagement_space_name_is_data()

◆ IMB_colormanagement_space_name_is_scene_linear()

◆ IMB_colormanagement_space_name_is_srgb()

bool IMB_colormanagement_space_name_is_srgb ( const char * name)

◆ IMB_colormanagement_srgb_to_scene_linear_v3()

◆ IMB_colormanagement_support_glsl_draw()

bool IMB_colormanagement_support_glsl_draw ( const ColorManagedViewSettings * view_settings)

Test if GLSL drawing is supported for combination of graphics card and this configuration.

Definition at line 4316 of file colormanagement.cc.

References OCIO_supportGPUShader().

Referenced by screen_render_invoke().

◆ IMB_colormanagement_transform()

void IMB_colormanagement_transform ( float * buffer,
int width,
int height,
int channels,
const char * from_colorspace,
const char * to_colorspace,
bool predivide )

◆ IMB_colormanagement_transform_byte()

void IMB_colormanagement_transform_byte ( unsigned char * buffer,
int width,
int height,
int channels,
const char * from_colorspace,
const char * to_colorspace )

Similar to IMB_colormanagement_transform_threaded, but operates on byte buffer.

Definition at line 2159 of file colormanagement.cc.

References colormanagement_transform_ex().

◆ IMB_colormanagement_transform_byte_threaded()

void IMB_colormanagement_transform_byte_threaded ( unsigned char * buffer,
int width,
int height,
int channels,
const char * from_colorspace,
const char * to_colorspace )

◆ IMB_colormanagement_transform_from_byte()

void IMB_colormanagement_transform_from_byte ( float * float_buffer,
unsigned char * byte_buffer,
int width,
int height,
int channels,
const char * from_colorspace,
const char * to_colorspace )

Similar to IMB_colormanagement_transform_byte_threaded, but gets float buffer from display one.

Definition at line 2180 of file colormanagement.cc.

References IB_PROFILE_SRGB, IMB_buffer_float_from_byte(), and IMB_colormanagement_transform().

◆ IMB_colormanagement_transform_from_byte_threaded()

void IMB_colormanagement_transform_from_byte_threaded ( float * float_buffer,
unsigned char * byte_buffer,
int width,
int height,
int channels,
const char * from_colorspace,
const char * to_colorspace )

◆ IMB_colormanagement_transform_threaded()

void IMB_colormanagement_transform_threaded ( float * buffer,
int width,
int height,
int channels,
const char * from_colorspace,
const char * to_colorspace,
bool predivide )

Convert the whole buffer from specified by name color space to another will do threaded conversion.

Definition at line 2147 of file colormanagement.cc.

References colormanagement_transform_ex().

Referenced by seq_imbuf_to_sequencer_space(), and SEQ_render_imbuf_from_sequencer_space().

◆ IMB_colormanagement_transform_v4()

void IMB_colormanagement_transform_v4 ( float pixel[4],
const char * from_colorspace,
const char * to_colorspace )

◆ IMB_colormanagement_validate_settings()

◆ IMB_colormanagement_view_get_default_name()

const char * IMB_colormanagement_view_get_default_name ( const char * display_name)

◆ IMB_colormanagement_view_get_indexed_name()

const char * IMB_colormanagement_view_get_indexed_name ( int index)

Definition at line 3219 of file colormanagement.cc.

References colormanage_view_get_indexed().

◆ IMB_colormanagement_view_get_named_index()

int IMB_colormanagement_view_get_named_index ( const char * name)

Definition at line 3208 of file colormanagement.cc.

References colormanage_view_get_named().

Referenced by colormanage_view_settings_to_cache().

◆ IMB_colormanagement_view_get_raw_or_default_name()

const char * IMB_colormanagement_view_get_raw_or_default_name ( const char * display_name)

◆ IMB_colormanagement_view_items_add()

void IMB_colormanagement_view_items_add ( EnumPropertyItem ** items,
int * totitem,
const char * display_name )

◆ IMB_colormanagement_wavelength_to_rgb()

void IMB_colormanagement_wavelength_to_rgb ( float r_dest[4],
float value )

◆ IMB_colormanagement_wavelength_to_rgb_table()

void IMB_colormanagement_wavelength_to_rgb_table ( float * r_table,
int width )

◆ IMB_colormanagement_xyz_to_scene_linear()

BLI_INLINE void IMB_colormanagement_xyz_to_scene_linear ( float scene_linear[3],
const float xyz[3] )

Conversion between scene linear and other color spaces.

Definition at line 38 of file colormanagement_inline.h.

References imbuf_xyz_to_scene_linear, and mul_v3_m3v3().

Referenced by Color_from_xyz_d65_to_scene_linear(), IMB_colormanagement_get_whitepoint(), and IMB_colormanagement_wavelength_to_rgb().

◆ IMB_display_buffer_acquire()

◆ IMB_display_buffer_acquire_ctx()

unsigned char * IMB_display_buffer_acquire_ctx ( const bContext * C,
ImBuf * ibuf,
void ** cache_handle )

Same as IMB_display_buffer_acquire but gets view and display settings from context.

Definition at line 2929 of file colormanagement.cc.

References IMB_colormanagement_display_settings_from_ctx(), and IMB_display_buffer_acquire().

Referenced by sequencer_OCIO_transform_ibuf().

◆ IMB_display_buffer_release()

◆ IMB_display_buffer_transform_apply()

void IMB_display_buffer_transform_apply ( unsigned char * display_buffer,
float * linear_buffer,
int width,
int height,
int channels,
const ColorManagedViewSettings * view_settings,
const ColorManagedDisplaySettings * display_settings,
bool predivide )

◆ IMB_display_buffer_transform_apply_float()

void IMB_display_buffer_transform_apply_float ( float * float_display_buffer,
float * linear_buffer,
int width,
int height,
int channels,
const ColorManagedViewSettings * view_settings,
const ColorManagedDisplaySettings * display_settings,
bool predivide )

◆ IMB_partial_display_buffer_update()

void IMB_partial_display_buffer_update ( ImBuf * ibuf,
const float * linear_buffer,
const unsigned char * byte_buffer,
int stride,
int offset_x,
int offset_y,
const ColorManagedViewSettings * view_settings,
const ColorManagedDisplaySettings * display_settings,
int xmin,
int ymin,
int xmax,
int ymax )

Definition at line 3936 of file colormanagement.cc.

References imb_partial_display_buffer_update_ex().

Referenced by image_buffer_rect_update().

◆ IMB_partial_display_buffer_update_delayed()

void IMB_partial_display_buffer_update_delayed ( ImBuf * ibuf,
int xmin,
int ymin,
int xmax,
int ymax )

◆ IMB_partial_display_buffer_update_threaded()

void IMB_partial_display_buffer_update_threaded ( ImBuf * ibuf,
const float * linear_buffer,
const unsigned char * byte_buffer,
int stride,
int offset_x,
int offset_y,
const ColorManagedViewSettings * view_settings,
const ColorManagedDisplaySettings * display_settings,
int xmin,
int ymin,
int xmax,
int ymax )

Definition at line 3964 of file colormanagement.cc.

References imb_partial_display_buffer_update_ex().

Referenced by IMB_display_buffer_acquire().