xref: /linux/Documentation/userspace-api/media/v4l/pixfmt-packed-hsv.rst (revision a34b0e4e21d6be3c3d620aa7f9dfbf0e9550c19e) 
1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2.. c:namespace:: V4L
3
4.. _packed-hsv:
5
6******************
7Packed HSV formats
8******************
9
10Description
11===========
12
13The *hue* (h) is measured in degrees, the equivalence between degrees and LSBs
14depends on the hsv-encoding used, see :ref:`colorspaces`.
15The *saturation* (s) and the *value* (v) are measured in percentage of the
16cylinder: 0 being the smallest value and 255 the maximum.
17
18
19The values are packed in 24 or 32 bit formats.
20
21
22.. raw:: latex
23
24    \begingroup
25    \tiny
26    \setlength{\tabcolsep}{2pt}
27
28.. 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}|
29
30.. _packed-hsv-formats:
31
32.. flat-table:: Packed HSV Image Formats
33    :header-rows:  2
34    :stub-columns: 0
35
36    * - Identifier
37      - Code
38      -
39      - :cspan:`7` Byte 0 in memory
40      - :cspan:`7` Byte 1
41      - :cspan:`7` Byte 2
42      - :cspan:`7` Byte 3
43    * -
44      -
45      - Bit
46      - 7
47      - 6
48      - 5
49      - 4
50      - 3
51      - 2
52      - 1
53      - 0
54
55      - 7
56      - 6
57      - 5
58      - 4
59      - 3
60      - 2
61      - 1
62      - 0
63
64      - 7
65      - 6
66      - 5
67      - 4
68      - 3
69      - 2
70      - 1
71      - 0
72
73      - 7
74      - 6
75      - 5
76      - 4
77      - 3
78      - 2
79      - 1
80      - 0
81    * .. _V4L2-PIX-FMT-HSV32:
82
83      - ``V4L2_PIX_FMT_HSV32``
84      - 'HSV4'
85      -
86      -
87      -
88      -
89      -
90      -
91      -
92      -
93      -
94
95      - h\ :sub:`7`
96      - h\ :sub:`6`
97      - h\ :sub:`5`
98      - h\ :sub:`4`
99      - h\ :sub:`3`
100      - h\ :sub:`2`
101      - h\ :sub:`1`
102      - h\ :sub:`0`
103
104      - s\ :sub:`7`
105      - s\ :sub:`6`
106      - s\ :sub:`5`
107      - s\ :sub:`4`
108      - s\ :sub:`3`
109      - s\ :sub:`2`
110      - s\ :sub:`1`
111      - s\ :sub:`0`
112
113      - v\ :sub:`7`
114      - v\ :sub:`6`
115      - v\ :sub:`5`
116      - v\ :sub:`4`
117      - v\ :sub:`3`
118      - v\ :sub:`2`
119      - v\ :sub:`1`
120      - v\ :sub:`0`
121    * .. _V4L2-PIX-FMT-HSV24:
122
123      - ``V4L2_PIX_FMT_HSV24``
124      - 'HSV3'
125      -
126      - h\ :sub:`7`
127      - h\ :sub:`6`
128      - h\ :sub:`5`
129      - h\ :sub:`4`
130      - h\ :sub:`3`
131      - h\ :sub:`2`
132      - h\ :sub:`1`
133      - h\ :sub:`0`
134
135      - s\ :sub:`7`
136      - s\ :sub:`6`
137      - s\ :sub:`5`
138      - s\ :sub:`4`
139      - s\ :sub:`3`
140      - s\ :sub:`2`
141      - s\ :sub:`1`
142      - s\ :sub:`0`
143
144      - v\ :sub:`7`
145      - v\ :sub:`6`
146      - v\ :sub:`5`
147      - v\ :sub:`4`
148      - v\ :sub:`3`
149      - v\ :sub:`2`
150      - v\ :sub:`1`
151      - v\ :sub:`0`
152      -
153
154.. raw:: latex
155
156    \endgroup
157
158Bit 7 is the most significant bit.
159