Commit 7f1bd7cd authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

doc-rst: pixfmt-007: Fix formula parsing

There are lots of warnings there:

/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:74: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:89: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:168: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:183: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:206: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:216: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:292: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:308: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:393: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:478: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:657: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:735: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:746: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:822: ERROR: Unexpected indentation.
/devel/v4l/patchwork/Documentation/linux_tv/media/v4l/pixfmt-007:833: ERROR: Unexpected indentation.

Also, sometimes the :sup: tag was ignored. Fix it.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent ac4141ce
...@@ -71,21 +71,24 @@ SMPTE C set, so this colorspace is sometimes called SMPTE C as well. ...@@ -71,21 +71,24 @@ SMPTE C set, so this colorspace is sometimes called SMPTE C as well.
The transfer function defined for SMPTE 170M is the same as the one The transfer function defined for SMPTE 170M is the same as the one
defined in Rec. 709. defined in Rec. 709.
L' = -1.099(-L):sup:`0.45` + 0.099 for L ≤ -0.018
L' = -1.099(-L) :sup:`0.45` + 0.099 for L ≤ -0.018
L' = 4.5L for -0.018 < L < 0.018 L' = 4.5L for -0.018 < L < 0.018
L' = 1.099L\ :sup:`0.45` - 0.099 for L ≥ 0.018 L' = 1.099L :sup:`0.45` - 0.099 for L ≥ 0.018
Inverse Transfer function: Inverse Transfer function:
L = -((L' - 0.099) / -1.099):sup:`1/0.45` for L' ≤ -0.081
L = -((L' - 0.099) / -1.099) :sup:`1/0.45` for L' ≤ -0.081
L = L' / 4.5 for -0.081 < L' < 0.081 L = L' / 4.5 for -0.081 < L' < 0.081
L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081 L = ((L' + 0.099) / 1.099) :sup:`1/0.45` for L' ≥ 0.081
The luminance (Y') and color difference (Cb and Cr) are obtained with The luminance (Y') and color difference (Cb and Cr) are obtained with
the following ``V4L2_YCBCR_ENC_601`` encoding: the following ``V4L2_YCBCR_ENC_601`` encoding:
Y' = 0.299R' + 0.587G' + 0.114B' Y' = 0.299R' + 0.587G' + 0.114B'
Cb = -0.169R' - 0.331G' + 0.5B' Cb = -0.169R' - 0.331G' + 0.5B'
...@@ -165,21 +168,24 @@ The full name of this standard is Rec. ITU-R BT.709-5. ...@@ -165,21 +168,24 @@ The full name of this standard is Rec. ITU-R BT.709-5.
Transfer function. Normally L is in the range [0…1], but for the Transfer function. Normally L is in the range [0…1], but for the
extended gamut xvYCC encoding values outside that range are allowed. extended gamut xvYCC encoding values outside that range are allowed.
L' = -1.099(-L):sup:`0.45` + 0.099 for L ≤ -0.018
L' = -1.099(-L) :sup:`0.45` + 0.099 for L ≤ -0.018
L' = 4.5L for -0.018 < L < 0.018 L' = 4.5L for -0.018 < L < 0.018
L' = 1.099L\ :sup:`0.45` - 0.099 for L ≥ 0.018 L' = 1.099L :sup:`0.45` - 0.099 for L ≥ 0.018
Inverse Transfer function: Inverse Transfer function:
L = -((L' - 0.099) / -1.099):sup:`1/0.45` for L' ≤ -0.081
L = -((L' - 0.099) / -1.099) :sup:`1/0.45` for L' ≤ -0.081
L = L' / 4.5 for -0.081 < L' < 0.081 L = L' / 4.5 for -0.081 < L' < 0.081
L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081 L = ((L' + 0.099) / 1.099) :sup:`1/0.45` for L' ≥ 0.081
The luminance (Y') and color difference (Cb and Cr) are obtained with The luminance (Y') and color difference (Cb and Cr) are obtained with
the following ``V4L2_YCBCR_ENC_709`` encoding: the following ``V4L2_YCBCR_ENC_709`` encoding:
Y' = 0.2126R' + 0.7152G' + 0.0722B' Y' = 0.2126R' + 0.7152G' + 0.0722B'
Cb = -0.1146R' - 0.3854G' + 0.5B' Cb = -0.1146R' - 0.3854G' + 0.5B'
...@@ -203,6 +209,7 @@ The xvYCC 709 encoding (``V4L2_YCBCR_ENC_XV709``, :ref:`xvycc`) is ...@@ -203,6 +209,7 @@ The xvYCC 709 encoding (``V4L2_YCBCR_ENC_XV709``, :ref:`xvycc`) is
similar to the Rec. 709 encoding, but it allows for R', G' and B' values similar to the Rec. 709 encoding, but it allows for R', G' and B' values
that are outside the range [0…1]. The resulting Y', Cb and Cr values are that are outside the range [0…1]. The resulting Y', Cb and Cr values are
scaled and offset: scaled and offset:
Y' = (219 / 256) * (0.2126R' + 0.7152G' + 0.0722B') + (16 / 256) Y' = (219 / 256) * (0.2126R' + 0.7152G' + 0.0722B') + (16 / 256)
Cb = (224 / 256) * (-0.1146R' - 0.3854G' + 0.5B') Cb = (224 / 256) * (-0.1146R' - 0.3854G' + 0.5B')
...@@ -213,6 +220,7 @@ The xvYCC 601 encoding (``V4L2_YCBCR_ENC_XV601``, :ref:`xvycc`) is ...@@ -213,6 +220,7 @@ The xvYCC 601 encoding (``V4L2_YCBCR_ENC_XV601``, :ref:`xvycc`) is
similar to the BT.601 encoding, but it allows for R', G' and B' values similar to the BT.601 encoding, but it allows for R', G' and B' values
that are outside the range [0…1]. The resulting Y', Cb and Cr values are that are outside the range [0…1]. The resulting Y', Cb and Cr values are
scaled and offset: scaled and offset:
Y' = (219 / 256) * (0.299R' + 0.587G' + 0.114B') + (16 / 256) Y' = (219 / 256) * (0.299R' + 0.587G' + 0.114B') + (16 / 256)
Cb = (224 / 256) * (-0.169R' - 0.331G' + 0.5B') Cb = (224 / 256) * (-0.169R' - 0.331G' + 0.5B')
...@@ -289,22 +297,25 @@ These chromaticities are identical to the Rec. 709 colorspace. ...@@ -289,22 +297,25 @@ These chromaticities are identical to the Rec. 709 colorspace.
Transfer function. Note that negative values for L are only used by the Transfer function. Note that negative values for L are only used by the
Y'CbCr conversion. Y'CbCr conversion.
L' = -1.055(-L):sup:`1/2.4` + 0.055 for L < -0.0031308
L' = -1.055(-L) :sup:`1/2.4` + 0.055 for L < -0.0031308
L' = 12.92L for -0.0031308 ≤ L ≤ 0.0031308 L' = 12.92L for -0.0031308 ≤ L ≤ 0.0031308
L' = 1.055L\ :sup:`1/2.4` - 0.055 for 0.0031308 < L ≤ 1 L' = 1.055L :sup:`1/2.4` - 0.055 for 0.0031308 < L ≤ 1
Inverse Transfer function: Inverse Transfer function:
L = -((-L' + 0.055) / 1.055)\ :sup:`2.4` for L' < -0.04045
L = -((-L' + 0.055) / 1.055) :sup:`2.4` for L' < -0.04045
L = L' / 12.92 for -0.04045 ≤ L' ≤ 0.04045 L = L' / 12.92 for -0.04045 ≤ L' ≤ 0.04045
L = ((L' + 0.055) / 1.055)\ :sup:`2.4` for L' > 0.04045 L = ((L' + 0.055) / 1.055) :sup:`2.4` for L' > 0.04045
The luminance (Y') and color difference (Cb and Cr) are obtained with The luminance (Y') and color difference (Cb and Cr) are obtained with
the following ``V4L2_YCBCR_ENC_SYCC`` encoding as defined by the following ``V4L2_YCBCR_ENC_SYCC`` encoding as defined by
:ref:`sycc`: :ref:`sycc`:
Y' = 0.2990R' + 0.5870G' + 0.1140B' Y' = 0.2990R' + 0.5870G' + 0.1140B'
Cb = -0.1687R' - 0.3313G' + 0.5B' Cb = -0.1687R' - 0.3313G' + 0.5B'
...@@ -383,13 +394,16 @@ are: ...@@ -383,13 +394,16 @@ are:
Transfer function: Transfer function:
L' = L\ :sup:`1/2.19921875`
L' = L :sup:`1/2.19921875`
Inverse Transfer function: Inverse Transfer function:
L = L'\ :sup:`2.19921875`
L = L' :sup:`2.19921875`
The luminance (Y') and color difference (Cb and Cr) are obtained with The luminance (Y') and color difference (Cb and Cr) are obtained with
the following ``V4L2_YCBCR_ENC_601`` encoding: the following ``V4L2_YCBCR_ENC_601`` encoding:
Y' = 0.299R' + 0.587G' + 0.114B' Y' = 0.299R' + 0.587G' + 0.114B'
Cb = -0.169R' - 0.331G' + 0.5B' Cb = -0.169R' - 0.331G' + 0.5B'
...@@ -464,17 +478,20 @@ of the primary colors and the white reference are: ...@@ -464,17 +478,20 @@ of the primary colors and the white reference are:
Transfer function (same as Rec. 709): Transfer function (same as Rec. 709):
L' = 4.5L for 0 ≤ L < 0.018 L' = 4.5L for 0 ≤ L < 0.018
L' = 1.099L\ :sup:`0.45` - 0.099 for 0.018 ≤ L ≤ 1 L' = 1.099L :sup:`0.45` - 0.099 for 0.018 ≤ L ≤ 1
Inverse Transfer function: Inverse Transfer function:
L = L' / 4.5 for L' < 0.081 L = L' / 4.5 for L' < 0.081
L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081 L = ((L' + 0.099) / 1.099) :sup:`1/0.45` for L' ≥ 0.081
The luminance (Y') and color difference (Cb and Cr) are obtained with The luminance (Y') and color difference (Cb and Cr) are obtained with
the following ``V4L2_YCBCR_ENC_BT2020`` encoding: the following ``V4L2_YCBCR_ENC_BT2020`` encoding:
Y' = 0.2627R' + 0.6780G' + 0.0593B' Y' = 0.2627R' + 0.6780G' + 0.0593B'
Cb = -0.1396R' - 0.3604G' + 0.5B' Cb = -0.1396R' - 0.3604G' + 0.5B'
...@@ -488,18 +505,23 @@ There is also an alternate constant luminance R'G'B' to Yc'CbcCrc ...@@ -488,18 +505,23 @@ There is also an alternate constant luminance R'G'B' to Yc'CbcCrc
(``V4L2_YCBCR_ENC_BT2020_CONST_LUM``) encoding: (``V4L2_YCBCR_ENC_BT2020_CONST_LUM``) encoding:
Luma: Luma:
Yc' = (0.2627R + 0.6780G + 0.0593B)' Yc' = (0.2627R + 0.6780G + 0.0593B)'
B' - Yc' ≤ 0: B' - Yc' ≤ 0:
Cbc = (B' - Yc') / 1.9404 Cbc = (B' - Yc') / 1.9404
B' - Yc' > 0: B' - Yc' > 0:
Cbc = (B' - Yc') / 1.5816 Cbc = (B' - Yc') / 1.5816
R' - Yc' ≤ 0: R' - Yc' ≤ 0:
Crc = (R' - Y') / 1.7184 Crc = (R' - Y') / 1.7184
R' - Yc' > 0: R' - Yc' > 0:
Crc = (R' - Y') / 0.9936 Crc = (R' - Y') / 0.9936
Yc' is clamped to the range [0…1] and Cbc and Crc are clamped to the Yc' is clamped to the range [0…1] and Cbc and Crc are clamped to the
...@@ -571,10 +593,12 @@ primary colors and the white reference are: ...@@ -571,10 +593,12 @@ primary colors and the white reference are:
Transfer function: Transfer function:
L' = L\ :sup:`1/2.6`
L' = L :sup:`1/2.6`
Inverse Transfer function: Inverse Transfer function:
L = L'\ :sup:`2.6`
L = L' :sup:`2.6`
Y'CbCr encoding is not specified. V4L2 defaults to Rec. 709. Y'CbCr encoding is not specified. V4L2 defaults to Rec. 709.
...@@ -643,17 +667,20 @@ and the white reference are: ...@@ -643,17 +667,20 @@ and the white reference are:
These chromaticities are identical to the SMPTE 170M colorspace. These chromaticities are identical to the SMPTE 170M colorspace.
Transfer function: Transfer function:
L' = 4L for 0 ≤ L < 0.0228 L' = 4L for 0 ≤ L < 0.0228
L' = 1.1115L\ :sup:`0.45` - 0.1115 for 0.0228 ≤ L ≤ 1 L' = 1.1115L :sup:`0.45` - 0.1115 for 0.0228 ≤ L ≤ 1
Inverse Transfer function: Inverse Transfer function:
L = L' / 4 for 0 ≤ L' < 0.0913 L = L' / 4 for 0 ≤ L' < 0.0913
L = ((L' + 0.1115) / 1.1115)\ :sup:`1/0.45` for L' ≥ 0.0913 L = ((L' + 0.1115) / 1.1115) :sup:`1/0.45` for L' ≥ 0.0913
The luminance (Y') and color difference (Cb and Cr) are obtained with The luminance (Y') and color difference (Cb and Cr) are obtained with
the following ``V4L2_YCBCR_ENC_SMPTE240M`` encoding: the following ``V4L2_YCBCR_ENC_SMPTE240M`` encoding:
Y' = 0.2122R' + 0.7013G' + 0.0865B' Y' = 0.2122R' + 0.7013G' + 0.0865B'
Cb = -0.1161R' - 0.3839G' + 0.5B' Cb = -0.1161R' - 0.3839G' + 0.5B'
...@@ -732,17 +759,20 @@ the Bradford method. ...@@ -732,17 +759,20 @@ the Bradford method.
The transfer function was never properly defined for NTSC 1953. The Rec. The transfer function was never properly defined for NTSC 1953. The Rec.
709 transfer function is recommended in the literature: 709 transfer function is recommended in the literature:
L' = 4.5L for 0 ≤ L < 0.018 L' = 4.5L for 0 ≤ L < 0.018
L' = 1.099L\ :sup:`0.45` - 0.099 for 0.018 ≤ L ≤ 1 L' = 1.099L :sup:`0.45` - 0.099 for 0.018 ≤ L ≤ 1
Inverse Transfer function: Inverse Transfer function:
L = L' / 4.5 for L' < 0.081 L = L' / 4.5 for L' < 0.081
L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081 L = ((L' + 0.099) / 1.099) :sup:`1/0.45` for L' ≥ 0.081
The luminance (Y') and color difference (Cb and Cr) are obtained with The luminance (Y') and color difference (Cb and Cr) are obtained with
the following ``V4L2_YCBCR_ENC_601`` encoding: the following ``V4L2_YCBCR_ENC_601`` encoding:
Y' = 0.299R' + 0.587G' + 0.114B' Y' = 0.299R' + 0.587G' + 0.114B'
Cb = -0.169R' - 0.331G' + 0.5B' Cb = -0.169R' - 0.331G' + 0.5B'
...@@ -819,17 +849,20 @@ are: ...@@ -819,17 +849,20 @@ are:
The transfer function was never properly defined for this colorspace. The transfer function was never properly defined for this colorspace.
The Rec. 709 transfer function is recommended in the literature: The Rec. 709 transfer function is recommended in the literature:
L' = 4.5L for 0 ≤ L < 0.018 L' = 4.5L for 0 ≤ L < 0.018
L' = 1.099L\ :sup:`0.45` - 0.099 for 0.018 ≤ L ≤ 1 L' = 1.099L :sup:`0.45` - 0.099 for 0.018 ≤ L ≤ 1
Inverse Transfer function: Inverse Transfer function:
L = L' / 4.5 for L' < 0.081 L = L' / 4.5 for L' < 0.081
L = ((L' + 0.099) / 1.099)\ :sup:`1/0.45` for L' ≥ 0.081 L = ((L' + 0.099) / 1.099) :sup:`1/0.45` for L' ≥ 0.081
The luminance (Y') and color difference (Cb and Cr) are obtained with The luminance (Y') and color difference (Cb and Cr) are obtained with
the following ``V4L2_YCBCR_ENC_601`` encoding: the following ``V4L2_YCBCR_ENC_601`` encoding:
Y' = 0.299R' + 0.587G' + 0.114B' Y' = 0.299R' + 0.587G' + 0.114B'
Cb = -0.169R' - 0.331G' + 0.5B' Cb = -0.169R' - 0.331G' + 0.5B'
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment