swscale: support gray to 9bit and 10bit formats
[libav.git] / libavutil / pixfmt.h
CommitLineData
04331dea
SS
1/*
2 * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at>
3 *
2912e87a 4 * This file is part of Libav.
04331dea 5 *
2912e87a 6 * Libav is free software; you can redistribute it and/or
04331dea
SS
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 *
2912e87a 11 * Libav is distributed in the hope that it will be useful,
04331dea
SS
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
2912e87a 17 * License along with Libav; if not, write to the Free Software
04331dea
SS
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/**
ba87f080 25 * @file
04331dea
SS
26 * pixel format definitions
27 *
04331dea
SS
28 */
29
1d52b4b3 30#include "libavutil/avconfig.h"
78071a14 31#include "libavutil/version.h"
1d52b4b3 32
04331dea 33/**
384bdace 34 * Pixel format.
04331dea 35 *
384bdace 36 * @note
04331dea
SS
37 * PIX_FMT_RGB32 is handled in an endian-specific manner. An RGBA
38 * color is put together as:
39 * (A << 24) | (R << 16) | (G << 8) | B
40 * This is stored as BGRA on little-endian CPU architectures and ARGB on
41 * big-endian CPUs.
42 *
384bdace 43 * @par
04331dea
SS
44 * When the pixel format is palettized RGB (PIX_FMT_PAL8), the palettized
45 * image data is stored in AVFrame.data[0]. The palette is transported in
46 * AVFrame.data[1], is 1024 bytes long (256 4-byte entries) and is
47 * formatted the same as in PIX_FMT_RGB32 described above (i.e., it is
48 * also endian-specific). Note also that the individual RGB palette
49 * components stored in AVFrame.data[1] should be in the range 0..255.
50 * This is important as many custom PAL8 video codecs that were designed
51 * to run on the IBM VGA graphics adapter use 6-bit palette components.
52 *
384bdace 53 * @par
04331dea
SS
54 * For all the 8bit per pixel formats, an RGB32 palette is in data[1] like
55 * for pal8. This palette is filled in automatically by the function
56 * allocating the picture.
57 *
384bdace
LB
58 * @note
59 * make sure that all newly added big endian formats have pix_fmt&1==1
60 * and that all newly added little endian formats have pix_fmt&1==0
61 * this allows simpler detection of big vs little endian.
04331dea 62 */
78071a14
AK
63enum AVPixelFormat {
64 AV_PIX_FMT_NONE = -1,
65 AV_PIX_FMT_YUV420P, ///< planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
66 AV_PIX_FMT_YUYV422, ///< packed YUV 4:2:2, 16bpp, Y0 Cb Y1 Cr
67 AV_PIX_FMT_RGB24, ///< packed RGB 8:8:8, 24bpp, RGBRGB...
68 AV_PIX_FMT_BGR24, ///< packed RGB 8:8:8, 24bpp, BGRBGR...
69 AV_PIX_FMT_YUV422P, ///< planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
70 AV_PIX_FMT_YUV444P, ///< planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
71 AV_PIX_FMT_YUV410P, ///< planar YUV 4:1:0, 9bpp, (1 Cr & Cb sample per 4x4 Y samples)
72 AV_PIX_FMT_YUV411P, ///< planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples)
73 AV_PIX_FMT_GRAY8, ///< Y , 8bpp
74 AV_PIX_FMT_MONOWHITE, ///< Y , 1bpp, 0 is white, 1 is black, in each byte pixels are ordered from the msb to the lsb
75 AV_PIX_FMT_MONOBLACK, ///< Y , 1bpp, 0 is black, 1 is white, in each byte pixels are ordered from the msb to the lsb
76 AV_PIX_FMT_PAL8, ///< 8 bit with PIX_FMT_RGB32 palette
77 AV_PIX_FMT_YUVJ420P, ///< planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of PIX_FMT_YUV420P and setting color_range
78 AV_PIX_FMT_YUVJ422P, ///< planar YUV 4:2:2, 16bpp, full scale (JPEG), deprecated in favor of PIX_FMT_YUV422P and setting color_range
79 AV_PIX_FMT_YUVJ444P, ///< planar YUV 4:4:4, 24bpp, full scale (JPEG), deprecated in favor of PIX_FMT_YUV444P and setting color_range
80 AV_PIX_FMT_XVMC_MPEG2_MC,///< XVideo Motion Acceleration via common packet passing
81 AV_PIX_FMT_XVMC_MPEG2_IDCT,
82 AV_PIX_FMT_UYVY422, ///< packed YUV 4:2:2, 16bpp, Cb Y0 Cr Y1
83 AV_PIX_FMT_UYYVYY411, ///< packed YUV 4:1:1, 12bpp, Cb Y0 Y1 Cr Y2 Y3
84 AV_PIX_FMT_BGR8, ///< packed RGB 3:3:2, 8bpp, (msb)2B 3G 3R(lsb)
85 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
86 AV_PIX_FMT_BGR4_BYTE, ///< packed RGB 1:2:1, 8bpp, (msb)1B 2G 1R(lsb)
87 AV_PIX_FMT_RGB8, ///< packed RGB 3:3:2, 8bpp, (msb)2R 3G 3B(lsb)
88 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
89 AV_PIX_FMT_RGB4_BYTE, ///< packed RGB 1:2:1, 8bpp, (msb)1R 2G 1B(lsb)
90 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)
91 AV_PIX_FMT_NV21, ///< as above, but U and V bytes are swapped
92
93 AV_PIX_FMT_ARGB, ///< packed ARGB 8:8:8:8, 32bpp, ARGBARGB...
94 AV_PIX_FMT_RGBA, ///< packed RGBA 8:8:8:8, 32bpp, RGBARGBA...
95 AV_PIX_FMT_ABGR, ///< packed ABGR 8:8:8:8, 32bpp, ABGRABGR...
96 AV_PIX_FMT_BGRA, ///< packed BGRA 8:8:8:8, 32bpp, BGRABGRA...
97
98 AV_PIX_FMT_GRAY16BE, ///< Y , 16bpp, big-endian
99 AV_PIX_FMT_GRAY16LE, ///< Y , 16bpp, little-endian
100 AV_PIX_FMT_YUV440P, ///< planar YUV 4:4:0 (1 Cr & Cb sample per 1x2 Y samples)
101 AV_PIX_FMT_YUVJ440P, ///< planar YUV 4:4:0 full scale (JPEG), deprecated in favor of PIX_FMT_YUV440P and setting color_range
102 AV_PIX_FMT_YUVA420P, ///< planar YUV 4:2:0, 20bpp, (1 Cr & Cb sample per 2x2 Y & A samples)
103 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
104 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
105 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
106 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
107 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
108 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
109 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
110
111 AV_PIX_FMT_RGB565BE, ///< packed RGB 5:6:5, 16bpp, (msb) 5R 6G 5B(lsb), big-endian
112 AV_PIX_FMT_RGB565LE, ///< packed RGB 5:6:5, 16bpp, (msb) 5R 6G 5B(lsb), little-endian
113 AV_PIX_FMT_RGB555BE, ///< packed RGB 5:5:5, 16bpp, (msb)1A 5R 5G 5B(lsb), big-endian, most significant bit to 0
114 AV_PIX_FMT_RGB555LE, ///< packed RGB 5:5:5, 16bpp, (msb)1A 5R 5G 5B(lsb), little-endian, most significant bit to 0
115
116 AV_PIX_FMT_BGR565BE, ///< packed BGR 5:6:5, 16bpp, (msb) 5B 6G 5R(lsb), big-endian
117 AV_PIX_FMT_BGR565LE, ///< packed BGR 5:6:5, 16bpp, (msb) 5B 6G 5R(lsb), little-endian
118 AV_PIX_FMT_BGR555BE, ///< packed BGR 5:5:5, 16bpp, (msb)1A 5B 5G 5R(lsb), big-endian, most significant bit to 1
119 AV_PIX_FMT_BGR555LE, ///< packed BGR 5:5:5, 16bpp, (msb)1A 5B 5G 5R(lsb), little-endian, most significant bit to 1
120
121 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
122 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
123 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
124
125 AV_PIX_FMT_YUV420P16LE, ///< planar YUV 4:2:0, 24bpp, (1 Cr & Cb sample per 2x2 Y samples), little-endian
126 AV_PIX_FMT_YUV420P16BE, ///< planar YUV 4:2:0, 24bpp, (1 Cr & Cb sample per 2x2 Y samples), big-endian
127 AV_PIX_FMT_YUV422P16LE, ///< planar YUV 4:2:2, 32bpp, (1 Cr & Cb sample per 2x1 Y samples), little-endian
128 AV_PIX_FMT_YUV422P16BE, ///< planar YUV 4:2:2, 32bpp, (1 Cr & Cb sample per 2x1 Y samples), big-endian
129 AV_PIX_FMT_YUV444P16LE, ///< planar YUV 4:4:4, 48bpp, (1 Cr & Cb sample per 1x1 Y samples), little-endian
130 AV_PIX_FMT_YUV444P16BE, ///< planar YUV 4:4:4, 48bpp, (1 Cr & Cb sample per 1x1 Y samples), big-endian
131 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
132 AV_PIX_FMT_DXVA2_VLD, ///< HW decoding through DXVA2, Picture.data[3] contains a LPDIRECT3DSURFACE9 pointer
133
134 AV_PIX_FMT_RGB444LE, ///< packed RGB 4:4:4, 16bpp, (msb)4A 4R 4G 4B(lsb), little-endian, most significant bits to 0
135 AV_PIX_FMT_RGB444BE, ///< packed RGB 4:4:4, 16bpp, (msb)4A 4R 4G 4B(lsb), big-endian, most significant bits to 0
136 AV_PIX_FMT_BGR444LE, ///< packed BGR 4:4:4, 16bpp, (msb)4A 4B 4G 4R(lsb), little-endian, most significant bits to 1
137 AV_PIX_FMT_BGR444BE, ///< packed BGR 4:4:4, 16bpp, (msb)4A 4B 4G 4R(lsb), big-endian, most significant bits to 1
138 AV_PIX_FMT_Y400A, ///< 8bit gray, 8bit alpha
139 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
140 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
141 AV_PIX_FMT_YUV420P9BE, ///< planar YUV 4:2:0, 13.5bpp, (1 Cr & Cb sample per 2x2 Y samples), big-endian
142 AV_PIX_FMT_YUV420P9LE, ///< planar YUV 4:2:0, 13.5bpp, (1 Cr & Cb sample per 2x2 Y samples), little-endian
143 AV_PIX_FMT_YUV420P10BE,///< planar YUV 4:2:0, 15bpp, (1 Cr & Cb sample per 2x2 Y samples), big-endian
144 AV_PIX_FMT_YUV420P10LE,///< planar YUV 4:2:0, 15bpp, (1 Cr & Cb sample per 2x2 Y samples), little-endian
145 AV_PIX_FMT_YUV422P10BE,///< planar YUV 4:2:2, 20bpp, (1 Cr & Cb sample per 2x1 Y samples), big-endian
146 AV_PIX_FMT_YUV422P10LE,///< planar YUV 4:2:2, 20bpp, (1 Cr & Cb sample per 2x1 Y samples), little-endian
147 AV_PIX_FMT_YUV444P9BE, ///< planar YUV 4:4:4, 27bpp, (1 Cr & Cb sample per 1x1 Y samples), big-endian
148 AV_PIX_FMT_YUV444P9LE, ///< planar YUV 4:4:4, 27bpp, (1 Cr & Cb sample per 1x1 Y samples), little-endian
149 AV_PIX_FMT_YUV444P10BE,///< planar YUV 4:4:4, 30bpp, (1 Cr & Cb sample per 1x1 Y samples), big-endian
150 AV_PIX_FMT_YUV444P10LE,///< planar YUV 4:4:4, 30bpp, (1 Cr & Cb sample per 1x1 Y samples), little-endian
151 AV_PIX_FMT_YUV422P9BE, ///< planar YUV 4:2:2, 18bpp, (1 Cr & Cb sample per 2x1 Y samples), big-endian
152 AV_PIX_FMT_YUV422P9LE, ///< planar YUV 4:2:2, 18bpp, (1 Cr & Cb sample per 2x1 Y samples), little-endian
153 AV_PIX_FMT_VDA_VLD, ///< hardware decoding through VDA
154 AV_PIX_FMT_GBRP, ///< planar GBR 4:4:4 24bpp
155 AV_PIX_FMT_GBRP9BE, ///< planar GBR 4:4:4 27bpp, big endian
156 AV_PIX_FMT_GBRP9LE, ///< planar GBR 4:4:4 27bpp, little endian
157 AV_PIX_FMT_GBRP10BE, ///< planar GBR 4:4:4 30bpp, big endian
158 AV_PIX_FMT_GBRP10LE, ///< planar GBR 4:4:4 30bpp, little endian
159 AV_PIX_FMT_GBRP16BE, ///< planar GBR 4:4:4 48bpp, big endian
160 AV_PIX_FMT_GBRP16LE, ///< planar GBR 4:4:4 48bpp, little endian
6d5600e8
LB
161 AV_PIX_FMT_YUVA422P, ///< planar YUV 4:2:2 24bpp, (1 Cr & Cb sample per 2x1 Y & A samples)
162 AV_PIX_FMT_YUVA444P, ///< planar YUV 4:4:4 32bpp, (1 Cr & Cb sample per 1x1 Y & A samples)
78071a14
AK
163 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
164
165#if FF_API_PIX_FMT
166#include "old_pix_fmts.h"
167#endif
04331dea
SS
168};
169
1d52b4b3 170#if AV_HAVE_BIGENDIAN
78071a14 171# define AV_PIX_FMT_NE(be, le) AV_PIX_FMT_##be
a1a05abe 172#else
78071a14 173# define AV_PIX_FMT_NE(be, le) AV_PIX_FMT_##le
a1a05abe
SS
174#endif
175
78071a14
AK
176#define AV_PIX_FMT_RGB32 AV_PIX_FMT_NE(ARGB, BGRA)
177#define AV_PIX_FMT_RGB32_1 AV_PIX_FMT_NE(RGBA, ABGR)
178#define AV_PIX_FMT_BGR32 AV_PIX_FMT_NE(ABGR, RGBA)
179#define AV_PIX_FMT_BGR32_1 AV_PIX_FMT_NE(BGRA, ARGB)
180
181#define AV_PIX_FMT_GRAY16 AV_PIX_FMT_NE(GRAY16BE, GRAY16LE)
182#define AV_PIX_FMT_RGB48 AV_PIX_FMT_NE(RGB48BE, RGB48LE)
183#define AV_PIX_FMT_RGB565 AV_PIX_FMT_NE(RGB565BE, RGB565LE)
184#define AV_PIX_FMT_RGB555 AV_PIX_FMT_NE(RGB555BE, RGB555LE)
185#define AV_PIX_FMT_RGB444 AV_PIX_FMT_NE(RGB444BE, RGB444LE)
186#define AV_PIX_FMT_BGR48 AV_PIX_FMT_NE(BGR48BE, BGR48LE)
187#define AV_PIX_FMT_BGR565 AV_PIX_FMT_NE(BGR565BE, BGR565LE)
188#define AV_PIX_FMT_BGR555 AV_PIX_FMT_NE(BGR555BE, BGR555LE)
189#define AV_PIX_FMT_BGR444 AV_PIX_FMT_NE(BGR444BE, BGR444LE)
190
191#define AV_PIX_FMT_YUV420P9 AV_PIX_FMT_NE(YUV420P9BE , YUV420P9LE)
192#define AV_PIX_FMT_YUV422P9 AV_PIX_FMT_NE(YUV422P9BE , YUV422P9LE)
193#define AV_PIX_FMT_YUV444P9 AV_PIX_FMT_NE(YUV444P9BE , YUV444P9LE)
194#define AV_PIX_FMT_YUV420P10 AV_PIX_FMT_NE(YUV420P10BE, YUV420P10LE)
195#define AV_PIX_FMT_YUV422P10 AV_PIX_FMT_NE(YUV422P10BE, YUV422P10LE)
196#define AV_PIX_FMT_YUV444P10 AV_PIX_FMT_NE(YUV444P10BE, YUV444P10LE)
197#define AV_PIX_FMT_YUV420P16 AV_PIX_FMT_NE(YUV420P16BE, YUV420P16LE)
198#define AV_PIX_FMT_YUV422P16 AV_PIX_FMT_NE(YUV422P16BE, YUV422P16LE)
199#define AV_PIX_FMT_YUV444P16 AV_PIX_FMT_NE(YUV444P16BE, YUV444P16LE)
200
201#define AV_PIX_FMT_GBRP9 AV_PIX_FMT_NE(GBRP9BE , GBRP9LE)
202#define AV_PIX_FMT_GBRP10 AV_PIX_FMT_NE(GBRP10BE, GBRP10LE)
203#define AV_PIX_FMT_GBRP16 AV_PIX_FMT_NE(GBRP16BE, GBRP16LE)
204
205#if FF_API_PIX_FMT
206#define PixelFormat AVPixelFormat
207
208#define PIX_FMT_NE(be, le) AV_PIX_FMT_NE(be, le)
209
210#define PIX_FMT_RGB32 AV_PIX_FMT_RGB32
211#define PIX_FMT_RGB32_1 AV_PIX_FMT_RGB32_1
212#define PIX_FMT_BGR32 AV_PIX_FMT_BGR32
213#define PIX_FMT_BGR32_1 AV_PIX_FMT_BGR32_1
214
215#define PIX_FMT_GRAY16 AV_PIX_FMT_GRAY16
216#define PIX_FMT_RGB48 AV_PIX_FMT_RGB48
217#define PIX_FMT_RGB565 AV_PIX_FMT_RGB565
218#define PIX_FMT_RGB555 AV_PIX_FMT_RGB555
219#define PIX_FMT_RGB444 AV_PIX_FMT_RGB444
220#define PIX_FMT_BGR48 AV_PIX_FMT_BGR48
221#define PIX_FMT_BGR565 AV_PIX_FMT_BGR565
222#define PIX_FMT_BGR555 AV_PIX_FMT_BGR555
223#define PIX_FMT_BGR444 AV_PIX_FMT_BGR444
224
225#define PIX_FMT_YUV420P9 AV_PIX_FMT_YUV420P9
226#define PIX_FMT_YUV422P9 AV_PIX_FMT_YUV422P9
227#define PIX_FMT_YUV444P9 AV_PIX_FMT_YUV444P9
228#define PIX_FMT_YUV420P10 AV_PIX_FMT_YUV420P10
229#define PIX_FMT_YUV422P10 AV_PIX_FMT_YUV422P10
230#define PIX_FMT_YUV444P10 AV_PIX_FMT_YUV444P10
231#define PIX_FMT_YUV420P16 AV_PIX_FMT_YUV420P16
232#define PIX_FMT_YUV422P16 AV_PIX_FMT_YUV422P16
233#define PIX_FMT_YUV444P16 AV_PIX_FMT_YUV444P16
234
235#define PIX_FMT_GBRP9 AV_PIX_FMT_GBRP9
236#define PIX_FMT_GBRP10 AV_PIX_FMT_GBRP10
237#define PIX_FMT_GBRP16 AV_PIX_FMT_GBRP16
238#endif
bd97b2e1 239
04331dea 240#endif /* AVUTIL_PIXFMT_H */