libavcodec.hg: avcodec.h comparison

comparison avcodec.h @ 2967:ef2149182f1c libavcodec

COSMETICS: Remove all trailing whitespace.

author	diego
date	Sat, 17 Dec 2005 18:14:38 +0000
parents	5f51b1e0bed6
children	583b6ac45c07

comparison

equal deleted inserted replaced

-:564788471dd4
+:ef2149182f1c
 #define AV_NOPTS_VALUE int64_t_C(0x8000000000000000)
 #define AV_TIME_BASE 1000000
 #define AV_TIME_BASE_Q (AVRational){1, AV_TIME_BASE}
 enum CodecID {
 CODEC_ID_NONE,
 CODEC_ID_MPEG1VIDEO,
 CODEC_ID_MPEG2VIDEO, /* prefered ID for MPEG Video 1 or 2 decoding */
 CODEC_ID_MPEG2VIDEO_XVMC,
 CODEC_ID_H261,
 CODEC_ID_H263,
 /* various DPCM codecs */
 CODEC_ID_ROQ_DPCM= 0x14000,
 CODEC_ID_INTERPLAY_DPCM,
 CODEC_ID_XAN_DPCM,
 CODEC_ID_SOL_DPCM,
 CODEC_ID_MP2= 0x15000,
 CODEC_ID_MP3, /* prefered ID for MPEG Audio layer 1, 2 or3 decoding */
 CODEC_ID_AAC,
 CODEC_ID_MPEG4AAC,
 CODEC_ID_AC3,
 CODEC_ID_MP3ADU,
 CODEC_ID_MP3ON4,
 CODEC_ID_SHORTEN,
 CODEC_ID_ALAC,
 CODEC_ID_WESTWOOD_SND1,
 CODEC_ID_GSM,
 CODEC_ID_QDM2,
 CODEC_ID_COOK,
 CODEC_ID_OGGTHEORA= 0x16000,
 /* subtitle codecs */
 CODEC_ID_DVD_SUBTITLE= 0x17000,
 CODEC_ID_DVB_SUBTITLE,
 CODEC_ID_MPEG2TS= 0x20000, /* _FAKE_ codec to indicate a raw MPEG2 transport
 stream (only used by libavformat) */
 };
 /* CODEC_ID_MP3LAME is absolete */
 CODEC_TYPE_DATA,
 CODEC_TYPE_SUBTITLE,
 };
 /**
 * Pixel format. Notes:
 *
 * PIX_FMT_RGBA32 is handled in an endian-specific manner. A RGBA
 * color is put together as:
 *  (A << 24) | (R << 16) | (G << 8) | B
 * This is stored as BGRA on little endian CPU architectures and ARGB on
 * to run on the IBM VGA graphics adapter use 6-bit palette components.
 */
 enum PixelFormat {
 PIX_FMT_NONE= -1,
 PIX_FMT_YUV420P,   ///< Planar YUV 4:2:0 (1 Cr & Cb sample per 2x2 Y samples)
 PIX_FMT_YUV422,    ///< Packed pixel, Y0 Cb Y1 Cr
 PIX_FMT_RGB24,     ///< Packed pixel, 3 bytes per pixel, RGBRGB...
 PIX_FMT_BGR24,     ///< Packed pixel, 3 bytes per pixel, BGRBGR...
 PIX_FMT_YUV422P,   ///< Planar YUV 4:2:2 (1 Cr & Cb sample per 2x1 Y samples)
 PIX_FMT_YUV444P,   ///< Planar YUV 4:4:4 (1 Cr & Cb sample per 1x1 Y samples)
 PIX_FMT_RGBA32,    ///< Packed pixel, 4 bytes per pixel, BGRABGRA..., stored in cpu endianness
 PIX_FMT_YUV410P,   ///< Planar YUV 4:1:0 (1 Cr & Cb sample per 4x4 Y samples)
 PIX_FMT_YUV411P,   ///< Planar YUV 4:1:1 (1 Cr & Cb sample per 4x1 Y samples)
 PIX_FMT_RGB565,    ///< always stored in cpu endianness
 PIX_FMT_RGB555,    ///< always stored in cpu endianness, most significant bit to 1
 PIX_FMT_GRAY8,
 PIX_FMT_MONOWHITE, ///< 0 is white
 PIX_FMT_MONOBLACK, ///< 0 is black
 PIX_FMT_PAL8,      ///< 8 bit with RGBA palette
 PIX_FMT_YUVJ420P,  ///< Planar YUV 4:2:0 full scale (jpeg)
 PIX_FMT_YUVJ422P,  ///< Planar YUV 4:2:2 full scale (jpeg)
 PIX_FMT_YUVJ444P,  ///< Planar YUV 4:4:4 full scale (jpeg)
 PIX_FMT_XVMC_MPEG2_MC,///< XVideo Motion Acceleration via common packet passing(xvmc_render.h)
 PIX_FMT_XVMC_MPEG2_IDCT,
 PIX_FMT_UYVY422,   ///< Packed pixel, Cb Y0 Cr Y1
 PIX_FMT_UYVY411,   ///< Packed pixel, Cb Y0 Y1 Cr Y2 Y3
 PIX_FMT_NB,
 };
 /* currently unused, may be used if 24/32 bits samples ever supported */
 enum SampleFormat {
 SAMPLE_FMT_S16 = 0,         ///< signed 16 bits
 SAMPLE_FMT_S32,             ///< signed 32 bits
 SAMPLE_FMT_FLT,             ///< float
 SAMPLE_FMT_DBL,             ///< double
 };
 /* in bytes */
 #define AVCODEC_MAX_AUDIO_FRAME_SIZE 131072
 /**
 * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
 * this is mainly needed because some optimized bitstream readers read
 * 32 or 64 bit at once and could read over the end<br>
 * Note, if the first 23 bits of the additional bytes are not 0 then damaged
 * MPEG bitstreams could cause overread and segfault
 */
 #define FF_INPUT_BUFFER_PADDING_SIZE 8
 extern int motion_estimation_method;
 #define FF_MAX_B_FRAMES 8
 /* encoding support
 these flags can be passed in AVCodecContext.flags before initing
 Note: not everything is supported yet.
 */
 #define CODEC_FLAG_QSCALE 0x0002  ///< use fixed qscale
 #define CODEC_FLAG_4MV    0x0004  ///< 4 MV per MB allowed / Advanced prediction for H263
 #define CODEC_FLAG_QPEL   0x0010  ///< use qpel MC
 #define CODEC_FLAG_GMC    0x0020  ///< use GMC
 #define CODEC_FLAG_MV0    0x0040  ///< always try a MB with MV=<0,0>
 #define CODEC_FLAG_PART   0x0080  ///< use data partitioning
 /* parent program gurantees that the input for b-frame containing streams is not written to
 for at least s->max_b_frames+1 frames, if this is not set than the input will be copied */
 #define CODEC_FLAG_INPUT_PRESERVED 0x0100
 #define CODEC_FLAG_PASS1 0x0200   ///< use internal 2pass ratecontrol in first  pass mode
 #define CODEC_FLAG_PASS2 0x0400   ///< use internal 2pass ratecontrol in second pass mode
 #define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< use external huffman table (for mjpeg)
 #define CODEC_FLAG_GRAY  0x2000   ///< only decode/encode grayscale
 #define CODEC_FLAG_EMU_EDGE 0x4000///< don't draw edges
 #define CODEC_FLAG_PSNR           0x8000 ///< error[?] variables will be set during encoding
 #define CODEC_FLAG_TRUNCATED  0x00010000 /** input bitstream might be truncated at a random location instead
 of only at frame boundaries */
 #define CODEC_FLAG_NORMALIZE_AQP  0x00020000 ///< normalize adaptive quantization
 #define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< use interlaced dct
 #define CODEC_FLAG_LOW_DELAY      0x00080000 ///< force low delay
 #define CODEC_FLAG_ALT_SCAN       0x00100000 ///< use alternate scan
 #define CODEC_FLAG_TRELLIS_QUANT  0x00200000 ///< use trellis quantization
 #define CODEC_FLAG_GLOBAL_HEADER  0x00400000 ///< place global headers in extradata instead of every keyframe
 #define CODEC_FLAG_BITEXACT       0x00800000 ///< use only bitexact stuff (except (i)dct)
 /* Fx : Flag for h263+ extra options */
 #define CODEC_FLAG_H263P_AIC      0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction (remove this)
 #define CODEC_FLAG_AC_PRED        0x01000000 ///< H263 Advanced intra coding / MPEG4 AC prediction
 #define CODEC_FLAG_H263P_UMV      0x02000000 ///< Unlimited motion vector
 #define CODEC_FLAG_CBP_RD         0x04000000 ///< use rate distortion optimization for cbp
 #define CODEC_FLAG_QP_RD          0x08000000 ///< use rate distortion optimization for qp selectioon
 #define CODEC_FLAG_H263P_AIV      0x00000008 ///< H263 Alternative inter vlc
 #define CODEC_FLAG_OBMC           0x00000001 ///< OBMC
 #define CODEC_FLAG_LOOP_FILTER    0x00000800 ///< loop filter
 * 		Reference Picture Selection
 * 		Independant Segment Decoding */
 /* /Fx */
 /* codec capabilities */
 #define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< decoder can use draw_horiz_band callback
 /**
 * Codec uses get_buffer() for allocating buffers.
 * direct rendering method 1
 */
 #define CODEC_CAP_DR1             0x0002
 used */
 #define CODEC_CAP_PARSE_ONLY      0x0004
 #define CODEC_CAP_TRUNCATED       0x0008
 /* codec can export data for HW decoding (XvMC) */
 #define CODEC_CAP_HWACCEL         0x0010
 /**
 * codec has a non zero delay and needs to be feeded with NULL at the end to get the delayed data.
 * if this is not set, the codec is guranteed to never be feeded with NULL data
 */
 #define CODEC_CAP_DELAY           0x0020
 */
 AVClass *av_class;
 /**
 * the average bitrate.
 * - encoding: set by user. unused for constant quantizer encoding
 * - decoding: set by lavc. 0 or some bitrate if this info is available in the stream
 */
 int bit_rate;
 /**
 * number of bits the bitstream is allowed to diverge from the reference.
 *           the reference can be CBR (for CBR pass1) or VBR (for pass2)
 * - encoding: set by user. unused for constant quantizer encoding
 * - decoding: unused
 */
 int bit_rate_tolerance;
 /**
 * CODEC_FLAG_*.
 * - encoding: set by user.
 * - decoding: set by user.
 */
 int flags;
 /**
 * some codecs needs additionnal format info. It is stored here
 * - encoding: set by user.
 * - decoding: set by lavc. (FIXME is this ok?)
 */
 int sub_id;
 /**
 * - encoding: set/allocated/freed by lavc.
 * - decoding: set/allocated/freed by user.
 */
 void *extradata;
 int extradata_size;
 /**
 * this is the fundamental unit of time (in seconds) in terms
 * of which frame timestamps are represented. for fixed-fps content,
 * timebase should be 1/framerate and timestamp increments should be
 * identically 1.
 * - encoding: MUST be set by user
 * - decoding: set by lavc.
 */
 AVRational time_base;
 /* video only */
 /**
 * picture width / height.
 * - encoding: MUST be set by user.
 * - decoding: set by lavc.
 * Note, for compatibility its possible to set this instead of
 * coded_width/height before decoding
 */
 int width, height;
 #define FF_ASPECT_EXTENDED 15
 /**
 * the number of pictures in a group of pitures, or 0 for intra_only.
 * - encoding: set by user.
 * pixel format, see PIX_FMT_xxx.
 * - encoding: set by user.
 * - decoding: set by lavc.
 */
 enum PixelFormat pix_fmt;
 /**
 * Frame rate emulation. If not zero lower layer (i.e. format handler)
 * has to read frames at native frame rate.
 * - encoding: set by user.
 * - decoding: unused.
 */
 int rate_emu;
 /**
 * if non NULL, 'draw_horiz_band' is called by the libavcodec
 * decoder to draw an horizontal band. It improve cache usage. Not
 * all codecs can do that. You must check the codec capabilities
 * before
 void (*draw_horiz_band)(struct AVCodecContext *s,
 const AVFrame *src, int offset[4],
 int y, int type, int height);
 /* audio only */
 int sample_rate; ///< samples per sec
 int channels;
 /**
 * audio sample format.
 * - encoding: set by user.
 * - decoding: set by lavc.
 */
 enum SampleFormat sample_fmt;  ///< sample format, currenly unused
 /* the following data should not be initialized */
 /**
 * samples per packet. initialized when calling 'init'
 */
 int frame_size;
 int frame_number;   ///< audio or video frame number
 int real_pict_num;  ///< returns the real picture number of previous encoded frame
 /**
 * number of frames the decoded output will be delayed relative to
 * the encoded input.
 * - encoding: set by lavc.
 * - decoding: unused
 */
 int delay;
 /* - encoding parameters */
 float qcompress;  ///< amount of qscale change between easy & hard scenes (0.0-1.0)
 float qblur;      ///< amount of qscale smoothing over time (0.0-1.0)
 /**
 * minimum quantizer.
 * - encoding: set by user.
 * - decoding: unused
 */
 * qscale factor between ip and b frames.
 * - encoding: set by user.
 * - decoding: unused
 */
 float b_quant_factor;
 /** obsolete FIXME remove */
 int rc_strategy;
 int b_frame_strategy;
 /**
 * deprecated in favor of skip_idct and skip_frame
 * - encoding: unused
 * - decoding: set by user. 1-> skip b frames, 2-> skip idct/dequant too, 5-> skip everything except header
 */
 int hurry_up;
 struct AVCodec *codec;
 void *priv_data;
 /* unused, FIXME remove*/
 int rtp_mode;
 int rtp_payload_size;   /* The size of the RTP payload: the coder will  */
 /* do it's best to deliver a chunk with size    */
 /* below rtp_payload_size, the chunk will start */
 /* with a start code on some codecs like H.263  */
 /* This doesn't take account of any particular  */
 /* headers inside the transmited RTP payload    */
 /* The RTP callback: This function is called   */
 /* every time the encoder has a packet to send */
 /* Depends on the encoder if the data starts   */
 /* with a Start Code (it should) H.263 does.   */
 /* mb_nb contains the number of macroblocks    */
 /* encoded in the RTP payload                  */
 void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb);
 /* statistics, used for 2-pass encoding */
 int mv_bits;
 int header_bits;
 int i_tex_bits;
 int p_tex_bits;
 int i_count;
 int p_count;
 int skip_count;
 int misc_bits;
 /**
 * number of bits used for the previously encoded frame.
 * - encoding: set by lavc
 * - decoding: unused
 */
 void *opaque;
 char codec_name[32];
 enum CodecType codec_type; /* see CODEC_TYPE_xxx */
 enum CodecID codec_id; /* see CODEC_ID_xxx */
 /**
 * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
 * this is used to workaround some encoder bugs
 * - encoding: set by user, if not then the default based on codec_id will be used
 * - decoding: set by user, will be converted to upper case by lavc during init
 */
 unsigned int codec_tag;
 /**
 * workaround bugs in encoders which sometimes cannot be detected automatically.
 * - encoding: set by user
 * - decoding: set by user
 */
 #define FF_BUG_EDGE             1024
 #define FF_BUG_HPEL_CHROMA      2048
 #define FF_BUG_DC_CLIP          4096
 #define FF_BUG_MS               8192 ///< workaround various bugs in microsofts broken decoders
 //#define FF_BUG_FAKE_SCALABILITY 16 //autodetection should work 100%
 /**
 * luma single coeff elimination threshold.
 * - encoding: set by user
 * - decoding: unused
 */
 int luma_elim_threshold;
 /**
 * chroma single coeff elimination threshold.
 * - encoding: set by user
 * - decoding: unused
 */
 int chroma_elim_threshold;
 /**
 * strictly follow the std (MPEG4, ...).
 * - encoding: set by user
 * - decoding: unused
 */
 * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
 * - encoding: set by user.
 * - decoding: unused
 */
 float b_quant_offset;
 /**
 * error resilience higher values will detect more errors but may missdetect
 * some more or less valid parts as errors.
 * - encoding: unused
 * - decoding: set by user
 int error_resilience;
 #define FF_ER_CAREFUL         1
 #define FF_ER_COMPLIANT       2
 #define FF_ER_AGGRESSIVE      3
 #define FF_ER_VERY_AGGRESSIVE 4
 /**
 * called at the beginning of each frame to get a buffer for it.
 * if pic.reference is set then the frame will be read later by lavc
 * avcodec_align_dimensions() should be used to find the required width and
 * height, as they normally need to be rounded up to the next multiple of 16
 * - encoding: unused
 * - decoding: set by lavc, user can override
 */
 int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
 /**
 * called to release buffers which where allocated with get_buffer.
 * a released buffer can be reused in get_buffer()
 * pic.data[*] must be set to NULL
 * - encoding: unused
 /**
 * number of bytes per packet if constant and known or 0
 * used by some WAV based audio codecs
 */
 int block_align;
 int parse_only; /* - decoding only: if true, only parsing is done
 (function avcodec_parse_frame()). The frame
 data is returned. Only MPEG codecs support this now. */
 /**
 * 0-> h263 quant 1-> mpeg quant.
 * - encoding: set by user.
 * - decoding: unused
 */
 int mpeg_quant;
 /**
 * pass1 encoding statistics output buffer.
 * - encoding: set by lavc
 * - decoding: unused
 */
 char *stats_out;
 /**
 * pass2 encoding statistics input buffer.
 * concatenated stuff from stats_out of pass1 should be placed here
 * - encoding: allocated/set/freed by user
 * - decoding: unused
 */
 char *stats_in;
 /**
 * ratecontrol qmin qmax limiting method.
 * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax
 * - encoding: set by user.
 * - decoding: unused
 */
 float rc_qsquish;
 float rc_qmod_amp;
 int rc_qmod_freq;
 /**
 * ratecontrol override, see RcOverride.
 * - encoding: allocated/set/freed by user.
 * - decoding: unused
 */
 RcOverride *rc_override;
 int rc_override_count;
 /**
 * rate control equation.
 * - encoding: set by user
 * - decoding: unused
 */
 char *rc_eq;
 /**
 * maximum bitrate.
 * - encoding: set by user.
 * - decoding: unused
 */
 int rc_max_rate;
 /**
 * minimum bitrate.
 * - encoding: set by user.
 * - decoding: unused
 */
 int rc_min_rate;
 /**
 * decoder bitstream buffer size.
 * - encoding: set by user.
 * - decoding: unused
 */
 * if < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset)
 * - encoding: set by user.
 * - decoding: unused
 */
 float i_quant_factor;
 /**
 * qscale offset between p and i frames.
 * - encoding: set by user.
 * - decoding: unused
 */
 float i_quant_offset;
 /**
 * initial complexity for pass1 ratecontrol.
 * - encoding: set by user.
 * - decoding: unused
 */
 #define FF_DCT_INT     2
 #define FF_DCT_MMX     3
 #define FF_DCT_MLIB    4
 #define FF_DCT_ALTIVEC 5
 #define FF_DCT_FAAN    6
 /**
 * luminance masking (0-> disabled).
 * - encoding: set by user
 * - decoding: unused
 */
 float lumi_masking;
 /**
 * temporary complexity masking (0-> disabled).
 * - encoding: set by user
 * - decoding: unused
 */
 float temporal_cplx_masking;
 /**
 * spatial complexity masking (0-> disabled).
 * - encoding: set by user
 * - decoding: unused
 */
 float spatial_cplx_masking;
 /**
 * p block masking (0-> disabled).
 * - encoding: set by user
 * - decoding: unused
 */
 * darkness masking (0-> disabled).
 * - encoding: set by user
 * - decoding: unused
 */
 float dark_masking;
 /* for binary compatibility */
 int unused;
 /**
 * idct algorithm, see FF_IDCT_* below.
 * - encoding: set by user
 * - decoding: set by user
 */
 * bits per sample/pixel from the demuxer (needed for huffyuv).
 * - encoding: set by lavc
 * - decoding: set by user
 */
 int bits_per_sample;
 /**
 * prediction method (needed for huffyuv).
 * - encoding: set by user
 * - decoding: unused
 */
 int prediction_method;
 #define FF_PRED_LEFT   0
 #define FF_PRED_PLANE  1
 #define FF_PRED_MEDIAN 2
 /**
 * sample aspect ratio (0 if unknown).
 * numerator and denominator must be relative prime and smaller then 256 for some video standards
 * - encoding: set by user.
 * - decoding: set by lavc.
 #define FF_DEBUG_ER        0x00000400
 #define FF_DEBUG_MMCO      0x00000800
 #define FF_DEBUG_BUGS      0x00001000
 #define FF_DEBUG_VIS_QP    0x00002000
 #define FF_DEBUG_VIS_MB_TYPE 0x00004000
 /**
 * debug.
 * - encoding: set by user.
 * - decoding: set by user.
 */
 * error.
 * - encoding: set by lavc if flags&CODEC_FLAG_PSNR
 * - decoding: unused
 */
 uint64_t error[4];
 /**
 * minimum MB quantizer.
 * - encoding: unused
 * - decoding: unused
 */
 * maximum MB quantizer.
 * - encoding: unused
 * - decoding: unused
 */
 int mb_qmax;
 /**
 * motion estimation compare function.
 * - encoding: set by user.
 * - decoding: unused
 */
 #define FF_CMP_NSSE 10
 #define FF_CMP_W53  11
 #define FF_CMP_W97  12
 #define FF_CMP_DCTMAX 13
 #define FF_CMP_CHROMA 256
 /**
 * ME diamond size & shape.
 * - encoding: set by user.
 * - decoding: unused
 */
 /**
 * DTG active format information (additionnal aspect ratio
 * information only used in DVB MPEG2 transport streams). 0 if
 * not set.
 *
 * - encoding: unused.
 * - decoding: set by decoder
 */
 int dtg_active_format;
 #define FF_DTG_AFD_SAME         8
 #define FF_DTG_AFD_4_3          9
 #define FF_DTG_AFD_16_9         10
 #define FF_DTG_AFD_SP_4_3       15
 /**
 * Maximum motion estimation search range in subpel units.
 * if 0 then no limit
 *
 * - encoding: set by user.
 * - decoding: unused.
 */
 int me_range;
 * - encoding: set by user.
 * - decoding: unused
 */
 int intra_quant_bias;
 #define FF_DEFAULT_QUANT_BIAS 999999
 /**
 * inter quantizer bias.
 * - encoding: set by user.
 * - decoding: unused
 */
 * - encoding: unused.
 * - decoding: which clrtable should be used for 8bit RGB images
 *             table have to be stored somewhere FIXME
 */
 int color_table_id;
 /**
 * internal_buffer count.
 * Don't touch, used by lavc default_get_buffer()
 */
 int internal_buffer_count;
 /**
 * internal_buffers.
 * Don't touch, used by lavc default_get_buffer()
 */
 void *internal_buffer;
 #define FF_LAMBDA_SHIFT 7
 * this should be proportional to MPEG1/2/4 qscale.
 * - encoding: set by user.
 * - decoding: unused
 */
 int global_quality;
 #define FF_CODER_TYPE_VLC   0
 #define FF_CODER_TYPE_AC    1
 /**
 * coder type
 * - encoding: set by user.
 * context model
 * - encoding: set by user.
 * - decoding: unused
 */
 int context_model;
 /**
 * slice flags
 * - encoding: unused
 * - decoding: set by user.
 */
 * XVideo Motion Acceleration
 * - encoding: forbidden
 * - decoding: set by decoder
 */
 int xvmc_acceleration;
 /**
 * macroblock decision mode
 * - encoding: set by user.
 * - decoding: unused
 */
 * custom inter quantization matrix
 * - encoding: set by user, can be NULL
 * - decoding: set by lavc
 */
 uint16_t *inter_matrix;
 /**
 * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
 * this is used to workaround some encoder bugs
 * - encoding: unused
 * - decoding: set by user, will be converted to upper case by lavc during init
 * noise reduction strength
 * - encoding: set by user.
 * - decoding: unused
 */
 int noise_reduction;
 /**
 * called at the beginning of a frame to get cr buffer for it.
 * buffer type (size, hints) must be the same. lavc won't check it.
 * lavc will pass previous buffer in pic, function should return
 * same buffer or new buffer with old frame "painted" into it.
 * simulates errors in the bitstream to test error concealment.
 * - encoding: set by user.
 * - decoding: unused.
 */
 int error_rate;
 /**
 * MP3 antialias algorithm, see FF_AA_* below.
 * - encoding: unused
 * - decoding: set by user
 */
 * is used to decide how many independant tasks should be passed to execute()
 * - encoding: set by user
 * - decoding: set by user
 */
 int thread_count;
 /**
 * the codec may call this to execute several independant things. it will return only after
 * finishing all tasks, the user may replace this with some multithreaded implementation, the
 * default implementation will execute the parts serially
 * @param count the number of things to execute
 * - encoding: set by lavc, user can override
 * - decoding: set by lavc, user can override
 */
 int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void **arg2, int *ret, int count);
 /**
 * Thread opaque.
 * can be used by execute() to store some per AVCodecContext stuff.
 * - encoding: set by execute()
 * - decoding: set by execute()
 */
 void *thread_opaque;
 /**
 * Motion estimation threshold. under which no motion estimation is
 * performed, but instead the user specified motion vectors are used
 *
 * - encoding: set by user
 * - decoding: unused
 */
 int me_threshold;
 * - decoding: unused
 */
 int mb_lmax;
 /**
 *
 * - encoding: set by user.
 * - decoding: unused
 */
 int me_penalty_compensation;
 /**
 *
 * - encoding: unused
 * - decoding: set by user.
 */
 enum AVDiscard skip_loop_filter;
 /**
 *
 * - encoding: unused
 * - decoding: set by user.
 */
 enum AVDiscard skip_idct;
 /**
 *
 * - encoding: unused
 * - decoding: set by user.
 */
 enum AVDiscard skip_frame;
 } AVCodecContext;
 struct ReSampleContext;
 struct AVResampleContext;
 typedef struct ReSampleContext ReSampleContext;
 ReSampleContext *audio_resample_init(int output_channels, int input_channels,
 int output_rate, int input_rate);
 int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
 void audio_resample_close(ReSampleContext *s);
 struct AVResampleContext *av_resample_init(int out_rate, int in_rate, int filter_length, int log2_phase_count, int linear, double cutoff);
 int leftBand, int rightBand,
 int padtop, int padbottom,
 int padleft, int padright);
 void img_resample(ImgReSampleContext *s,
 AVPicture *output, const AVPicture *input);
 void img_resample_close(ImgReSampleContext *s);
 /**
 int img_get_alpha_info(const AVPicture *src,
 		       int pix_fmt, int width, int height);
 /* convert among pixel formats */
 int img_convert(AVPicture *dst, int dst_pix_fmt,
 const AVPicture *src, int pix_fmt,
 int width, int height);
 /* deinterlace a picture */
 int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
 int pix_fmt, int width, int height);
 * opens / inits the AVCodecContext.
 * not thread save!
 */
 int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
 int avcodec_decode_audio(AVCodecContext *avctx, int16_t *samples,
 int *frame_size_ptr,
 uint8_t *buf, int buf_size);
 int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture,
 int *got_picture_ptr,
 uint8_t *buf, int buf_size);
 int avcodec_decode_subtitle(AVCodecContext *avctx, AVSubtitle *sub,
 int *got_sub_ptr,
 const uint8_t *buf, int buf_size);
 int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata,
 int *data_size_ptr,
 uint8_t *buf, int buf_size);
 int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size,
 const short *samples);
 int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size,
 const AVFrame *pict);
 int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size,
 const AVSubtitle *sub);
 int avcodec_close(AVCodecContext *avctx);
 void avcodec_register_all(void);
 /* frame parsing */
 typedef struct AVCodecParserContext {
 void *priv_data;
 struct AVCodecParser *parser;
 int64_t frame_offset; /* offset of the current frame */
 int64_t cur_offset; /* current offset
 (incremented by each av_parser_parse()) */
 int64_t last_frame_offset; /* offset of the last frame */
 /* video info */
 int pict_type; /* XXX: put it back in AVCodecContext */
 int repeat_pict; /* XXX: put it back in AVCodecContext */
 #define AV_PARSER_PTS_NB 4
 int cur_frame_start_index;
 int64_t cur_frame_offset[AV_PARSER_PTS_NB];
 int64_t cur_frame_pts[AV_PARSER_PTS_NB];
 int64_t cur_frame_dts[AV_PARSER_PTS_NB];
 int flags;
 #define PARSER_FLAG_COMPLETE_FRAMES           0x0001
 } AVCodecParserContext;
 typedef struct AVCodecParser {
 int codec_ids[5]; /* several codec IDs are permitted */
 int priv_data_size;
 int (*parser_init)(AVCodecParserContext *s);
 int (*parser_parse)(AVCodecParserContext *s,
 AVCodecContext *avctx,
 uint8_t **poutbuf, int *poutbuf_size,
 const uint8_t *buf, int buf_size);
 void (*parser_close)(AVCodecParserContext *s);
 int (*split)(AVCodecContext *avctx, const uint8_t *buf, int buf_size);
 struct AVCodecParser *next;
 } AVCodecParser;
 extern AVCodecParser *av_first_parser;
 void av_register_codec_parser(AVCodecParser *parser);
 AVCodecParserContext *av_parser_init(int codec_id);
 int av_parser_parse(AVCodecParserContext *s,
 AVCodecContext *avctx,
 uint8_t **poutbuf, int *poutbuf_size,
 const uint8_t *buf, int buf_size,
 int64_t pts, int64_t dts);
 int av_parser_change(AVCodecParserContext *s,
 AVCodecContext *avctx,
 uint8_t **poutbuf, int *poutbuf_size,
 const uint8_t *buf, int buf_size, int keyframe);
 void av_parser_close(AVCodecParserContext *s);
 extern AVCodecParser mpegvideo_parser;
 extern AVCodecParser mpeg4video_parser;

Mercurial > libavcodec.hg

comparison avcodec.h @ 2967:ef2149182f1c libavcodec