0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002
0003 .. _pixfmt-reserved:
0004
0005 ***************************
0006 Reserved Format Identifiers
0007 ***************************
0008
0009 These formats are not defined by this specification, they are just
0010 listed for reference and to avoid naming conflicts. If you want to
0011 register your own format, send an e-mail to the linux-media mailing list
0012 `https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__
0013 for inclusion in the ``videodev2.h`` file. If you want to share your
0014 format with other developers add a link to your documentation and send a
0015 copy to the linux-media mailing list for inclusion in this section. If
0016 you think your format should be listed in a standard format section
0017 please make a proposal on the linux-media mailing list.
0018
0019
0020 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.5cm}|
0021
0022 .. raw:: latex
0023
0024 \small
0025
0026 .. _reserved-formats:
0027
0028 .. flat-table:: Reserved Image Formats
0029 :header-rows: 1
0030 :stub-columns: 0
0031 :widths: 3 1 4
0032
0033 * - Identifier
0034 - Code
0035 - Details
0036 * .. _V4L2-PIX-FMT-DV:
0037
0038 - ``V4L2_PIX_FMT_DV``
0039 - 'dvsd'
0040 - unknown
0041 * .. _V4L2-PIX-FMT-ET61X251:
0042
0043 - ``V4L2_PIX_FMT_ET61X251``
0044 - 'E625'
0045 - Compressed format of the ET61X251 driver.
0046 * .. _V4L2-PIX-FMT-HI240:
0047
0048 - ``V4L2_PIX_FMT_HI240``
0049 - 'HI24'
0050 - 8 bit RGB format used by the BTTV driver.
0051 * .. _V4L2-PIX-FMT-CPIA1:
0052
0053 - ``V4L2_PIX_FMT_CPIA1``
0054 - 'CPIA'
0055 - YUV format used by the gspca cpia1 driver.
0056 * .. _V4L2-PIX-FMT-JPGL:
0057
0058 - ``V4L2_PIX_FMT_JPGL``
0059 - 'JPGL'
0060 - JPEG-Light format (Pegasus Lossless JPEG) used in Divio webcams NW
0061 80x.
0062 * .. _V4L2-PIX-FMT-SPCA501:
0063
0064 - ``V4L2_PIX_FMT_SPCA501``
0065 - 'S501'
0066 - YUYV per line used by the gspca driver.
0067 * .. _V4L2-PIX-FMT-SPCA505:
0068
0069 - ``V4L2_PIX_FMT_SPCA505``
0070 - 'S505'
0071 - YYUV per line used by the gspca driver.
0072 * .. _V4L2-PIX-FMT-SPCA508:
0073
0074 - ``V4L2_PIX_FMT_SPCA508``
0075 - 'S508'
0076 - YUVY per line used by the gspca driver.
0077 * .. _V4L2-PIX-FMT-SPCA561:
0078
0079 - ``V4L2_PIX_FMT_SPCA561``
0080 - 'S561'
0081 - Compressed GBRG Bayer format used by the gspca driver.
0082 * .. _V4L2-PIX-FMT-PAC207:
0083
0084 - ``V4L2_PIX_FMT_PAC207``
0085 - 'P207'
0086 - Compressed BGGR Bayer format used by the gspca driver.
0087 * .. _V4L2-PIX-FMT-MR97310A:
0088
0089 - ``V4L2_PIX_FMT_MR97310A``
0090 - 'M310'
0091 - Compressed BGGR Bayer format used by the gspca driver.
0092 * .. _V4L2-PIX-FMT-JL2005BCD:
0093
0094 - ``V4L2_PIX_FMT_JL2005BCD``
0095 - 'JL20'
0096 - JPEG compressed RGGB Bayer format used by the gspca driver.
0097 * .. _V4L2-PIX-FMT-OV511:
0098
0099 - ``V4L2_PIX_FMT_OV511``
0100 - 'O511'
0101 - OV511 JPEG format used by the gspca driver.
0102 * .. _V4L2-PIX-FMT-OV518:
0103
0104 - ``V4L2_PIX_FMT_OV518``
0105 - 'O518'
0106 - OV518 JPEG format used by the gspca driver.
0107 * .. _V4L2-PIX-FMT-PJPG:
0108
0109 - ``V4L2_PIX_FMT_PJPG``
0110 - 'PJPG'
0111 - Pixart 73xx JPEG format used by the gspca driver.
0112 * .. _V4L2-PIX-FMT-SE401:
0113
0114 - ``V4L2_PIX_FMT_SE401``
0115 - 'S401'
0116 - Compressed RGB format used by the gspca se401 driver
0117 * .. _V4L2-PIX-FMT-SQ905C:
0118
0119 - ``V4L2_PIX_FMT_SQ905C``
0120 - '905C'
0121 - Compressed RGGB bayer format used by the gspca driver.
0122 * .. _V4L2-PIX-FMT-MJPEG:
0123
0124 - ``V4L2_PIX_FMT_MJPEG``
0125 - 'MJPG'
0126 - Compressed format used by the Zoran driver
0127 * .. _V4L2-PIX-FMT-PWC1:
0128
0129 - ``V4L2_PIX_FMT_PWC1``
0130 - 'PWC1'
0131 - Compressed format of the PWC driver.
0132 * .. _V4L2-PIX-FMT-PWC2:
0133
0134 - ``V4L2_PIX_FMT_PWC2``
0135 - 'PWC2'
0136 - Compressed format of the PWC driver.
0137 * .. _V4L2-PIX-FMT-SN9C10X:
0138
0139 - ``V4L2_PIX_FMT_SN9C10X``
0140 - 'S910'
0141 - Compressed format of the SN9C102 driver.
0142 * .. _V4L2-PIX-FMT-SN9C20X-I420:
0143
0144 - ``V4L2_PIX_FMT_SN9C20X_I420``
0145 - 'S920'
0146 - YUV 4:2:0 format of the gspca sn9c20x driver.
0147 * .. _V4L2-PIX-FMT-SN9C2028:
0148
0149 - ``V4L2_PIX_FMT_SN9C2028``
0150 - 'SONX'
0151 - Compressed GBRG bayer format of the gspca sn9c2028 driver.
0152 * .. _V4L2-PIX-FMT-STV0680:
0153
0154 - ``V4L2_PIX_FMT_STV0680``
0155 - 'S680'
0156 - Bayer format of the gspca stv0680 driver.
0157 * .. _V4L2-PIX-FMT-WNVA:
0158
0159 - ``V4L2_PIX_FMT_WNVA``
0160 - 'WNVA'
0161 - Used by the Winnov Videum driver,
0162 `http://www.thedirks.org/winnov/ <http://www.thedirks.org/winnov/>`__
0163 * .. _V4L2-PIX-FMT-TM6000:
0164
0165 - ``V4L2_PIX_FMT_TM6000``
0166 - 'TM60'
0167 - Used by Trident tm6000
0168 * .. _V4L2-PIX-FMT-CIT-YYVYUY:
0169
0170 - ``V4L2_PIX_FMT_CIT_YYVYUY``
0171 - 'CITV'
0172 - Used by xirlink CIT, found at IBM webcams.
0173
0174 Uses one line of Y then 1 line of VYUY
0175 * .. _V4L2-PIX-FMT-KONICA420:
0176
0177 - ``V4L2_PIX_FMT_KONICA420``
0178 - 'KONI'
0179 - Used by Konica webcams.
0180
0181 YUV420 planar in blocks of 256 pixels.
0182 * .. _V4L2-PIX-FMT-YYUV:
0183
0184 - ``V4L2_PIX_FMT_YYUV``
0185 - 'YYUV'
0186 - unknown
0187 * .. _V4L2-PIX-FMT-Y4:
0188
0189 - ``V4L2_PIX_FMT_Y4``
0190 - 'Y04 '
0191 - Old 4-bit greyscale format. Only the most significant 4 bits of
0192 each byte are used, the other bits are set to 0.
0193 * .. _V4L2-PIX-FMT-Y6:
0194
0195 - ``V4L2_PIX_FMT_Y6``
0196 - 'Y06 '
0197 - Old 6-bit greyscale format. Only the most significant 6 bits of
0198 each byte are used, the other bits are set to 0.
0199 * .. _V4L2-PIX-FMT-S5C-UYVY-JPG:
0200
0201 - ``V4L2_PIX_FMT_S5C_UYVY_JPG``
0202 - 'S5CI'
0203 - Two-planar format used by Samsung S5C73MX cameras. The first plane
0204 contains interleaved JPEG and UYVY image data, followed by meta
0205 data in form of an array of offsets to the UYVY data blocks. The
0206 actual pointer array follows immediately the interleaved JPEG/UYVY
0207 data, the number of entries in this array equals the height of the
0208 UYVY image. Each entry is a 4-byte unsigned integer in big endian
0209 order and it's an offset to a single pixel line of the UYVY image.
0210 The first plane can start either with JPEG or UYVY data chunk. The
0211 size of a single UYVY block equals the UYVY image's width
0212 multiplied by 2. The size of a JPEG chunk depends on the image and
0213 can vary with each line.
0214
0215 The second plane, at an offset of 4084 bytes, contains a 4-byte
0216 offset to the pointer array in the first plane. This offset is
0217 followed by a 4-byte value indicating size of the pointer array.
0218 All numbers in the second plane are also in big endian order.
0219 Remaining data in the second plane is undefined. The information
0220 in the second plane allows to easily find location of the pointer
0221 array, which can be different for each frame. The size of the
0222 pointer array is constant for given UYVY image height.
0223
0224 In order to extract UYVY and JPEG frames an application can
0225 initially set a data pointer to the start of first plane and then
0226 add an offset from the first entry of the pointers table. Such a
0227 pointer indicates start of an UYVY image pixel line. Whole UYVY
0228 line can be copied to a separate buffer. These steps should be
0229 repeated for each line, i.e. the number of entries in the pointer
0230 array. Anything what's in between the UYVY lines is JPEG data and
0231 should be concatenated to form the JPEG stream.
0232 * .. _V4L2-PIX-FMT-MT21C:
0233
0234 - ``V4L2_PIX_FMT_MT21C``
0235 - 'MT21'
0236 - Compressed two-planar YVU420 format used by Mediatek MT8173, MT8192,
0237 MT8195 and more. The compression is lossless. This format have
0238 similitude with ``V4L2_PIX_FMT_MM21`` in term of alignment and tiling.
0239 It remains an opaque intermediate format and the MDP hardware must be
0240 used to convert ``V4L2_PIX_FMT_MT21C`` to ``V4L2_PIX_FMT_NV12M``,
0241 ``V4L2_PIX_FMT_YUV420M`` or ``V4L2_PIX_FMT_YVU420``.
0242 * .. _V4L2-PIX-FMT-QC08C:
0243
0244 - ``V4L2_PIX_FMT_QC08C``
0245 - 'QC08C'
0246 - Compressed Macro-tile 8-Bit YUV420 format used by Qualcomm platforms.
0247 It is an opaque intermediate format. The used compression is lossless
0248 and it is used by various multimedia hardware blocks like GPU, display
0249 controllers, ISP and video accelerators.
0250 It contains four planes for progressive video and eight planes for
0251 interlaced video.
0252 * .. _V4L2-PIX-FMT-QC10C:
0253
0254 - ``V4L2_PIX_FMT_QC10C``
0255 - 'QC10C'
0256 - Compressed Macro-tile 10-Bit YUV420 format used by Qualcomm platforms.
0257 It is an opaque intermediate format. The used compression is lossless
0258 and it is used by various multimedia hardware blocks like GPU, display
0259 controllers, ISP and video accelerators.
0260 It contains four planes for progressive video.
0261 .. raw:: latex
0262
0263 \normalsize
