54f38fcae5
Since 2017, there is an space reserved for userspace API,
created by changeset 1d596dee38 ("docs: Create a user-space API guide").
As the media subsystem was one of the first subsystems to use
Sphinx, until this patch, we were keeping things on a separate
place.
Let's just use the new location, as having all uAPI altogether
will likely make things easier for developers.
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
165 lines
3.1 KiB
ReStructuredText
165 lines
3.1 KiB
ReStructuredText
.. Permission is granted to copy, distribute and/or modify this
|
|
.. document under the terms of the GNU Free Documentation License,
|
|
.. Version 1.1 or any later version published by the Free Software
|
|
.. Foundation, with no Invariant Sections, no Front-Cover Texts
|
|
.. and no Back-Cover Texts. A copy of the license is included at
|
|
.. Documentation/userspace-api/media/fdl-appendix.rst.
|
|
..
|
|
.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
|
|
|
|
.. _packed-hsv:
|
|
|
|
******************
|
|
Packed HSV formats
|
|
******************
|
|
|
|
Description
|
|
===========
|
|
|
|
The *hue* (h) is measured in degrees, the equivalence between degrees and LSBs
|
|
depends on the hsv-encoding used, see :ref:`colorspaces`.
|
|
The *saturation* (s) and the *value* (v) are measured in percentage of the
|
|
cylinder: 0 being the smallest value and 255 the maximum.
|
|
|
|
|
|
The values are packed in 24 or 32 bit formats.
|
|
|
|
|
|
.. raw:: latex
|
|
|
|
\begingroup
|
|
\tiny
|
|
\setlength{\tabcolsep}{2pt}
|
|
|
|
.. tabularcolumns:: |p{2.6cm}|p{0.8cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|p{0.22cm}|
|
|
|
|
.. _packed-hsv-formats:
|
|
|
|
.. flat-table:: Packed HSV Image Formats
|
|
:header-rows: 2
|
|
:stub-columns: 0
|
|
|
|
* - Identifier
|
|
- Code
|
|
-
|
|
- :cspan:`7` Byte 0 in memory
|
|
- :cspan:`7` Byte 1
|
|
- :cspan:`7` Byte 2
|
|
- :cspan:`7` Byte 3
|
|
* -
|
|
-
|
|
- Bit
|
|
- 7
|
|
- 6
|
|
- 5
|
|
- 4
|
|
- 3
|
|
- 2
|
|
- 1
|
|
- 0
|
|
|
|
- 7
|
|
- 6
|
|
- 5
|
|
- 4
|
|
- 3
|
|
- 2
|
|
- 1
|
|
- 0
|
|
|
|
- 7
|
|
- 6
|
|
- 5
|
|
- 4
|
|
- 3
|
|
- 2
|
|
- 1
|
|
- 0
|
|
|
|
- 7
|
|
- 6
|
|
- 5
|
|
- 4
|
|
- 3
|
|
- 2
|
|
- 1
|
|
- 0
|
|
* .. _V4L2-PIX-FMT-HSV32:
|
|
|
|
- ``V4L2_PIX_FMT_HSV32``
|
|
- 'HSV4'
|
|
-
|
|
-
|
|
-
|
|
-
|
|
-
|
|
-
|
|
-
|
|
-
|
|
-
|
|
|
|
- h\ :sub:`7`
|
|
- h\ :sub:`6`
|
|
- h\ :sub:`5`
|
|
- h\ :sub:`4`
|
|
- h\ :sub:`3`
|
|
- h\ :sub:`2`
|
|
- h\ :sub:`1`
|
|
- h\ :sub:`0`
|
|
|
|
- s\ :sub:`7`
|
|
- s\ :sub:`6`
|
|
- s\ :sub:`5`
|
|
- s\ :sub:`4`
|
|
- s\ :sub:`3`
|
|
- s\ :sub:`2`
|
|
- s\ :sub:`1`
|
|
- s\ :sub:`0`
|
|
|
|
- v\ :sub:`7`
|
|
- v\ :sub:`6`
|
|
- v\ :sub:`5`
|
|
- v\ :sub:`4`
|
|
- v\ :sub:`3`
|
|
- v\ :sub:`2`
|
|
- v\ :sub:`1`
|
|
- v\ :sub:`0`
|
|
* .. _V4L2-PIX-FMT-HSV24:
|
|
|
|
- ``V4L2_PIX_FMT_HSV24``
|
|
- 'HSV3'
|
|
-
|
|
- h\ :sub:`7`
|
|
- h\ :sub:`6`
|
|
- h\ :sub:`5`
|
|
- h\ :sub:`4`
|
|
- h\ :sub:`3`
|
|
- h\ :sub:`2`
|
|
- h\ :sub:`1`
|
|
- h\ :sub:`0`
|
|
|
|
- s\ :sub:`7`
|
|
- s\ :sub:`6`
|
|
- s\ :sub:`5`
|
|
- s\ :sub:`4`
|
|
- s\ :sub:`3`
|
|
- s\ :sub:`2`
|
|
- s\ :sub:`1`
|
|
- s\ :sub:`0`
|
|
|
|
- v\ :sub:`7`
|
|
- v\ :sub:`6`
|
|
- v\ :sub:`5`
|
|
- v\ :sub:`4`
|
|
- v\ :sub:`3`
|
|
- v\ :sub:`2`
|
|
- v\ :sub:`1`
|
|
- v\ :sub:`0`
|
|
-
|
|
|
|
.. raw:: latex
|
|
|
|
\endgroup
|
|
|
|
Bit 7 is the most significant bit.
|