PipeWire 1.4.5 |

Loading...
Searching...
No Matches
color.h
Go to the documentation of this file.
1/* Simple Plugin API */
2/* SPDX-FileCopyrightText: Copyright © 2018 Wim Taymans */
3/* SPDX-License-Identifier: MIT */
4
5#ifndef SPA_VIDEO_COLOR_H
6#define SPA_VIDEO_COLOR_H
7
8#ifdef __cplusplus
9 extern "C" {
10#endif
11
16
21 enum spa_video_color_range {
22 SPA_VIDEO_COLOR_RANGE_UNKNOWN = 0,
23 SPA_VIDEO_COLOR_RANGE_0_255,
24 SPA_VIDEO_COLOR_RANGE_16_235
26};
27
32 enum spa_video_color_matrix {
33 SPA_VIDEO_COLOR_MATRIX_UNKNOWN = 0,
34 SPA_VIDEO_COLOR_MATRIX_RGB,
35 SPA_VIDEO_COLOR_MATRIX_FCC,
36 SPA_VIDEO_COLOR_MATRIX_BT709,
37 SPA_VIDEO_COLOR_MATRIX_BT601,
38 SPA_VIDEO_COLOR_MATRIX_SMPTE240M,
39 SPA_VIDEO_COLOR_MATRIX_BT2020,
40};
41
46 enum spa_video_transfer_function {
47 SPA_VIDEO_TRANSFER_UNKNOWN = 0,
48 SPA_VIDEO_TRANSFER_GAMMA10,
49 SPA_VIDEO_TRANSFER_GAMMA18,
50 SPA_VIDEO_TRANSFER_GAMMA20,
51 SPA_VIDEO_TRANSFER_GAMMA22,
52 SPA_VIDEO_TRANSFER_BT709,
53 SPA_VIDEO_TRANSFER_SMPTE240M,
54 SPA_VIDEO_TRANSFER_SRGB,
55 SPA_VIDEO_TRANSFER_GAMMA28,
56 SPA_VIDEO_TRANSFER_LOG100,
57 SPA_VIDEO_TRANSFER_LOG316,
58 SPA_VIDEO_TRANSFER_BT2020_12,
61 SPA_VIDEO_TRANSFER_ADOBERGB,
62};
63
68 enum spa_video_color_primaries {
69 SPA_VIDEO_COLOR_PRIMARIES_UNKNOWN = 0,
70 SPA_VIDEO_COLOR_PRIMARIES_BT709,
71 SPA_VIDEO_COLOR_PRIMARIES_BT470M,
72 SPA_VIDEO_COLOR_PRIMARIES_BT470BG,
73 SPA_VIDEO_COLOR_PRIMARIES_SMPTE170M,
74 SPA_VIDEO_COLOR_PRIMARIES_SMPTE240M,
75 SPA_VIDEO_COLOR_PRIMARIES_FILM,
76 SPA_VIDEO_COLOR_PRIMARIES_BT2020,
77 SPA_VIDEO_COLOR_PRIMARIES_ADOBERGB,
78};
79
84
85 struct spa_video_colorimetry {
86 enum spa_video_color_range range;
89 enum spa_video_color_matrix matrix;
90 * non-linear RGB (R'G'B') */
91 enum spa_video_transfer_function transfer;
93 enum spa_video_color_primaries primaries;
95};
96
100
101#ifdef __cplusplus
102} /* extern "C" */
103#endif
104
105#endif /* SPA_VIDEO_COLOR_H */
spa_video_color_matrix
spa_video_color_matrix
The color matrix is used to convert between Y'PbPr and non-linear RGB (R'G'B')
Definition color.h:37
spa_video_color_range
spa_video_color_range
Possible color range values.
Definition color.h:26
spa_video_color_primaries
spa_video_color_primaries
The color primaries define the how to transform linear RGB values to and from the CIE XYZ colorspace.
Definition color.h:73
spa_video_transfer_function
spa_video_transfer_function
The video transfer function defines the formula for converting between non-linear RGB (R'G'B') and li...
Definition color.h:51
SPA_VIDEO_COLOR_MATRIX_FCC
@ SPA_VIDEO_COLOR_MATRIX_FCC
FCC color matrix.
Definition color.h:40
SPA_VIDEO_COLOR_MATRIX_BT709
@ SPA_VIDEO_COLOR_MATRIX_BT709
ITU BT.709 color matrix.
Definition color.h:41
SPA_VIDEO_COLOR_MATRIX_UNKNOWN
@ SPA_VIDEO_COLOR_MATRIX_UNKNOWN
unknown matrix
Definition color.h:38
SPA_VIDEO_COLOR_MATRIX_SMPTE240M
@ SPA_VIDEO_COLOR_MATRIX_SMPTE240M
SMTPE 240M color matrix.
Definition color.h:43
SPA_VIDEO_COLOR_MATRIX_BT601
@ SPA_VIDEO_COLOR_MATRIX_BT601
ITU BT.601 color matrix.
Definition color.h:42
SPA_VIDEO_COLOR_MATRIX_RGB
@ SPA_VIDEO_COLOR_MATRIX_RGB
identity matrix
Definition color.h:39
SPA_VIDEO_COLOR_MATRIX_BT2020
@ SPA_VIDEO_COLOR_MATRIX_BT2020
ITU-R BT.2020 color matrix.
Definition color.h:44
SPA_VIDEO_COLOR_RANGE_16_235
@ SPA_VIDEO_COLOR_RANGE_16_235
[16..235] for 8 bit components.
Definition color.h:29
SPA_VIDEO_COLOR_RANGE_UNKNOWN
@ SPA_VIDEO_COLOR_RANGE_UNKNOWN
unknown range
Definition color.h:27
SPA_VIDEO_COLOR_RANGE_0_255
@ SPA_VIDEO_COLOR_RANGE_0_255
[0..255] for 8 bit components
Definition color.h:28
SPA_VIDEO_COLOR_PRIMARIES_BT709
@ SPA_VIDEO_COLOR_PRIMARIES_BT709
BT709 primaries.
Definition color.h:75
SPA_VIDEO_COLOR_PRIMARIES_UNKNOWN
@ SPA_VIDEO_COLOR_PRIMARIES_UNKNOWN
unknown color primaries
Definition color.h:74
SPA_VIDEO_COLOR_PRIMARIES_SMPTE240M
@ SPA_VIDEO_COLOR_PRIMARIES_SMPTE240M
SMPTE240M primaries.
Definition color.h:79
SPA_VIDEO_COLOR_PRIMARIES_BT470M
@ SPA_VIDEO_COLOR_PRIMARIES_BT470M
BT470M primaries.
Definition color.h:76
SPA_VIDEO_COLOR_PRIMARIES_ADOBERGB
@ SPA_VIDEO_COLOR_PRIMARIES_ADOBERGB
Adobe RGB primaries.
Definition color.h:82
SPA_VIDEO_COLOR_PRIMARIES_SMPTE170M
@ SPA_VIDEO_COLOR_PRIMARIES_SMPTE170M
SMPTE170M primaries.
Definition color.h:78
SPA_VIDEO_COLOR_PRIMARIES_FILM
@ SPA_VIDEO_COLOR_PRIMARIES_FILM
Generic film.
Definition color.h:80
SPA_VIDEO_COLOR_PRIMARIES_BT2020
@ SPA_VIDEO_COLOR_PRIMARIES_BT2020
BT2020 primaries.
Definition color.h:81
SPA_VIDEO_COLOR_PRIMARIES_BT470BG
@ SPA_VIDEO_COLOR_PRIMARIES_BT470BG
BT470BG primaries.
Definition color.h:77
SPA_VIDEO_TRANSFER_ADOBERGB
@ SPA_VIDEO_TRANSFER_ADOBERGB
Gamma 2.19921875.
Definition color.h:66
SPA_VIDEO_TRANSFER_LOG316
@ SPA_VIDEO_TRANSFER_LOG316
Logarithmic transfer characteristic 316.22777:1 range.
Definition color.h:62
SPA_VIDEO_TRANSFER_SRGB
@ SPA_VIDEO_TRANSFER_SRGB
Gamma 2.4 curve with a linear segment in the lower range.
Definition color.h:59
SPA_VIDEO_TRANSFER_SMPTE240M
@ SPA_VIDEO_TRANSFER_SMPTE240M
Gamma 2.2 curve with a linear segment in the lower range.
Definition color.h:58
SPA_VIDEO_TRANSFER_GAMMA28
@ SPA_VIDEO_TRANSFER_GAMMA28
Gamma 2.8 curve.
Definition color.h:60
SPA_VIDEO_TRANSFER_GAMMA10
@ SPA_VIDEO_TRANSFER_GAMMA10
linear RGB, gamma 1.0 curve
Definition color.h:53
SPA_VIDEO_TRANSFER_BT2020_12
@ SPA_VIDEO_TRANSFER_BT2020_12
Gamma 2.2 curve with a linear segment in the lower range.
Definition color.h:63
SPA_VIDEO_TRANSFER_GAMMA22
@ SPA_VIDEO_TRANSFER_GAMMA22
Gamma 2.2 curve.
Definition color.h:56
SPA_VIDEO_TRANSFER_BT709
@ SPA_VIDEO_TRANSFER_BT709
Gamma 2.2 curve with a linear segment in the lower range.
Definition color.h:57
SPA_VIDEO_TRANSFER_UNKNOWN
@ SPA_VIDEO_TRANSFER_UNKNOWN
unknown transfer function
Definition color.h:52
SPA_VIDEO_TRANSFER_LOG100
@ SPA_VIDEO_TRANSFER_LOG100
Logarithmic transfer characteristic 100:1 range.
Definition color.h:61
SPA_VIDEO_TRANSFER_GAMMA20
@ SPA_VIDEO_TRANSFER_GAMMA20
Gamma 2.0 curve.
Definition color.h:55
SPA_VIDEO_TRANSFER_GAMMA18
@ SPA_VIDEO_TRANSFER_GAMMA18
Gamma 1.8 curve.
Definition color.h:54
spa_video_colorimetry
spa_video_colorimetry:
Definition color.h:90
spa_video_colorimetry::range
enum spa_video_color_range range
The color range.
Definition color.h:91
spa_video_colorimetry::matrix
enum spa_video_color_matrix matrix
the color matrix.
Definition color.h:94
spa_video_colorimetry::transfer
enum spa_video_transfer_function transfer
The transfer function.
Definition color.h:96
spa_video_colorimetry::primaries
enum spa_video_color_primaries primaries
Color primaries.
Definition color.h:98