Blender V5.3
colormanagement.cc File Reference
#include "BLI_utility_mixins.hh"
#include "IMB_colormanagement.hh"
#include "IMB_colormanagement_intern.hh"
#include <cmath>
#include <cstring>
#include <optional>
#include <string>
#include "DNA_ID.h"
#include "DNA_color_types.h"
#include "DNA_image_types.h"
#include "DNA_movieclip_types.h"
#include "DNA_node_types.h"
#include "DNA_scene_types.h"
#include "DNA_sequence_types.h"
#include "DNA_space_types.h"
#include "IMB_filetype.hh"
#include "IMB_filter.hh"
#include "IMB_imbuf.hh"
#include "IMB_imbuf_types.hh"
#include "MEM_guardedalloc.h"
#include "BLI_color.hh"
#include "BLI_colorspace.hh"
#include "BLI_fileops.hh"
#include "BLI_listbase.hh"
#include "BLI_math_color.hh"
#include "BLI_math_color_c.hh"
#include "BLI_math_matrix.hh"
#include "BLI_math_matrix_types.hh"
#include "BLI_math_vector_types.hh"
#include "BLI_path_utils.hh"
#include "BLI_rect.hh"
#include "BLI_string.hh"
#include "BLI_string_ref.hh"
#include "BLI_string_utf8.hh"
#include "BLI_task.hh"
#include "BLI_threads.hh"
#include "BLI_vector_set.hh"
#include "BKE_appdir.hh"
#include "BKE_blender_project.hh"
#include "BKE_colortools.hh"
#include "BKE_context.hh"
#include "BKE_idtype.hh"
#include "BKE_image_format.hh"
#include "BKE_library.hh"
#include "BKE_main.hh"
#include "BKE_node.hh"
#include "BKE_node_legacy_types.hh"
#include "GPU_capabilities.hh"
#include "RNA_define.hh"
#include "SEQ_iterator.hh"
#include "DEG_depsgraph.hh"
#include "CLG_log.h"
#include "OCIO_api.hh"

Go to the source code of this file.

Classes

struct  blender::ColorManagedConfigPath
struct  blender::ColorManagedStartupEnv
struct  blender::GlobalGPUState
struct  blender::GlobalColorPickingState
struct  blender::DisplayBufferThread
struct  blender::DisplayBufferInitData
struct  blender::ProcessorTransformThread
struct  blender::ProcessorTransformInitData

Namespaces

namespace  blender
 BMesh Iterators.

Functions

