Libav
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 "h264chroma.h"
28 #include "mpegvideo.h"
29 #include "intrax8.h"
30 #include "vc1dsp.h"
31 
32 #define AC_VLC_BITS 9
33 
36 enum VC1Code {
37  VC1_CODE_RES0 = 0x00000100,
38  VC1_CODE_ENDOFSEQ = 0x0000010A,
44 };
46 
47 #define IS_MARKER(x) (((x) & ~0xFF) == VC1_CODE_RES0)
48 
51 enum Profile {
56 };
58 
61 enum QuantMode {
66 };
68 
71 enum DQProfile {
76 };
78 
87 };
89 
97 };
99 
102 enum MVModes {
108 };
110 
120 };
122 
125 enum BMVTypes {
130 };
132 
139  TT_8X4, // both halves
142  TT_4X8, // both halves
144 };
146 
147 enum CodingSet {
156 };
157 
160 enum COTypes {
164 };
166 
176 };
177 
182 typedef struct VC1Context{
187 
188  int bits;
189 
193  int res_y411;
194  int res_x8;
195  int multires;
198  int rangered;
199  int res_rtm_flag;
201  int reserved;
202 
203 
206  int level;
209  int broadcast;
210  int interlace;
219  int psf;
221 
222 
227  int profile;
230  int fastuvmc;
232  int dquant;
234  int overlap;
237 
238 
243  int k_x;
244  int k_y;
247  uint8_t zz_8x8[4][64];
249  const uint8_t* zz_8x4;
250  const uint8_t* zz_4x8;
251 
258 
264 
265  int ttfrm;
267  int *ttblk_base, *ttblk;
268  int codingset;
270  int pqindex;
273 
274 
280  int16_t bfraction;
284 
293  int tt_index;
301  uint8_t last_luty[2][256], last_lutuv[2][256];
302  uint8_t aux_luty[2][256], aux_lutuv[2][256];
303  uint8_t next_luty[2][256], next_lutuv[2][256];
304  uint8_t (*curr_luty)[256] ,(*curr_lutuv)[256];
306  int rnd;
307 
313 
320  uint16_t topleftx;
321  uint16_t toplefty;
322  uint16_t bottomrightx;
323  uint16_t bottomrighty;
334  uint16_t *hrd_rate, *hrd_buffer;
341 
345  int intcomp;
356  int8_t zzi_8x8[64];
361  int fptype;
363  int refdist;
364  int numref;
365  // 0 corresponds to 1 and 1 corresponds to 2 references
366  int reffield;
367  // field to use among the two fields from previous frame
369  // 0: both fields, 1: bottom field, 2: top field
371  int ref_field_type[2];
373  int qs_last;
374  int bmvtype;
375  int frfd, brfd;
378 
385  uint8_t* sr_rows[2][2];
386 
387 
389  int bi_type;
390  int x8_type;
391 
392  int16_t (*block)[6][64];
394  uint32_t *cbp_base, *cbp;
396  int16_t (*luma_mv_base)[2], (*luma_mv)[2];
400 
401  int end_mb_x;
402 
405 } VC1Context;
406 
410 static av_always_inline const uint8_t* find_next_marker(const uint8_t *src, const uint8_t *end)
411 {
412  uint32_t mrk = 0xFFFFFFFF;
413 
414  if (end-src < 4)
415  return end;
416  while (src < end) {
417  mrk = (mrk << 8) | *src++;
418  if (IS_MARKER(mrk))
419  return src - 4;
420  }
421  return end;
422 }
423 
424 static av_always_inline int vc1_unescape_buffer(const uint8_t *src, int size, uint8_t *dst)
425 {
426  int dsize = 0, i;
427 
428  if (size < 4) {
429  for (dsize = 0; dsize < size; dsize++)
430  *dst++ = *src++;
431  return size;
432  }
433  for (i = 0; i < size; i++, src++) {
434  if (src[0] == 3 && i >= 2 && !src[-1] && !src[-2] && i < size-1 && src[1] < 4) {
435  dst[dsize++] = src[1];
436  src++;
437  i++;
438  } else
439  dst[dsize++] = *src;
440  }
441  return dsize;
442 }
443 
452 
454 
458 
463 
464 #endif /* AVCODEC_VC1_H */
int color_prim
8bits, chroma coordinates of the color primaries
Definition: vc1.h:215
in the bitstream is reported as 00b
Definition: vc1.h:173
int topleft_blk_idx
Definition: vc1.h:393
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:397
int p_frame_skipped
Definition: vc1.h:388
The VC1 Context.
Definition: vc1.h:182
int size
This structure describes decoded (raw) audio or video data.
Definition: frame.h:135
uint8_t lumscale2
for interlaced field P picture
Definition: vc1.h:346
int k_x
Number of bits for MVs (depends on MV range)
Definition: vc1.h:243
int reffield
if numref = 0 (1 reference) then reffield decides which
Definition: vc1.h:366
uint8_t * mv_f_base
Definition: vc1.h:358
#define av_always_inline
Definition: attributes.h:40
int mv_type_is_raw
mv type mb plane is not coded
Definition: vc1.h:297
Explicitly specified at frame level.
Definition: vc1.h:63
uint8_t dmvrange
Frame decoding info for interlaced picture.
Definition: vc1.h:343
int tt_index
Index for Transform Type tables (to decode TTMB)
Definition: vc1.h:293
int extended_mv
Ext MV in P/B (not in Simple)
Definition: vc1.h:231
CodingSet
Definition: vc1.h:147
int broadcast
TFF/RFF present.
Definition: vc1.h:209
int next_use_ic
Definition: vc1.h:305
int transfer_char
8bits, Opto-electronic transfer characteristics
Definition: vc1.h:216
uint8_t rangeredfrm
Frame decoding info for S/M profiles only.
Definition: vc1.h:310
uint16_t bottomrighty
Definition: vc1.h:323
int frfd
Definition: vc1.h:375
uint8_t zz_8x8[4][64]
Zigzag table for TT_8x8, permuted for IDCT.
Definition: vc1.h:247
mpegvideo header.
int top_blk_idx
Definition: vc1.h:393
IntraX8Context x8
Definition: vc1.h:184
int intcompfield
which of the two fields to be intensity compensated
Definition: vc1.h:368
VLC * imv_vlc
Definition: vc1.h:349
uint8_t dqprofile
Definition: vc1.h:254
uint8_t * mb_type_base
Definition: vc1.h:272
uint8_t * mv_f[2]
0: MV obtained from same field, 1: opposite field
Definition: vc1.h:358
int sprite_height
Definition: vc1.h:384
MVModes
MV modes for P frames.
Definition: vc1.h:102
int last_use_ic
Definition: vc1.h:305
int fastuvmc
Rounding of qpel vector to hpel ? (not in Simple)
Definition: vc1.h:230
int end_mb_x
Horizontal macroblock limit (used only by mss2)
Definition: vc1.h:401
int frmrtq_postproc
3bits,
Definition: vc1.h:228
uint8_t rff
Definition: vc1.h:319
uint8_t numpanscanwin
Definition: vc1.h:317
int hrd_param_flag
Presence of Hypothetical Reference Decoder parameters.
Definition: vc1.h:218
uint8_t lumshift2
Definition: vc1.h:347
int bits
Definition: vc1.h:188
int range_x
Definition: vc1.h:245
uint8_t dqsbedge
Definition: vc1.h:255
int refdist
distance of the current picture from reference
Definition: vc1.h:363
uint8_t * acpred_plane
AC prediction flags bitplane.
Definition: vc1.h:329
int res_transtab
reserved, always 0
Definition: vc1.h:197
int bi_type
Definition: vc1.h:389
int matrix_coef
8bits, Color primaries->YCbCr transform matrix
Definition: vc1.h:217
uint8_t
int first_pic_header_flag
Definition: vc1.h:376
uint16_t * hrd_rate
Definition: vc1.h:334
TransformTypes
Definition: vc1.h:135
int panscanflag
NUMPANSCANWIN, TOPLEFT{X,Y}, BOTRIGHT{X,Y} present.
Definition: vc1.h:212
int left_blk_idx
Definition: vc1.h:393
int interlace
Progressive/interlaced (RPTFTM syntax element)
Definition: vc1.h:210
int y_ac_table_index
Luma index from AC2FRM element.
Definition: vc1.h:263
int second_field
Definition: vc1.h:362
int n_allocated_blks
Definition: vc1.h:393
int c_ac_table_index
AC coding set indexes.
Definition: vc1.h:262
int ttfrm
Transform type info present at frame level.
Definition: vc1.h:265
int codingset2
index of current table set from 11.8 to use for chroma block decoding
Definition: vc1.h:269
uint8_t aux_luty[2][256]
Definition: vc1.h:302
DQSingleEdge
Definition: vc1.h:82
int16_t bfraction
Relative position % anchors=> how to scale MVs.
Definition: vc1.h:280
uint16_t toplefty
Definition: vc1.h:321
int profile
Sequence header data for all Profiles TODO: choose between ints, uint8_ts and monobit flags...
Definition: vc1.h:227
int refdist_flag
REFDIST syntax element present in II, IP, PI or PP field picture headers.
Definition: vc1.h:213
uint8_t * forward_mb_plane
bitplane for "forward" MBs
Definition: vc1.h:296
uint8_t last_luty[2][256]
Definition: vc1.h:301
FrameCodingMode
FCM Frame Coding Mode.
Definition: vc1.h:172
int fieldtx_is_raw
Definition: vc1.h:355
Non-uniform quant used for all frames.
Definition: vc1.h:64
int ff_vc1_decode_entry_point(AVCodecContext *avctx, VC1Context *v, GetBitContext *gb)
Definition: vc1.c:526
uint8_t * over_flags_plane
Overflags bitplane.
Definition: vc1.h:331
uint8_t dqbilevel
Definition: vc1.h:256
uint8_t fourmvbp
Definition: vc1.h:353
int ff_vc1_decode_end(AVCodecContext *avctx)
Close a VC1/WMV3 decoder.
Definition: vc1dec.c:5741
int range_y
MV range.
Definition: vc1.h:245
uint8_t last_lutuv[2][256]
lookup tables used for intensity compensation
Definition: vc1.h:301
int psf
Progressive Segmented Frame.
Definition: vc1.h:220
uint8_t ttmbf
Transform type flag.
Definition: vc1.h:266
Definition: vc1.h:143
int k_y
Number of bits for MVs (depends on MV range)
Definition: vc1.h:244
Implicitly specified at frame level.
Definition: vc1.h:62
uint8_t twomvbp
Definition: vc1.h:352
int dmb_is_raw
direct mb plane is raw
Definition: vc1.h:298
int16_t(* block)[6][64]
Definition: vc1.h:392
int res_y411
reserved, old interlaced mode
Definition: vc1.h:193
int overlap
overlapped transforms in use
Definition: vc1.h:234
in the bitstream is reported as 11b
Definition: vc1.h:175
int res_x8
reserved
Definition: vc1.h:194
uint8_t * hrd_fullness
Definition: vc1.h:335
int qs_last
if qpel has been used in the previous (tr.) picture
Definition: vc1.h:373
uint8_t * mv_f_next_base
Definition: vc1.h:359
TODO: WMV9 specific.
Definition: vc1.h:54
VLC * mbmode_vlc
Definition: vc1.h:348
int ff_vc1_init_common(VC1Context *v)
Init VC-1 specific tables and VC1Context members.
Definition: vc1.c:1568
void ff_vc1_decode_blocks(VC1Context *v)
Definition: vc1dec.c:5205
int resync_marker
could this stream contain resync markers
Definition: vc1.h:404
Libavcodec external API header.
uint8_t broken_link
Broken link flag (BROKEN_LINK syntax element)
Definition: vc1.h:398
const uint8_t * zz_8x4
Zigzag scan table for TT_8x4 coding mode.
Definition: vc1.h:249
int postprocflag
Per-frame processing suggestion flag present.
Definition: vc1.h:208
int res_rtm_flag
reserved, set to 1
Definition: vc1.h:200
Definition: get_bits.h:64
int a_avail
Definition: vc1.h:271
uint8_t * blk_mv_type
0: frame MV, 1: field MV (interlaced frame)
Definition: vc1.h:357
int cur_field_type
0: top, 1: bottom
Definition: vc1.h:370
VLC * twomvbp_vlc
Definition: vc1.h:350
const uint8_t * zz_4x8
Zigzag scan table for TT_4x8 coding mode.
Definition: vc1.h:250
uint8_t buffer_size_exponent
Definition: vc1.h:328
int x8_type
Definition: vc1.h:390
uint8_t * blk_mv_type_base
Definition: vc1.h:357
int tfcntrflag
TFCNTR present.
Definition: vc1.h:211
int field_mode
1 for interlaced field pictures
Definition: vc1.h:360
COTypes
Definition: vc1.h:160
int8_t zzi_8x8[64]
Definition: vc1.h:356
uint8_t mv_mode
Frame decoding info for all profiles.
Definition: vc1.h:241
Profile
Available Profiles.
Definition: vc1.h:51
int fourmvswitch
Definition: vc1.h:344
int mb_off
Definition: vc1.h:372
#define IS_MARKER(x)
Definition: vc1.h:47
MBModesIntfr
MBMODE for interlaced frame P-picture.
Definition: vc1.h:113
int ff_vc1_parse_frame_header_adv(VC1Context *v, GetBitContext *gb)
Definition: vc1.c:839
uint8_t lumscale
Luma compensation parameters.
Definition: vc1.h:277
uint8_t range_mapuv_flag
Definition: vc1.h:337
uint8_t closed_entry
Closed entry point flag (CLOSED_ENTRY syntax element)
Definition: vc1.h:399
DQProfile
Where quant can be changed.
Definition: vc1.h:71
int intcomp
Definition: vc1.h:345
uint32_t * cbp
Definition: vc1.h:394
int left_blk_sh
Definition: vc1.h:248
int16_t(* luma_mv_base)[2]
Definition: vc1.h:396
uint8_t * fieldtx_plane
Definition: vc1.h:354
int * ttblk_base
Definition: vc1.h:267
VLC * cbpcy_vlc
CBPCY VLC table.
Definition: vc1.h:292
uint8_t * sr_rows[2][2]
Sprite resizer line cache.
Definition: vc1.h:385
uint8_t aux_lutuv[2][256]
lookup tables used for intensity compensation
Definition: vc1.h:302
int rangered
RANGEREDFRM (range reduction) syntax element present at frame level.
Definition: vc1.h:198
int finterpflag
INTERPFRM present.
Definition: vc1.h:236
int chromaformat
2bits, 2=4:2:0, only defined
Definition: vc1.h:207
int res_sprite
Simple/Main Profile sequence header.
Definition: vc1.h:192
int top_blk_sh
Either 3 or 0, positions of l/t in blk[].
Definition: vc1.h:248
int c_avail
Definition: vc1.h:271
int multires
frame-level RESPIC syntax element present
Definition: vc1.h:195
uint32_t * cbp_base
Definition: vc1.h:394
main external API structure.
Definition: avcodec.h:1050
uint8_t * is_intra
Definition: vc1.h:395
uint8_t range_mapy
Definition: vc1.h:338
int curr_use_ic
Definition: vc1.h:305
int extended_dmv
Additional extended dmv range at P/B frame-level.
Definition: vc1.h:214
int sprite_width
Definition: vc1.h:384
int fmb_is_raw
forward mb plane is raw
Definition: vc1.h:299
QuantMode
Sequence quantizer mode.
Definition: vc1.h:61
uint8_t * is_intra_base
Definition: vc1.h:395
int fptype
Definition: vc1.h:361
Definition: vc1.h:139
int buffer_fullness
HRD info.
Definition: vc1.h:283
int reserved
reserved
Definition: vc1.h:201
int aux_use_ic
Definition: vc1.h:305
uint8_t respic
Frame-level flag for resized images.
Definition: vc1.h:282
int skip_is_raw
skip mb plane is not coded
Definition: vc1.h:300
uint16_t bottomrightx
Definition: vc1.h:322
int quantizer_mode
2bits, quantizer mode used for sequence, see QUANT_*
Definition: vc1.h:235
uint8_t next_lutuv[2][256]
lookup tables used for intensity compensation
Definition: vc1.h:303
int ref_field_type[2]
forward and backward reference field type (top or bottom)
Definition: vc1.h:371
uint8_t * direct_mb_plane
bitplane for "direct" MBs
Definition: vc1.h:295
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:290
uint8_t * mv_type_mb_plane
bitplane for mv_type == (4MV)
Definition: vc1.h:294
int vstransform
variable-size [48]x[48] transform type + info
Definition: vc1.h:233
int numref
number of past field pictures used as reference
Definition: vc1.h:364
int blocks_off
Definition: vc1.h:372
DQDoubleEdge
Which pair of edges is quantized with ALTPQUANT.
Definition: vc1.h:92
uint8_t range_mapuv
Definition: vc1.h:339
uint8_t tff
Definition: vc1.h:319
MpegEncContext s
Definition: vc1.h:183
in the bitstream is reported as 10b
Definition: vc1.h:174
MpegEncContext.
Definition: mpegvideo.h:204
void ff_vc1_init_transposed_scantables(VC1Context *v)
Definition: vc1dec.c:5590
int cur_blk_idx
Definition: vc1.h:393
uint8_t pq
Definition: vc1.h:246
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:270
int hrd_num_leaky_buckets
Definition: vc1.h:326
int output_width
Definition: vc1.h:384
enum FrameCodingMode fcm
Frame decoding info for Advanced profile.
Definition: vc1.h:316
Uniform quant used for all frames.
Definition: vc1.h:65
uint8_t dquantfrm
pquant parameters
Definition: vc1.h:253
uint8_t lumshift
Definition: vc1.h:278
uint8_t next_luty[2][256]
Definition: vc1.h:303
BMVTypes
Definition: vc1.h:125
int res_fasttx
reserved, always 1
Definition: vc1.h:196
int pic_header_flag
Definition: vc1.h:377
int * ttblk
Transform type at the block level.
Definition: vc1.h:267
uint8_t bit_rate_exponent
Definition: vc1.h:327
uint8_t postproc
Definition: vc1.h:325
uint8_t condover
Definition: vc1.h:333
uint8_t uvsamp
Definition: vc1.h:324
uint8_t pquantizer
Uniform (over sequence) quantizer in use.
Definition: vc1.h:291
int rnd
rounding control
Definition: vc1.h:306
Definition: vc1.h:142
AVFrame * sprite_output_frame
Definition: vc1.h:383
int acpred_is_raw
Definition: vc1.h:330
uint8_t rptfrm
Definition: vc1.h:319
uint8_t(* curr_luty)[256]
Definition: vc1.h:304
int bmvtype
Definition: vc1.h:374
int bitrtq_postproc
5bits, quantized framerate-based postprocessing strength
Definition: vc1.h:229
int parse_only
Context is used within parser.
Definition: vc1.h:403
H264ChromaContext h264chroma
Definition: vc1.h:185
int overflg_is_raw
Definition: vc1.h:332
static av_always_inline int vc1_unescape_buffer(const uint8_t *src, int size, uint8_t *dst)
Definition: vc1.h:424
uint8_t interpfrm
Definition: vc1.h:311
Definition: vc1.h:136
int ff_vc1_decode_init_alloc_tables(VC1Context *v)
Definition: vc1dec.c:5515
int level
Advanced Profile.
Definition: vc1.h:206
uint8_t range_mapy_flag
Definition: vc1.h:336
uint8_t tfcntr
Definition: vc1.h:318
int brfd
reference frame distance (forward or backward)
Definition: vc1.h:375
int dquant
How qscale varies with MBs, 2bits (not in Simple)
Definition: vc1.h:232
uint8_t mv_mode2
Secondary MV coding mode (B frames)
Definition: vc1.h:242
int new_sprite
Frame decoding info for sprite modes.
Definition: vc1.h:381
uint8_t * mv_f_next[2]
Definition: vc1.h:359
int ff_vc1_parse_frame_header(VC1Context *v, GetBitContext *gb)
Definition: vc1.c:624
int two_sprites
Definition: vc1.h:382
int codingset
index of current table set from 11.8 to use for luma block decoding
Definition: vc1.h:268
VC1Code
Markers used in VC-1 AP frame data.
Definition: vc1.h:36
uint8_t * mb_type[3]
Definition: vc1.h:272
uint16_t * hrd_buffer
Definition: vc1.h:334
VLC * fourmvbp_vlc
Definition: vc1.h:351
uint8_t halfpq
Uniform quant over image and qp+.5.
Definition: vc1.h:281
VC1DSPContext vc1dsp
Definition: vc1.h:186
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:410
int output_height
Definition: vc1.h:384
uint16_t topleftx
Definition: vc1.h:320
uint8_t altpq
Current/alternate frame quantizer scale.
Definition: vc1.h:246