xref: /third_party/ffmpeg/libavcodec/rv34.h (revision cabdff1a)
1/*
2 * RV30/40 decoder common data declarations
3 * Copyright (c) 2007 Mike Melanson, Konstantin Shishkov
4 *
5 * This file is part of FFmpeg.
6 *
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21
22/**
23 * @file
24 * RV30 and RV40 decoder common data declarations
25 */
26
27#ifndef AVCODEC_RV34_H
28#define AVCODEC_RV34_H
29
30#include "libavutil/mem_internal.h"
31
32#include "avcodec.h"
33#include "mpegvideo.h"
34
35#include "h264pred.h"
36#include "rv34dsp.h"
37
38#define MB_TYPE_SEPARATE_DC 0x01000000
39#define IS_SEPARATE_DC(a)   ((a) & MB_TYPE_SEPARATE_DC)
40
41/**
42 * RV30 and RV40 Macroblock types
43 */
44enum RV40BlockTypes{
45    RV34_MB_TYPE_INTRA,      ///< Intra macroblock
46    RV34_MB_TYPE_INTRA16x16, ///< Intra macroblock with DCs in a separate 4x4 block
47    RV34_MB_P_16x16,         ///< P-frame macroblock, one motion frame
48    RV34_MB_P_8x8,           ///< P-frame macroblock, 8x8 motion compensation partitions
49    RV34_MB_B_FORWARD,       ///< B-frame macroblock, forward prediction
50    RV34_MB_B_BACKWARD,      ///< B-frame macroblock, backward prediction
51    RV34_MB_SKIP,            ///< Skipped block
52    RV34_MB_B_DIRECT,        ///< Bidirectionally predicted B-frame macroblock, no motion vectors
53    RV34_MB_P_16x8,          ///< P-frame macroblock, 16x8 motion compensation partitions
54    RV34_MB_P_8x16,          ///< P-frame macroblock, 8x16 motion compensation partitions
55    RV34_MB_B_BIDIR,         ///< Bidirectionally predicted B-frame macroblock, two motion vectors
56    RV34_MB_P_MIX16x16,      ///< P-frame macroblock with DCs in a separate 4x4 block, one motion vector
57    RV34_MB_TYPES
58};
59
60/**
61 * VLC tables used by the decoder
62 *
63 * Intra frame VLC sets do not contain some of those tables.
64 */
65typedef struct RV34VLC{
66    VLC cbppattern[2];     ///< VLCs used for pattern of coded block patterns decoding
67    VLC cbp[2][4];         ///< VLCs used for coded block patterns decoding
68    VLC first_pattern[4];  ///< VLCs used for decoding coefficients in the first subblock
69    VLC second_pattern[2]; ///< VLCs used for decoding coefficients in the subblocks 2 and 3
70    VLC third_pattern[2];  ///< VLCs used for decoding coefficients in the last subblock
71    VLC coefficient;       ///< VLCs used for decoding big coefficients
72}RV34VLC;
73
74/** essential slice information */
75typedef struct SliceInfo{
76    int type;              ///< slice type (intra, inter)
77    int quant;             ///< quantizer used for this slice
78    int vlc_set;           ///< VLCs used for this slice
79    int start, end;        ///< start and end macroblocks of the slice
80    int width;             ///< coded width
81    int height;            ///< coded height
82    int pts;               ///< frame timestamp
83}SliceInfo;
84
85/** decoder context */
86typedef struct RV34DecContext{
87    MpegEncContext s;
88    RV34DSPContext rdsp;
89    int8_t *intra_types_hist;///< old block types, used for prediction
90    int8_t *intra_types;     ///< block types
91    int    intra_types_stride;///< block types array stride
92    const uint8_t *luma_dc_quant_i;///< luma subblock DC quantizer for intraframes
93    const uint8_t *luma_dc_quant_p;///< luma subblock DC quantizer for interframes
94
95    RV34VLC *cur_vlcs;       ///< VLC set used for current frame decoding
96    H264PredContext h;       ///< functions for 4x4 and 16x16 intra block prediction
97    SliceInfo si;            ///< current slice information
98
99    int *mb_type;            ///< internal macroblock types
100    int block_type;          ///< current block type
101    int luma_vlc;            ///< which VLC set will be used for decoding of luma blocks
102    int chroma_vlc;          ///< which VLC set will be used for decoding of chroma blocks
103    int is16;                ///< current block has additional 16x16 specific features or not
104    int dmv[4][2];           ///< differential motion vectors for the current macroblock
105
106    int rv30;                ///< indicates which RV variant is currently decoded
107    int max_rpr;
108
109    int cur_pts, last_pts, next_pts;
110    int scaled_weight;
111    int weight1, weight2;    ///< B-frame distance fractions (0.14) used in motion compensation
112    int mv_weight1, mv_weight2;
113
114    int orig_width, orig_height;
115
116    uint16_t *cbp_luma;      ///< CBP values for luma subblocks
117    uint8_t  *cbp_chroma;    ///< CBP values for chroma subblocks
118    uint16_t *deblock_coefs; ///< deblock coefficients for each macroblock
119
120    /** 8x8 block available flags (for MV prediction) */
121    DECLARE_ALIGNED(8, uint32_t, avail_cache)[3*4];
122
123    /** temporary blocks for RV4 weighted MC */
124    uint8_t *tmp_b_block_y[2];
125    uint8_t *tmp_b_block_uv[4];
126    uint8_t *tmp_b_block_base;
127
128    int (*parse_slice_header)(struct RV34DecContext *r, GetBitContext *gb, SliceInfo *si);
129    int (*decode_mb_info)(struct RV34DecContext *r);
130    int (*decode_intra_types)(struct RV34DecContext *r, GetBitContext *gb, int8_t *dst);
131    void (*loop_filter)(struct RV34DecContext *r, int row);
132}RV34DecContext;
133
134/**
135 * common decoding functions
136 */
137int ff_rv34_get_start_offset(GetBitContext *gb, int blocks);
138int ff_rv34_decode_init(AVCodecContext *avctx);
139int ff_rv34_decode_frame(AVCodecContext *avctx, AVFrame *frame,
140                         int *got_frame, AVPacket *avpkt);
141int ff_rv34_decode_end(AVCodecContext *avctx);
142int ff_rv34_decode_update_thread_context(AVCodecContext *dst, const AVCodecContext *src);
143
144#endif /* AVCODEC_RV34_H */
145