Debian Codegraph @

Documentation/userspace-api/media/v4l/colorspaces-details.rst

raw
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2 .. c:namespace:: V4L
3
4 ********************************
5 Detailed Colorspace Descriptions
6 ********************************
7
8
9 .. _col-smpte-170m:
10
11 Colorspace SMPTE 170M (V4L2_COLORSPACE_SMPTE170M)
12 =================================================
13
14 The :ref:`smpte170m` standard defines the colorspace used by NTSC and
15 PAL and by SDTV in general. The default transfer function is
16 ``V4L2_XFER_FUNC_709``. The default Y'CbCr encoding is
17 ``V4L2_YCBCR_ENC_601``. The default Y'CbCr quantization is limited
18 range. The chromaticities of the primary colors and the white reference
19 are:
20
21 .. flat-table:: SMPTE 170M Chromaticities
22 :header-rows: 1
23 :stub-columns: 0
24 :widths: 1 1 2
25
26 * - Color
27 - x
28 - y
29 * - Red
30 - 0.630
31 - 0.340
32 * - Green
33 - 0.310
34 - 0.595
35 * - Blue
36 - 0.155
37 - 0.070
38 * - White Reference (D65)
39 - 0.3127
40 - 0.3290
41
42
43 The red, green and blue chromaticities are also often referred to as the
44 SMPTE C set, so this colorspace is sometimes called SMPTE C as well.
45
46 The transfer function defined for SMPTE 170M is the same as the one
47 defined in Rec. 709.
48
49 .. math::
50
51 L' = -1.099(-L)^{0.45} + 0.099 \text{, for } L \le-0.018
52
53 L' = 4.5L \text{, for } -0.018 < L < 0.018
54
55 L' = 1.099L^{0.45} - 0.099 \text{, for } L \ge 0.018
56
57 Inverse Transfer function:
58
59 .. math::
60
61 L = -\left( \frac{L' - 0.099}{-1.099} \right) ^{\frac{1}{0.45}} \text{, for } L' \le -0.081
62
63 L = \frac{L'}{4.5} \text{, for } -0.081 < L' < 0.081
64
65 L = \left(\frac{L' + 0.099}{1.099}\right)^{\frac{1}{0.45} } \text{, for } L' \ge 0.081
66
67 The luminance (Y') and color difference (Cb and Cr) are obtained with
68 the following ``V4L2_YCBCR_ENC_601`` encoding:
69
70 .. math::
71
72 Y' = 0.2990R' + 0.5870G' + 0.1140B'
73
74 Cb = -0.1687R' - 0.3313G' + 0.5B'
75
76 Cr = 0.5R' - 0.4187G' - 0.0813B'
77
78 Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
79 [-0.5…0.5]. This conversion to Y'CbCr is identical to the one defined in
80 the :ref:`itu601` standard and this colorspace is sometimes called
81 BT.601 as well, even though BT.601 does not mention any color primaries.
82
83 The default quantization is limited range, but full range is possible
84 although rarely seen.
85
86
87 .. _col-rec709:
88
89 Colorspace Rec. 709 (V4L2_COLORSPACE_REC709)
90 ============================================
91
92 The :ref:`itu709` standard defines the colorspace used by HDTV in
93 general. The default transfer function is ``V4L2_XFER_FUNC_709``. The
94 default Y'CbCr encoding is ``V4L2_YCBCR_ENC_709``. The default Y'CbCr
95 quantization is limited range. The chromaticities of the primary colors
96 and the white reference are:
97
98 .. flat-table:: Rec. 709 Chromaticities
99 :header-rows: 1
100 :stub-columns: 0
101 :widths: 1 1 2
102
103 * - Color
104 - x
105 - y
106 * - Red
107 - 0.640
108 - 0.330
109 * - Green
110 - 0.300
111 - 0.600
112 * - Blue
113 - 0.150
114 - 0.060
115 * - White Reference (D65)
116 - 0.3127
117 - 0.3290
118
119
120 The full name of this standard is Rec. ITU-R BT.709-5.
121
122 Transfer function. Normally L is in the range [0…1], but for the
123 extended gamut xvYCC encoding values outside that range are allowed.
124
125 .. math::
126
127 L' = -1.099(-L)^{0.45} + 0.099 \text{, for } L \le -0.018
128
129 L' = 4.5L \text{, for } -0.018 < L < 0.018
130
131 L' = 1.099L^{0.45} - 0.099 \text{, for } L \ge 0.018
132
133 Inverse Transfer function:
134
135 .. math::
136
137 L = -\left( \frac{L' - 0.099}{-1.099} \right)^\frac{1}{0.45} \text{, for } L' \le -0.081
138
139 L = \frac{L'}{4.5}\text{, for } -0.081 < L' < 0.081
140
141 L = \left(\frac{L' + 0.099}{1.099}\right)^{\frac{1}{0.45} } \text{, for } L' \ge 0.081
142
143 The luminance (Y') and color difference (Cb and Cr) are obtained with
144 the following ``V4L2_YCBCR_ENC_709`` encoding:
145
146 .. math::
147
148 Y' = 0.2126R' + 0.7152G' + 0.0722B'
149
150 Cb = -0.1146R' - 0.3854G' + 0.5B'
151
152 Cr = 0.5R' - 0.4542G' - 0.0458B'
153
154 Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
155 [-0.5…0.5].
156
157 The default quantization is limited range, but full range is possible
158 although rarely seen.
159
160 The ``V4L2_YCBCR_ENC_709`` encoding described above is the default for
161 this colorspace, but it can be overridden with ``V4L2_YCBCR_ENC_601``,
162 in which case the BT.601 Y'CbCr encoding is used.
163
164 Two additional extended gamut Y'CbCr encodings are also possible with
165 this colorspace:
166
167 The xvYCC 709 encoding (``V4L2_YCBCR_ENC_XV709``, :ref:`xvycc`) is
168 similar to the Rec. 709 encoding, but it allows for R', G' and B' values
169 that are outside the range [0…1]. The resulting Y', Cb and Cr values are
170 scaled and offset according to the limited range formula:
171
172 .. math::
173
174 Y' = \frac{219}{256} * (0.2126R' + 0.7152G' + 0.0722B') + \frac{16}{256}
175
176 Cb = \frac{224}{256} * (-0.1146R' - 0.3854G' + 0.5B')
177
178 Cr = \frac{224}{256} * (0.5R' - 0.4542G' - 0.0458B')
179
180 The xvYCC 601 encoding (``V4L2_YCBCR_ENC_XV601``, :ref:`xvycc`) is
181 similar to the BT.601 encoding, but it allows for R', G' and B' values
182 that are outside the range [0…1]. The resulting Y', Cb and Cr values are
183 scaled and offset according to the limited range formula:
184
185 .. math::
186
187 Y' = \frac{219}{256} * (0.2990R' + 0.5870G' + 0.1140B') + \frac{16}{256}
188
189 Cb = \frac{224}{256} * (-0.1687R' - 0.3313G' + 0.5B')
190
191 Cr = \frac{224}{256} * (0.5R' - 0.4187G' - 0.0813B')
192
193 Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
194 [-0.5…0.5] and quantized without further scaling or offsets.
195 The non-standard xvYCC 709 or xvYCC 601 encodings can be
196 used by selecting ``V4L2_YCBCR_ENC_XV709`` or ``V4L2_YCBCR_ENC_XV601``.
197 As seen by the xvYCC formulas these encodings always use limited range quantization,
198 there is no full range variant. The whole point of these extended gamut encodings
199 is that values outside the limited range are still valid, although they
200 map to R', G' and B' values outside the [0…1] range and are therefore outside
201 the Rec. 709 colorspace gamut.
202
203
204 .. _col-srgb:
205
206 Colorspace sRGB (V4L2_COLORSPACE_SRGB)
207 ======================================
208
209 The :ref:`srgb` standard defines the colorspace used by most webcams
210 and computer graphics. The default transfer function is
211 ``V4L2_XFER_FUNC_SRGB``. The default Y'CbCr encoding is
212 ``V4L2_YCBCR_ENC_601``. The default Y'CbCr quantization is limited range.
213
214 Note that the :ref:`sycc` standard specifies full range quantization,
215 however all current capture hardware supported by the kernel convert
216 R'G'B' to limited range Y'CbCr. So choosing full range as the default
217 would break how applications interpret the quantization range.
218
219 The chromaticities of the primary colors and the white reference are:
220
221 .. flat-table:: sRGB Chromaticities
222 :header-rows: 1
223 :stub-columns: 0
224 :widths: 1 1 2
225
226 * - Color
227 - x
228 - y
229 * - Red
230 - 0.640
231 - 0.330
232 * - Green
233 - 0.300
234 - 0.600
235 * - Blue
236 - 0.150
237 - 0.060
238 * - White Reference (D65)
239 - 0.3127
240 - 0.3290
241
242
243 These chromaticities are identical to the Rec. 709 colorspace.
244
245 Transfer function. Note that negative values for L are only used by the
246 Y'CbCr conversion.
247
248 .. math::
249
250 L' = -1.055(-L)^{\frac{1}{2.4} } + 0.055\text{, for }L < -0.0031308
251
252 L' = 12.92L\text{, for }-0.0031308 \le L \le 0.0031308
253
254 L' = 1.055L ^{\frac{1}{2.4} } - 0.055\text{, for }0.0031308 < L \le 1
255
256 Inverse Transfer function:
257
258 .. math::
259
260 L = -((-L' + 0.055) / 1.055) ^{2.4}\text{, for }L' < -0.04045
261
262 L = L' / 12.92\text{, for }-0.04045 \le L' \le 0.04045
263
264 L = ((L' + 0.055) / 1.055) ^{2.4}\text{, for }L' > 0.04045
265
266 The luminance (Y') and color difference (Cb and Cr) are obtained with
267 the following ``V4L2_YCBCR_ENC_601`` encoding as defined by :ref:`sycc`:
268
269 .. math::
270
271 Y' = 0.2990R' + 0.5870G' + 0.1140B'
272
273 Cb = -0.1687R' - 0.3313G' + 0.5B'
274
275 Cr = 0.5R' - 0.4187G' - 0.0813B'
276
277 Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
278 [-0.5…0.5]. This transform is identical to one defined in SMPTE
279 170M/BT.601. The Y'CbCr quantization is limited range.
280
281
282 .. _col-oprgb:
283
284 Colorspace opRGB (V4L2_COLORSPACE_OPRGB)
285 ===============================================
286
287 The :ref:`oprgb` standard defines the colorspace used by computer
288 graphics that use the opRGB colorspace. The default transfer function is
289 ``V4L2_XFER_FUNC_OPRGB``. The default Y'CbCr encoding is
290 ``V4L2_YCBCR_ENC_601``. The default Y'CbCr quantization is limited
291 range.
292
293 Note that the :ref:`oprgb` standard specifies full range quantization,
294 however all current capture hardware supported by the kernel convert
295 R'G'B' to limited range Y'CbCr. So choosing full range as the default
296 would break how applications interpret the quantization range.
297
298 The chromaticities of the primary colors and the white reference are:
299
300 .. flat-table:: opRGB Chromaticities
301 :header-rows: 1
302 :stub-columns: 0
303 :widths: 1 1 2
304
305 * - Color
306 - x
307 - y
308 * - Red
309 - 0.6400
310 - 0.3300
311 * - Green
312 - 0.2100
313 - 0.7100
314 * - Blue
315 - 0.1500
316 - 0.0600
317 * - White Reference (D65)
318 - 0.3127
319 - 0.3290
320
321
322
323 Transfer function:
324
325 .. math::
326
327 L' = L ^{\frac{1}{2.19921875}}
328
329 Inverse Transfer function:
330
331 .. math::
332
333 L = L'^{(2.19921875)}
334
335 The luminance (Y') and color difference (Cb and Cr) are obtained with
336 the following ``V4L2_YCBCR_ENC_601`` encoding:
337
338 .. math::
339
340 Y' = 0.2990R' + 0.5870G' + 0.1140B'
341
342 Cb = -0.1687R' - 0.3313G' + 0.5B'
343
344 Cr = 0.5R' - 0.4187G' - 0.0813B'
345
346 Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
347 [-0.5…0.5]. This transform is identical to one defined in SMPTE
348 170M/BT.601. The Y'CbCr quantization is limited range.
349
350
351 .. _col-bt2020:
352
353 Colorspace BT.2020 (V4L2_COLORSPACE_BT2020)
354 ===========================================
355
356 The :ref:`itu2020` standard defines the colorspace used by Ultra-high
357 definition television (UHDTV). The default transfer function is
358 ``V4L2_XFER_FUNC_709``. The default Y'CbCr encoding is
359 ``V4L2_YCBCR_ENC_BT2020``. The default Y'CbCr quantization is limited range.
360 The chromaticities of the primary colors and the white reference are:
361
362 .. flat-table:: BT.2020 Chromaticities
363 :header-rows: 1
364 :stub-columns: 0
365 :widths: 1 1 2
366
367 * - Color
368 - x
369 - y
370 * - Red
371 - 0.708
372 - 0.292
373 * - Green
374 - 0.170
375 - 0.797
376 * - Blue
377 - 0.131
378 - 0.046
379 * - White Reference (D65)
380 - 0.3127
381 - 0.3290
382
383
384
385 Transfer function (same as Rec. 709):
386
387 .. math::
388
389 L' = 4.5L\text{, for }0 \le L < 0.018
390
391 L' = 1.099L ^{0.45} - 0.099\text{, for } 0.018 \le L \le 1
392
393 Inverse Transfer function:
394
395 .. math::
396
397 L = L' / 4.5\text{, for } L' < 0.081
398
399 L = \left( \frac{L' + 0.099}{1.099}\right) ^{\frac{1}{0.45} }\text{, for } L' \ge 0.081
400
401 Please note that while Rec. 709 is defined as the default transfer function
402 by the :ref:`itu2020` standard, in practice this colorspace is often used
403 with the :ref:`xf-smpte-2084`. In particular Ultra HD Blu-ray discs use
404 this combination.
405
406 The luminance (Y') and color difference (Cb and Cr) are obtained with
407 the following ``V4L2_YCBCR_ENC_BT2020`` encoding:
408
409 .. math::
410
411 Y' = 0.2627R' + 0.6780G' + 0.0593B'
412
413 Cb = -0.1396R' - 0.3604G' + 0.5B'
414
415 Cr = 0.5R' - 0.4598G' - 0.0402B'
416
417 Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
418 [-0.5…0.5]. The Y'CbCr quantization is limited range.
419
420 There is also an alternate constant luminance R'G'B' to Yc'CbcCrc
421 (``V4L2_YCBCR_ENC_BT2020_CONST_LUM``) encoding:
422
423 Luma:
424
425 .. math::
426 :nowrap:
427
428 \begin{align*}
429 Yc' = (0.2627R + 0.6780G + 0.0593B)'& \\
430 B' - Yc' \le 0:& \\
431 &Cbc = (B' - Yc') / 1.9404 \\
432 B' - Yc' > 0: & \\
433 &Cbc = (B' - Yc') / 1.5816 \\
434 R' - Yc' \le 0:& \\
435 &Crc = (R' - Y') / 1.7184 \\
436 R' - Yc' > 0:& \\
437 &Crc = (R' - Y') / 0.9936
438 \end{align*}
439
440 Yc' is clamped to the range [0…1] and Cbc and Crc are clamped to the
441 range [-0.5…0.5]. The Yc'CbcCrc quantization is limited range.
442
443
444 .. _col-dcip3:
445
446 Colorspace DCI-P3 (V4L2_COLORSPACE_DCI_P3)
447 ==========================================
448
449 The :ref:`smpte431` standard defines the colorspace used by cinema
450 projectors that use the DCI-P3 colorspace. The default transfer function
451 is ``V4L2_XFER_FUNC_DCI_P3``. The default Y'CbCr encoding is
452 ``V4L2_YCBCR_ENC_709``. The default Y'CbCr quantization is limited range.
453
454 .. note::
455
456 Note that this colorspace standard does not specify a
457 Y'CbCr encoding since it is not meant to be encoded to Y'CbCr. So this
458 default Y'CbCr encoding was picked because it is the HDTV encoding.
459
460 The chromaticities of the primary colors and the white reference are:
461
462
463 .. flat-table:: DCI-P3 Chromaticities
464 :header-rows: 1
465 :stub-columns: 0
466 :widths: 1 1 2
467
468 * - Color
469 - x
470 - y
471 * - Red
472 - 0.6800
473 - 0.3200
474 * - Green
475 - 0.2650
476 - 0.6900
477 * - Blue
478 - 0.1500
479 - 0.0600
480 * - White Reference
481 - 0.3140
482 - 0.3510
483
484
485
486 Transfer function:
487
488 .. math::
489
490 L' = L^{\frac{1}{2.6}}
491
492 Inverse Transfer function:
493
494 .. math::
495
496 L = L'^{(2.6)}
497
498 Y'CbCr encoding is not specified. V4L2 defaults to Rec. 709.
499
500
501 .. _col-smpte-240m:
502
503 Colorspace SMPTE 240M (V4L2_COLORSPACE_SMPTE240M)
504 =================================================
505
506 The :ref:`smpte240m` standard was an interim standard used during the
507 early days of HDTV (1988-1998). It has been superseded by Rec. 709. The
508 default transfer function is ``V4L2_XFER_FUNC_SMPTE240M``. The default
509 Y'CbCr encoding is ``V4L2_YCBCR_ENC_SMPTE240M``. The default Y'CbCr
510 quantization is limited range. The chromaticities of the primary colors
511 and the white reference are:
512
513
514 .. flat-table:: SMPTE 240M Chromaticities
515 :header-rows: 1
516 :stub-columns: 0
517 :widths: 1 1 2
518
519 * - Color
520 - x
521 - y
522 * - Red
523 - 0.630
524 - 0.340
525 * - Green
526 - 0.310
527 - 0.595
528 * - Blue
529 - 0.155
530 - 0.070
531 * - White Reference (D65)
532 - 0.3127
533 - 0.3290
534
535
536 These chromaticities are identical to the SMPTE 170M colorspace.
537
538 Transfer function:
539
540 .. math::
541
542 L' = 4L\text{, for } 0 \le L < 0.0228
543
544 L' = 1.1115L ^{0.45} - 0.1115\text{, for } 0.0228 \le L \le 1
545
546 Inverse Transfer function:
547
548 .. math::
549
550 L = \frac{L'}{4}\text{, for } 0 \le L' < 0.0913
551
552 L = \left( \frac{L' + 0.1115}{1.1115}\right) ^{\frac{1}{0.45} }\text{, for } L' \ge 0.0913
553
554 The luminance (Y') and color difference (Cb and Cr) are obtained with
555 the following ``V4L2_YCBCR_ENC_SMPTE240M`` encoding:
556
557 .. math::
558
559 Y' = 0.2122R' + 0.7013G' + 0.0865B'
560
561 Cb = -0.1161R' - 0.3839G' + 0.5B'
562
563 Cr = 0.5R' - 0.4451G' - 0.0549B'
564
565 Y' is clamped to the range [0…1] and Cb and Cr are clamped to the
566 range [-0.5…0.5]. The Y'CbCr quantization is limited range.
567
568
569 .. _col-sysm:
570
571 Colorspace NTSC 1953 (V4L2_COLORSPACE_470_SYSTEM_M)
572 ===================================================
573
574 This standard defines the colorspace used by NTSC in 1953. In practice
575 this colorspace is obsolete and SMPTE 170M should be used instead. The
576 default transfer function is ``V4L2_XFER_FUNC_709``. The default Y'CbCr
577 encoding is ``V4L2_YCBCR_ENC_601``. The default Y'CbCr quantization is
578 limited range. The chromaticities of the primary colors and the white
579 reference are:
580
581
582 .. flat-table:: NTSC 1953 Chromaticities
583 :header-rows: 1
584 :stub-columns: 0
585 :widths: 1 1 2
586
587 * - Color
588 - x
589 - y
590 * - Red
591 - 0.67
592 - 0.33
593 * - Green
594 - 0.21
595 - 0.71
596 * - Blue
597 - 0.14
598 - 0.08
599 * - White Reference (C)
600 - 0.310
601 - 0.316
602
603
604 .. note::
605
606 This colorspace uses Illuminant C instead of D65 as the white
607 reference. To correctly convert an image in this colorspace to another
608 that uses D65 you need to apply a chromatic adaptation algorithm such as
609 the Bradford method.
610
611 The transfer function was never properly defined for NTSC 1953. The Rec.
612 709 transfer function is recommended in the literature:
613
614 .. math::
615
616 L' = 4.5L\text{, for } 0 \le L < 0.018
617
618 L' = 1.099L ^{0.45} - 0.099\text{, for } 0.018 \le L \le 1
619
620 Inverse Transfer function:
621
622 .. math::
623
624 L = \frac{L'}{4.5} \text{, for } L' < 0.081
625
626 L = \left( \frac{L' + 0.099}{1.099}\right) ^{\frac{1}{0.45} }\text{, for } L' \ge 0.081
627
628 The luminance (Y') and color difference (Cb and Cr) are obtained with
629 the following ``V4L2_YCBCR_ENC_601`` encoding:
630
631 .. math::
632
633 Y' = 0.2990R' + 0.5870G' + 0.1140B'
634
635 Cb = -0.1687R' - 0.3313G' + 0.5B'
636
637 Cr = 0.5R' - 0.4187G' - 0.0813B'
638
639 Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
640 [-0.5…0.5]. The Y'CbCr quantization is limited range. This transform is
641 identical to one defined in SMPTE 170M/BT.601.
642
643
644 .. _col-sysbg:
645
646 Colorspace EBU Tech. 3213 (V4L2_COLORSPACE_470_SYSTEM_BG)
647 =========================================================
648
649 The :ref:`tech3213` standard defines the colorspace used by PAL/SECAM
650 in 1975. Note that this colorspace is not supported by the HDMI interface.
651 Instead :ref:`tech3321` recommends that Rec. 709 is used instead for HDMI.
652 The default transfer function is
653 ``V4L2_XFER_FUNC_709``. The default Y'CbCr encoding is
654 ``V4L2_YCBCR_ENC_601``. The default Y'CbCr quantization is limited
655 range. The chromaticities of the primary colors and the white reference
656 are:
657
658
659 .. flat-table:: EBU Tech. 3213 Chromaticities
660 :header-rows: 1
661 :stub-columns: 0
662 :widths: 1 1 2
663
664 * - Color
665 - x
666 - y
667 * - Red
668 - 0.64
669 - 0.33
670 * - Green
671 - 0.29
672 - 0.60
673 * - Blue
674 - 0.15
675 - 0.06
676 * - White Reference (D65)
677 - 0.3127
678 - 0.3290
679
680
681
682 The transfer function was never properly defined for this colorspace.
683 The Rec. 709 transfer function is recommended in the literature:
684
685 .. math::
686
687 L' = 4.5L\text{, for } 0 \le L < 0.018
688
689 L' = 1.099L ^{0.45} - 0.099\text{, for } 0.018 \le L \le 1
690
691 Inverse Transfer function:
692
693 .. math::
694
695 L = \frac{L'}{4.5} \text{, for } L' < 0.081
696
697 L = \left(\frac{L' + 0.099}{1.099} \right) ^{\frac{1}{0.45} }\text{, for } L' \ge 0.081
698
699 The luminance (Y') and color difference (Cb and Cr) are obtained with
700 the following ``V4L2_YCBCR_ENC_601`` encoding:
701
702 .. math::
703
704 Y' = 0.2990R' + 0.5870G' + 0.1140B'
705
706 Cb = -0.1687R' - 0.3313G' + 0.5B'
707
708 Cr = 0.5R' - 0.4187G' - 0.0813B'
709
710 Y' is clamped to the range [0…1] and Cb and Cr are clamped to the range
711 [-0.5…0.5]. The Y'CbCr quantization is limited range. This transform is
712 identical to one defined in SMPTE 170M/BT.601.
713
714
715 .. _col-jpeg:
716
717 Colorspace JPEG (V4L2_COLORSPACE_JPEG)
718 ======================================
719
720 This colorspace defines the colorspace used by most (Motion-)JPEG
721 formats. The chromaticities of the primary colors and the white
722 reference are identical to sRGB. The transfer function use is
723 ``V4L2_XFER_FUNC_SRGB``. The Y'CbCr encoding is ``V4L2_YCBCR_ENC_601``
724 with full range quantization where Y' is scaled to [0…255] and Cb/Cr are
725 scaled to [-128…128] and then clipped to [-128…127].
726
727 .. note::
728
729 The JPEG standard does not actually store colorspace
730 information. So if something other than sRGB is used, then the driver
731 will have to set that information explicitly. Effectively
732 ``V4L2_COLORSPACE_JPEG`` can be considered to be an abbreviation for
733 ``V4L2_COLORSPACE_SRGB``, ``V4L2_XFER_FUNC_SRGB``, ``V4L2_YCBCR_ENC_601``
734 and ``V4L2_QUANTIZATION_FULL_RANGE``.
735
736 ***************************************
737 Detailed Transfer Function Descriptions
738 ***************************************
739
740 .. _xf-smpte-2084:
741
742 Transfer Function SMPTE 2084 (V4L2_XFER_FUNC_SMPTE2084)
743 =======================================================
744
745 The :ref:`smpte2084` standard defines the transfer function used by
746 High Dynamic Range content.
747
748 Constants:
749 m1 = (2610 / 4096) / 4
750
751 m2 = (2523 / 4096) * 128
752
753 c1 = 3424 / 4096
754
755 c2 = (2413 / 4096) * 32
756
757 c3 = (2392 / 4096) * 32
758
759 Transfer function:
760 L' = ((c1 + c2 * L\ :sup:`m1`) / (1 + c3 * L\ :sup:`m1`))\ :sup:`m2`
761
762 Inverse Transfer function:
763 L = (max(L':sup:`1/m2` - c1, 0) / (c2 - c3 *
764 L'\ :sup:`1/m2`))\ :sup:`1/m1`
765
766 Take care when converting between this transfer function and non-HDR transfer
767 functions: the linear RGB values [0…1] of HDR content map to a luminance range
768 of 0 to 10000 cd/m\ :sup:`2` whereas the linear RGB values of non-HDR (aka
769 Standard Dynamic Range or SDR) map to a luminance range of 0 to 100 cd/m\ :sup:`2`.
770
771 To go from SDR to HDR you will have to divide L by 100 first. To go in the other
772 direction you will have to multiply L by 100. Of course, this clamps all
773 luminance values over 100 cd/m\ :sup:`2` to 100 cd/m\ :sup:`2`.
774
775 There are better methods, see e.g. :ref:`colimg` for more in-depth information
776 about this.