#include "common/chromatic_adaptation.h"
#include "common/image.h"

Include dependency graph for illuminants.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	pair

Typedefs
typedef enum dt_illuminant_t	dt_illuminant_t

typedef enum dt_illuminant_fluo_t	dt_illuminant_fluo_t

typedef enum dt_illuminant_led_t	dt_illuminant_led_t

typedef struct pair	pair

Enumerations
enum	dt_illuminant_t { DT_ILLUMINANT_PIPE = 0 , DT_ILLUMINANT_A = 1 , DT_ILLUMINANT_D = 2 , DT_ILLUMINANT_E = 3 , DT_ILLUMINANT_F = 4 , DT_ILLUMINANT_LED = 5 , DT_ILLUMINANT_BB = 6 , DT_ILLUMINANT_CUSTOM = 7 , DT_ILLUMINANT_DETECT_SURFACES = 8 , DT_ILLUMINANT_DETECT_EDGES = 9 , DT_ILLUMINANT_CAMERA = 10 , DT_ILLUMINANT_LAST }

enum	dt_illuminant_fluo_t { DT_ILLUMINANT_FLUO_F1 = 0 , DT_ILLUMINANT_FLUO_F2 = 1 , DT_ILLUMINANT_FLUO_F3 = 2 , DT_ILLUMINANT_FLUO_F4 = 3 , DT_ILLUMINANT_FLUO_F5 = 4 , DT_ILLUMINANT_FLUO_F6 = 5 , DT_ILLUMINANT_FLUO_F7 = 6 , DT_ILLUMINANT_FLUO_F8 = 7 , DT_ILLUMINANT_FLUO_F9 = 8 , DT_ILLUMINANT_FLUO_F10 = 9 , DT_ILLUMINANT_FLUO_F11 = 10 , DT_ILLUMINANT_FLUO_F12 = 11 , DT_ILLUMINANT_FLUO_LAST }

enum	dt_illuminant_led_t { DT_ILLUMINANT_LED_B1 = 0 , DT_ILLUMINANT_LED_B2 = 1 , DT_ILLUMINANT_LED_B3 = 2 , DT_ILLUMINANT_LED_B4 = 3 , DT_ILLUMINANT_LED_B5 = 4 , DT_ILLUMINANT_LED_BH1 = 5 , DT_ILLUMINANT_LED_RGB1 = 6 , DT_ILLUMINANT_LED_V1 = 7 , DT_ILLUMINANT_LED_V2 = 8 , DT_ILLUMINANT_LED_LAST }

Functions
static float	xy_to_CCT (const float x, const float y)

static void	CCT_to_xy_daylight (const float t, float x, float y)

static void	CCT_to_xy_blackbody (const float t, float x, float y)

static void	illuminant_xy_to_XYZ (const float x, const float y, dt_aligned_pixel_t XYZ)

static void	illuminant_xy_to_RGB (const float x, const float y, dt_aligned_pixel_t RGB)

static void	illuminant_CCT_to_RGB (const float t, dt_aligned_pixel_t RGB)

static int	find_temperature_from_raw_coeffs (const dt_image_t img, const dt_aligned_pixel_t custom_wb, float chroma_x, float *chroma_y)

static int	illuminant_to_xy (const dt_illuminant_t illuminant, const dt_image_t img, const dt_aligned_pixel_t custom_wb, float x_out, float *y_out, const float t, const dt_illuminant_fluo_t fluo, const dt_illuminant_led_t iled)

static void	WB_coeffs_to_illuminant_xy (const float CAM_to_XYZ[4][3], const dt_aligned_pixel_t WB, float x, float y)

static void	matrice_pseudoinverse (float(in)[3], float(out)[3], int size)

static float	planckian_normal (const float x, const float t)

static void	blackbody_xy_to_tinted_xy (const float x, const float y, const float t, const float tint, float x_out, float y_out)

static float	get_tint_from_tinted_xy (const float x, const float y, const float t)

static void	xy_to_uv (const float xy[2], float uv[2])

