tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
[media] Documentation: Add HSV format
Describe the HSV formats
Signed-off-by: Ricardo Ribalda Delgado <ricardo.ribalda@gmail.com>
Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
authored by
Ricardo Ribalda Delgado
and committed by
Mauro Carvalho Chehab
9bef7546
66b2ab27
+181
+19
Documentation/media/uapi/v4l/hsv-formats.rst
+19
Documentation/media/uapi/v4l/hsv-formats.rst
···
1
+
.. -*- coding: utf-8; mode: rst -*-
2
+
3
+
.. _hsv-formats:
4
+
5
+
***********
6
+
HSV Formats
7
+
***********
8
+
9
+
These formats store the color information of the image
10
+
in a geometrical representation. The colors are mapped into a
11
+
cylinder, where the angle is the HUE, the height is the VALUE
12
+
and the distance to the center is the SATURATION. This is a very
13
+
useful format for image segmentation algorithms.
14
+
15
+
16
+
.. toctree::
17
+
:maxdepth: 1
18
+
19
+
pixfmt-packed-hsv
+156
Documentation/media/uapi/v4l/pixfmt-packed-hsv.rst
+156
Documentation/media/uapi/v4l/pixfmt-packed-hsv.rst
···
1
+
.. -*- coding: utf-8; mode: rst -*-
2
+
3
+
.. _packed-hsv:
4
+
5
+
******************
6
+
Packed HSV formats
7
+
******************
8
+
9
+
Description
10
+
===========
11
+
12
+
The *hue* (h) is measured in degrees, one LSB represents two degrees.
13
+
The *saturation* (s) and the *value* (v) are measured in percentage of the
14
+
cylinder: 0 being the smallest value and 255 the maximum.
15
+
16
+
17
+
The values are packed in 24 or 32 bit formats.
18
+
19
+
.. raw:: latex
20
+
21
+
\newline\begin{adjustbox}{width=\columnwidth}
22
+
23
+
.. tabularcolumns:: |p{4.2cm}|p{1.0cm}|p{0.7cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.2cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{0.4cm}|p{1.7cm}|
24
+
25
+
.. _packed-hsv-formats:
26
+
27
+
.. flat-table:: Packed HSV Image Formats
28
+
:header-rows: 2
29
+
:stub-columns: 0
30
+
31
+
* - Identifier
32
+
- Code
33
+
-
34
+
- :cspan:`7` Byte 0 in memory
35
+
-
36
+
- :cspan:`7` Byte 1
37
+
-
38
+
- :cspan:`7` Byte 2
39
+
-
40
+
- :cspan:`7` Byte 3
41
+
* -
42
+
-
43
+
- Bit
44
+
- 7
45
+
- 6
46
+
- 5
47
+
- 4
48
+
- 3
49
+
- 2
50
+
- 1
51
+
- 0
52
+
-
53
+
- 7
54
+
- 6
55
+
- 5
56
+
- 4
57
+
- 3
58
+
- 2
59
+
- 1
60
+
- 0
61
+
-
62
+
- 7
63
+
- 6
64
+
- 5
65
+
- 4
66
+
- 3
67
+
- 2
68
+
- 1
69
+
- 0
70
+
-
71
+
- 7
72
+
- 6
73
+
- 5
74
+
- 4
75
+
- 3
76
+
- 2
77
+
- 1
78
+
- 0
79
+
* .. _V4L2-PIX-FMT-HSV32:
80
+
81
+
- ``V4L2_PIX_FMT_HSV32``
82
+
- 'HSV4'
83
+
-
84
+
-
85
+
-
86
+
-
87
+
-
88
+
-
89
+
-
90
+
-
91
+
-
92
+
-
93
+
- h\ :sub:`7`
94
+
- h\ :sub:`6`
95
+
- h\ :sub:`5`
96
+
- h\ :sub:`4`
97
+
- h\ :sub:`3`
98
+
- h\ :sub:`2`
99
+
- h\ :sub:`1`
100
+
- h\ :sub:`0`
101
+
-
102
+
- s\ :sub:`7`
103
+
- s\ :sub:`6`
104
+
- s\ :sub:`5`
105
+
- s\ :sub:`4`
106
+
- s\ :sub:`3`
107
+
- s\ :sub:`2`
108
+
- s\ :sub:`1`
109
+
- s\ :sub:`0`
110
+
-
111
+
- v\ :sub:`7`
112
+
- v\ :sub:`6`
113
+
- v\ :sub:`5`
114
+
- v\ :sub:`4`
115
+
- v\ :sub:`3`
116
+
- v\ :sub:`2`
117
+
- v\ :sub:`1`
118
+
- v\ :sub:`0`
119
+
* .. _V4L2-PIX-FMT-HSV24:
120
+
121
+
- ``V4L2_PIX_FMT_HSV24``
122
+
- 'HSV3'
123
+
-
124
+
- h\ :sub:`7`
125
+
- h\ :sub:`6`
126
+
- h\ :sub:`5`
127
+
- h\ :sub:`4`
128
+
- h\ :sub:`3`
129
+
- h\ :sub:`2`
130
+
- h\ :sub:`1`
131
+
- h\ :sub:`0`
132
+
-
133
+
- s\ :sub:`7`
134
+
- s\ :sub:`6`
135
+
- s\ :sub:`5`
136
+
- s\ :sub:`4`
137
+
- s\ :sub:`3`
138
+
- s\ :sub:`2`
139
+
- s\ :sub:`1`
140
+
- s\ :sub:`0`
141
+
-
142
+
- v\ :sub:`7`
143
+
- v\ :sub:`6`
144
+
- v\ :sub:`5`
145
+
- v\ :sub:`4`
146
+
- v\ :sub:`3`
147
+
- v\ :sub:`2`
148
+
- v\ :sub:`1`
149
+
- v\ :sub:`0`
150
+
-
151
+
-
152
+
.. raw:: latex
153
+
154
+
\end{adjustbox}\newline\newline
155
+
156
+
Bit 7 is the most significant bit.
+1
Documentation/media/uapi/v4l/pixfmt.rst
+1
Documentation/media/uapi/v4l/pixfmt.rst
+5
Documentation/media/uapi/v4l/v4l2.rst
+5
Documentation/media/uapi/v4l/v4l2.rst