Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 5dcd7c66 authored by Hans Verkuil's avatar Hans Verkuil Committed by Mauro Carvalho Chehab
Browse files

media: media/doc: rename and reorder pixfmt files 



After the DocBook conversion a number of pixfmt description files just
had a number in the filename (pix-fmt-004, 006, etc) which was not very
descriptive.

Rename them.

Note that pixfmt-008.rst was folded into colorspaces-details.rst, so
that file is deleted. It's easier to maintain that way.

Also moved the colorspace sections to the end of the chapter. The old
order was weird: the "Standard Image Formats" section (an intro into
pixel formats) was followed by the colorspace sections instead of the
pixel format descriptions.

Moving it to the end resolved that issue.

Signed-off-by: default avatarHans Verkuil <hansverk@cisco.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent 6c2c188f

Documentation/media/uapi/v4l/pixfmt-007.rst→Documentation/media/uapi/v4l/colorspaces-details.rst

+30 −0
Original line number Diff line number Diff line
@@ -758,3 +758,33 @@ scaled to [-128…128] and then clipped to [-128…127]. 
   ``V4L2_COLORSPACE_JPEG`` can be considered to be an abbreviation for

   ``V4L2_COLORSPACE_SRGB``, ``V4L2_YCBCR_ENC_601`` and

   ``V4L2_QUANTIZATION_FULL_RANGE``.



***************************************

Detailed Transfer Function Descriptions

***************************************



.. _xf-smpte-2084:



Transfer Function SMPTE 2084 (V4L2_XFER_FUNC_SMPTE2084)

=======================================================



The :ref:`smpte2084` standard defines the transfer function used by

High Dynamic Range content.



Constants:

    m1 = (2610 / 4096) / 4



    m2 = (2523 / 4096) * 128



    c1 = 3424 / 4096



    c2 = (2413 / 4096) * 32



    c3 = (2392 / 4096) * 32



Transfer function:

    L' = ((c1 + c2 * L\ :sup:`m1`) / (1 + c3 * L\ :sup:`m1`))\ :sup:`m2`



Inverse Transfer function:

    L = (max(L':sup:`1/m2` - c1, 0) / (c2 - c3 *

    L'\ :sup:`1/m2`))\ :sup:`1/m1`

Documentation/media/uapi/v4l/pixfmt-008.rst

deleted100644 → 0
+0 −32
Original line number Diff line number Diff line 
.. -*- coding: utf-8; mode: rst -*-



***************************************

Detailed Transfer Function Descriptions

***************************************





.. _xf-smpte-2084:



Transfer Function SMPTE 2084 (V4L2_XFER_FUNC_SMPTE2084)

=======================================================



The :ref:`smpte2084` standard defines the transfer function used by

High Dynamic Range content.



Constants:

    m1 = (2610 / 4096) / 4



    m2 = (2523 / 4096) * 128



    c1 = 3424 / 4096



    c2 = (2413 / 4096) * 32



    c3 = (2392 / 4096) * 32



Transfer function:

    L' = ((c1 + c2 * L\ :sup:`m1`) / (1 + c3 * L\ :sup:`m1`))\ :sup:`m2`



Inverse Transfer function:

    L = (max(L':sup:`1/m2` - c1, 0) / (c2 - c3 *

    L'\ :sup:`1/m2`))\ :sup:`1/m1`