struct pair	pair_min (struct pair r, struct pair n)

static float	CCT_reverse_lookup (const float x, const float y)

Variables
static float	fluorescent [DT_ILLUMINANT_FLUO_LAST][2]

static float	led [DT_ILLUMINANT_LED_LAST][2]

Typedef Documentation

◆ dt_illuminant_fluo_t

typedef enum dt_illuminant_fluo_t dt_illuminant_fluo_t

◆ dt_illuminant_led_t

typedef enum dt_illuminant_led_t dt_illuminant_led_t

◆ dt_illuminant_t

typedef enum dt_illuminant_t dt_illuminant_t

◆ pair

typedef struct pair pair

Enumeration Type Documentation

◆ dt_illuminant_fluo_t

enum dt_illuminant_fluo_t

Enumerator
DT_ILLUMINANT_FLUO_F1
DT_ILLUMINANT_FLUO_F2
DT_ILLUMINANT_FLUO_F3
DT_ILLUMINANT_FLUO_F4
DT_ILLUMINANT_FLUO_F5
DT_ILLUMINANT_FLUO_F6
DT_ILLUMINANT_FLUO_F7
DT_ILLUMINANT_FLUO_F8
DT_ILLUMINANT_FLUO_F9
DT_ILLUMINANT_FLUO_F10
DT_ILLUMINANT_FLUO_F11
DT_ILLUMINANT_FLUO_F12
DT_ILLUMINANT_FLUO_LAST

◆ dt_illuminant_led_t

enum dt_illuminant_led_t

Enumerator
DT_ILLUMINANT_LED_B1
DT_ILLUMINANT_LED_B2
DT_ILLUMINANT_LED_B3
DT_ILLUMINANT_LED_B4
DT_ILLUMINANT_LED_B5
DT_ILLUMINANT_LED_BH1
DT_ILLUMINANT_LED_RGB1
DT_ILLUMINANT_LED_V1
DT_ILLUMINANT_LED_V2
DT_ILLUMINANT_LED_LAST

◆ dt_illuminant_t

enum dt_illuminant_t

Enumerator
DT_ILLUMINANT_PIPE
DT_ILLUMINANT_A
DT_ILLUMINANT_D
DT_ILLUMINANT_E
DT_ILLUMINANT_F
DT_ILLUMINANT_LED
DT_ILLUMINANT_BB
DT_ILLUMINANT_CUSTOM
DT_ILLUMINANT_DETECT_SURFACES
DT_ILLUMINANT_DETECT_EDGES
DT_ILLUMINANT_CAMERA
DT_ILLUMINANT_LAST

Function Documentation

◆ blackbody_xy_to_tinted_xy()

static void blackbody_xy_to_tinted_xy	(	const float	x,
		const float	y,
		const float	t,
		const float	tint,
		float *	x_out,
		float *	y_out
	)

inlinestatic

References planckian_normal().

◆ CCT_reverse_lookup()

static float CCT_reverse_lookup	(	const float	x,
		const float	y
	)

inlinestatic

References CCT_to_xy_blackbody(), CCT_to_xy_daylight(), dt_fast_hypotf(), pair_min(), and pair::temperature.

Referenced by check_if_close_to_daylight(), and illum_xy_callback().

◆ CCT_to_xy_blackbody()

static void CCT_to_xy_blackbody	(	const float	t,
		float *	x,
		float *	y
	)

inlinestatic

Referenced by CCT_reverse_lookup(), get_tint_from_tinted_xy(), illuminant_CCT_to_RGB(), and illuminant_to_xy().

◆ CCT_to_xy_daylight()

static void CCT_to_xy_daylight	(	const float	t,
		float *	x,
		float *	y
	)

inlinestatic

Referenced by CCT_reverse_lookup(), illuminant_CCT_to_RGB(), and illuminant_to_xy().

◆ find_temperature_from_raw_coeffs()

