[cvs] / xvidcore / src / xvid.h Repository:
ViewVC logotype

Diff of /xvidcore/src/xvid.h

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.11, Fri Jun 14 13:27:47 2002 UTC revision 1.17.2.13, Mon Dec 9 10:47:05 2002 UTC
# Line 37  Line 37 
37  #define _XVID_H_  #define _XVID_H_
38    
39  #ifdef __cplusplus  #ifdef __cplusplus
40  *  $Id$  extern "C" {
41  #endif  #endif
42    
43  /*****************************************************************************  /*****************************************************************************
# Line 47  Line 47 
47  /* API Version : 2.1 */  /* API Version : 2.1 */
48  #define API_VERSION ((2 << 16) | (1))  #define API_VERSION ((2 << 16) | (1))
49    
50    /* Bitstream Version
51     * this will be writen into the bitstream to allow easy detection of xvid
52     * encoder bugs in the decoder, without this it might not possible to
53     * automatically distinquish between a file which has been encoded with an
54     * old & buggy XVID from a file which has been encoded with a bugfree version
55     * see the infamous interlacing bug ...
56     *
57     * this MUST be increased if an encoder bug is fixed, increasing it too often
58     * doesnt hurt but not increasing it could cause difficulty for decoders in the
59     * future
60     */
61    #define XVID_BS_VERSION "0003"
62    
63    
64  /* Error codes */  /* Error codes */
65  #define XVID_ERR_FAIL           -1  #define XVID_ERR_FAIL           -1
# Line 56  Line 69 
69    
70    
71  /* Colorspaces */  /* Colorspaces */
72  #define XVID_CSP_RGB24  0  #define XVID_CSP_RGB24  0               /* [b|g|r] */
73  #define XVID_CSP_YV12   1  #define XVID_CSP_YV12   1
74  #define XVID_CSP_YUY2   2  #define XVID_CSP_YUY2   2
75  #define XVID_CSP_UYVY   3  #define XVID_CSP_UYVY   3
# Line 66  Line 79 
79  #define XVID_CSP_USER   12  #define XVID_CSP_USER   12
80  #define XVID_CSP_EXTERN      1004  // per slice rendering  #define XVID_CSP_EXTERN      1004  // per slice rendering
81  #define XVID_CSP_YVYU   1002  #define XVID_CSP_YVYU   1002
82  #define XVID_CSP_RGB32  1000  #define XVID_CSP_RGB32  1000    /* [b|g|r|a] */
83    #define XVID_CSP_ABGR   1006    /* [a|b|g|r] */
84    #define XVID_CSP_RGBA   1005    /* [r|g|b|a] */
85    
86    
87    
88  #define XVID_CSP_NULL   9999  #define XVID_CSP_NULL   9999
89    
90  #define XVID_CSP_VFLIP  0x80000000      // flip mask  #define XVID_CSP_VFLIP  0x80000000      // flip mask
91    
92    
93  /*****************************************************************************  /*****************************************************************************
94     *  Initialization constants
95   ****************************************************************************/   ****************************************************************************/
96    
97  /* CPU flags for XVID_INIT_PARAM.cpu_flags */  /* CPU flags for XVID_INIT_PARAM.cpu_flags */
# Line 91  Line 110 
110  #define XVID_CPU_CHKONLY        0x40000000              /* check cpu only; dont init globals */  #define XVID_CPU_CHKONLY        0x40000000              /* check cpu only; dont init globals */
111  #define XVID_CPU_FORCE          0x80000000  #define XVID_CPU_FORCE          0x80000000
112    
113            typedef struct
114            {
115                    int colorspace;
116                    void * y;
117                    void * u;
118                    void * v;
119                    int y_stride;
120                    int uv_stride;
121            } XVID_IMAGE;           /* from yv12 */
122    
123    #define XVID_INIT_INIT          0
124    #define XVID_INIT_CONVERT       1
125    
126  /*****************************************************************************  /*****************************************************************************
127   *  Initialization structures   *  Initialization structures
128   ****************************************************************************/   ****************************************************************************/
129    
130          typedef struct          typedef struct
131            {
132                  int cpu_flags;                  int cpu_flags;
133                  int api_version;                  int api_version;
134                  int core_build;                  int core_build;
135          }          }
136          XVID_INIT_PARAM;          XVID_INIT_PARAM;
137    
138            typedef struct
139            {
140                    XVID_IMAGE input;
141                    XVID_IMAGE output;
142                    int width;
143                    int height;
144                    int interlacing;
145            } XVID_INIT_CONVERTINFO;
146    
147  /*****************************************************************************  /*****************************************************************************
148   *  Initialization entry point   *  Initialization entry point
149   ****************************************************************************/   ****************************************************************************/
# Line 133  Line 174 
174          XVID_DEC_PARAM;          XVID_DEC_PARAM;
175    
176    
177    #define XVID_DEC_VOP    0
178    #define XVID_DEC_VOL    1
179    
180            typedef struct
181            {
182                    int notify;                     /* [out]        output 'mode' */
183                    union
184                    {
185                            struct  /* XVID_DEC_VOP */
186                            {
187                                    int time_base;          /* [out]        time base */
188                                    int time_increment;     /* [out]        time increment */
189                            } vop;
190                            struct  /* XVID_DEC_VOL */
191                            {
192                                    int general;            /* [out]        flags: eg. frames are interlaced */
193                                    int width;                      /* [out]        width */
194                                    int height;                     /* [out]        height */
195                                    int aspect_ratio;       /* [out]        aspect ratio */
196                                    int par_width;          /* [out]        aspect ratio width */
197                                    int par_height;         /* [out]        aspect ratio height */
198                            } vol;
199                    } data;
200            } XVID_DEC_STATS;
201    
202    
203          typedef struct          typedef struct
204          {          {
205                  int general;                  int general;
# Line 153  Line 220 
220                  int stride_y, stride_u,stride_v;                  int stride_y, stride_u,stride_v;
221          } XVID_DEC_PICTURE;          } XVID_DEC_PICTURE;
222    
223    
224    /*****************************************************************************
225     * Decoder entry point
226     ****************************************************************************/
227    
228    /* decoder options */
229    #define XVID_DEC_DECODE         0
230    #define XVID_DEC_CREATE         1
231  #define XVID_DEC_DESTROY        2  #define XVID_DEC_DESTROY        2
232    
233          int xvid_decore(void *handle,          int xvid_decore(void *handle,
# Line 169  Line 244 
244  #define XVID_GLOBAL_PACKED              0x00000001      /* packed bitstream */  #define XVID_GLOBAL_PACKED              0x00000001      /* packed bitstream */
245  #define XVID_GLOBAL_DX50BVOP    0x00000002      /* dx50 bvop compatibility */  #define XVID_GLOBAL_DX50BVOP    0x00000002      /* dx50 bvop compatibility */
246  #define XVID_GLOBAL_DEBUG               0x00000004      /* print debug info on each frame */  #define XVID_GLOBAL_DEBUG               0x00000004      /* print debug info on each frame */
247    #define XVID_GLOBAL_REDUCED             0x04000000      /* reduced resolution vop enable */
248    
249  /* Flags for XVID_ENC_FRAME.general */  /* Flags for XVID_ENC_FRAME.general */
250  #define XVID_VALID_FLAGS                0x80000000  #define XVID_VALID_FLAGS                0x80000000
251    
252  #define XVID_CUSTOM_QMATRIX             0x00000004      /* use custom quant matrix */  #define XVID_CUSTOM_QMATRIX             0x00000004      /* use custom quant matrix */
253    #define XVID_H263QUANT                  0x00000010
254    #define XVID_MPEGQUANT                  0x00000020
255    #define XVID_HALFPEL                    0x00000040      /* use halfpel interpolation */
256    #define XVID_QUARTERPEL                 0x02000000
257    #define XVID_ADAPTIVEQUANT              0x00000080
258    #define XVID_LUMIMASKING                0x00000100
259  #define XVID_LATEINTRA                  0x00000200  #define XVID_LATEINTRA                  0x00000200
260    
261  #define XVID_INTERLACING                0x00000400      /* enable interlaced encoding */  #define XVID_INTERLACING                0x00000400      /* enable interlaced encoding */
# Line 191  Line 273 
273  #define XVID_ME_PMVFAST                 0x00080000  #define XVID_ME_PMVFAST                 0x00080000
274  #define XVID_ME_EPZS                    0x00100000  #define XVID_ME_EPZS                    0x00100000
275    
   
276  #define XVID_GREYSCALE                  0x01000000      /* enable greyscale only mode (even for */  #define XVID_GREYSCALE                  0x01000000      /* enable greyscale only mode (even for */
277  #define XVID_GRAYSCALE                  0x01000000      /* color input material chroma is ignored) */  #define XVID_GRAYSCALE                  0x01000000      /* color input material chroma is ignored) */
278    
279    #define XVID_GMC                                0x20000000
280    #define XVID_ME_COLOUR                  0x40000000
281    
282    #define XVID_REDUCED                    0x04000000      /* reduced resolution vop */
283    
284  /* Flags for XVID_ENC_FRAME.motion */  /* Flags for XVID_ENC_FRAME.motion */
285  #define PMV_ADVANCEDDIAMOND8    0x00004000  #define PMV_ADVANCEDDIAMOND8    0x00004000
286  #define PMV_ADVANCEDDIAMOND16   0x00008000  #define PMV_ADVANCEDDIAMOND16   0x00008000
287  #define PMV_EARLYSTOP16                 0x00080000  
288    #define PMV_HALFPELDIAMOND16    0x00010000
289    #define PMV_HALFPELREFINE16     0x00020000
290    #define PMV_QUARTERPELREFINE16  0x00040000
291    #define PMV_EXTSEARCH16                 0x00080000      /* extend PMV by more searches */
292  #define PMV_QUICKSTOP16                 0x00100000      /* like early, but without any more refinement */  #define PMV_QUICKSTOP16                 0x00100000      /* like early, but without any more refinement */
293  #define PMV_UNRESTRICTED16      0x00200000      /* unrestricted ME, not implemented */  #define PMV_UNRESTRICTED16      0x00200000      /* unrestricted ME, not implemented */
294  #define PMV_OVERLAPPING16       0x00400000      /* overlapping ME, not implemented */  #define PMV_OVERLAPPING16       0x00400000      /* overlapping ME, not implemented */
# Line 207  Line 296 
296    
297  #define PMV_HALFPELDIAMOND8     0x01000000  #define PMV_HALFPELDIAMOND8     0x01000000
298  #define PMV_HALFPELREFINE8              0x02000000  #define PMV_HALFPELREFINE8              0x02000000
299  #define PMV_EXTSEARCH8                  0x04000000      /* extend PMV by more searches */  #define PMV_QUARTERPELREFINE8   0x04000000
300  #define PMV_EARLYSTOP8                  0x08000000  #define PMV_EXTSEARCH8                  0x08000000      /* extend PMV by more searches */
301  #define PMV_QUICKSTOP8                  0x10000000      /* like early, but without any more refinement */  #define PMV_QUICKSTOP8                  0x10000000      /* like early, but without any more refinement */
302  #define PMV_UNRESTRICTED8       0x20000000      /* unrestricted ME, not implemented */  #define PMV_UNRESTRICTED8       0x20000000      /* unrestricted ME, not implemented */
303  #define PMV_OVERLAPPING8                0x40000000      /* overlapping ME, not implemented */  #define PMV_OVERLAPPING8                0x40000000      /* overlapping ME, not implemented */
304  #define PMV_USESQUARES8                 0x80000000  #define PMV_USESQUARES8                 0x80000000
305    
306    
307    
308  /*****************************************************************************  /*****************************************************************************
309   * Encoder structures   * Encoder structures
310   ****************************************************************************/   ****************************************************************************/
# Line 233  Line 323 
323  #ifdef _SMP  #ifdef _SMP
324                  int num_threads;                /* number of threads */                  int num_threads;                /* number of threads */
325  #endif  #endif
 #ifdef BFRAMES  
326                  int global;                             /* global/debug options */                  int global;                             /* global/debug options */
327                  int max_bframes;                /* max sequential bframes (0=disable bframes) */                  int max_bframes;                /* max sequential bframes (0=disable bframes) */
328                  int bquant_ratio;               /* bframe quantizer multipier (percentage).                  int bquant_ratio;               /* bframe quantizer multipier (percentage).
329                                                                   * used only when bquant < 1                                                                   * used only when bquant < 1
330                                                                   * eg. 200 = x2 multiplier                                                                   * eg. 200 = x2 multiplier
331  #endif                                                                   * quant = ((past_quant + future_quant) * bquant_ratio)/200
332                                                                     */
333                    int bquant_offset;              /* bquant += bquant_offset */
334                    int frame_drop_ratio;   /* frame dropping: 0=drop none... 100=drop all */
335                    void *handle;                   /* [out] encoder instance handle */
336          }          }
337          XVID_ENC_PARAM;          XVID_ENC_PARAM;
338    
339          typedef struct          typedef struct
340          {          {
341                  int x;                  int x;
342                    int y;
343          }          }
344          VECTOR;          VECTOR;
345    
# Line 282  Line 376 
376                  int length;                             /* [out] bitstream length (bytes) */                  int length;                             /* [out] bitstream length (bytes) */
377    
378                  void *image;                    /* [in] image ptr */                  void *image;                    /* [in] image ptr */
379                    int stride;
380                  int colorspace;                 /* [in] source colorspace */                  int colorspace;                 /* [in] source colorspace */
381    
382                  unsigned char *quant_intra_matrix;      // [in] custom intra qmatrix */                  unsigned char *quant_intra_matrix;      // [in] custom intra qmatrix */
# Line 292  Line 387 
387                                                                   */                                                                   */
388                  HINTINFO hint;                  /* [in/out] mv hint information */                  HINTINFO hint;                  /* [in/out] mv hint information */
389    
 #ifdef BFRAMES  
390                  int bquant;                             /* [in] bframe quantizer */                  int bquant;                             /* [in] bframe quantizer */
 #endif  
391    
392          }          }
393          XVID_ENC_FRAME;          XVID_ENC_FRAME;
# Line 303  Line 396 
396          typedef struct          typedef struct
397          {          {
398                  int quant;                              /* [out] frame quantizer */                  int quant;                              /* [out] frame quantizer */
                 int input_consumed;             /* [out] */  
399                  int hlength;                    /* [out] header length (bytes) */                  int hlength;                    /* [out] header length (bytes) */
400                  int kblks, mblks, ublks;        /* [out] */                  int kblks, mblks, ublks;        /* [out] */
   
401          }          }
402          XVID_ENC_STATS;          XVID_ENC_STATS;
403    

Legend:
Removed from v.1.11  
changed lines
  Added in v.1.17.2.13

No admin address has been configured
ViewVC Help
Powered by ViewVC 1.0.4