FFmpeg
Macros | Functions | Variables
csp.c File Reference
#include <stdlib.h>
#include <math.h>
#include "attributes.h"
#include "csp.h"
#include "pixfmt.h"
#include "rational.h"

Go to the source code of this file.

Macros

#define AVR(d)   { (int)(d * 100000 + 0.5), 100000 }
 
#define WP_D65   { AVR(0.3127), AVR(0.3290) }
 
#define WP_C   { AVR(0.3100), AVR(0.3160) }
 
#define WP_DCI   { AVR(0.3140), AVR(0.3510) }
 
#define WP_E   { {1, 3}, {1, 3} }
 
#define BT709_alpha   1.099296826809442
 
#define BT709_beta   0.018053968510807
 

Functions

const struct AVLumaCoefficientsav_csp_luma_coeffs_from_avcsp (enum AVColorSpace csp)
 Retrieves the Luma coefficients necessary to construct a conversion matrix from an enum constant describing the colorspace. More...
 
const AVColorPrimariesDescav_csp_primaries_desc_from_id (enum AVColorPrimaries prm)
 Retrieves a complete gamut description from an enum constant describing the color primaries. More...
 
static av_always_inline AVRational abs_sub_q (AVRational r1, AVRational r2)
 
enum AVColorPrimaries av_csp_primaries_id_from_desc (const AVColorPrimariesDesc *prm)
 Detects which enum AVColorPrimaries constant corresponds to the given complete gamut description. More...
 
double av_csp_approximate_trc_gamma (enum AVColorTransferCharacteristic trc)
 Determine a suitable 'gamma' value to match the supplied AVColorTransferCharacteristic. More...
 
static double trc_bt709 (double Lc)
 
static double trc_gamma22 (double Lc)
 
static double trc_gamma28 (double Lc)
 
static double trc_smpte240M (double Lc)
 
static double trc_linear (double Lc)
 
static double trc_log (double Lc)
 
static double trc_log_sqrt (double Lc)
 
static double trc_iec61966_2_4 (double Lc)
 
static double trc_bt1361 (double Lc)
 
static double trc_iec61966_2_1 (double Lc)
 
static double trc_smpte_st2084 (double Lc)
 
static double trc_smpte_st428_1 (double Lc)
 
static double trc_arib_std_b67 (double Lc)
 
av_csp_trc_function av_csp_trc_func_from_id (enum AVColorTransferCharacteristic trc)
 Determine the function needed to apply the given AVColorTransferCharacteristic to linear input. More...
 

Variables

static const struct AVLumaCoefficients luma_coefficients [AVCOL_SPC_NB]
 
static const AVColorPrimariesDesc color_primaries [AVCOL_PRI_NB]
 
static const double approximate_gamma [AVCOL_TRC_NB]
 
static const av_csp_trc_function trc_funcs [AVCOL_TRC_NB]
 

Macro Definition Documentation

◆ AVR

#define AVR (   d)    { (int)(d * 100000 + 0.5), 100000 }

Definition at line 38 of file csp.c.

◆ WP_D65

#define WP_D65   { AVR(0.3127), AVR(0.3290) }

Definition at line 71 of file csp.c.

◆ WP_C

#define WP_C   { AVR(0.3100), AVR(0.3160) }

Definition at line 72 of file csp.c.

◆ WP_DCI

#define WP_DCI   { AVR(0.3140), AVR(0.3510) }

Definition at line 73 of file csp.c.

◆ WP_E

#define WP_E   { {1, 3}, {1, 3} }

Definition at line 74 of file csp.c.

◆ BT709_alpha

#define BT709_alpha   1.099296826809442

Definition at line 160 of file csp.c.

◆ BT709_beta

#define BT709_beta   0.018053968510807

Definition at line 161 of file csp.c.

Function Documentation

◆ abs_sub_q()

static av_always_inline AVRational abs_sub_q ( AVRational  r1,
AVRational  r2 
)
static

Definition at line 103 of file csp.c.

Referenced by av_csp_primaries_id_from_desc().

◆ trc_bt709()

static double trc_bt709 ( double  Lc)
static

Definition at line 163 of file csp.c.

◆ trc_gamma22()

static double trc_gamma22 ( double  Lc)
static

Definition at line 173 of file csp.c.

◆ trc_gamma28()

static double trc_gamma28 ( double  Lc)
static

Definition at line 178 of file csp.c.

◆ trc_smpte240M()

static double trc_smpte240M ( double  Lc)
static

Definition at line 183 of file csp.c.

◆ trc_linear()

static double trc_linear ( double  Lc)
static