static int find_temperature_from_raw_coeffs	(	const dt_image_t *	img,
		const dt_aligned_pixel_t	custom_wb,
		float *	chroma_x,
		float *	chroma_y
	)

inlinestatic

References dt_image_t::adobe_XYZ_to_CAM, dt_image_t::d65_color_matrix, DT_IMAGE_4BAYER, dt_image_is_matrix_correction_supported(), FALSE, dt_image_t::flags, matrice_pseudoinverse(), TRUE, dt_image_t::wb_coeffs, and WB_coeffs_to_illuminant_xy().

Referenced by gui_changed(), illuminant_to_xy(), process(), and reload_defaults().

◆ get_tint_from_tinted_xy()

static float get_tint_from_tinted_xy	(	const float	x,
		const float	y,
		const float	t
	)

inlinestatic

References CCT_to_xy_blackbody(), and planckian_normal().

◆ illuminant_CCT_to_RGB()

static void illuminant_CCT_to_RGB	(	const float	t,
		dt_aligned_pixel_t	RGB
	)

inlinestatic

References CCT_to_xy_blackbody(), CCT_to_xy_daylight(), and illuminant_xy_to_RGB().

Referenced by paint_temperature_background().

◆ illuminant_to_xy()

static int illuminant_to_xy	(	const dt_illuminant_t	illuminant,
		const dt_image_t *	img,
		const dt_aligned_pixel_t	custom_wb,
		float *	x_out,
		float *	y_out,
		const float	t,
		const dt_illuminant_fluo_t	fluo,
		const dt_illuminant_led_t	iled
	)

inlinestatic

Compute the x and y chromaticity coordinates in Yxy spaces for standard illuminants

Returns : TRUE if chromaticity of the requested standard illuminant has been found FALSE if no valid chromaticity has been found or custom illuminant has been requested

References CCT_to_xy_blackbody(), CCT_to_xy_daylight(), DT_ILLUMINANT_A, DT_ILLUMINANT_BB, DT_ILLUMINANT_CAMERA, DT_ILLUMINANT_CUSTOM, DT_ILLUMINANT_D, DT_ILLUMINANT_DETECT_EDGES, DT_ILLUMINANT_DETECT_SURFACES, DT_ILLUMINANT_E, DT_ILLUMINANT_F, DT_ILLUMINANT_FLUO_LAST, DT_ILLUMINANT_LAST, DT_ILLUMINANT_LED, DT_ILLUMINANT_LED_LAST, DT_ILLUMINANT_PIPE, FALSE, find_temperature_from_raw_coeffs(), fluorescent, led, and TRUE.

Referenced by _auto_set_illuminant(), check_if_close_to_daylight(), commit_params(), gui_changed(), illuminant_color_draw(), init_presets(), and update_approx_cct().

◆ illuminant_xy_to_RGB()

static void illuminant_xy_to_RGB	(	const float	x,
		const float	y,
		dt_aligned_pixel_t	RGB
	)

inlinestatic

References dt_XYZ_to_Rec709_D50(), and illuminant_xy_to_XYZ().

Referenced by illuminant_CCT_to_RGB(), illuminant_color_draw(), and update_xy_color().

◆ illuminant_xy_to_XYZ()

static void illuminant_xy_to_XYZ	(	const float	x,
		const float	y,
		dt_aligned_pixel_t	XYZ
	)

inlinestatic

Referenced by _auto_set_illuminant(), commit_params(), extract_color_checker(), illuminant_xy_to_RGB(), and process().

◆ matrice_pseudoinverse()

static void matrice_pseudoinverse	(	float(*)	in[3],
		float(*)	out[3],
		int	size
	)

inlinestatic

References DT_ALIGNED_ARRAY, and size.

Referenced by _auto_set_illuminant(), and find_temperature_from_raw_coeffs().

◆ pair_min()

struct pair pair_min	(	struct pair	r,
		struct pair	n
	)

Referenced by CCT_reverse_lookup().

◆ planckian_normal()

static float planckian_normal	(	const float	x,
		const float	t
	)

inlinestatic

