wok annotate ffmpeg-dev/stuff/avutil.h @ rev 5195

slitaz-doc: fix version for 3.0
author Christophe Lincoln <pankso@slitaz.org>
date Sun Mar 28 17:16:33 2010 +0200 (2010-03-28)
parents
children 7a3e60dd9305
rev   line source
jozee@2680 1 /*
jozee@2680 2 * copyright (c) 2006 Michael Niedermayer <michaelni@gmx.at>
jozee@2680 3 *
jozee@2680 4 * This file is part of FFmpeg.
jozee@2680 5 *
jozee@2680 6 * FFmpeg is free software; you can redistribute it and/or
jozee@2680 7 * modify it under the terms of the GNU Lesser General Public
jozee@2680 8 * License as published by the Free Software Foundation; either
jozee@2680 9 * version 2.1 of the License, or (at your option) any later version.
jozee@2680 10 *
jozee@2680 11 * FFmpeg is distributed in the hope that it will be useful,
jozee@2680 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
jozee@2680 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
jozee@2680 14 * Lesser General Public License for more details.
jozee@2680 15 *
jozee@2680 16 * You should have received a copy of the GNU Lesser General Public
jozee@2680 17 * License along with FFmpeg; if not, write to the Free Software
jozee@2680 18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
jozee@2680 19 */
jozee@2680 20
jozee@2680 21 #ifndef AVUTIL_AVUTIL_H
jozee@2680 22 #define AVUTIL_AVUTIL_H
jozee@2680 23
jozee@2680 24 /**
jozee@2680 25 * @file libavutil/avutil.h
jozee@2680 26 * external API header
jozee@2680 27 */
jozee@2680 28
jozee@2680 29
jozee@2680 30 #define AV_STRINGIFY(s) AV_TOSTRING(s)
jozee@2680 31 #define AV_TOSTRING(s) #s
jozee@2680 32
jozee@2680 33 #define AV_VERSION_INT(a, b, c) (a<<16 | b<<8 | c)
jozee@2680 34 #define AV_VERSION_DOT(a, b, c) a ##.## b ##.## c
jozee@2680 35 #define AV_VERSION(a, b, c) AV_VERSION_DOT(a, b, c)
jozee@2680 36
jozee@2680 37 #define LIBAVUTIL_VERSION_MAJOR 49
jozee@2680 38 #define LIBAVUTIL_VERSION_MINOR 14
jozee@2680 39 #define LIBAVUTIL_VERSION_MICRO 0
jozee@2680 40
jozee@2680 41 #define LIBAVUTIL_VERSION_INT AV_VERSION_INT(LIBAVUTIL_VERSION_MAJOR, \
jozee@2680 42 LIBAVUTIL_VERSION_MINOR, \
jozee@2680 43 LIBAVUTIL_VERSION_MICRO)
jozee@2680 44 #define LIBAVUTIL_VERSION AV_VERSION(LIBAVUTIL_VERSION_MAJOR, \
jozee@2680 45 LIBAVUTIL_VERSION_MINOR, \
jozee@2680 46 LIBAVUTIL_VERSION_MICRO)
jozee@2680 47 #define LIBAVUTIL_BUILD LIBAVUTIL_VERSION_INT
jozee@2680 48
jozee@2680 49 #define LIBAVUTIL_IDENT "Lavu" AV_STRINGIFY(LIBAVUTIL_VERSION)
jozee@2680 50
jozee@2680 51 /**
jozee@2680 52 * Returns the LIBAVUTIL_VERSION_INT constant.
jozee@2680 53 */
jozee@2680 54 unsigned avutil_version(void);
jozee@2680 55
jozee@2680 56 #include "common.h"
jozee@2680 57 #include "mathematics.h"
jozee@2680 58 #include "rational.h"
jozee@2680 59 #include "intfloat_readwrite.h"
jozee@2680 60 #include "log.h"
jozee@2680 61
jozee@2680 62 /**
jozee@2680 63 * Pixel format. Notes:
jozee@2680 64 *
jozee@2680 65 * PIX_FMT_RGB32 is handled in an endian-specific manner. An RGBA
jozee@2680 66 * color is put together as:
jozee@2680 67 * (A << 24) | (R << 16) | (G << 8) | B
jozee@2680 68 * This is stored as BGRA on little-endian CPU architectures and ARGB on
jozee@2680 69 * big-endian CPUs.
jozee@2680 70 *
jozee@2680 71 * When the pixel format is palettized RGB (PIX_FMT_PAL8), the palettized
jozee@2680 72 * image data is stored in AVFrame.data[0]. The palette is transported in
jozee@2680 73 * AVFrame.data[1], is 1024 bytes long (256 4-byte entries) and is
jozee@2680 74 * formatted the same as in PIX_FMT_RGB32 described above (i.e., it is
jozee@2680 75 * also endian-specific). Note also that the individual RGB palette
jozee@2680 76 * components stored in AVFrame.data[1] should be in the range 0..255.
jozee@2680 77 * This is important as many custom PAL8 video codecs that were designed
jozee@2680 78 * to run on the IBM VGA graphics adapter use 6-bit palette components.
jozee@2680 79 *
jozee@2680 80 * For all the 8bit per pixel formats, an RGB32 palette is in data[1] like
jozee@2680 81 * for pal8. This palette is filled in automatically by the function
jozee@2680 82 * allocating the picture.
jozee@2680 83 */
jozee@2680 84 enum PixelFormat {
jozee@2680 85 PIX_FMT_NONE= -1,
jozee@2680 86 PIX_FMT_YUV420P, ///< planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
jozee@2680 87 PIX_FMT_YUYV422, ///< packed YUV 4:2:2, 16bpp, Y0 Cb Y1 Cr
jozee@2680 88 PIX_FMT_RGB24, ///< packed RGB 8:8:8, 24bpp, RGBRGB...
jozee@2680 89 PIX_FMT_BGR24, ///< packed RGB 8:8:8, 24bpp, BGRBGR...
jozee@2680 90 PIX_FMT_YUV422P, ///< planar YUV 4:2:2, 16bpp, (1 Cr & Cb sample per 2x1 Y samples)
jozee@2680 91 PIX_FMT_YUV444P, ///< planar YUV 4:4:4, 24bpp, (1 Cr & Cb sample per 1x1 Y samples)
jozee@2680 92 PIX_FMT_RGB32, ///< packed RGB 8:8:8, 32bpp, (msb)8A 8R 8G 8B(lsb), in CPU endianness
jozee@2680 93 PIX_FMT_YUV410P, ///< planar YUV 4:1:0, 9bpp, (1 Cr & Cb sample per 4x4 Y samples)
jozee@2680 94 PIX_FMT_YUV411P, ///< planar YUV 4:1:1, 12bpp, (1 Cr & Cb sample per 4x1 Y samples)
jozee@2680 95 PIX_FMT_RGB565, ///< packed RGB 5:6:5, 16bpp, (msb) 5R 6G 5B(lsb), in CPU endianness
jozee@2680 96 PIX_FMT_RGB555, ///< packed RGB 5:5:5, 16bpp, (msb)1A 5R 5G 5B(lsb), in CPU endianness, most significant bit to 0
jozee@2680 97 PIX_FMT_GRAY8, ///< Y , 8bpp
jozee@2680 98 PIX_FMT_MONOWHITE, ///< Y , 1bpp, 0 is white, 1 is black
jozee@2680 99 PIX_FMT_MONOBLACK, ///< Y , 1bpp, 0 is black, 1 is white
jozee@2680 100 PIX_FMT_PAL8, ///< 8 bit with PIX_FMT_RGB32 palette
jozee@2680 101 PIX_FMT_YUVJ420P, ///< planar YUV 4:2:0, 12bpp, full scale (JPEG)
jozee@2680 102 PIX_FMT_YUVJ422P, ///< planar YUV 4:2:2, 16bpp, full scale (JPEG)
jozee@2680 103 PIX_FMT_YUVJ444P, ///< planar YUV 4:4:4, 24bpp, full scale (JPEG)
jozee@2680 104 PIX_FMT_XVMC_MPEG2_MC,///< XVideo Motion Acceleration via common packet passing
jozee@2680 105 PIX_FMT_XVMC_MPEG2_IDCT,
jozee@2680 106 PIX_FMT_UYVY422, ///< packed YUV 4:2:2, 16bpp, Cb Y0 Cr Y1
jozee@2680 107 PIX_FMT_UYYVYY411, ///< packed YUV 4:1:1, 12bpp, Cb Y0 Y1 Cr Y2 Y3
jozee@2680 108 PIX_FMT_BGR32, ///< packed RGB 8:8:8, 32bpp, (msb)8A 8B 8G 8R(lsb), in CPU endianness
jozee@2680 109 PIX_FMT_BGR565, ///< packed RGB 5:6:5, 16bpp, (msb) 5B 6G 5R(lsb), in CPU endianness
jozee@2680 110 PIX_FMT_BGR555, ///< packed RGB 5:5:5, 16bpp, (msb)1A 5B 5G 5R(lsb), in CPU endianness, most significant bit to 1
jozee@2680 111 PIX_FMT_BGR8, ///< packed RGB 3:3:2, 8bpp, (msb)2B 3G 3R(lsb)
jozee@2680 112 PIX_FMT_BGR4, ///< packed RGB 1:2:1, 4bpp, (msb)1B 2G 1R(lsb)
jozee@2680 113 PIX_FMT_BGR4_BYTE, ///< packed RGB 1:2:1, 8bpp, (msb)1B 2G 1R(lsb)
jozee@2680 114 PIX_FMT_RGB8, ///< packed RGB 3:3:2, 8bpp, (msb)2R 3G 3B(lsb)
jozee@2680 115 PIX_FMT_RGB4, ///< packed RGB 1:2:1, 4bpp, (msb)1R 2G 1B(lsb)
jozee@2680 116 PIX_FMT_RGB4_BYTE, ///< packed RGB 1:2:1, 8bpp, (msb)1R 2G 1B(lsb)
jozee@2680 117 PIX_FMT_NV12, ///< planar YUV 4:2:0, 12bpp, 1 plane for Y and 1 for UV
jozee@2680 118 PIX_FMT_NV21, ///< as above, but U and V bytes are swapped
jozee@2680 119
jozee@2680 120 PIX_FMT_RGB32_1, ///< packed RGB 8:8:8, 32bpp, (msb)8R 8G 8B 8A(lsb), in CPU endianness
jozee@2680 121 PIX_FMT_BGR32_1, ///< packed RGB 8:8:8, 32bpp, (msb)8B 8G 8R 8A(lsb), in CPU endianness
jozee@2680 122
jozee@2680 123 PIX_FMT_GRAY16BE, ///< Y , 16bpp, big-endian
jozee@2680 124 PIX_FMT_GRAY16LE, ///< Y , 16bpp, little-endian
jozee@2680 125 PIX_FMT_YUV440P, ///< planar YUV 4:4:0 (1 Cr & Cb sample per 1x2 Y samples)
jozee@2680 126 PIX_FMT_YUVJ440P, ///< planar YUV 4:4:0 full scale (JPEG)
jozee@2680 127 PIX_FMT_YUVA420P, ///< planar YUV 4:2:0, 20bpp, (1 Cr & Cb sample per 2x2 Y & A samples)
jozee@2680 128 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
jozee@2680 129 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
jozee@2680 130 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
jozee@2680 131 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
jozee@2680 132 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
jozee@2680 133 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
jozee@2680 134 };
jozee@2680 135
jozee@2680 136 #ifdef WORDS_BIGENDIAN
jozee@2680 137 #define PIX_FMT_RGBA PIX_FMT_RGB32_1
jozee@2680 138 #define PIX_FMT_BGRA PIX_FMT_BGR32_1
jozee@2680 139 #define PIX_FMT_ARGB PIX_FMT_RGB32
jozee@2680 140 #define PIX_FMT_ABGR PIX_FMT_BGR32
jozee@2680 141 #define PIX_FMT_GRAY16 PIX_FMT_GRAY16BE
jozee@2680 142 #else
jozee@2680 143 #define PIX_FMT_RGBA PIX_FMT_BGR32
jozee@2680 144 #define PIX_FMT_BGRA PIX_FMT_RGB32
jozee@2680 145 #define PIX_FMT_ARGB PIX_FMT_BGR32_1
jozee@2680 146 #define PIX_FMT_ABGR PIX_FMT_RGB32_1
jozee@2680 147 #define PIX_FMT_GRAY16 PIX_FMT_GRAY16LE
jozee@2680 148 #endif
jozee@2680 149
jozee@2680 150 #if LIBAVUTIL_VERSION_INT < (50<<16)
jozee@2680 151 #define PIX_FMT_UYVY411 PIX_FMT_UYYVYY411
jozee@2680 152 #define PIX_FMT_RGBA32 PIX_FMT_RGB32
jozee@2680 153 #define PIX_FMT_YUV422 PIX_FMT_YUYV422
jozee@2680 154 #endif
jozee@2680 155
jozee@2680 156 #endif /* AVUTIL_AVUTIL_H */