Initialization / De-initialization
static bool blender::colormanage_role_color_space_name_get (const ocio::Config &config, char *colorspace_name, const char *role, const char *backup_role, const bool optional=false)
static void blender::colormanage_update_matrices (const ocio::Config &config)
static void blender::colormanage_clear_config ()
static bool blender::colormanage_load_config (const ocio::Config &config, const bool validate_only=false)
static void blender::colormanage_free_config ()
static void blender::colormanage_set_ocio_env (const char *filepath, std::optional< std::string > &r_old_ocio_env)
static void blender::colormanage_restore_ocio_env (const std::optional< std::string > &old_ocio_env)
static std::string blender::colormanage_project_config_path_resolve (const StringRef path, const bke::BlenderProject &project)
static Vector< ColorManagedConfigPath > blender::colormanage_config_candidates_get (const Main *bmain)
static const char * blender::colormanage_config_source_identifier (const ColorManagedConfigSource source)
static void blender::colormanage_config_load_candidates (const Span< ColorManagedConfigPath > candidates)
void blender::colormanagement_init ()
void blender::colormanage_environment_setup_for_test (std::optional< std::string > blender_ocio_env, std::optional< std::string > ocio_env)
void blender::colormanagement_exit ()
bool blender::colormanage_config_reload (Main *bmain)
Internal Functions
static StringRef blender::view_filter_for_look (StringRefNull view_name)
static bool blender::colormanage_compatible_look (const ocio::Look *look, StringRef view_filter)
static bool blender::colormanage_compatible_look (const ocio::Look *look, const char *view_name)
static bool blender::colormanage_use_look (const char *look_name, const char *view_name)
static bool blender::get_display_emulation (const ColorManagedDisplaySettings &display_settings)
static std::shared_ptr< const ocio::CPUProcessor > blender::get_display_buffer_processor (const ColorManagedDisplaySettings &display_settings, const char *look, const char *view_transform, const float exposure, const float gamma, const float temperature, const float tint, const bool use_white_balance, const char *from_colorspace, const ColorManagedDisplaySpace target, const bool inverse=false)
static void blender::curve_mapping_apply_pixel (const CurveMapping *curve_mapping, float *pixel, int channels)
void blender::colormanage_imbuf_set_default_spaces (ImBuf *ibuf)
void blender::colormanage_imbuf_make_linear (ImBuf *ibuf, const char *from_colorspace, const ColorManagedFileOutput output)
Color Space Transformation Functions
void blender::IMB_colormanagement_display_settings_from_ctx (const bContext *C, ColorManagedViewSettings **r_view_settings, ColorManagedDisplaySettings **r_display_settings)
static void blender::colormanagement_transform_ex (uchar *byte_buffer, float *float_buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace, bool predivide)
void blender::IMB_colormanagement_transform_float (float *buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace, bool predivide)
void blender::IMB_colormanagement_transform_byte (unsigned char *buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace)
void blender::IMB_colormanagement_transform_byte_to_float (float *float_buffer, const unsigned char *byte_buffer, int width, int height, int channels, const char *from_colorspace, const char *to_colorspace)
void blender::IMB_colormanagement_transform_v4 (float pixel[4], const char *from_colorspace, const char *to_colorspace)
void blender::IMB_colormanagement_colorspace_to_scene_linear_v3 (float pixel[3], const ColorSpace *colorspace)
void blender::IMB_colormanagement_scene_linear_to_colorspace_v3 (float pixel[3], const ColorSpace *colorspace)
void blender::IMB_colormanagement_colorspace_to_scene_linear_v4 (float pixel[4], bool predivide, const ColorSpace *colorspace)
void blender::IMB_colormanagement_colorspace_to_scene_linear (float *buffer, int width, int height, int channels, const ColorSpace *colorspace, bool predivide)
void blender::IMB_colormanagement_scene_linear_to_colorspace (float *buffer, int width, int height, int channels, const ColorSpace *colorspace)
void blender::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 blender::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 blender::IMB_colormanagement_scene_linear_to_color_picking_v3 (float color_picking[3], const float scene_linear[3])
void blender::IMB_colormanagement_color_picking_to_scene_linear_v3 (float scene_linear[3], const float color_picking[3])
void blender::IMB_colormanagement_scene_linear_to_display_v3 (float pixel[3], const ColorManagedDisplay *display, ColorManagedDisplaySpace display_space=DISPLAY_SPACE_DRAW)
void blender::IMB_colormanagement_display_to_scene_linear_v3 (float pixel[3], const ColorManagedDisplay *display, ColorManagedDisplaySpace display_space=DISPLAY_SPACE_DRAW)
void blender::IMB_colormanagement_pixel_to_display_space_v4 (float result[4], const float pixel[4], const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, ColorManagedDisplaySpace display_space=DISPLAY_SPACE_DRAW)
static ImBuf * blender::imbuf_ensure_editable (ImBuf *ibuf, ImBuf *colormanaged_ibuf, bool allocate_result)
static const char * blender::imbuf_colorspace_name (const ImBuf *ibuf, const bool prefer_byte_buffer)
ImBuf * blender::IMB_colormanagement_imbuf_for_write (ImBuf *ibuf, bool save_as_render, bool allocate_result, const ImageFormatData *image_format)
void blender::IMB_colormanagement_scene_linear_to_display_buffer (uint8_t *display_buffer, const float *linear_buffer, int width, int height, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings)
View Transform
void blender::IMB_colormanagement_init_untonemapped_view_settings (ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings)
Display Buffer Transform Routines
static void blender::display_buffer_init_handle (DisplayBufferThread *handle, int start_line, int tot_line, DisplayBufferInitData *init_data)
static void blender::display_buffer_apply_get_linear_buffer (DisplayBufferThread *handle, int height, float *linear_buffer, bool *is_straight_alpha)
static void blender::do_display_buffer_apply_no_processor (DisplayBufferThread *handle)
static void blender::do_display_buffer_apply_thread (DisplayBufferThread *handle)
static void blender::display_buffer_apply_threaded (ImBuf *ibuf, const float *buffer, uchar *byte_buffer, float *display_buffer, uchar *display_buffer_byte, ColormanageProcessor *cm_processor)
static bool blender::is_colorspace_same_as_display (const ColorSpace *colorspace, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings)
static bool blender::imb_colormanagement_display_processor_needed (const ImBuf *ibuf, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, const ColorManagedDisplaySpace display_space)
static void blender::colormanage_display_buffer_process (ImBuf *ibuf, float *display_buffer, uchar *display_buffer_byte, const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, const ColorManagedDisplaySpace display_space)
Threaded Processor Transform Routines
static void blender::processor_transform_init_handle (ProcessorTransformThread *handle, int start_line, int tot_line, ProcessorTransformInitData *init_data)
static void blender::do_processor_transform_thread (ProcessorTransformThread *handle)
Display Functions
int blender::IMB_colormanagement_display_get_named_index (const char *name)
const char * blender::IMB_colormanagement_display_get_indexed_name (int index)
const char * blender::IMB_colormanagement_display_get_default_name ()
const ColorManagedDisplay * blender::IMB_colormanagement_display_get_named (const char *name)
const char * blender::IMB_colormanagement_display_get_none_name ()
const char * blender::IMB_colormanagement_display_get_default_view_transform_name (const ColorManagedDisplay *display)
const ColorSpace * blender::IMB_colormangement_display_get_color_space (const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings)
bool blender::IMB_colormanagement_display_is_hdr (const ColorManagedDisplaySettings *display_settings, const char *view_name)
bool blender::IMB_colormanagement_display_is_wide_gamut (const ColorManagedDisplaySettings *display_settings, const char *view_name)
bool blender::IMB_colormanagement_display_support_emulation (const ColorManagedDisplaySettings *display_settings, const char *view_name)
int blender::IMB_colormanagement_view_max_nits (const char *display_name, const char *view_name)
ocio::ScopeInfo blender::IMB_colormanagement_get_scope_info (const ColorManagedDisplaySettings *display_settings, const ColorManagedViewSettings *view_settings)
View Functions
int blender::IMB_colormanagement_view_get_id_by_name (const char *name)
const char * blender::IMB_colormanagement_view_get_name_by_id (int index)
Color Space Functions
const char * blender::IMB_colormanagement_view_get_default_name (const char *display_name)
const char * blender::IMB_colormanagement_view_get_raw_or_default_name (const char *display_name)
const ColorSpace * blender::colormanage_colorspace_get_named (const char *name)
const ColorSpace * blender::colormanage_colorspace_get_roled (const int role)
int blender::IMB_colormanagement_colorspace_get_named_index (const char *name)
const char * blender::IMB_colormanagement_colorspace_get_indexed_name (int index)
const char * blender::IMB_colormanagement_colorspace_get_name (const ColorSpace *colorspace)
void blender::IMB_colormanagement_colorspace_name_set (char *name, char *interop_id, const char *new_name)
void blender::IMB_colormanagement_colorspace_settings_set (ColorManagedColorspaceSettings *settings, const char *name)
const char * blender::IMB_colormanagement_colorspace_get_family (const ColorSpace *colorspace)
const char * blender::IMB_colormanagement_colorspace_get_description (const ColorSpace *colorspace)
void blender::IMB_colormanagement_colorspace_from_ibuf_ftype (ColorManagedColorspaceSettings *colorspace_settings, ImBuf *ibuf)
Look Functions
int blender::IMB_colormanagement_look_get_named_index (const char *name)
const char * blender::IMB_colormanagement_look_get_indexed_name (int index)
const char * blender::IMB_colormanagement_look_get_default_name ()
const char * blender::IMB_colormanagement_look_validate_for_view (const char *view_name, const char *look_name)
RNA Helper Functions
void blender::IMB_colormanagement_display_items_add (EnumPropertyItem **items, int *totitem)
void blender::IMB_colormanagement_view_items_add (EnumPropertyItem **items, int *totitem, const char *display_name)
void blender::IMB_colormanagement_look_items_add (EnumPropertyItem **items, int *totitem, const char *view_name)
void blender::IMB_colormanagement_interop_id_items_add (EnumPropertyItem **items, int *totitem)
void blender::IMB_colormanagement_colorspace_items_add (EnumPropertyItem **items, int *totitem)
Pixel Processor Functions
static CurveMapping * blender::update_glsl_curve_mapping (const ColorManagedViewSettings *view_settings)
OpenGL Drawing Routines Using GLSL for Color Space Transform
bool blender::IMB_colormanagement_setup_glsl_draw_from_space (const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, const ColorSpace *from_colorspace, float dither, bool predivide, bool do_overlay_merge, ColorManagedDisplaySpace display_space=DISPLAY_SPACE_DRAW, float opacity=1.0f)
bool blender::IMB_colormanagement_setup_glsl_draw (const ColorManagedViewSettings *view_settings, const ColorManagedDisplaySettings *display_settings, float dither, bool predivide)
bool blender::IMB_colormanagement_setup_glsl_draw_from_space_ctx (const bContext *C, const ColorSpace *from_colorspace, float dither, bool predivide)
bool blender::IMB_colormanagement_setup_glsl_draw_ctx (const bContext *C, float dither, bool predivide)
bool blender::IMB_colormanagement_setup_glsl_draw_to_scene_linear (const char *from_colorspace_name, bool predivide)
void blender::IMB_colormanagement_finish_glsl_draw ()

