FFmpeg
vc1.h
1 /*
2  * VC-1 and WMV3 decoder
3  * Copyright (c) 2006-2007 Konstantin Shishkov
4  * Partly based on vc9.c (c) 2005 Anonymous, Alex Beregszaszi, Michael Niedermayer
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_VC1_H
24 #define AVCODEC_VC1_H
25 
26 #include "avcodec.h"
27 #include "h264chroma.h"
28 #include "mpegvideo.h"
29 #include "intrax8.h"
30 #include "vc1_common.h"
31 #include "vc1dsp.h"
32 
33 #define AC_VLC_BITS 9
34 
37 enum QuantMode {
38  QUANT_FRAME_IMPLICIT,
39  QUANT_FRAME_EXPLICIT,
40  QUANT_NON_UNIFORM,
41  QUANT_UNIFORM
42 };
44 
47 enum DQProfile {
48  DQPROFILE_FOUR_EDGES,
49  DQPROFILE_DOUBLE_EDGES,
50  DQPROFILE_SINGLE_EDGE,
51  DQPROFILE_ALL_MBS
52 };
54 
58 enum DQSingleEdge {
59  DQSINGLE_BEDGE_LEFT,
60  DQSINGLE_BEDGE_TOP,
61  DQSINGLE_BEDGE_RIGHT,
62  DQSINGLE_BEDGE_BOTTOM
63 };
65 
68 enum DQDoubleEdge {
69  DQDOUBLE_BEDGE_TOPLEFT,
70  DQDOUBLE_BEDGE_TOPRIGHT,
71  DQDOUBLE_BEDGE_BOTTOMRIGHT,
72  DQDOUBLE_BEDGE_BOTTOMLEFT
73 };
75 
78 enum MVModes {
79  MV_PMODE_1MV_HPEL_BILIN,
80  MV_PMODE_1MV,
81  MV_PMODE_1MV_HPEL,
82  MV_PMODE_MIXED_MV,
83  MV_PMODE_INTENSITY_COMP
84 };
86 
89 enum MBModesIntfr {
90  MV_PMODE_INTFR_1MV,
91  MV_PMODE_INTFR_2MV_FIELD,
92  MV_PMODE_INTFR_2MV,
93  MV_PMODE_INTFR_4MV_FIELD,
94  MV_PMODE_INTFR_4MV,
95  MV_PMODE_INTFR_INTRA,
96 };
98 
101 enum BMVTypes {
102  BMV_TYPE_BACKWARD,
103  BMV_TYPE_FORWARD,
104  BMV_TYPE_INTERPOLATED,
105  BMV_TYPE_DIRECT
106 };
108 
111 enum TransformTypes {
112  TT_8X8,
113  TT_8X4_BOTTOM,
114  TT_8X4_TOP,
115  TT_8X4, // both halves
116  TT_4X8_RIGHT,
117  TT_4X8_LEFT,
118  TT_4X8, // both halves
119  TT_4X4
120 };
122 
123 enum CodingSet {
124  CS_HIGH_MOT_INTRA = 0,
125  CS_HIGH_MOT_INTER,
126  CS_LOW_MOT_INTRA,
127  CS_LOW_MOT_INTER,
128  CS_MID_RATE_INTRA,
129  CS_MID_RATE_INTER,
130  CS_HIGH_RATE_INTRA,
131  CS_HIGH_RATE_INTER
132 };
133 
136 enum COTypes {
137  CONDOVER_NONE = 0,
138  CONDOVER_ALL,
139  CONDOVER_SELECT
140 };
142 
148 enum FrameCodingMode {
149  PROGRESSIVE = 0,
150  ILACE_FRAME,
151  ILACE_FIELD
152 };
153 
158 enum Imode {
159  IMODE_RAW,
160  IMODE_NORM2,
161  IMODE_DIFF2,
162  IMODE_NORM6,
163  IMODE_DIFF6,
164  IMODE_ROWSKIP,
165  IMODE_COLSKIP
166 }; //imode defines
168 
173 typedef struct VC1Context{
174  MpegEncContext s;
175  IntraX8Context x8;
176  H264ChromaContext h264chroma;
177  VC1DSPContext vc1dsp;
178 
179  int bits;
180 
184  int res_y411;
185  int res_x8;
186  int multires;
189  int rangered;
190  int res_rtm_flag;
192  int reserved;
193 
194 
197  int level;
200  int broadcast;
201  int interlace;
210  int psf;
212 
213 
218  int profile;
221  int max_coded_width, max_coded_height;
222  int fastuvmc;
224  int dquant;
226  int overlap;
229 
230 
233  uint8_t mv_mode;
234  uint8_t mv_mode2;
235  int k_x;
236  int k_y;
237  int range_x, range_y;
238  uint8_t pq, altpq;
239  uint8_t zz_8x8[4][64];
240  int left_blk_sh, top_blk_sh;
241  const uint8_t* zz_8x4;
242  const uint8_t* zz_4x8;
243 
245  uint8_t dquantfrm;
246  uint8_t dqprofile;
247  uint8_t dqsbedge;
248  uint8_t dqbilevel;
250 
256 
257  int ttfrm;
258  uint8_t ttmbf;
259  int *ttblk_base, *ttblk;
260  int codingset;
262  int pqindex;
263  int a_avail, c_avail;
264  uint8_t *mb_type_base, *mb_type[3];
265 
266 
269  uint8_t lumscale;
270  uint8_t lumshift;
272  int16_t bfraction;
273  uint8_t halfpq;
274  uint8_t respic;
276 
282  uint8_t mvrange;
283  uint8_t pquantizer;
285  int tt_index;
286  uint8_t* mv_type_mb_plane;
287  uint8_t* direct_mb_plane;
288  uint8_t* forward_mb_plane;
293  uint8_t last_luty[2][256], last_lutuv[2][256];
294  uint8_t aux_luty[2][256], aux_lutuv[2][256];
295  uint8_t next_luty[2][256], next_lutuv[2][256];
296  uint8_t (*curr_luty)[256] ,(*curr_lutuv)[256];
297  int last_use_ic, *curr_use_ic, next_use_ic, aux_use_ic;
298  int rnd;
299  int cbptab;
300 
303  uint8_t rangeredfrm;
304  uint8_t interpfrm;
306 
309  enum FrameCodingMode fcm;
310  uint8_t numpanscanwin;
311  uint8_t tfcntr;
312  uint8_t rptfrm, tff, rff;
313  uint16_t topleftx;
314  uint16_t toplefty;
315  uint16_t bottomrightx;
316  uint16_t bottomrighty;
317  uint8_t uvsamp;
318  uint8_t postproc;
319  int hrd_num_leaky_buckets;
320  uint8_t bit_rate_exponent;
321  uint8_t buffer_size_exponent;
322  uint8_t* acpred_plane;
323  int acpred_is_raw;
324  uint8_t* over_flags_plane;
325  int overflg_is_raw;
326  uint8_t condover;
327  uint16_t *hrd_rate, *hrd_buffer;
328  uint8_t *hrd_fullness;
329  uint8_t range_mapy_flag;
330  uint8_t range_mapuv_flag;
331  uint8_t range_mapy;
332  uint8_t range_mapuv;
334 
336  uint8_t dmvrange;
337  int fourmvswitch;
338  int intcomp;
339  uint8_t lumscale2;
340  uint8_t lumshift2;
341  VLC* mbmode_vlc;
342  VLC* imv_vlc;
343  VLC* twomvbp_vlc;
344  VLC* fourmvbp_vlc;
345  uint8_t twomvbp;
346  uint8_t fourmvbp;
347  uint8_t* fieldtx_plane;
348  int fieldtx_is_raw;
349  uint8_t zzi_8x8[64];
350  uint8_t *blk_mv_type_base, *blk_mv_type;
351  uint8_t *mv_f_base, *mv_f[2];
352  uint8_t *mv_f_next_base, *mv_f_next[2];
354  int fptype;
355  int second_field;
356  int refdist;
357  int numref;
358  // 0 corresponds to 1 and 1 corresponds to 2 references
359  int reffield;
360  // field to use among the two fields from previous frame
362  // 0: both fields, 1: bottom field, 2: top field
364  int ref_field_type[2];
365  int blocks_off, mb_off;
366  int qs_last;
367  int bmvtype;
368  int frfd, brfd;
369  int first_pic_header_flag;
370  int pic_header_flag;
371  int mbmodetab;
372  int icbptab;
373  int imvtab;
374  int twomvbptab;
375  int fourmvbptab;
376 
380  int two_sprites;
381  AVFrame *sprite_output_frame;
382  int output_width, output_height, sprite_width, sprite_height;
383  uint8_t* sr_rows[2][2];
384 
385 
386  int p_frame_skipped;
387  int bi_type;
388  int x8_type;
389 
390  int16_t (*block)[6][64];
391  int n_allocated_blks, cur_blk_idx, left_blk_idx, topleft_blk_idx, top_blk_idx;
392  uint32_t *cbp_base, *cbp;
393  uint8_t *is_intra_base, *is_intra;
394  int16_t (*luma_mv_base)[2], (*luma_mv)[2];
396  uint8_t broken_link;
397  uint8_t closed_entry;
398 
399  int end_mb_x;
400 
403 } VC1Context;
404 
413 
414 int ff_vc1_decode_entry_point(AVCodecContext *avctx, VC1Context *v, GetBitContext *gb);
415 
416 int ff_vc1_parse_frame_header (VC1Context *v, GetBitContext *gb);
417 int ff_vc1_parse_frame_header_adv(VC1Context *v, GetBitContext *gb);
419 
420 int ff_vc1_decode_init_alloc_tables(VC1Context *v);
421 void ff_vc1_init_transposed_scantables(VC1Context *v);
423 void ff_vc1_decode_blocks(VC1Context *v);
424 
425 void ff_vc1_loop_filter_iblk(VC1Context *v, int pq);
426 void ff_vc1_loop_filter_iblk_delayed(VC1Context *v, int pq);
427 void ff_vc1_smooth_overlap_filter_iblk(VC1Context *v);
428 void ff_vc1_apply_p_loop_filter(VC1Context *v);
429 
430 void ff_vc1_mc_1mv(VC1Context *v, int dir);
431 void ff_vc1_mc_4mv_luma(VC1Context *v, int n, int dir, int avg);
432 void ff_vc1_mc_4mv_chroma(VC1Context *v, int dir);
433 void ff_vc1_mc_4mv_chroma4(VC1Context *v, int dir, int dir2, int avg);
434 
436 
437 #endif /* AVCODEC_VC1_H */
int color_prim
8 bits, chroma coordinates of the color primaries
Definition: vc1.h:206
Definition: vc1dsp.h:35
uint8_t bfraction_lut_index
Index for BFRACTION value (see Table 40, reproduced into ff_vc1_bfraction_lut[])
Definition: vc1.h:395
The VC1 Context.
Definition: vc1.h:173
This structure describes decoded (raw) audio or video data.
Definition: frame.h:218
uint8_t lumscale2
for interlaced field P picture
Definition: vc1.h:339
int k_x
Number of bits for MVs (depends on MV range)
Definition: vc1.h:235
int reffield
if numref = 0 (1 reference) then reffield decides which
Definition: vc1.h:359
int mv_type_is_raw
mv type mb plane is not coded
Definition: vc1.h:289
uint8_t dmvrange
Frame decoding info for interlaced picture.
Definition: vc1.h:336
av_cold int ff_vc1_decode_end(AVCodecContext *avctx)
Close a VC1/WMV3 decoder.
Definition: vc1dec.c:587
int tt_index
Index for Transform Type tables (to decode TTMB)
Definition: vc1.h:285
int extended_mv
Ext MV in P/B (not in Simple)
Definition: vc1.h:223
int broadcast
TFF/RFF present.
Definition: vc1.h:200
int transfer_char
8 bits, Opto-electronic transfer characteristics
Definition: vc1.h:207
uint8_t rangeredfrm
Frame decoding info for S/M profiles only.
Definition: vc1.h:303
uint8_t zz_8x8[4][64]
Zigzag table for TT_8x8, permuted for IDCT.
Definition: vc1.h:239
mpegvideo header.
int intcompfield
which of the two fields to be intensity compensated
Definition: vc1.h:361
uint8_t * mv_f[2]
0: MV obtained from same field, 1: opposite field
Definition: vc1.h:351
int fastuvmc
Rounding of qpel vector to hpel ? (not in Simple)
Definition: vc1.h:222
int end_mb_x
Horizontal macroblock limit (used only by mss2)
Definition: vc1.h:399
int frmrtq_postproc
3 bits,
Definition: vc1.h:219
int hrd_param_flag
Presence of Hypothetical Reference Decoder parameters.
Definition: vc1.h:209
int refdist
distance of the current picture from reference
Definition: vc1.h:356
uint8_t * acpred_plane
AC prediction flags bitplane.
Definition: vc1.h:322
int res_transtab
reserved, always 0
Definition: vc1.h:188
int matrix_coef
8 bits, Color primaries->YCbCr transform matrix
Definition: vc1.h:208
int panscanflag
NUMPANSCANWIN, TOPLEFT{X,Y}, BOTRIGHT{X,Y} present.
Definition: vc1.h:203
av_cold int ff_vc1_init_common(VC1Context *v)
Init VC-1 specific tables and VC1Context members.
Definition: vc1.c:1578
int interlace
Progressive/interlaced (RPTFTM syntax element)
Definition: vc1.h:201
int y_ac_table_index
Luma index from AC2FRM element.
Definition: vc1.h:255
int c_ac_table_index
AC coding set indexes.
Definition: vc1.h:254
void ff_vc1_interp_mc(VC1Context *v)
Motion compensation for direct or interpolated blocks in B-frames.
Definition: vc1_mc.c:748
int ttfrm
Transform type info present at frame level.
Definition: vc1.h:257
int codingset2
index of current table set from 11.8 to use for chroma block decoding
Definition: vc1.h:261
Definition: h264chroma.h:27
int16_t bfraction
Relative position % anchors=> how to scale MVs.
Definition: vc1.h:272
int profile
Sequence header data for all Profiles TODO: choose between ints, uint8_ts and monobit flags...
Definition: vc1.h:218
int refdist_flag
REFDIST syntax element present in II, IP, PI or PP field picture headers.
Definition: vc1.h:204
void ff_vc1_mc_4mv_luma(VC1Context *v, int n, int dir, int avg)
Do motion compensation for 4-MV macroblock - luminance block.
Definition: vc1_mc.c:351
uint8_t * forward_mb_plane
bitplane for "forward" MBs
Definition: vc1.h:288
int ff_vc1_decode_sequence_header(AVCodecContext *avctx, VC1Context *v, GetBitContext *gb)
Decode Simple/Main Profiles sequence header.
Definition: vc1.c:276
uint8_t * over_flags_plane
Overflags bitplane.
Definition: vc1.h:324
int range_y
MV range.
Definition: vc1.h:237
uint8_t last_lutuv[2][256]
lookup tables used for intensity compensation
Definition: vc1.h:293
int psf
Progressive Segmented Frame.
Definition: vc1.h:211
uint8_t ttmbf
Transform type flag.
Definition: vc1.h:258
int k_y
Number of bits for MVs (depends on MV range)
Definition: vc1.h:236
int dmb_is_raw
direct mb plane is raw
Definition: vc1.h:290
int res_y411
reserved, old interlaced mode
Definition: vc1.h:184
int overlap
overlapped transforms in use
Definition: vc1.h:226
int res_x8
reserved
Definition: vc1.h:185
int qs_last
if qpel has been used in the previous (tr.) picture
Definition: vc1.h:366
int resync_marker
could this stream contain resync markers
Definition: vc1.h:402
uint8_t broken_link
Broken link flag (BROKEN_LINK syntax element)
Definition: vc1.h:396
const uint8_t * zz_8x4
Zigzag scan table for TT_8x4 coding mode.
Definition: vc1.h:241
int postprocflag
Per-frame processing suggestion flag present.
Definition: vc1.h:199
int res_rtm_flag
reserved, set to 1
Definition: vc1.h:191
Definition: vlc.h:26
uint8_t * blk_mv_type
0: frame MV, 1: field MV (interlaced frame)
Definition: vc1.h:350
Definition: intrax8.h:29
int cur_field_type
0: top, 1: bottom
Definition: vc1.h:363
const uint8_t * zz_4x8
Zigzag scan table for TT_4x8 coding mode.
Definition: vc1.h:242
int tfcntrflag
TFCNTR present.
Definition: vc1.h:202
int field_mode
1 for interlaced field pictures
Definition: vc1.h:353
uint8_t mv_mode
Frame decoding info for all profiles.
Definition: vc1.h:233
uint8_t lumscale
Luma compensation parameters.
Definition: vc1.h:269
uint8_t closed_entry
Closed entry point flag (CLOSED_ENTRY syntax element)
Definition: vc1.h:397
VLC * cbpcy_vlc
CBPCY VLC table.
Definition: vc1.h:284
uint8_t * sr_rows[2][2]
Sprite resizer line cache.
Definition: vc1.h:383
uint8_t aux_lutuv[2][256]
lookup tables used for intensity compensation
Definition: vc1.h:294
int rangered
RANGEREDFRM (range reduction) syntax element present at frame level.
Definition: vc1.h:189
int finterpflag
INTERPFRM present.
Definition: vc1.h:228
int chromaformat
2 bits, 2=4:2:0, only defined
Definition: vc1.h:198
int res_sprite
Simple/Main Profile sequence header.
Definition: vc1.h:183
int top_blk_sh
Either 3 or 0, positions of l/t in blk[].
Definition: vc1.h:240
Libavcodec external API header.
int multires
frame-level RESPIC syntax element present
Definition: vc1.h:186
main external API structure.
Definition: avcodec.h:1518
int extended_dmv
Additional extended dmv range at P/B-frame-level.
Definition: vc1.h:205
int fmb_is_raw
forward mb plane is raw
Definition: vc1.h:291
int buffer_fullness
HRD info.
Definition: vc1.h:275
int reserved
reserved
Definition: vc1.h:192
void ff_vc1_mc_1mv(VC1Context *v, int dir)
Do motion compensation over 1 macroblock Mostly adapted hpel_motion and qpel_motion from mpegvideo...
Definition: vc1_mc.c:172
void ff_vc1_mc_4mv_chroma4(VC1Context *v, int dir, int dir2, int avg)
Do motion compensation for 4-MV interlaced frame chroma macroblock (both U and V) ...
Definition: vc1_mc.c:643
uint8_t respic
Frame-level flag for resized images.
Definition: vc1.h:274
int skip_is_raw
skip mb plane is not coded
Definition: vc1.h:292
int quantizer_mode
2 bits, quantizer mode used for sequence, see QUANT_*
Definition: vc1.h:227
uint8_t next_lutuv[2][256]
lookup tables used for intensity compensation
Definition: vc1.h:295
int ref_field_type[2]
forward and backward reference field type (top or bottom)
Definition: vc1.h:364
uint8_t * direct_mb_plane
bitplane for "direct" MBs
Definition: vc1.h:287
uint8_t mvrange
Ranges:0 -> [-64n 63.f] x [-32, 31.f]1 -> [-128, 127.f] x [-64, 63.f]2 -> [-512, 511.f] x [-128, 127.f]3 -> [-1024, 1023.f] x [-256, 255.f].
Definition: vc1.h:282
uint8_t * mv_type_mb_plane
bitplane for mv_type == (4MV)
Definition: vc1.h:286
int vstransform
variable-size [48]x[48] transform type + info
Definition: vc1.h:225
int numref
number of past field pictures used as reference
Definition: vc1.h:357
MpegEncContext.
Definition: mpegvideo.h:81
int pqindex
raw pqindex used in coding set selection
Definition: vc1.h:262
Definition: get_bits.h:56
enum FrameCodingMode fcm
Frame decoding info for Advanced profile.
Definition: vc1.h:309
uint8_t dquantfrm
pquant parameters
Definition: vc1.h:245
int res_fasttx
reserved, always 1
Definition: vc1.h:187
int * ttblk
Transform type at the block level.
Definition: vc1.h:259
uint8_t pquantizer
Uniform (over sequence) quantizer in use.
Definition: vc1.h:283
int rnd
rounding control
Definition: vc1.h:298
int bitrtq_postproc
5 bits, quantized framerate-based postprocessing strength
Definition: vc1.h:220
int parse_only
Context is used within parser.
Definition: vc1.h:401
int level
Advanced Profile.
Definition: vc1.h:197
int brfd
reference frame distance (forward or backward)
Definition: vc1.h:368
void ff_vc1_mc_4mv_chroma(VC1Context *v, int dir)
Do motion compensation for 4-MV macroblock - both chroma blocks.
Definition: vc1_mc.c:507
int dquant
How qscale varies with MBs, 2 bits (not in Simple)
Definition: vc1.h:224
uint8_t mv_mode2
Secondary MV coding mode (B-frames)
Definition: vc1.h:234
int new_sprite
Frame decoding info for sprite modes.
Definition: vc1.h:379
int codingset
index of current table set from 11.8 to use for luma block decoding
Definition: vc1.h:260
uint8_t halfpq
Uniform quant over image and qp+.5.
Definition: vc1.h:273
uint8_t altpq
Current/alternate frame quantizer scale.
Definition: vc1.h:238