Definition at line 193 of file csp.c.

◆ trc_log()

static double trc_log ( double  Lc)
static

Definition at line 198 of file csp.c.

◆ trc_log_sqrt()

static double trc_log_sqrt ( double  Lc)
static

Definition at line 203 of file csp.c.

◆ trc_iec61966_2_4()

static double trc_iec61966_2_4 ( double  Lc)
static

Definition at line 209 of file csp.c.

◆ trc_bt1361()

static double trc_bt1361 ( double  Lc)
static

Definition at line 219 of file csp.c.

◆ trc_iec61966_2_1()

static double trc_iec61966_2_1 ( double  Lc)
static

Definition at line 229 of file csp.c.

◆ trc_smpte_st2084()

static double trc_smpte_st2084 ( double  Lc)
static

Definition at line 239 of file csp.c.

◆ trc_smpte_st428_1()

static double trc_smpte_st428_1 ( double  Lc)
static

Definition at line 254 of file csp.c.

◆ trc_arib_std_b67()

static double trc_arib_std_b67 ( double  Lc)
static

Definition at line 261 of file csp.c.

Variable Documentation

◆ luma_coefficients

const struct AVLumaCoefficients luma_coefficients[AVCOL_SPC_NB]
static
Initial value:
= {
[AVCOL_SPC_FCC] = { AVR(0.30), AVR(0.59), AVR(0.11) },
[AVCOL_SPC_BT470BG] = { AVR(0.299), AVR(0.587), AVR(0.114) },
[AVCOL_SPC_SMPTE170M] = { AVR(0.299), AVR(0.587), AVR(0.114) },
[AVCOL_SPC_BT709] = { AVR(0.2126), AVR(0.7152), AVR(0.0722) },
[AVCOL_SPC_SMPTE240M] = { AVR(0.212), AVR(0.701), AVR(0.087) },
[AVCOL_SPC_YCOCG] = { AVR(0.25), AVR(0.5), AVR(0.25) },
[AVCOL_SPC_RGB] = { AVR(1), AVR(1), AVR(1) },
[AVCOL_SPC_BT2020_NCL] = { AVR(0.2627), AVR(0.6780), AVR(0.0593) },
[AVCOL_SPC_BT2020_CL] = { AVR(0.2627), AVR(0.6780), AVR(0.0593) },
}

Definition at line 46 of file csp.c.

Referenced by av_csp_luma_coeffs_from_avcsp().

◆ color_primaries

const AVColorPrimariesDesc color_primaries[AVCOL_PRI_NB]
static
Initial value:
= {
[AVCOL_PRI_BT709] = { WP_D65, { { AVR(0.640), AVR(0.330) }, { AVR(0.300), AVR(0.600) }, { AVR(0.150), AVR(0.060) } } },
[AVCOL_PRI_BT470M] = { WP_C, { { AVR(0.670), AVR(0.330) }, { AVR(0.210), AVR(0.710) }, { AVR(0.140), AVR(0.080) } } },
[AVCOL_PRI_BT470BG] = { WP_D65, { { AVR(0.640), AVR(0.330) }, { AVR(0.290), AVR(0.600) }, { AVR(0.150), AVR(0.060) } } },
[AVCOL_PRI_SMPTE170M] = { WP_D65, { { AVR(0.630), AVR(0.340) }, { AVR(0.310), AVR(0.595) }, { AVR(0.155), AVR(0.070) } } },
[AVCOL_PRI_SMPTE240M] = { WP_D65, { { AVR(0.630), AVR(0.340) }, { AVR(0.310), AVR(0.595) }, { AVR(0.155), AVR(0.070) } } },
[AVCOL_PRI_SMPTE428] = { WP_E, { { AVR(0.735), AVR(0.265) }, { AVR(0.274), AVR(0.718) }, { AVR(0.167), AVR(0.009) } } },
[AVCOL_PRI_SMPTE431] = { WP_DCI, { { AVR(0.680), AVR(0.320) }, { AVR(0.265), AVR(0.690) }, { AVR(0.150), AVR(0.060) } } },
[AVCOL_PRI_SMPTE432] = { WP_D65, { { AVR(0.680), AVR(0.320) }, { AVR(0.265), AVR(0.690) }, { AVR(0.150), AVR(0.060) } } },
[AVCOL_PRI_FILM] = { WP_C, { { AVR(0.681), AVR(0.319) }, { AVR(0.243), AVR(0.692) }, { AVR(0.145), AVR(0.049) } } },
[AVCOL_PRI_BT2020] = { WP_D65, { { AVR(0.708), AVR(0.292) }, { AVR(0.170), AVR(0.797) }, { AVR(0.131), AVR(0.046) } } },
[AVCOL_PRI_JEDEC_P22] = { WP_D65, { { AVR(0.630), AVR(0.340) }, { AVR(0.295), AVR(0.605) }, { AVR(0.155), AVR(0.077) } } },
}

