1 /*
2 * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at>
3 *
4 * This file is part of FFmpeg.
5 *
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 #ifndef AVUTIL_PIXFMT_H
22 #define AVUTIL_PIXFMT_H
23
24 /**
25 * @file
26 * pixel format definitions
27 *
28 */
29
30 #include "libavutil/avconfig.h"
32
33 #define AVPALETTE_SIZE 1024
34 #define AVPALETTE_COUNT 256
35
36 /**
37 * Pixel format.
38 *
39 * @note
40 * AV_PIX_FMT_RGB32 is handled in an endian-specific manner. An RGBA
41 * color is put together as:
42 * (A << 24) | (R << 16) | (G << 8) | B
43 * This is stored as BGRA on little-endian CPU architectures and ARGB on
44 * big-endian CPUs.
45 *
46 * @par
47 * When the pixel format is palettized RGB (AV_PIX_FMT_PAL8), the palettized
48 * image data is stored in AVFrame.data[0]. The palette is transported in
49 * AVFrame.data[1], is 1024 bytes long (256 4-byte entries) and is
50 * formatted the same as in AV_PIX_FMT_RGB32 described above (i.e., it is
51 * also endian-specific). Note also that the individual RGB palette
52 * components stored in AVFrame.data[1] should be in the range 0..255.
53 * This is important as many custom PAL8 video codecs that were designed
54 * to run on the IBM VGA graphics adapter use 6-bit palette components.
55 *
56 * @par
57 * For all the 8bit per pixel formats, an RGB32 palette is in data[1] like
58 * for pal8. This palette is filled in automatically by the function
59 * allocating the picture.
60 *
61 * @note
62 * Make sure that all newly added big-endian formats have (pix_fmt & 1) == 1
63 * and that all newly added little-endian formats have (pix_fmt & 1) == 0.
64 * This allows simpler detection of big vs little-endian.
65 */
77 AV_PIX_FMT_MONOWHITE,
///< Y , 1bpp, 0 is white, 1 is black, in each byte pixels are ordered from the msb to the lsb
78 AV_PIX_FMT_MONOBLACK,
///< Y , 1bpp, 0 is black, 1 is white, in each byte pixels are ordered from the msb to the lsb
80 AV_PIX_FMT_YUVJ420P,
///< planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of PIX_FMT_YUV420P and setting color_range
81 AV_PIX_FMT_YUVJ422P,
///< planar YUV 4:2:2, 16bpp, full scale (JPEG), deprecated in favor of PIX_FMT_YUV422P and setting color_range
82 AV_PIX_FMT_YUVJ444P,
///< planar YUV 4:4:4, 24bpp, full scale (JPEG), deprecated in favor of PIX_FMT_YUV444P and setting color_range
88 AV_PIX_FMT_BGR4,
///< packed RGB 1:2:1 bitstream, 4bpp, (msb)1B 2G 1R(lsb), a byte contains two pixels, the first pixel in the byte is the one composed by the 4 msb bits
91 AV_PIX_FMT_RGB4,
///< packed RGB 1:2:1 bitstream, 4bpp, (msb)1R 2G 1B(lsb), a byte contains two pixels, the first pixel in the byte is the one composed by the 4 msb bits
93 AV_PIX_FMT_NV12,
///< planar YUV 4:2:0, 12bpp, 1 plane for Y and 1 plane for the UV components, which are interleaved (first byte U and the following byte V)
95
100
104 AV_PIX_FMT_YUVJ440P,
///< planar YUV 4:4:0 full scale (JPEG), deprecated in favor of PIX_FMT_YUV440P and setting color_range
106 #if FF_API_VDPAU
107 AV_PIX_FMT_VDPAU_H264,
///< H.264 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
108 AV_PIX_FMT_VDPAU_MPEG1,
///< MPEG-1 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
109 AV_PIX_FMT_VDPAU_MPEG2,
///< MPEG-2 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
110 AV_PIX_FMT_VDPAU_WMV3,
///< WMV3 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
111 AV_PIX_FMT_VDPAU_VC1,
///< VC-1 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
112 #endif
113 AV_PIX_FMT_RGB48BE,
///< packed RGB 16:16:16, 48bpp, 16R, 16G, 16B, the 2-byte value for each R/G/B component is stored as big-endian
114 AV_PIX_FMT_RGB48LE,
///< packed RGB 16:16:16, 48bpp, 16R, 16G, 16B, the 2-byte value for each R/G/B component is stored as little-endian
115
118 AV_PIX_FMT_RGB555BE,
///< packed RGB 5:5:5, 16bpp, (msb)1A 5R 5G 5B(lsb), big-endian, most significant bit to 0
119 AV_PIX_FMT_RGB555LE,
///< packed RGB 5:5:5, 16bpp, (msb)1A 5R 5G 5B(lsb), little-endian, most significant bit to 0
120
123 AV_PIX_FMT_BGR555BE,
///< packed BGR 5:5:5, 16bpp, (msb)1A 5B 5G 5R(lsb), big-endian, most significant bit to 1
124 AV_PIX_FMT_BGR555LE,
///< packed BGR 5:5:5, 16bpp, (msb)1A 5B 5G 5R(lsb), little-endian, most significant bit to 1
125
126 AV_PIX_FMT_VAAPI_MOCO,
///< HW acceleration through VA API at motion compensation entry-point, Picture.data[3] contains a vaapi_render_state struct which contains macroblocks as well as various fields extracted from headers
127 AV_PIX_FMT_VAAPI_IDCT,
///< HW acceleration through VA API at IDCT entry-point, Picture.data[3] contains a vaapi_render_state struct which contains fields extracted from headers
128 AV_PIX_FMT_VAAPI_VLD,
///< HW decoding through VA API, Picture.data[3] contains a vaapi_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
129
136 #if FF_API_VDPAU
137 AV_PIX_FMT_VDPAU_MPEG4,
///< MPEG4 HW decoding with VDPAU, data[0] contains a vdpau_render_state struct which contains the bitstream of the slices as well as various fields extracted from headers
138 #endif
140
141 AV_PIX_FMT_RGB444LE,
///< packed RGB 4:4:4, 16bpp, (msb)4A 4R 4G 4B(lsb), little-endian, most significant bits to 0
142 AV_PIX_FMT_RGB444BE,
///< packed RGB 4:4:4, 16bpp, (msb)4A 4R 4G 4B(lsb), big-endian, most significant bits to 0
143 AV_PIX_FMT_BGR444LE,
///< packed BGR 4:4:4, 16bpp, (msb)4A 4B 4G 4R(lsb), little-endian, most significant bits to 1
144 AV_PIX_FMT_BGR444BE,
///< packed BGR 4:4:4, 16bpp, (msb)4A 4B 4G 4R(lsb), big-endian, most significant bits to 1
146 AV_PIX_FMT_BGR48BE,
///< packed RGB 16:16:16, 48bpp, 16B, 16G, 16R, the 2-byte value for each R/G/B component is stored as big-endian
147 AV_PIX_FMT_BGR48LE,
///< packed RGB 16:16:16, 48bpp, 16B, 16G, 16R, the 2-byte value for each R/G/B component is stored as little-endian
148
149 /**
150 * The following 12 formats have the disadvantage of needing 1 format for each bit depth.
151 * Notice that each 9/10 bits sample is stored in 16 bits with extra padding.
152 * If you want to support multiple bit depths, then using AV_PIX_FMT_YUV420P16* with the bpp stored separately is better.
153 */
167
168 #ifdef AV_PIX_FMT_ABI_GIT_MASTER
169 AV_PIX_FMT_RGBA64BE,
///< packed RGBA 16:16:16:16, 64bpp, 16R, 16G, 16B, 16A, the 2-byte value for each R/G/B/A component is stored as big-endian
170 AV_PIX_FMT_RGBA64LE,
///< packed RGBA 16:16:16:16, 64bpp, 16R, 16G, 16B, 16A, the 2-byte value for each R/G/B/A component is stored as little-endian
171 AV_PIX_FMT_BGRA64BE,
///< packed RGBA 16:16:16:16, 64bpp, 16B, 16G, 16R, 16A, the 2-byte value for each R/G/B/A component is stored as big-endian
172 AV_PIX_FMT_BGRA64LE,
///< packed RGBA 16:16:16:16, 64bpp, 16B, 16G, 16R, 16A, the 2-byte value for each R/G/B/A component is stored as little-endian
173 #endif
181
182 /**
183 * duplicated pixel formats for compatibility with libav.
184 * FFmpeg supports these formats since May 8 2012 and Jan 28 2012 (commits f9ca1ac7 and 143a5c55)
185 * Libav added them Oct 12 2012 with incompatible values (commit 6d5600e85)
186 */
189
208
209 AV_PIX_FMT_VDPAU,
///< HW acceleration through VDPAU, Picture.data[3] contains a VdpVideoSurface
210
211 AV_PIX_FMT_XYZ12LE,
///< packed XYZ 4:4:4, 36 bpp, (msb) 12X, 12Y, 12Z (lsb), the 2-byte value for each X/Y/Z is stored as little-endian, the 4 lower bits are set to 0
212 AV_PIX_FMT_XYZ12BE,
///< packed XYZ 4:4:4, 36 bpp, (msb) 12X, 12Y, 12Z (lsb), the 2-byte value for each X/Y/Z is stored as big-endian, the 4 lower bits are set to 0
213 AV_PIX_FMT_NV16,
///< interleaved chroma YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
214 AV_PIX_FMT_NV20LE,
///< interleaved chroma YUV 4:2:2, 20bpp, (1 Cr & Cb sample per 2x1 Y samples), little-endian
215 AV_PIX_FMT_NV20BE,
///< interleaved chroma YUV 4:2:2, 20bpp, (1 Cr & Cb sample per 2x1 Y samples), big-endian
216
217 #ifndef AV_PIX_FMT_ABI_GIT_MASTER
218 AV_PIX_FMT_RGBA64BE=0x123,
///< packed RGBA 16:16:16:16, 64bpp, 16R, 16G, 16B, 16A, the 2-byte value for each R/G/B/A component is stored as big-endian
219 AV_PIX_FMT_RGBA64LE,
///< packed RGBA 16:16:16:16, 64bpp, 16R, 16G, 16B, 16A, the 2-byte value for each R/G/B/A component is stored as little-endian
220 AV_PIX_FMT_BGRA64BE,
///< packed RGBA 16:16:16:16, 64bpp, 16B, 16G, 16R, 16A, the 2-byte value for each R/G/B/A component is stored as big-endian
221 AV_PIX_FMT_BGRA64LE,
///< packed RGBA 16:16:16:16, 64bpp, 16B, 16G, 16R, 16A, the 2-byte value for each R/G/B/A component is stored as little-endian
222 #endif
229
249 AV_PIX_FMT_YUVJ411P,
///< planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples) full scale (JPEG), deprecated in favor of PIX_FMT_YUV411P and setting color_range
250
263
264 AV_PIX_FMT_NB,
///< number of pixel formats, DO NOT USE THIS if you want to link with shared libav* because the number of formats might differ between versions
265
266 #if FF_API_PIX_FMT
268 #endif
269 };
270
271 #if AV_HAVE_INCOMPATIBLE_LIBAV_ABI
272 #define AV_PIX_FMT_YUVA422P AV_PIX_FMT_YUVA422P_LIBAV
273 #define AV_PIX_FMT_YUVA444P AV_PIX_FMT_YUVA444P_LIBAV
274 #endif
275
276
277 #define AV_PIX_FMT_Y400A AV_PIX_FMT_GRAY8A
278 #define AV_PIX_FMT_GBR24P AV_PIX_FMT_GBRP
279
280 #if AV_HAVE_BIGENDIAN
281 # define AV_PIX_FMT_NE(be, le) AV_PIX_FMT_##be
282 #else
283 # define AV_PIX_FMT_NE(be, le) AV_PIX_FMT_##le
284 #endif
285
286 #define AV_PIX_FMT_RGB32 AV_PIX_FMT_NE(ARGB, BGRA)
287 #define AV_PIX_FMT_RGB32_1 AV_PIX_FMT_NE(RGBA, ABGR)
288 #define AV_PIX_FMT_BGR32 AV_PIX_FMT_NE(ABGR, RGBA)
289 #define AV_PIX_FMT_BGR32_1 AV_PIX_FMT_NE(BGRA, ARGB)
290 #define AV_PIX_FMT_0RGB32 AV_PIX_FMT_NE(0RGB, BGR0)
291 #define AV_PIX_FMT_0BGR32 AV_PIX_FMT_NE(0BGR, RGB0)
292
293 #define AV_PIX_FMT_GRAY16 AV_PIX_FMT_NE(GRAY16BE, GRAY16LE)
294 #define AV_PIX_FMT_RGB48 AV_PIX_FMT_NE(RGB48BE, RGB48LE)
295 #define AV_PIX_FMT_RGB565 AV_PIX_FMT_NE(RGB565BE, RGB565LE)
296 #define AV_PIX_FMT_RGB555 AV_PIX_FMT_NE(RGB555BE, RGB555LE)
297 #define AV_PIX_FMT_RGB444 AV_PIX_FMT_NE(RGB444BE, RGB444LE)
298 #define AV_PIX_FMT_BGR48 AV_PIX_FMT_NE(BGR48BE, BGR48LE)
299 #define AV_PIX_FMT_BGR565 AV_PIX_FMT_NE(BGR565BE, BGR565LE)
300 #define AV_PIX_FMT_BGR555 AV_PIX_FMT_NE(BGR555BE, BGR555LE)
301 #define AV_PIX_FMT_BGR444 AV_PIX_FMT_NE(BGR444BE, BGR444LE)
303 #define AV_PIX_FMT_YUV420P9 AV_PIX_FMT_NE(YUV420P9BE , YUV420P9LE)
304 #define AV_PIX_FMT_YUV422P9 AV_PIX_FMT_NE(YUV422P9BE , YUV422P9LE)
305 #define AV_PIX_FMT_YUV444P9 AV_PIX_FMT_NE(YUV444P9BE , YUV444P9LE)
306 #define AV_PIX_FMT_YUV420P10 AV_PIX_FMT_NE(YUV420P10BE, YUV420P10LE)
307 #define AV_PIX_FMT_YUV422P10 AV_PIX_FMT_NE(YUV422P10BE, YUV422P10LE)
308 #define AV_PIX_FMT_YUV444P10 AV_PIX_FMT_NE(YUV444P10BE, YUV444P10LE)
309 #define AV_PIX_FMT_YUV420P12 AV_PIX_FMT_NE(YUV420P12BE, YUV420P12LE)
310 #define AV_PIX_FMT_YUV422P12 AV_PIX_FMT_NE(YUV422P12BE, YUV422P12LE)
311 #define AV_PIX_FMT_YUV444P12 AV_PIX_FMT_NE(YUV444P12BE, YUV444P12LE)
312 #define AV_PIX_FMT_YUV420P14 AV_PIX_FMT_NE(YUV420P14BE, YUV420P14LE)
313 #define AV_PIX_FMT_YUV422P14 AV_PIX_FMT_NE(YUV422P14BE, YUV422P14LE)
314 #define AV_PIX_FMT_YUV444P14 AV_PIX_FMT_NE(YUV444P14BE, YUV444P14LE)
315 #define AV_PIX_FMT_YUV420P16 AV_PIX_FMT_NE(YUV420P16BE, YUV420P16LE)
316 #define AV_PIX_FMT_YUV422P16 AV_PIX_FMT_NE(YUV422P16BE, YUV422P16LE)
317 #define AV_PIX_FMT_YUV444P16 AV_PIX_FMT_NE(YUV444P16BE, YUV444P16LE)
319 #define AV_PIX_FMT_RGBA64 AV_PIX_FMT_NE(RGBA64BE, RGBA64LE)
320 #define AV_PIX_FMT_BGRA64 AV_PIX_FMT_NE(BGRA64BE, BGRA64LE)
321 #define AV_PIX_FMT_GBRP9 AV_PIX_FMT_NE(GBRP9BE , GBRP9LE)
322 #define AV_PIX_FMT_GBRP10 AV_PIX_FMT_NE(GBRP10BE, GBRP10LE)
323 #define AV_PIX_FMT_GBRP12 AV_PIX_FMT_NE(GBRP12BE, GBRP12LE)
324 #define AV_PIX_FMT_GBRP14 AV_PIX_FMT_NE(GBRP14BE, GBRP14LE)
325 #define AV_PIX_FMT_GBRP16 AV_PIX_FMT_NE(GBRP16BE, GBRP16LE)
326 #define AV_PIX_FMT_GBRAP16 AV_PIX_FMT_NE(GBRAP16BE, GBRAP16LE)
328 #define AV_PIX_FMT_BAYER_BGGR16 AV_PIX_FMT_NE(BAYER_BGGR16BE, BAYER_BGGR16LE)
329 #define AV_PIX_FMT_BAYER_RGGB16 AV_PIX_FMT_NE(BAYER_RGGB16BE, BAYER_RGGB16LE)
330 #define AV_PIX_FMT_BAYER_GBRG16 AV_PIX_FMT_NE(BAYER_GBRG16BE, BAYER_GBRG16LE)
331 #define AV_PIX_FMT_BAYER_GRBG16 AV_PIX_FMT_NE(BAYER_GRBG16BE, BAYER_GRBG16LE)
334 #define AV_PIX_FMT_YUVA420P9 AV_PIX_FMT_NE(YUVA420P9BE , YUVA420P9LE)
335 #define AV_PIX_FMT_YUVA422P9 AV_PIX_FMT_NE(YUVA422P9BE , YUVA422P9LE)
336 #define AV_PIX_FMT_YUVA444P9 AV_PIX_FMT_NE(YUVA444P9BE , YUVA444P9LE)
337 #define AV_PIX_FMT_YUVA420P10 AV_PIX_FMT_NE(YUVA420P10BE, YUVA420P10LE)
338 #define AV_PIX_FMT_YUVA422P10 AV_PIX_FMT_NE(YUVA422P10BE, YUVA422P10LE)
339 #define AV_PIX_FMT_YUVA444P10 AV_PIX_FMT_NE(YUVA444P10BE, YUVA444P10LE)
340 #define AV_PIX_FMT_YUVA420P16 AV_PIX_FMT_NE(YUVA420P16BE, YUVA420P16LE)
341 #define AV_PIX_FMT_YUVA422P16 AV_PIX_FMT_NE(YUVA422P16BE, YUVA422P16LE)
342 #define AV_PIX_FMT_YUVA444P16 AV_PIX_FMT_NE(YUVA444P16BE, YUVA444P16LE)
343
344 #define AV_PIX_FMT_XYZ12 AV_PIX_FMT_NE(XYZ12BE, XYZ12LE)
345 #define AV_PIX_FMT_NV20 AV_PIX_FMT_NE(NV20BE, NV20LE)
346
348 #define PixelFormat AVPixelFormat
350 #define PIX_FMT_Y400A AV_PIX_FMT_Y400A
351 #define PIX_FMT_GBR24P AV_PIX_FMT_GBR24P
353 #define PIX_FMT_NE(be, le) AV_PIX_FMT_NE(be, le)
355 #define PIX_FMT_RGB32 AV_PIX_FMT_RGB32
356 #define PIX_FMT_RGB32_1 AV_PIX_FMT_RGB32_1
357 #define PIX_FMT_BGR32 AV_PIX_FMT_BGR32
358 #define PIX_FMT_BGR32_1 AV_PIX_FMT_BGR32_1
359 #define PIX_FMT_0RGB32 AV_PIX_FMT_0RGB32
360 #define PIX_FMT_0BGR32 AV_PIX_FMT_0BGR32
362 #define PIX_FMT_GRAY16 AV_PIX_FMT_GRAY16
363 #define PIX_FMT_RGB48 AV_PIX_FMT_RGB48
364 #define PIX_FMT_RGB565 AV_PIX_FMT_RGB565
365 #define PIX_FMT_RGB555 AV_PIX_FMT_RGB555
366 #define PIX_FMT_RGB444 AV_PIX_FMT_RGB444
367 #define PIX_FMT_BGR48 AV_PIX_FMT_BGR48
368 #define PIX_FMT_BGR565 AV_PIX_FMT_BGR565
369 #define PIX_FMT_BGR555 AV_PIX_FMT_BGR555
370 #define PIX_FMT_BGR444 AV_PIX_FMT_BGR444
371
372 #define PIX_FMT_YUV420P9 AV_PIX_FMT_YUV420P9
373 #define PIX_FMT_YUV422P9 AV_PIX_FMT_YUV422P9
374 #define PIX_FMT_YUV444P9 AV_PIX_FMT_YUV444P9
375 #define PIX_FMT_YUV420P10 AV_PIX_FMT_YUV420P10
376 #define PIX_FMT_YUV422P10 AV_PIX_FMT_YUV422P10
377 #define PIX_FMT_YUV444P10 AV_PIX_FMT_YUV444P10
378 #define PIX_FMT_YUV420P12 AV_PIX_FMT_YUV420P12
379 #define PIX_FMT_YUV422P12 AV_PIX_FMT_YUV422P12
380 #define PIX_FMT_YUV444P12 AV_PIX_FMT_YUV444P12
381 #define PIX_FMT_YUV420P14 AV_PIX_FMT_YUV420P14
382 #define PIX_FMT_YUV422P14 AV_PIX_FMT_YUV422P14
383 #define PIX_FMT_YUV444P14 AV_PIX_FMT_YUV444P14
384 #define PIX_FMT_YUV420P16 AV_PIX_FMT_YUV420P16
385 #define PIX_FMT_YUV422P16 AV_PIX_FMT_YUV422P16
386 #define PIX_FMT_YUV444P16 AV_PIX_FMT_YUV444P16
388 #define PIX_FMT_RGBA64 AV_PIX_FMT_RGBA64
389 #define PIX_FMT_BGRA64 AV_PIX_FMT_BGRA64
390 #define PIX_FMT_GBRP9 AV_PIX_FMT_GBRP9
391 #define PIX_FMT_GBRP10 AV_PIX_FMT_GBRP10
392 #define PIX_FMT_GBRP12 AV_PIX_FMT_GBRP12
393 #define PIX_FMT_GBRP14 AV_PIX_FMT_GBRP14
394 #define PIX_FMT_GBRP16 AV_PIX_FMT_GBRP16
396
397 #endif /* AVUTIL_PIXFMT_H */