Referenced by blackbody_xy_to_tinted_xy(), and get_tint_from_tinted_xy().

◆ WB_coeffs_to_illuminant_xy()

static void WB_coeffs_to_illuminant_xy	(	const float	CAM_to_XYZ[4][3],
		const dt_aligned_pixel_t	WB,
		float *	x,
		float *	y
	)

inlinestatic

References bradford_adapt_D50(), convert_bradford_LMS_to_XYZ(), convert_XYZ_to_bradford_LMS(), and FALSE.

Referenced by find_temperature_from_raw_coeffs().

◆ xy_to_CCT()

static float xy_to_CCT	(	const float	x,
		const float	y
	)

inlinestatic

Referenced by check_if_close_to_daylight(), and illum_xy_callback().

◆ xy_to_uv()

static void xy_to_uv	(	const float	xy[2],
		float	uv[2]
	)

inlinestatic

Referenced by check_if_close_to_daylight().

Variable Documentation

◆ fluorescent

float fluorescent[DT_ILLUMINANT_FLUO_LAST][2]

static

Initial value:

= { { 0.31310f, 0.33727f },   
                                                          { 0.37208f, 0.37529f },   
                                                          { 0.40910f, 0.39430f },   
                                                          { 0.44018f, 0.40329f },   
                                                          { 0.31379f, 0.34531f },   
                                                          { 0.37790f, 0.38835f },   
                                                          { 0.31292f, 0.32933f },   
                                                          { 0.34588f, 0.35875f },   
                                                          { 0.37417f, 0.37281f },   
                                                          { 0.34609f, 0.35986f },   
                                                          { 0.38052f, 0.37713f },   
                                                          { 0.43695f, 0.40441f } }

References: https://en.wikipedia.org/wiki/Planckian_locus https://en.wikipedia.org/wiki/Standard_illuminant

Note : All values are x and y chromaticities for CIE 1931 2° observer

Referenced by illuminant_to_xy().

◆ led

float led[DT_ILLUMINANT_LED_LAST][2]

static

Initial value:

= { { 0.4560f, 0.4078f },  
                                                { 0.4357f, 0.4012f },  
                                                { 0.3756f, 0.3723f },  
                                                { 0.3422f, 0.3502f },  
                                                { 0.3118f, 0.3236f },  
                                                { 0.4474f, 0.4066f },  
                                                { 0.4557f, 0.4211f },  
                                                { 0.4560f, 0.4548f },  
                                                { 0.3781f, 0.3775f }}

FLUORESCENT

F1-F6 : standard fluo lamps (two semi-broadband emissions). F4 : used for calibrating the CIE color rendering index (CRI = 51). F7-F9 : broadband / full-spectrum light (multiple phosphors, higher CRI). F10-F12 : three narrowband emissions in the R,G,B regions of the visible spectrum tuned to desired CCT.

Referenced by illuminant_to_xy().

Data Structures

Typedefs

Enumerations

Functions

Variables

Typedef Documentation

◆ dt_illuminant_fluo_t

◆ dt_illuminant_led_t

◆ dt_illuminant_t

◆ pair

Enumeration Type Documentation

◆ dt_illuminant_fluo_t

◆ dt_illuminant_led_t

◆ dt_illuminant_t

Function Documentation

◆ blackbody_xy_to_tinted_xy()

◆ CCT_reverse_lookup()

◆ CCT_to_xy_blackbody()

◆ CCT_to_xy_daylight()

◆ find_temperature_from_raw_coeffs()

◆ get_tint_from_tinted_xy()

◆ illuminant_CCT_to_RGB()

◆ illuminant_to_xy()

◆ illuminant_xy_to_RGB()

◆ illuminant_xy_to_XYZ()

◆ matrice_pseudoinverse()

◆ pair_min()

◆ planckian_normal()

◆ WB_coeffs_to_illuminant_xy()

◆ xy_to_CCT()

◆ xy_to_uv()

Variable Documentation

◆ fluorescent

◆ led