Definition at line 76 of file csp.c.

Referenced by av_csp_primaries_desc_from_id(), av_csp_primaries_id_from_desc(), color_config(), convert_primaries(), mov_read_colr(), mov_read_vpcc(), print_film_grain_params(), print_primaries(), scale_vaapi_init(), scale_vt_init(), tonemap_vaapi_init(), and vpp_init().

◆ approximate_gamma

const double approximate_gamma[AVCOL_TRC_NB]
static
Initial value:

Definition at line 135 of file csp.c.

Referenced by av_csp_approximate_trc_gamma().

◆ trc_funcs

const av_csp_trc_function trc_funcs[AVCOL_TRC_NB]
static
trc_smpte240M
static double trc_smpte240M(double Lc)
Definition: csp.c:183
WP_D65
#define WP_D65
Definition: csp.c:71
AVCOL_TRC_LINEAR
@ AVCOL_TRC_LINEAR
"Linear transfer characteristics"
Definition: pixfmt.h:589
AVCOL_SPC_YCOCG
@ AVCOL_SPC_YCOCG
Definition: pixfmt.h:619
AVCOL_PRI_JEDEC_P22
@ AVCOL_PRI_JEDEC_P22
Definition: pixfmt.h:572
AVCOL_SPC_RGB
@ AVCOL_SPC_RGB
order of coefficients is actually GBR, also IEC 61966-2-1 (sRGB), YZX and ST 428-1
Definition: pixfmt.h:610
AVCOL_TRC_BT2020_12
@ AVCOL_TRC_BT2020_12
ITU-R BT2020 for 12-bit system.
Definition: pixfmt.h:596
AVCOL_SPC_BT2020_CL
@ AVCOL_SPC_BT2020_CL
ITU-R BT2020 constant luminance system.
Definition: pixfmt.h:621
AVCOL_SPC_BT470BG
@ AVCOL_SPC_BT470BG
also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM / IEC 61966-2-4 xvYCC601
Definition: pixfmt.h:615
AVCOL_TRC_IEC61966_2_1
@ AVCOL_TRC_IEC61966_2_1
IEC 61966-2-1 (sRGB or sYCC)
Definition: pixfmt.h:594
WP_C
#define WP_C
Definition: csp.c:72
AVCOL_TRC_GAMMA28
@ AVCOL_TRC_GAMMA28
also ITU-R BT470BG
Definition: pixfmt.h:586
trc_gamma22
static double trc_gamma22(double Lc)
Definition: csp.c:173
AVCOL_TRC_LOG_SQRT
@ AVCOL_TRC_LOG_SQRT
"Logarithmic transfer characteristic (100 * Sqrt(10) : 1 range)"
Definition: pixfmt.h:591
AVCOL_TRC_GAMMA22
@ AVCOL_TRC_GAMMA22
also ITU-R BT470M / ITU-R BT1700 625 PAL & SECAM
Definition: pixfmt.h:585
trc_iec61966_2_1
static double trc_iec61966_2_1(double Lc)
Definition: csp.c:229
AVCOL_TRC_BT1361_ECG
@ AVCOL_TRC_BT1361_ECG
ITU-R BT1361 Extended Colour Gamut.
Definition: pixfmt.h:593
AVCOL_SPC_SMPTE170M
@ AVCOL_SPC_SMPTE170M
also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC / functionally identical to above
Definition: pixfmt.h:616
AVCOL_PRI_SMPTE428
@ AVCOL_PRI_SMPTE428
SMPTE ST 428-1 (CIE 1931 XYZ)
Definition: pixfmt.h:567
AVCOL_PRI_SMPTE240M
@ AVCOL_PRI_SMPTE240M
identical to above, also called "SMPTE C" even though it uses D65
Definition: pixfmt.h:564
AVCOL_PRI_BT470BG
@ AVCOL_PRI_BT470BG
also ITU-R BT601-6 625 / ITU-R BT1358 625 / ITU-R BT1700 625 PAL & SECAM
Definition: pixfmt.h:562
AVCOL_PRI_SMPTE170M
@ AVCOL_PRI_SMPTE170M
also ITU-R BT601-6 525 / ITU-R BT1358 525 / ITU-R BT1700 NTSC
Definition: pixfmt.h:563
AVCOL_TRC_IEC61966_2_4
@ AVCOL_TRC_IEC61966_2_4
IEC 61966-2-4.
Definition: pixfmt.h:592
AVCOL_PRI_BT709
@ AVCOL_PRI_BT709
also ITU-R BT1361 / IEC 61966-2-4 / SMPTE RP 177 Annex B
Definition: pixfmt.h:557
trc_bt1361
static double trc_bt1361(double Lc)
Definition: csp.c:219
AVCOL_TRC_BT2020_10
@ AVCOL_TRC_BT2020_10
ITU-R BT2020 for 10-bit system.
Definition: pixfmt.h:595
AVCOL_PRI_BT2020
@ AVCOL_PRI_BT2020
ITU-R BT2020.
Definition: pixfmt.h:566
AVCOL_TRC_SMPTE2084
@ AVCOL_TRC_SMPTE2084
SMPTE ST 2084 for 10-, 12-, 14- and 16-bit systems.
Definition: pixfmt.h:597
AVCOL_PRI_SMPTE431
@ AVCOL_PRI_SMPTE431
SMPTE ST 431-2 (2011) / DCI P3.
Definition: pixfmt.h:569
AVCOL_TRC_SMPTE240M
@ AVCOL_TRC_SMPTE240M
Definition: pixfmt.h:588
AVCOL_PRI_FILM
@ AVCOL_PRI_FILM
colour filters using Illuminant C
Definition: pixfmt.h:565
trc_log
static double trc_log(double Lc)
Definition: csp.c:198
AVCOL_TRC_LOG
@ AVCOL_TRC_LOG
"Logarithmic transfer characteristic (100:1 range)"
Definition: pixfmt.h:590
trc_smpte_st2084
static double trc_smpte_st2084(double Lc)
Definition: csp.c:239
AVCOL_TRC_BT709
@ AVCOL_TRC_BT709
also ITU-R BT1361
Definition: pixfmt.h:582
AVCOL_SPC_SMPTE240M
@ AVCOL_SPC_SMPTE240M
derived from 170M primaries and D65 white point, 170M is derived from BT470 System M's primaries
Definition: pixfmt.h:617
AVCOL_SPC_BT2020_NCL
@ AVCOL_SPC_BT2020_NCL
ITU-R BT2020 non-constant luminance system.
Definition: pixfmt.h:620
trc_bt709
static double trc_bt709(double Lc)
Definition: csp.c:163
AVCOL_PRI_BT470M
@ AVCOL_PRI_BT470M
also FCC Title 47 Code of Federal Regulations 73.682 (a)(20)
Definition: pixfmt.h:560
WP_E
#define WP_E
Definition: csp.c:74
AVR
#define AVR(d)
Definition: csp.c:38
trc_linear
static double trc_linear(double Lc)
Definition: csp.c:193
WP_DCI
#define WP_DCI
Definition: csp.c:73
AVCOL_TRC_ARIB_STD_B67
@ AVCOL_TRC_ARIB_STD_B67
ARIB STD-B67, known as "Hybrid log-gamma".
Definition: pixfmt.h:601
trc_gamma28
static double trc_gamma28(double Lc)
Definition: csp.c:178
AVCOL_SPC_FCC
@ AVCOL_SPC_FCC
FCC Title 47 Code of Federal Regulations 73.682 (a)(20)
Definition: pixfmt.h:614
AVCOL_TRC_SMPTE170M
@ AVCOL_TRC_SMPTE170M
also ITU-R BT601-6 525 or 625 / ITU-R BT1358 525 or 625 / ITU-R BT1700 NTSC
Definition: pixfmt.h:587
trc_log_sqrt
static double trc_log_sqrt(double Lc)
Definition: csp.c:203
AVCOL_PRI_SMPTE432
@ AVCOL_PRI_SMPTE432
SMPTE ST 432-1 (2010) / P3 D65 / Display P3.
Definition: pixfmt.h:570
AVCOL_TRC_SMPTE428
@ AVCOL_TRC_SMPTE428
SMPTE ST 428-1.
Definition: pixfmt.h:599
trc_arib_std_b67
static double trc_arib_std_b67(double Lc)
Definition: csp.c:261
trc_smpte_st428_1
static double trc_smpte_st428_1(double Lc)
Definition: csp.c:254
AVCOL_SPC_BT709
@ AVCOL_SPC_BT709
also ITU-R BT1361 / IEC 61966-2-4 xvYCC709 / derived in SMPTE RP 177 Annex B
Definition: pixfmt.h:611
trc_iec61966_2_4
static double trc_iec61966_2_4(double Lc)
Definition: csp.c:209