Merge commit 'bc5abfb19e7ff00b859120561d6ffd622c7904fe'
[ffmpeg.git] / libavcodec / mpeg4video.h
1 /*
2  * MPEG4 encoder/decoder internal header.
3  * Copyright (c) 2000,2001 Fabrice Bellard
4  * Copyright (c) 2002-2010 Michael Niedermayer <michaelni@gmx.at>
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22
23 #ifndef AVCODEC_MPEG4VIDEO_H
24 #define AVCODEC_MPEG4VIDEO_H
25
26 #include <stdint.h>
27
28 #include "get_bits.h"
29 #include "mpegvideo.h"
30 #include "rl.h"
31
32 // shapes
33 #define RECT_SHAPE       0
34 #define BIN_SHAPE        1
35 #define BIN_ONLY_SHAPE   2
36 #define GRAY_SHAPE       3
37
38 #define SIMPLE_VO_TYPE           1
39 #define CORE_VO_TYPE             3
40 #define MAIN_VO_TYPE             4
41 #define NBIT_VO_TYPE             5
42 #define ARTS_VO_TYPE            10
43 #define ACE_VO_TYPE             12
44 #define ADV_SIMPLE_VO_TYPE      17
45
46 // aspect_ratio_info
47 #define EXTENDED_PAR 15
48
49 //vol_sprite_usage / sprite_enable
50 #define STATIC_SPRITE 1
51 #define GMC_SPRITE 2
52
53 #define MOTION_MARKER 0x1F001
54 #define DC_MARKER     0x6B001
55
56 #define VOS_STARTCODE        0x1B0
57 #define USER_DATA_STARTCODE  0x1B2
58 #define GOP_STARTCODE        0x1B3
59 #define VISUAL_OBJ_STARTCODE 0x1B5
60 #define VOP_STARTCODE        0x1B6
61
62 typedef struct Mpeg4DecContext {
63     MpegEncContext m;
64
65     ///< number of bits to represent the fractional part of time
66     int time_increment_bits;
67     int shape;
68     int vol_sprite_usage;
69     // reversible vlc
70     int rvlc;
71 } Mpeg4DecContext;
72
73 /* dc encoding for mpeg4 */
74 extern const uint8_t ff_mpeg4_DCtab_lum[13][2];
75 extern const uint8_t ff_mpeg4_DCtab_chrom[13][2];
76
77 extern const uint16_t ff_mpeg4_intra_vlc[103][2];
78 extern const int8_t ff_mpeg4_intra_level[102];
79 extern const int8_t ff_mpeg4_intra_run[102];
80
81 extern RLTable ff_mpeg4_rl_intra;
82
83 /* Note this is identical to the intra rvlc except that it is reordered. */
84 extern RLTable ff_rvlc_rl_inter;
85 extern RLTable ff_rvlc_rl_intra;
86
87 extern const uint16_t ff_sprite_trajectory_tab[15][2];
88 extern const uint8_t ff_mb_type_b_tab[4][2];
89
90 /* these matrixes will be permuted for the idct */
91 extern const int16_t ff_mpeg4_default_intra_matrix[64];
92 extern const int16_t ff_mpeg4_default_non_intra_matrix[64];
93
94 extern const uint8_t ff_mpeg4_y_dc_scale_table[32];
95 extern const uint8_t ff_mpeg4_c_dc_scale_table[32];
96 extern const uint16_t ff_mpeg4_resync_prefix[8];
97
98 extern const uint8_t ff_mpeg4_dc_threshold[8];
99
100 void ff_mpeg4_encode_mb(MpegEncContext *s,
101                         int16_t block[6][64],
102                         int motion_x, int motion_y);
103 void ff_mpeg4_pred_ac(MpegEncContext *s, int16_t *block, int n,
104                       int dir);
105 void ff_set_mpeg4_time(MpegEncContext *s);
106 void ff_mpeg4_encode_picture_header(MpegEncContext *s, int picture_number);
107
108 int ff_mpeg4_decode_picture_header(Mpeg4DecContext *ctx, GetBitContext *gb);
109 void ff_mpeg4_encode_video_packet_header(MpegEncContext *s);
110 void ff_mpeg4_clean_buffers(MpegEncContext *s);
111 void ff_mpeg4_stuffing(PutBitContext *pbc);
112 void ff_mpeg4_init_partitions(MpegEncContext *s);
113 void ff_mpeg4_merge_partitions(MpegEncContext *s);
114 void ff_clean_mpeg4_qscales(MpegEncContext *s);
115 int ff_mpeg4_decode_partitions(Mpeg4DecContext *ctx);
116 int ff_mpeg4_get_video_packet_prefix_length(MpegEncContext *s);
117 int ff_mpeg4_decode_video_packet_header(Mpeg4DecContext *ctx);
118 void ff_mpeg4_init_direct_mv(MpegEncContext *s);
119 void ff_mpeg4videodec_static_init(void);
120
121 /**
122  *
123  * @return the mb_type
124  */
125 int ff_mpeg4_set_direct_mv(MpegEncContext *s, int mx, int my);
126
127 extern uint8_t ff_mpeg4_static_rl_table_store[3][2][2 * MAX_RUN + MAX_LEVEL + 3];
128
129 #if 0 //3IV1 is quite rare and it slows things down a tiny bit
130 #define IS_3IV1 s->codec_tag == AV_RL32("3IV1")
131 #else
132 #define IS_3IV1 0
133 #endif
134
135 /**
136  * Predict the dc.
137  * encoding quantized level -> quantized diff
138  * decoding quantized diff -> quantized level
139  * @param n block index (0-3 are luma, 4-5 are chroma)
140  * @param dir_ptr pointer to an integer where the prediction direction will be stored
141  */
142 static inline int ff_mpeg4_pred_dc(MpegEncContext *s, int n, int level,
143                                    int *dir_ptr, int encoding)
144 {
145     int a, b, c, wrap, pred, scale, ret;
146     int16_t *dc_val;
147
148     /* find prediction */
149     if (n < 4)
150         scale = s->y_dc_scale;
151     else
152         scale = s->c_dc_scale;
153     if (IS_3IV1)
154         scale = 8;
155
156     wrap   = s->block_wrap[n];
157     dc_val = s->dc_val[0] + s->block_index[n];
158
159     /* B C
160      * A X
161      */
162     a = dc_val[-1];
163     b = dc_val[-1 - wrap];
164     c = dc_val[-wrap];
165
166     /* outside slice handling (we can't do that by memset as we need the
167      * dc for error resilience) */
168     if (s->first_slice_line && n != 3) {
169         if (n != 2)
170             b = c = 1024;
171         if (n != 1 && s->mb_x == s->resync_mb_x)
172             b = a = 1024;
173     }
174     if (s->mb_x == s->resync_mb_x && s->mb_y == s->resync_mb_y + 1) {
175         if (n == 0 || n == 4 || n == 5)
176             b = 1024;
177     }
178
179     if (abs(a - b) < abs(b - c)) {
180         pred     = c;
181         *dir_ptr = 1; /* top */
182     } else {
183         pred     = a;
184         *dir_ptr = 0; /* left */
185     }
186     /* we assume pred is positive */
187     pred = FASTDIV((pred + (scale >> 1)), scale);
188
189     if (encoding) {
190         ret = level - pred;
191     } else {
192         level += pred;
193         ret    = level;
194         if (s->err_recognition & (AV_EF_BITSTREAM | AV_EF_AGGRESSIVE)) {
195             if (level < 0) {
196                 av_log(s->avctx, AV_LOG_ERROR,
197                        "dc<0 at %dx%d\n", s->mb_x, s->mb_y);
198                 return -1;
199             }
200             if (level * scale > 2048 + scale) {
201                 av_log(s->avctx, AV_LOG_ERROR,
202                        "dc overflow at %dx%d\n", s->mb_x, s->mb_y);
203                 return -1;
204             }
205         }
206     }
207     level *= scale;
208     if (level & (~2047)) {
209         if (level < 0)
210             level = 0;
211         else if (!(s->workaround_bugs & FF_BUG_DC_CLIP))
212             level = 2047;
213     }
214     dc_val[0] = level;
215
216     return ret;
217 }
218
219 #endif /* AVCODEC_MPEG4VIDEO_H */