Variables

static CLG_LogRef blender::LOG = {"color_management"}

Global declarations

#define DISPLAY_BUFFER_CHANNELS   4
static char blender::global_role_data [MAX_COLORSPACE_NAME]
static char blender::global_role_scene_linear [MAX_COLORSPACE_NAME]
static char blender::global_role_color_picking [MAX_COLORSPACE_NAME]
static char blender::global_role_texture_painting [MAX_COLORSPACE_NAME]
static char blender::global_role_default_byte [MAX_COLORSPACE_NAME]
static char blender::global_role_default_float [MAX_COLORSPACE_NAME]
static char blender::global_role_default_sequencer [MAX_COLORSPACE_NAME]
static char blender::global_role_aces_interchange [MAX_COLORSPACE_NAME]
static char blender::global_role_video_rec709 [MAX_COLORSPACE_NAME]
static char blender::global_role_scene_linear_default [MAX_COLORSPACE_NAME]
float3x3 blender::global_scene_linear_to_xyz_default = float3x3::zero()
static pthread_mutex_t blender::processor_lock = BLI_MUTEX_INITIALIZER
blender::GlobalGPUState blender::global_gpu_state
static struct blender::GlobalColorPickingState blender::global_color_picking_state
static void blender::processor_transform_apply_threaded (uchar *byte_buffer, float *float_buffer, int width, int height, int channels, ColormanageProcessor *cm_processor, bool predivide)
static std::unique_ptr< ocio::Config > & blender::g_config ()
static VectorSet< StringRefNull > & blender::g_all_view_names ()
static ColorManagedConfigPath & blender::g_config_active ()
static Vector< ColorManagedConfigPath > & blender::g_config_requested ()
static ColorManagedStartupEnv & blender::g_startup_env ()

