1.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later 2 3.. _pixfmt-reserved: 4 5*************************** 6Reserved Format Identifiers 7*************************** 8 9These formats are not defined by this specification, they are just 10listed for reference and to avoid naming conflicts. If you want to 11register your own format, send an e-mail to the linux-media mailing list 12`https://linuxtv.org/lists.php <https://linuxtv.org/lists.php>`__ 13for inclusion in the ``videodev2.h`` file. If you want to share your 14format with other developers add a link to your documentation and send a 15copy to the linux-media mailing list for inclusion in this section. If 16you think your format should be listed in a standard format section 17please make a proposal on the linux-media mailing list. 18 19 20.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.5cm}| 21 22.. raw:: latex 23 24 \small 25 26.. _reserved-formats: 27 28.. flat-table:: Reserved Image Formats 29 :header-rows: 1 30 :stub-columns: 0 31 :widths: 3 1 4 32 33 * - Identifier 34 - Code 35 - Details 36 * .. _V4L2-PIX-FMT-DV: 37 38 - ``V4L2_PIX_FMT_DV`` 39 - 'dvsd' 40 - unknown 41 * .. _V4L2-PIX-FMT-ET61X251: 42 43 - ``V4L2_PIX_FMT_ET61X251`` 44 - 'E625' 45 - Compressed format of the ET61X251 driver. 46 * .. _V4L2-PIX-FMT-HI240: 47 48 - ``V4L2_PIX_FMT_HI240`` 49 - 'HI24' 50 - 8 bit RGB format used by the BTTV driver. 51 * .. _V4L2-PIX-FMT-CPIA1: 52 53 - ``V4L2_PIX_FMT_CPIA1`` 54 - 'CPIA' 55 - YUV format used by the gspca cpia1 driver. 56 * .. _V4L2-PIX-FMT-JPGL: 57 58 - ``V4L2_PIX_FMT_JPGL`` 59 - 'JPGL' 60 - JPEG-Light format (Pegasus Lossless JPEG) used in Divio webcams NW 61 80x. 62 * .. _V4L2-PIX-FMT-SPCA501: 63 64 - ``V4L2_PIX_FMT_SPCA501`` 65 - 'S501' 66 - YUYV per line used by the gspca driver. 67 * .. _V4L2-PIX-FMT-SPCA505: 68 69 - ``V4L2_PIX_FMT_SPCA505`` 70 - 'S505' 71 - YYUV per line used by the gspca driver. 72 * .. _V4L2-PIX-FMT-SPCA508: 73 74 - ``V4L2_PIX_FMT_SPCA508`` 75 - 'S508' 76 - YUVY per line used by the gspca driver. 77 * .. _V4L2-PIX-FMT-SPCA561: 78 79 - ``V4L2_PIX_FMT_SPCA561`` 80 - 'S561' 81 - Compressed GBRG Bayer format used by the gspca driver. 82 * .. _V4L2-PIX-FMT-PAC207: 83 84 - ``V4L2_PIX_FMT_PAC207`` 85 - 'P207' 86 - Compressed BGGR Bayer format used by the gspca driver. 87 * .. _V4L2-PIX-FMT-MR97310A: 88 89 - ``V4L2_PIX_FMT_MR97310A`` 90 - 'M310' 91 - Compressed BGGR Bayer format used by the gspca driver. 92 * .. _V4L2-PIX-FMT-JL2005BCD: 93 94 - ``V4L2_PIX_FMT_JL2005BCD`` 95 - 'JL20' 96 - JPEG compressed RGGB Bayer format used by the gspca driver. 97 * .. _V4L2-PIX-FMT-OV511: 98 99 - ``V4L2_PIX_FMT_OV511`` 100 - 'O511' 101 - OV511 JPEG format used by the gspca driver. 102 * .. _V4L2-PIX-FMT-OV518: 103 104 - ``V4L2_PIX_FMT_OV518`` 105 - 'O518' 106 - OV518 JPEG format used by the gspca driver. 107 * .. _V4L2-PIX-FMT-PJPG: 108 109 - ``V4L2_PIX_FMT_PJPG`` 110 - 'PJPG' 111 - Pixart 73xx JPEG format used by the gspca driver. 112 * .. _V4L2-PIX-FMT-SE401: 113 114 - ``V4L2_PIX_FMT_SE401`` 115 - 'S401' 116 - Compressed RGB format used by the gspca se401 driver 117 * .. _V4L2-PIX-FMT-SQ905C: 118 119 - ``V4L2_PIX_FMT_SQ905C`` 120 - '905C' 121 - Compressed RGGB bayer format used by the gspca driver. 122 * .. _V4L2-PIX-FMT-MJPEG: 123 124 - ``V4L2_PIX_FMT_MJPEG`` 125 - 'MJPG' 126 - Compressed format used by the Zoran driver 127 * .. _V4L2-PIX-FMT-PWC1: 128 129 - ``V4L2_PIX_FMT_PWC1`` 130 - 'PWC1' 131 - Compressed format of the PWC driver. 132 * .. _V4L2-PIX-FMT-PWC2: 133 134 - ``V4L2_PIX_FMT_PWC2`` 135 - 'PWC2' 136 - Compressed format of the PWC driver. 137 * .. _V4L2-PIX-FMT-SN9C10X: 138 139 - ``V4L2_PIX_FMT_SN9C10X`` 140 - 'S910' 141 - Compressed format of the SN9C102 driver. 142 * .. _V4L2-PIX-FMT-SN9C20X-I420: 143 144 - ``V4L2_PIX_FMT_SN9C20X_I420`` 145 - 'S920' 146 - YUV 4:2:0 format of the gspca sn9c20x driver. 147 * .. _V4L2-PIX-FMT-SN9C2028: 148 149 - ``V4L2_PIX_FMT_SN9C2028`` 150 - 'SONX' 151 - Compressed GBRG bayer format of the gspca sn9c2028 driver. 152 * .. _V4L2-PIX-FMT-STV0680: 153 154 - ``V4L2_PIX_FMT_STV0680`` 155 - 'S680' 156 - Bayer format of the gspca stv0680 driver. 157 * .. _V4L2-PIX-FMT-WNVA: 158 159 - ``V4L2_PIX_FMT_WNVA`` 160 - 'WNVA' 161 - Used by the Winnov Videum driver, 162 `http://www.thedirks.org/winnov/ <http://www.thedirks.org/winnov/>`__ 163 * .. _V4L2-PIX-FMT-TM6000: 164 165 - ``V4L2_PIX_FMT_TM6000`` 166 - 'TM60' 167 - Used by Trident tm6000 168 * .. _V4L2-PIX-FMT-CIT-YYVYUY: 169 170 - ``V4L2_PIX_FMT_CIT_YYVYUY`` 171 - 'CITV' 172 - Used by xirlink CIT, found at IBM webcams. 173 174 Uses one line of Y then 1 line of VYUY 175 * .. _V4L2-PIX-FMT-KONICA420: 176 177 - ``V4L2_PIX_FMT_KONICA420`` 178 - 'KONI' 179 - Used by Konica webcams. 180 181 YUV420 planar in blocks of 256 pixels. 182 * .. _V4L2-PIX-FMT-YYUV: 183 184 - ``V4L2_PIX_FMT_YYUV`` 185 - 'YYUV' 186 - unknown 187 * .. _V4L2-PIX-FMT-Y4: 188 189 - ``V4L2_PIX_FMT_Y4`` 190 - 'Y04 ' 191 - Old 4-bit greyscale format. Only the most significant 4 bits of 192 each byte are used, the other bits are set to 0. 193 * .. _V4L2-PIX-FMT-Y6: 194 195 - ``V4L2_PIX_FMT_Y6`` 196 - 'Y06 ' 197 - Old 6-bit greyscale format. Only the most significant 6 bits of 198 each byte are used, the other bits are set to 0. 199 * .. _V4L2-PIX-FMT-S5C-UYVY-JPG: 200 201 - ``V4L2_PIX_FMT_S5C_UYVY_JPG`` 202 - 'S5CI' 203 - Two-planar format used by Samsung S5C73MX cameras. The first plane 204 contains interleaved JPEG and UYVY image data, followed by meta 205 data in form of an array of offsets to the UYVY data blocks. The 206 actual pointer array follows immediately the interleaved JPEG/UYVY 207 data, the number of entries in this array equals the height of the 208 UYVY image. Each entry is a 4-byte unsigned integer in big endian 209 order and it's an offset to a single pixel line of the UYVY image. 210 The first plane can start either with JPEG or UYVY data chunk. The 211 size of a single UYVY block equals the UYVY image's width 212 multiplied by 2. The size of a JPEG chunk depends on the image and 213 can vary with each line. 214 215 The second plane, at an offset of 4084 bytes, contains a 4-byte 216 offset to the pointer array in the first plane. This offset is 217 followed by a 4-byte value indicating size of the pointer array. 218 All numbers in the second plane are also in big endian order. 219 Remaining data in the second plane is undefined. The information 220 in the second plane allows to easily find location of the pointer 221 array, which can be different for each frame. The size of the 222 pointer array is constant for given UYVY image height. 223 224 In order to extract UYVY and JPEG frames an application can 225 initially set a data pointer to the start of first plane and then 226 add an offset from the first entry of the pointers table. Such a 227 pointer indicates start of an UYVY image pixel line. Whole UYVY 228 line can be copied to a separate buffer. These steps should be 229 repeated for each line, i.e. the number of entries in the pointer 230 array. Anything what's in between the UYVY lines is JPEG data and 231 should be concatenated to form the JPEG stream. 232 * .. _V4L2-PIX-FMT-MT21C: 233 234 - ``V4L2_PIX_FMT_MT21C`` 235 - 'MT21' 236 - Compressed two-planar YVU420 format used by Mediatek MT8173, MT8192, 237 MT8195 and more. The compression is lossless. This format have 238 similitude with ``V4L2_PIX_FMT_MM21`` in term of alignment and tiling. 239 It remains an opaque intermediate format and the MDP hardware must be 240 used to convert ``V4L2_PIX_FMT_MT21C`` to ``V4L2_PIX_FMT_NV12M``, 241 ``V4L2_PIX_FMT_YUV420M`` or ``V4L2_PIX_FMT_YVU420``. 242 * .. _V4L2-PIX-FMT-QC08C: 243 244 - ``V4L2_PIX_FMT_QC08C`` 245 - 'QC08C' 246 - Compressed Macro-tile 8-Bit YUV420 format used by Qualcomm platforms. 247 It is an opaque intermediate format. The used compression is lossless 248 and it is used by various multimedia hardware blocks like GPU, display 249 controllers, ISP and video accelerators. 250 It contains four planes for progressive video and eight planes for 251 interlaced video. 252 * .. _V4L2-PIX-FMT-QC10C: 253 254 - ``V4L2_PIX_FMT_QC10C`` 255 - 'QC10C' 256 - Compressed Macro-tile 10-Bit YUV420 format used by Qualcomm platforms. 257 It is an opaque intermediate format. The used compression is lossless 258 and it is used by various multimedia hardware blocks like GPU, display 259 controllers, ISP and video accelerators. 260 It contains four planes for progressive video. 261 * .. _V4L2-PIX-FMT-AJPG: 262 263 - ``V4L2_PIX_FMT_AJPG`` 264 - 'AJPG' 265 - ASPEED JPEG format used by the aspeed-video driver on Aspeed platforms, 266 which is generally adapted for remote KVM. 267 On each frame compression, I will compare the new frame with previous 268 one to decide which macroblock's data is changed, and only the changed 269 macroblocks will be compressed. 270 271 The implementation is based on AST2600 A3 datasheet, revision 0.9, which 272 is not publicly available. Or you can reference Video stream data format 273 – ASPEED mode compression of SDK_User_Guide which available on 274 `github <https://github.com/AspeedTech-BMC/openbmc/releases/>`__. 275 276 Decoder's implementation can be found here, 277 `aspeed_codec <https://github.com/AspeedTech-BMC/aspeed_codec/>`__ 278.. raw:: latex 279 280 \normalsize 281