summaryrefslogtreecommitdiff
path: root/Documentation/media/uapi/v4l/pixfmt-reserved.rst
blob: d6938cd5e03e6602da9c527faa849a34affd9031 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
.. -*- coding: utf-8; mode: rst -*-

.. _pixfmt-reserved:

***************************
Reserved Format Identifiers
***************************

These formats are not defined by this specification, they are just
listed for reference and to avoid naming conflicts. If you want to
register your own format, send an e-mail to the linux-media mailing list
`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__
for inclusion in the ``videodev2.h`` file. If you want to share your
format with other developers add a link to your documentation and send a
copy to the linux-media mailing list for inclusion in this section. If
you think your format should be listed in a standard format section
please make a proposal on the linux-media mailing list.


.. _reserved-formats:

.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|

.. flat-table:: Reserved Image Formats
    :header-rows:  1
    :stub-columns: 0
    :widths:       3 1 4


    -  .. row 1

       -  Identifier

       -  Code

       -  Details

    -  .. _V4L2-PIX-FMT-DV:

       -  ``V4L2_PIX_FMT_DV``

       -  'dvsd'

       -  unknown

    -  .. _V4L2-PIX-FMT-ET61X251:

       -  ``V4L2_PIX_FMT_ET61X251``

       -  'E625'

       -  Compressed format of the ET61X251 driver.

    -  .. _V4L2-PIX-FMT-HI240:

       -  ``V4L2_PIX_FMT_HI240``

       -  'HI24'

       -  8 bit RGB format used by the BTTV driver.

    -  .. _V4L2-PIX-FMT-HM12:

       -  ``V4L2_PIX_FMT_HM12``

       -  'HM12'

       -  YUV 4:2:0 format used by the IVTV driver,
	  `http://www.ivtvdriver.org/ <http://www.ivtvdriver.org/>`__

	  The format is documented in the kernel sources in the file
	  ``Documentation/video4linux/cx2341x/README.hm12``

    -  .. _V4L2-PIX-FMT-CPIA1:

       -  ``V4L2_PIX_FMT_CPIA1``

       -  'CPIA'

       -  YUV format used by the gspca cpia1 driver.

    -  .. _V4L2-PIX-FMT-JPGL:

       -  ``V4L2_PIX_FMT_JPGL``

       -  'JPGL'

       -  JPEG-Light format (Pegasus Lossless JPEG) used in Divio webcams NW
	  80x.

    -  .. _V4L2-PIX-FMT-SPCA501:

       -  ``V4L2_PIX_FMT_SPCA501``

       -  'S501'

       -  YUYV per line used by the gspca driver.

    -  .. _V4L2-PIX-FMT-SPCA505:

       -  ``V4L2_PIX_FMT_SPCA505``

       -  'S505'

       -  YYUV per line used by the gspca driver.

    -  .. _V4L2-PIX-FMT-SPCA508:

       -  ``V4L2_PIX_FMT_SPCA508``

       -  'S508'

       -  YUVY per line used by the gspca driver.

    -  .. _V4L2-PIX-FMT-SPCA561:

       -  ``V4L2_PIX_FMT_SPCA561``

       -  'S561'

       -  Compressed GBRG Bayer format used by the gspca driver.

    -  .. _V4L2-PIX-FMT-PAC207:

       -  ``V4L2_PIX_FMT_PAC207``

       -  'P207'

       -  Compressed BGGR Bayer format used by the gspca driver.

    -  .. _V4L2-PIX-FMT-MR97310A:

       -  ``V4L2_PIX_FMT_MR97310A``

       -  'M310'

       -  Compressed BGGR Bayer format used by the gspca driver.

    -  .. _V4L2-PIX-FMT-JL2005BCD:

       -  ``V4L2_PIX_FMT_JL2005BCD``

       -  'JL20'

       -  JPEG compressed RGGB Bayer format used by the gspca driver.

    -  .. _V4L2-PIX-FMT-OV511:

       -  ``V4L2_PIX_FMT_OV511``

       -  'O511'

       -  OV511 JPEG format used by the gspca driver.

    -  .. _V4L2-PIX-FMT-OV518:

       -  ``V4L2_PIX_FMT_OV518``

       -  'O518'

       -  OV518 JPEG format used by the gspca driver.

    -  .. _V4L2-PIX-FMT-PJPG:

       -  ``V4L2_PIX_FMT_PJPG``

       -  'PJPG'

       -  Pixart 73xx JPEG format used by the gspca driver.

    -  .. _V4L2-PIX-FMT-SE401:

       -  ``V4L2_PIX_FMT_SE401``

       -  'S401'

       -  Compressed RGB format used by the gspca se401 driver

    -  .. _V4L2-PIX-FMT-SQ905C:

       -  ``V4L2_PIX_FMT_SQ905C``

       -  '905C'

       -  Compressed RGGB bayer format used by the gspca driver.

    -  .. _V4L2-PIX-FMT-MJPEG:

       -  ``V4L2_PIX_FMT_MJPEG``

       -  'MJPG'

       -  Compressed format used by the Zoran driver

    -  .. _V4L2-PIX-FMT-PWC1:

       -  ``V4L2_PIX_FMT_PWC1``

       -  'PWC1'

       -  Compressed format of the PWC driver.

    -  .. _V4L2-PIX-FMT-PWC2:

       -  ``V4L2_PIX_FMT_PWC2``

       -  'PWC2'

       -  Compressed format of the PWC driver.

    -  .. _V4L2-PIX-FMT-SN9C10X:

       -  ``V4L2_PIX_FMT_SN9C10X``

       -  'S910'

       -  Compressed format of the SN9C102 driver.

    -  .. _V4L2-PIX-FMT-SN9C20X-I420:

       -  ``V4L2_PIX_FMT_SN9C20X_I420``

       -  'S920'

       -  YUV 4:2:0 format of the gspca sn9c20x driver.

    -  .. _V4L2-PIX-FMT-SN9C2028:

       -  ``V4L2_PIX_FMT_SN9C2028``

       -  'SONX'

       -  Compressed GBRG bayer format of the gspca sn9c2028 driver.

    -  .. _V4L2-PIX-FMT-STV0680:

       -  ``V4L2_PIX_FMT_STV0680``

       -  'S680'

       -  Bayer format of the gspca stv0680 driver.

    -  .. _V4L2-PIX-FMT-WNVA:

       -  ``V4L2_PIX_FMT_WNVA``

       -  'WNVA'

       -  Used by the Winnov Videum driver,
	  `http://www.thedirks.org/winnov/ <http://www.thedirks.org/winnov/>`__

    -  .. _V4L2-PIX-FMT-TM6000:

       -  ``V4L2_PIX_FMT_TM6000``

       -  'TM60'

       -  Used by Trident tm6000

    -  .. _V4L2-PIX-FMT-CIT-YYVYUY:

       -  ``V4L2_PIX_FMT_CIT_YYVYUY``

       -  'CITV'

       -  Used by xirlink CIT, found at IBM webcams.

	  Uses one line of Y then 1 line of VYUY

    -  .. _V4L2-PIX-FMT-KONICA420:

       -  ``V4L2_PIX_FMT_KONICA420``

       -  'KONI'

       -  Used by Konica webcams.

	  YUV420 planar in blocks of 256 pixels.

    -  .. _V4L2-PIX-FMT-YYUV:

       -  ``V4L2_PIX_FMT_YYUV``

       -  'YYUV'

       -  unknown

    -  .. _V4L2-PIX-FMT-Y4:

       -  ``V4L2_PIX_FMT_Y4``

       -  'Y04 '

       -  Old 4-bit greyscale format. Only the most significant 4 bits of
	  each byte are used, the other bits are set to 0.

    -  .. _V4L2-PIX-FMT-Y6:

       -  ``V4L2_PIX_FMT_Y6``

       -  'Y06 '

       -  Old 6-bit greyscale format. Only the most significant 6 bits of
	  each byte are used, the other bits are set to 0.

    -  .. _V4L2-PIX-FMT-S5C-UYVY-JPG:

       -  ``V4L2_PIX_FMT_S5C_UYVY_JPG``

       -  'S5CI'

       -  Two-planar format used by Samsung S5C73MX cameras. The first plane
	  contains interleaved JPEG and UYVY image data, followed by meta
	  data in form of an array of offsets to the UYVY data blocks. The
	  actual pointer array follows immediately the interleaved JPEG/UYVY
	  data, the number of entries in this array equals the height of the
	  UYVY image. Each entry is a 4-byte unsigned integer in big endian
	  order and it's an offset to a single pixel line of the UYVY image.
	  The first plane can start either with JPEG or UYVY data chunk. The
	  size of a single UYVY block equals the UYVY image's width
	  multiplied by 2. The size of a JPEG chunk depends on the image and
	  can vary with each line.

	  The second plane, at an offset of 4084 bytes, contains a 4-byte
	  offset to the pointer array in the first plane. This offset is
	  followed by a 4-byte value indicating size of the pointer array.
	  All numbers in the second plane are also in big endian order.
	  Remaining data in the second plane is undefined. The information
	  in the second plane allows to easily find location of the pointer
	  array, which can be different for each frame. The size of the
	  pointer array is constant for given UYVY image height.

	  In order to extract UYVY and JPEG frames an application can
	  initially set a data pointer to the start of first plane and then
	  add an offset from the first entry of the pointers table. Such a
	  pointer indicates start of an UYVY image pixel line. Whole UYVY
	  line can be copied to a separate buffer. These steps should be
	  repeated for each line, i.e. the number of entries in the pointer
	  array. Anything what's in between the UYVY lines is JPEG data and
	  should be concatenated to form the JPEG stream.



.. _format-flags:

.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|

.. flat-table:: Format Flags
    :header-rows:  0
    :stub-columns: 0
    :widths:       3 1 4


    -  .. row 1

       -  ``V4L2_PIX_FMT_FLAG_PREMUL_ALPHA``

       -  0x00000001

       -  The color values are premultiplied by the alpha channel value. For
	  example, if a light blue pixel with 50% transparency was described
	  by RGBA values (128, 192, 255, 128), the same pixel described with
	  premultiplied colors would be described by RGBA values (64, 96,
	  128, 128)