added PPM read/write support - added pgmyuvpipe format - added PPM pipe read/write...
[libav.git] / libavcodec / avcodec.h
CommitLineData
de6d9b64
FB
1#include "common.h"
2
3enum CodecID {
4 CODEC_ID_NONE,
5 CODEC_ID_MPEG1VIDEO,
6 CODEC_ID_H263,
7 CODEC_ID_RV10,
8 CODEC_ID_MP2,
9 CODEC_ID_AC3,
10 CODEC_ID_MJPEG,
11 CODEC_ID_OPENDIVX,
12 CODEC_ID_PCM,
13 CODEC_ID_RAWVIDEO,
14 CODEC_ID_MSMPEG4,
15 CODEC_ID_H263P,
16 CODEC_ID_H263I,
17};
18
19enum CodecType {
20 CODEC_TYPE_VIDEO,
21 CODEC_TYPE_AUDIO,
22};
23
24enum PixelFormat {
25 PIX_FMT_YUV420P,
26 PIX_FMT_YUV422,
27 PIX_FMT_RGB24,
28 PIX_FMT_BGR24,
d9fea0b5
FB
29 PIX_FMT_YUV422P,
30 PIX_FMT_YUV444P,
de6d9b64
FB
31};
32
33/* in bytes */
34#define AVCODEC_MAX_AUDIO_FRAME_SIZE 18432
35
36/* motion estimation type */
37extern int motion_estimation_method;
38#define ME_ZERO 0
39#define ME_FULL 1
40#define ME_LOG 2
41#define ME_PHODS 3
42
43/* encoding support */
44
45#define CODEC_FLAG_HQ 0x0001 /* high quality (non real time) encoding */
46#define CODEC_FLAG_QSCALE 0x0002 /* use fixed qscale */
47
48#define FRAME_RATE_BASE 10000
49
50typedef struct AVCodecContext {
51 int bit_rate;
52 int flags;
53 int sub_id; /* some codecs needs additionnal format info. It is
54 stored there */
55 /* video only */
56 int frame_rate; /* frames per sec multiplied by FRAME_RATE_BASE */
57 int width, height;
58 int gop_size; /* 0 = intra only */
59 int pix_fmt; /* pixel format, see PIX_FMT_xxx */
60 /* audio only */
61 int sample_rate; /* samples per sec */
62 int channels;
63
64 /* the following data should not be initialized */
65 int frame_size; /* in samples, initialized when calling 'init' */
66 int frame_number; /* audio or video frame number */
67 int key_frame; /* true if the previous compressed frame was
68 a key frame (intra, or seekable) */
69 int quality; /* quality of the previous encoded frame
70 (between 1 (good) and 31 (bad)) */
71 struct AVCodec *codec;
72 void *priv_data;
73
74 /* the following fields are ignored */
75 char codec_name[32];
76 int codec_type; /* see CODEC_TYPE_xxx */
77 int codec_id; /* see CODEC_ID_xxx */
78 unsigned int codec_tag; /* codec tag, only used if unknown codec */
79} AVCodecContext;
80
81typedef struct AVCodec {
82 char *name;
83 int type;
84 int id;
85 int priv_data_size;
86 int (*init)(AVCodecContext *);
87 int (*encode)(AVCodecContext *, UINT8 *buf, int buf_size, void *data);
88 int (*close)(AVCodecContext *);
89 int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
90 UINT8 *buf, int buf_size);
91 struct AVCodec *next;
92} AVCodec;
93
94/* three components are given, that's all */
95typedef struct AVPicture {
96 UINT8 *data[3];
97 int linesize[3];
98} AVPicture;
99
100extern AVCodec ac3_encoder;
101extern AVCodec mp2_encoder;
102extern AVCodec mpeg1video_encoder;
103extern AVCodec h263_encoder;
104extern AVCodec h263p_encoder;
105extern AVCodec rv10_encoder;
106extern AVCodec mjpeg_encoder;
107extern AVCodec opendivx_encoder;
108extern AVCodec msmpeg4_encoder;
109
110extern AVCodec h263_decoder;
111extern AVCodec opendivx_decoder;
112extern AVCodec msmpeg4_decoder;
113extern AVCodec mpeg_decoder;
114extern AVCodec h263i_decoder;
115extern AVCodec rv10_decoder;
4e66ab3b 116extern AVCodec mjpeg_decoder;
de6d9b64
FB
117
118/* dummy raw codecs */
119extern AVCodec pcm_codec;
120extern AVCodec rawvideo_codec;
121
122/* the following codecs use external GPL libs */
123extern AVCodec mp3_decoder;
124extern AVCodec ac3_decoder;
125
126/* resample.c */
127
128struct ReSampleContext;
129
130typedef struct ReSampleContext ReSampleContext;
131
132ReSampleContext *audio_resample_init(int output_channels, int input_channels,
133 int output_rate, int input_rate);
134int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
135void audio_resample_close(ReSampleContext *s);
136
137/* YUV420 format is assumed ! */
138
139struct ImgReSampleContext;
140
141typedef struct ImgReSampleContext ImgReSampleContext;
142
143ImgReSampleContext *img_resample_init(int output_width, int output_height,
144 int input_width, int input_height);
145void img_resample(ImgReSampleContext *s,
146 AVPicture *output, AVPicture *input);
147
148void img_resample_close(ImgReSampleContext *s);
149
150int img_convert_to_yuv420(UINT8 *img_out, UINT8 *img,
151 int pix_fmt, int width, int height);
152
153/* external high level API */
154
155extern AVCodec *first_avcodec;
156
157void avcodec_init(void);
158
159void register_avcodec(AVCodec *format);
160AVCodec *avcodec_find_encoder(enum CodecID id);
161AVCodec *avcodec_find_decoder(enum CodecID id);
162AVCodec *avcodec_find_decoder_by_name(const char *name);
163void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
164
165int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
166int avcodec_decode_audio(AVCodecContext *avctx, INT16 *samples,
167 int *frame_size_ptr,
168 UINT8 *buf, int buf_size);
169int avcodec_decode_video(AVCodecContext *avctx, AVPicture *picture,
170 int *got_picture_ptr,
171 UINT8 *buf, int buf_size);
172int avcodec_encode_audio(AVCodecContext *avctx, UINT8 *buf, int buf_size,
173 const short *samples);
174int avcodec_encode_video(AVCodecContext *avctx, UINT8 *buf, int buf_size,
175 const AVPicture *pict);
176
177int avcodec_close(AVCodecContext *avctx);
178
179void avcodec_register_all(void);