Generic Functions

static const int blender::CICP_PRI_REC709 = 1
static const int blender::CICP_PRI_UNSPECIFIED = 2
static const int blender::CICP_PRI_REC2020 = 9
static const int blender::CICP_PRI_XYZD65 = 10
static const int blender::CICP_PRI_P3D65 = 12
static const int blender::CICP_TRC_BT709 = 1
static const int blender::CICP_TRC_UNSPECIFIED = 2
static const int blender::CICP_TRC_G22 = 4
static const int blender::CICP_TRC_LINEAR = 8
static const int blender::CICP_TRC_SRGB = 13
static const int blender::CICP_TRC_PQ = 16
static const int blender::CICP_TRC_SMPTE428 = 17
static const int blender::CICP_TRC_HLG = 18
static const int blender::CICP_MATRIX_RGB = 0
static const int blender::CICP_MATRIX_BT709 = 1
static const int blender::CICP_MATRIX_REC2020_NCL = 9
static const int blender::CICP_RANGE_LIMITED = 0
static const int blender::CICP_RANGE_FULL = 1
StringRefNull blender::IMB_colormanagement_config_path_get ()
ColorManagedConfigSource blender::IMB_colormanagement_config_source_get ()
bool blender::IMB_colormanagement_switch_config (const char *filepath)
static bool blender::colormanage_check_display_settings (ColorManagedDisplaySettings *display_settings, const char *what, const ocio::Display *default_display, const CLG_Level log_level)
static StringRefNull blender::colormanage_find_matching_view_name (const ocio::Display *display, StringRefNull view_name)
static bool blender::colormanage_check_view_settings (ColorManagedDisplaySettings *display_settings, ColorManagedViewSettings *view_settings, const char *what, const CLG_Level log_level)
static void blender::colormanage_name_to_interop_id (const char *name, char *interop_id)
static bool blender::colormanage_check_colorspace_name (char *name, char *interop_id, const char *what, const CLG_Level log_level)
static bool blender::colormanage_check_colorspace_settings (ColorManagedColorspaceSettings *settings, const char *what, const CLG_Level log_level)
ColorManagedConfig & blender::IMB_colormanagement_get_config ()
void blender::IMB_colormanagement_check_file_config (Main *bmain)
void blender::IMB_colormanagement_validate_settings (const ColorManagedDisplaySettings *display_settings, ColorManagedViewSettings *view_settings)
const char * blender::IMB_colormanagement_role_colorspace_name_get (int role)
void blender::IMB_colormanagement_copy_settings (ImBuf *ibuf_src, ImBuf *ibuf_dst)
void blender::IMB_colormanagement_assign_float_colorspace (ImBuf *ibuf, const char *name)
void blender::IMB_colormanagement_assign_byte_colorspace (ImBuf *ibuf, const char *name)
const char * blender::IMB_colormanagement_get_float_colorspace (const ImBuf *ibuf)
const char * blender::IMB_colormanagement_get_byte_colorspace (const ImBuf *ibuf)
const char * blender::IMB_colormanagement_space_from_filepath_rules (const char *filepath)
const ColorSpace * blender::IMB_colormanagement_space_get_named (const char *name)
const ColorSpace * blender::IMB_colormanagement_space_get_named (StringRefNull name)
bool blender::IMB_colormanagement_space_is_data (const ColorSpace *colorspace)
bool blender::IMB_colormanagement_space_is_scene_linear (const ColorSpace *colorspace)
bool blender::IMB_colormanagement_space_is_srgb (const ColorSpace *colorspace)
bool blender::IMB_colormanagement_space_is_scene_linear_srgb (const ColorSpace *colorspace)
bool blender::IMB_colormanagement_space_name_is_data (const char *name)
bool blender::IMB_colormanagement_space_name_is_scene_linear (const char *name)
bool blender::IMB_colormanagement_space_name_is_srgb (const char *name)
const char * blender::IMB_colormanagement_srgb_colorspace_name_get ()
static Vector< char > blender::imb_icc_profile_from_filepath (StringRef filepath)
Vector< char > blender::IMB_colormanagement_space_to_icc_profile (const ColorSpace *colorspace)
static const ColorSpace * blender::video_rec709_colorspace ()
bool blender::IMB_colormanagement_space_to_cicp (const ColorSpace *colorspace, ColorManagedFileOutput output, bool rgb_matrix, int cicp[4])
const ColorSpace * blender::IMB_colormanagement_space_from_cicp (const int cicp[4], ColorManagedFileOutput output)
StringRefNull blender::IMB_colormanagement_space_get_interop_id (const ColorSpace *colorspace)
const ColorSpace * blender::IMB_colormanagement_space_from_interop_id (StringRefNull interop_id)
int blender::IMB_colormanagement_colorspace_get_interop_id_index (const char *name, const char *interop_id)
void blender::IMB_colormanagement_colorspace_interop_id_set (char *name, char *interop_id, int index)
float3x3 blender::IMB_colormanagement_get_xyz_to_scene_linear ()
float3x3 blender::IMB_colormanagement_get_scene_linear_to_xyz ()
void blender::IMB_colormanagement_get_whitepoint (float temperature, float tint, float whitepoint[3])
bool blender::IMB_colormanagement_set_whitepoint (const float whitepoint[3], float &temperature, float &tint)
void blender::IMB_colormanagement_project_read_post (Main *bmain)
void blender::IMB_colormanagement_file_read_post (Main *bmain, Main *old_bmain, bool is_startup, bool have_editable_assets)
void blender::IMB_colormanagement_file_save_post (Main *bmain)
void blender::IMB_colormanagement_undo_read_post (Main *bmain, const MainColorspace &old_colorspace)

