vc1.h
Go to the documentation of this file.
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 Libav.
7  *
8  * Libav 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  * Libav 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 Libav; 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 "mpegvideo.h"
28 #include "intrax8.h"
29 #include "vc1dsp.h"
30 
31 #define AC_VLC_BITS 9
32 
35 enum VC1Code {
36  VC1_CODE_RES0 = 0x00000100,
37  VC1_CODE_ENDOFSEQ = 0x0000010A,
43 };
45 
46 #define IS_MARKER(x) (((x) & ~0xFF) == VC1_CODE_RES0)
47 
50 enum Profile {
55 };
57 
60 enum QuantMode {
65 };
67 
70 enum DQProfile {
75 };
77 
86 };
88 
96 };
98 
101 enum MVModes {
107 };
109 
119 };
121 
124 enum BMVTypes {
129 };
131 
138  TT_8X4, // both halves
141  TT_4X8, // both halves
143 };
145 
146 enum CodingSet {
155 };
156 
159 enum COTypes {
163 };
165 
175 };
176 
181 typedef struct VC1Context{
185 
186  int bits;
187 
191  int res_y411;
192  int res_x8;
193  int multires;
196  int rangered;
197  int res_rtm_flag;
199  int reserved;
200 
201 
204  int level;
207  int broadcast;
208  int interlace;
217  int psf;
219 
220 
225  int profile;
228  int fastuvmc;
230  int dquant;
232  int overlap;
235 
236 
241  int k_x;
242  int k_y;
245  uint8_t zz_8x8[4][64];
247  const uint8_t* zz_8x4;
248  const uint8_t* zz_4x8;
249 
256 
262 
263  int ttfrm;
265  int *ttblk_base, *ttblk;
266  int codingset;
268  int pqindex;
271 
272 
278  int16_t bfraction;
282 
291  int tt_index;
299  uint8_t luty[256], lutuv[256];
300  int use_ic;
301  int rnd;
302 
308 
315  uint16_t topleftx;
316  uint16_t toplefty;
317  uint16_t bottomrightx;
318  uint16_t bottomrighty;
329  uint16_t *hrd_rate, *hrd_buffer;
336 
340  int intcomp;
343  uint8_t luty2[256], lutuv2[256]; // lookup tables used for intensity compensation
352  int8_t zzi_8x8[64];
358  int fptype;
360  int refdist;
361  int numref;
362  // 0 corresponds to 1 and 1 corresponds to 2 references
363  int reffield;
364  // field to use among the two fields from previous frame
366  // 0: both fields, 1: bottom field, 2: top field
368  int ref_field_type[2];
370  int qs_last;
371  int bmvtype;
372  int frfd, brfd;
374 
381  uint8_t* sr_rows[2][2];
382 
383 
385  int bi_type;
386  int x8_type;
387 
388  DCTELEM (*block)[6][64];
390  uint32_t *cbp_base, *cbp;
392  int16_t (*luma_mv_base)[2], (*luma_mv)[2];
396 
397  int end_mb_x;
398 
400 
402 } VC1Context;
403 
407 static av_always_inline const uint8_t* find_next_marker(const uint8_t *src, const uint8_t *end)
408 {
409  uint32_t mrk = 0xFFFFFFFF;
410 
411  if (end-src < 4)
412  return end;
413  while (src < end) {
414  mrk = (mrk << 8) | *src++;
415  if (IS_MARKER(mrk))
416  return src - 4;
417  }
418  return end;
419 }
420 
421 static av_always_inline int vc1_unescape_buffer(const uint8_t *src, int size, uint8_t *dst)
422 {
423  int dsize = 0, i;
424 
425  if (size < 4) {
426  for (dsize = 0; dsize < size; dsize++)
427  *dst++ = *src++;
428  return size;
429  }
430  for (i = 0; i < size; i++, src++) {
431  if (src[0] == 3 && i >= 2 && !src[-1] && !src[-2] && i < size-1 && src[1] < 4) {
432  dst[dsize++] = src[1];
433  src++;
434  i++;
435  } else
436  dst[dsize++] = *src;
437  }
438  return dsize;
439 }
440 
449 
451 
455 
460 
461 #endif /* AVCODEC_VC1_H */
int color_prim
8bits, chroma coordinates of the color primaries
Definition: vc1.h:213
in the bitstream is reported as 00b
Definition: vc1.h:172
int use_ic
use intensity compensation in B-frames
Definition: vc1.h:300
av_cold int ff_vc1_decode_init_alloc_tables(VC1Context *v)
Definition: vc1dec.c:5077
int topleft_blk_idx
Definition: vc1.h:389
VC-1 and WMV3 decoder.
uint8_t bfraction_lut_index
Index for BFRACTION value (see Table 40, reproduced into ff_vc1_bfraction_lut[])
Definition: vc1.h:393
int p_frame_skipped
Definition: vc1.h:384
uint8_t luty[256]
Definition: vc1.h:299
av_cold void ff_vc1_init_transposed_scantables(VC1Context *v)
Definition: vc1dec.c:5154
The VC1 Context.
Definition: vc1.h:181
int size
This structure describes decoded (raw) audio or video data.
Definition: avcodec.h:989
uint8_t lumscale2
for interlaced field P picture
Definition: vc1.h:341
int k_x
Number of bits for MVs (depends on MV range)
Definition: vc1.h:241
int reffield
if numref = 0 (1 reference) then reffield decides which
Definition: vc1.h:363
uint8_t * mv_f_base
Definition: vc1.h:354
int mv_type_is_raw
mv type mb plane is not coded
Definition: vc1.h:295
Explicitly specified at frame level.
Definition: vc1.h:62
uint8_t dmvrange
Frame decoding info for interlaced picture.
Definition: vc1.h:338
int tt_index
Index for Transform Type tables (to decode TTMB)
Definition: vc1.h:291
int extended_mv
Ext MV in P/B (not in Simple)
Definition: vc1.h:229
uint8_t * mv_f_last_base
Definition: vc1.h:355
CodingSet
Definition: vc1.h:146
int broadcast
TFF/RFF present.
Definition: vc1.h:207
int transfer_char
8bits, Opto-electronic transfer characteristics
Definition: vc1.h:214
uint8_t rangeredfrm
Frame decoding info for S/M profiles only.
Definition: vc1.h:305
uint16_t bottomrighty
Definition: vc1.h:318
uint8_t luty2[256]
Definition: vc1.h:343
int frfd
Definition: vc1.h:372
uint8_t zz_8x8[4][64]
Zigzag table for TT_8x8, permuted for IDCT.
Definition: vc1.h:245
mpegvideo header.
int top_blk_idx
Definition: vc1.h:389
IntraX8Context x8
Definition: vc1.h:183
int intcompfield
which of the two fields to be intensity compensated
Definition: vc1.h:365
VLC * imv_vlc
Definition: vc1.h:345
uint8_t dqprofile
Definition: vc1.h:252
uint8_t * mb_type_base
Definition: vc1.h:270
uint8_t * mv_f[2]
0: MV obtained from same field, 1: opposite field
Definition: vc1.h:354
int sprite_height
Definition: vc1.h:380
MVModes
MV modes for P frames.
Definition: vc1.h:101
int fastuvmc
Rounding of qpel vector to hpel ? (not in Simple)
Definition: vc1.h:228
int end_mb_x
Horizontal macroblock limit (used only by mss2)
Definition: vc1.h:397
struct VC1Context VC1Context
The VC1 Context.
int frmrtq_postproc
3bits,
Definition: vc1.h:226
uint8_t rff
Definition: vc1.h:314
uint8_t numpanscanwin
Definition: vc1.h:312
int hrd_param_flag
Presence of Hypothetical Reference Decoder parameters.
Definition: vc1.h:216
uint8_t lumshift2
Definition: vc1.h:342
int bits
Definition: vc1.h:186
int range_x
Definition: vc1.h:243
uint8_t dqsbedge
Definition: vc1.h:253
int refdist
distance of the current picture from reference
Definition: vc1.h:360
uint8_t * acpred_plane
AC prediction flags bitplane.
Definition: vc1.h:324
int res_transtab
reserved, always 0
Definition: vc1.h:195
int bi_type
Definition: vc1.h:385
int matrix_coef
8bits, Color primaries->YCbCr transform matrix
Definition: vc1.h:215
uint8_t
uint16_t * hrd_rate
Definition: vc1.h:329
TransformTypes
Definition: vc1.h:134
int panscanflag
NUMPANSCANWIN, TOPLEFT{X,Y}, BOTRIGHT{X,Y} present.
Definition: vc1.h:210
int left_blk_idx
Definition: vc1.h:389
int interlace
Progressive/interlaced (RPTFTM syntax element)
Definition: vc1.h:208
int y_ac_table_index
Luma index from AC2FRM element.
Definition: vc1.h:261
int second_field
Definition: vc1.h:359
int n_allocated_blks
Definition: vc1.h:389
int c_ac_table_index
AC coding set indexes.
Definition: vc1.h:260
int ttfrm
Transform type info present at frame level.
Definition: vc1.h:263
uint8_t lutuv[256]
lookup tables used for intensity compensation
Definition: vc1.h:299
int codingset2
index of current table set from 11.8 to use for chroma block decoding
Definition: vc1.h:267
uint8_t lutuv2[256]
Definition: vc1.h:343
DQSingleEdge
Definition: vc1.h:81
int16_t bfraction
Relative position % anchors=> how to scale MVs.
Definition: vc1.h:278
uint16_t toplefty
Definition: vc1.h:316
int profile
Sequence header data for all Profiles TODO: choose between ints, uint8_ts and monobit flags...
Definition: vc1.h:225
int refdist_flag
REFDIST syntax element present in II, IP, PI or PP field picture headers.
Definition: vc1.h:211
uint8_t * forward_mb_plane
bitplane for "forward" MBs
Definition: vc1.h:294
FrameCodingMode
FCM Frame Coding Mode.
Definition: vc1.h:171
int fieldtx_is_raw
Definition: vc1.h:351
Non-uniform quant used for all frames.
Definition: vc1.h:63
int ff_vc1_decode_entry_point(AVCodecContext *avctx, VC1Context *v, GetBitContext *gb)
Definition: vc1.c:525
uint8_t * over_flags_plane
Overflags bitplane.
Definition: vc1.h:326
uint8_t dqbilevel
Definition: vc1.h:254
uint8_t fourmvbp
Definition: vc1.h:349
int range_y
MV range.
Definition: vc1.h:243
int psf
Progressive Segmented Frame.
Definition: vc1.h:218
uint8_t ttmbf
Transform type flag.
Definition: vc1.h:264
Definition: vc1.h:142
int k_y
Number of bits for MVs (depends on MV range)
Definition: vc1.h:242
Implicitly specified at frame level.
Definition: vc1.h:61
uint8_t twomvbp
Definition: vc1.h:348
int dmb_is_raw
direct mb plane is raw
Definition: vc1.h:296
int res_y411
reserved, old interlaced mode
Definition: vc1.h:191
int overlap
overlapped transforms in use
Definition: vc1.h:232
in the bitstream is reported as 11b
Definition: vc1.h:174
int res_x8
reserved
Definition: vc1.h:192
uint8_t * hrd_fullness
Definition: vc1.h:330
int qs_last
if qpel has been used in the previous (tr.) picture
Definition: vc1.h:370
AVFrame sprite_output_frame
Definition: vc1.h:379
uint8_t * mv_f_next_base
Definition: vc1.h:356
TODO: WMV9 specific.
Definition: vc1.h:53
VLC * mbmode_vlc
Definition: vc1.h:344
int ff_vc1_init_common(VC1Context *v)
Init VC-1 specific tables and VC1Context members.
Definition: vc1.c:1489
void ff_vc1_decode_blocks(VC1Context *v)
Definition: vc1dec.c:4763
uint8_t broken_link
Broken link flag (BROKEN_LINK syntax element)
Definition: vc1.h:394
const uint8_t * zz_8x4
Zigzag scan table for TT_8x4 coding mode.
Definition: vc1.h:247
int postprocflag
Per-frame processing suggestion flag present.
Definition: vc1.h:206
int res_rtm_flag
reserved, set to 1
Definition: vc1.h:198
Definition: get_bits.h:63
int a_avail
Definition: vc1.h:269
uint8_t * blk_mv_type
0: frame MV, 1: field MV (interlaced frame)
Definition: vc1.h:353
int cur_field_type
0: top, 1: bottom
Definition: vc1.h:367
VLC * twomvbp_vlc
Definition: vc1.h:346
const uint8_t * zz_4x8
Zigzag scan table for TT_4x8 coding mode.
Definition: vc1.h:248
uint8_t buffer_size_exponent
Definition: vc1.h:323
int x8_type
Definition: vc1.h:386
uint8_t * blk_mv_type_base
Definition: vc1.h:353
int tfcntrflag
TFCNTR present.
Definition: vc1.h:209
int field_mode
1 for interlaced field pictures
Definition: vc1.h:357
COTypes
Definition: vc1.h:159
int8_t zzi_8x8[64]
Definition: vc1.h:352
uint8_t mv_mode
Frame decoding info for all profiles.
Definition: vc1.h:239
Profile
Available Profiles.
Definition: vc1.h:50
int fourmvswitch
Definition: vc1.h:339
int mb_off
Definition: vc1.h:369
#define IS_MARKER(x)
Definition: vc1.h:46
MBModesIntfr
MBMODE for interlaced frame P-picture.
Definition: vc1.h:112
int ff_vc1_parse_frame_header_adv(VC1Context *v, GetBitContext *gb)
Definition: vc1.c:822
uint8_t lumscale
Luma compensation parameters.
Definition: vc1.h:275
av_cold int ff_vc1_decode_end(AVCodecContext *avctx)
Close a VC1/WMV3 decoder.
Definition: vc1dec.c:5306
uint8_t range_mapuv_flag
Definition: vc1.h:332
uint8_t closed_entry
Closed entry point flag (CLOSED_ENTRY syntax element)
Definition: vc1.h:395
DQProfile
Where quant can be changed.
Definition: vc1.h:70
int intcomp
Definition: vc1.h:340
uint32_t * cbp
Definition: vc1.h:390
int left_blk_sh
Definition: vc1.h:246
int16_t(* luma_mv_base)[2]
Definition: vc1.h:392
uint8_t * fieldtx_plane
Definition: vc1.h:350
int * ttblk_base
Definition: vc1.h:265
VLC * cbpcy_vlc
CBPCY VLC table.
Definition: vc1.h:290
int warn_interlaced
Definition: vc1.h:401
uint8_t * sr_rows[2][2]
Sprite resizer line cache.
Definition: vc1.h:381
int rangered
RANGEREDFRM (range reduction) syntax element present at frame level.
Definition: vc1.h:196
int finterpflag
INTERPFRM present.
Definition: vc1.h:234
int chromaformat
2bits, 2=4:2:0, only defined
Definition: vc1.h:205
int res_sprite
Simple/Main Profile sequence header.
Definition: vc1.h:190
int top_blk_sh
Either 3 or 0, positions of l/t in blk[].
Definition: vc1.h:246
external API header
int c_avail
Definition: vc1.h:269
int multires
frame-level RESPIC syntax element present
Definition: vc1.h:193
uint32_t * cbp_base
Definition: vc1.h:390
main external API structure.
Definition: avcodec.h:1339
uint8_t * is_intra
Definition: vc1.h:391
uint8_t range_mapy
Definition: vc1.h:333
int extended_dmv
Additional extended dmv range at P/B frame-level.
Definition: vc1.h:212
int sprite_width
Definition: vc1.h:380
int fmb_is_raw
forward mb plane is raw
Definition: vc1.h:297
QuantMode
Sequence quantizer mode.
Definition: vc1.h:60
uint8_t * is_intra_base
Definition: vc1.h:391
int fptype
Definition: vc1.h:358
Definition: vc1.h:138
int buffer_fullness
HRD info.
Definition: vc1.h:281
uint8_t * mv_f_last[2]
Definition: vc1.h:355
int reserved
reserved
Definition: vc1.h:199
uint8_t respic
Frame-level flag for resized images.
Definition: vc1.h:280
int skip_is_raw
skip mb plane is not coded
Definition: vc1.h:298
uint16_t bottomrightx
Definition: vc1.h:317
int quantizer_mode
2bits, quantizer mode used for sequence, see QUANT_*
Definition: vc1.h:233
int ref_field_type[2]
forward and backward reference field type (top or bottom)
Definition: vc1.h:368
uint8_t * direct_mb_plane
bitplane for "direct" MBs
Definition: vc1.h:293
short DCTELEM
Definition: dsputil.h:39
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:288
uint8_t * mv_type_mb_plane
bitplane for mv_type == (4MV)
Definition: vc1.h:292
int vstransform
variable-size [48]x[48] transform type + info
Definition: vc1.h:231
int numref
number of past field pictures used as reference
Definition: vc1.h:361
DCTELEM(* block)[6][64]
Definition: vc1.h:388
int blocks_off
Definition: vc1.h:369
DQDoubleEdge
Which pair of edges is quantized with ALTPQUANT.
Definition: vc1.h:91
uint8_t range_mapuv
Definition: vc1.h:334
uint8_t tff
Definition: vc1.h:314
MpegEncContext s
Definition: vc1.h:182
in the bitstream is reported as 10b
Definition: vc1.h:173
MpegEncContext.
Definition: mpegvideo.h:212
int cur_blk_idx
Definition: vc1.h:389
uint8_t pq
Definition: vc1.h:244
int ff_vc1_decode_sequence_header(AVCodecContext *avctx, VC1Context *v, GetBitContext *gb)
Decode Simple/Main Profiles sequence header.
Definition: vc1.c:294
int pqindex
raw pqindex used in coding set selection
Definition: vc1.h:268
int hrd_num_leaky_buckets
Definition: vc1.h:321
int output_width
Definition: vc1.h:380
enum FrameCodingMode fcm
Frame decoding info for Advanced profile.
Definition: vc1.h:311
Uniform quant used for all frames.
Definition: vc1.h:64
uint8_t dquantfrm
pquant parameters
Definition: vc1.h:251
uint8_t lumshift
Definition: vc1.h:276
BMVTypes
Definition: vc1.h:124
int res_fasttx
reserved, always 1
Definition: vc1.h:194
int pic_header_flag
Definition: vc1.h:373
int * ttblk
Transform type at the block level.
Definition: vc1.h:265
uint8_t bit_rate_exponent
Definition: vc1.h:322
uint8_t postproc
Definition: vc1.h:320
uint8_t condover
Definition: vc1.h:328
uint8_t uvsamp
Definition: vc1.h:319
uint8_t pquantizer
Uniform (over sequence) quantizer in use.
Definition: vc1.h:289
int rnd
rounding control
Definition: vc1.h:301
Definition: vc1.h:141
int acpred_is_raw
Definition: vc1.h:325
uint8_t rptfrm
Definition: vc1.h:314
int bmvtype
Definition: vc1.h:371
int bitrtq_postproc
5bits, quantized framerate-based postprocessing strength
Definition: vc1.h:227
int parse_only
Context is used within parser.
Definition: vc1.h:399
int overflg_is_raw
Definition: vc1.h:327
static av_always_inline int vc1_unescape_buffer(const uint8_t *src, int size, uint8_t *dst)
Definition: vc1.h:421
uint8_t interpfrm
Definition: vc1.h:306
Definition: vc1.h:135
int level
Advanced Profile.
Definition: vc1.h:204
uint8_t range_mapy_flag
Definition: vc1.h:331
uint8_t tfcntr
Definition: vc1.h:313
int brfd
reference frame distance (forward or backward)
Definition: vc1.h:372
int dquant
How qscale varies with MBs, 2bits (not in Simple)
Definition: vc1.h:230
uint8_t mv_mode2
Secondary MV coding mode (B frames)
Definition: vc1.h:240
int new_sprite
Frame decoding info for sprite modes.
Definition: vc1.h:377
uint8_t * mv_f_next[2]
Definition: vc1.h:356
int ff_vc1_parse_frame_header(VC1Context *v, GetBitContext *gb)
Definition: vc1.c:573
int two_sprites
Definition: vc1.h:378
int codingset
index of current table set from 11.8 to use for luma block decoding
Definition: vc1.h:266
VC1Code
Markers used in VC-1 AP frame data.
Definition: vc1.h:35
uint8_t * mb_type[3]
Definition: vc1.h:270
uint16_t * hrd_buffer
Definition: vc1.h:329
VLC * fourmvbp_vlc
Definition: vc1.h:347
uint8_t halfpq
Uniform quant over image and qp+.5.
Definition: vc1.h:279
VC1DSPContext vc1dsp
Definition: vc1.h:184
static av_always_inline const uint8_t * find_next_marker(const uint8_t *src, const uint8_t *end)
Find VC-1 marker in buffer.
Definition: vc1.h:407
int output_height
Definition: vc1.h:380
uint16_t topleftx
Definition: vc1.h:315
uint8_t altpq
Current/alternate frame quantizer scale.
Definition: vc1.h:244