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