Working Space Functions

static const float blender::imb_working_space_compare_threshold = 0.001f
const char * blender::IMB_colormanagement_working_space_get_default ()
int blender::IMB_colormanagement_working_space_get_named_index (const char *name)
const char * blender::IMB_colormanagement_working_space_get_indexed_name (int index)
void blender::IMB_colormanagement_working_space_items_add (EnumPropertyItem **items, int *totitem)
const char * blender::IMB_colormanagement_working_space_get ()
bool blender::IMB_colormanagement_working_space_set_from_name (const char *name)
static bool blender::imb_colormanagement_working_space_set_from_matrix (Main *bmain, const char *name, const float3x3 &scene_linear_to_xyz, const bool report_missing)
static void blender::imb_colormanagement_working_space_set_from_file (Main *bmain, const bool report_missing)
static float3 blender::imb_working_space_convert (const float3x3 &m, const bool is_smaller_gamut, const float3 in_rgb)
static ColorGeometry4f blender::imb_working_space_convert (const float3x3 &m, const bool is_smaller_gamut, const ColorGeometry4f color)
void blender::IMB_colormanagement_working_space_convert (Main *bmain, const float3x3 &current_scene_linear_to_xyz, const float3x3 &new_xyz_to_scene_linear, bool depsgraph_tag=false, bool linked_only=false, bool editable_assets_only=false)
void blender::IMB_colormanagement_working_space_convert (Main *bmain, const Main *reference_bmain)
void blender::IMB_colormanagement_working_space_init_default (Main *bmain)
static void blender::imb_colormanagement_working_space_init_startup (Main *bmain)

Rendering Tables

static const float blender::blackbody_table_r [7][3]
static const float blender::blackbody_table_g [7][3]
static const float blender::blackbody_table_b [7][4]
static float blender::cie_color_match [81][3]
static void blender::blackbody_temperature_to_rec709 (float rec709[3], float t)
void blender::IMB_colormanagement_blackbody_temperature_to_rgb (float r_dest[4], float value)
void blender::IMB_colormanagement_blackbody_temperature_to_rgb_table (float *r_table, int width, float min, float max)
static void blender::wavelength_to_xyz (float xyz[3], float lambda_nm)
void blender::IMB_colormanagement_wavelength_to_rgb (float r_dest[4], float value)
void blender::IMB_colormanagement_wavelength_to_rgb_table (float *r_table, int width)

Macro Definition Documentation

◆ DISPLAY_BUFFER_CHANNELS

#define DISPLAY_BUFFER_CHANNELS   4

Definition at line 143 of file colormanagement.cc.

Referenced by blender::display_buffer_init_handle().