FFmpeg
rv30.c
Go to the documentation of this file.
1 /*
2  * RV30 decoder
3  * Copyright (c) 2007 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 decoder
25  */
26 
27 #include "avcodec.h"
28 #include "mpegutils.h"
29 #include "mpegvideo.h"
30 #include "golomb.h"
31 
32 #include "rv34.h"
33 #include "rv30data.h"
34 
35 
37 {
38  AVCodecContext *avctx = r->s.avctx;
39  int mb_bits;
40  int w = r->s.width, h = r->s.height;
41  int mb_size;
42  int rpr;
43 
44  memset(si, 0, sizeof(SliceInfo));
45  if(get_bits(gb, 3))
46  return -1;
47  si->type = get_bits(gb, 2);
48  if(si->type == 1) si->type = 0;
49  if(get_bits1(gb))
50  return -1;
51  si->quant = get_bits(gb, 5);
52  skip_bits1(gb);
53  si->pts = get_bits(gb, 13);
54  rpr = get_bits(gb, av_log2(r->max_rpr) + 1);
55  if(rpr){
56  if (rpr > r->max_rpr) {
57  av_log(avctx, AV_LOG_ERROR, "rpr too large\n");
58  return AVERROR_INVALIDDATA;
59  }
60 
61  if (avctx->extradata_size < rpr * 2 + 8) {
62  av_log(avctx, AV_LOG_ERROR,
63  "Insufficient extradata - need at least %d bytes, got %d\n",
64  8 + rpr * 2, avctx->extradata_size);
65  return AVERROR(EINVAL);
66  }
67 
68  w = r->s.avctx->extradata[6 + rpr*2] << 2;
69  h = r->s.avctx->extradata[7 + rpr*2] << 2;
70  } else {
71  w = r->orig_width;
72  h = r->orig_height;
73  }
74  si->width = w;
75  si->height = h;
76  mb_size = ((w + 15) >> 4) * ((h + 15) >> 4);
77  mb_bits = ff_rv34_get_start_offset(gb, mb_size);
78  si->start = get_bits(gb, mb_bits);
79  skip_bits1(gb);
80  return 0;
81 }
82 
83 /**
84  * Decode 4x4 intra types array.
85  */
86 static int rv30_decode_intra_types(RV34DecContext *r, GetBitContext *gb, int8_t *dst)
87 {
88  int i, j, k;
89 
90  for(i = 0; i < 4; i++, dst += r->intra_types_stride - 4){
91  for(j = 0; j < 4; j+= 2){
92  unsigned code = get_interleaved_ue_golomb(gb) << 1;
93  if (code > 80U*2U) {
94  av_log(r->s.avctx, AV_LOG_ERROR, "Incorrect intra prediction code\n");
95  return -1;
96  }
97  for(k = 0; k < 2; k++){
98  int A = dst[-r->intra_types_stride] + 1;
99  int B = dst[-1] + 1;
100  *dst++ = rv30_itype_from_context[A * 90 + B * 9 + rv30_itype_code[code + k]];
101  if(dst[-1] == 9){
102  av_log(r->s.avctx, AV_LOG_ERROR, "Incorrect intra prediction mode\n");
103  return -1;
104  }
105  }
106  }
107  }
108  return 0;
109 }
110 
111 /**
112  * Decode macroblock information.
113  */
115 {
116  static const int rv30_p_types[6] = { RV34_MB_SKIP, RV34_MB_P_16x16, RV34_MB_P_8x8, -1, RV34_MB_TYPE_INTRA, RV34_MB_TYPE_INTRA16x16 };
117  static const int rv30_b_types[6] = { RV34_MB_SKIP, RV34_MB_B_DIRECT, RV34_MB_B_FORWARD, RV34_MB_B_BACKWARD, RV34_MB_TYPE_INTRA, RV34_MB_TYPE_INTRA16x16 };
118  MpegEncContext *s = &r->s;
119  GetBitContext *gb = &s->gb;
120  unsigned code = get_interleaved_ue_golomb(gb);
121 
122  if (code > 11) {
123  av_log(s->avctx, AV_LOG_ERROR, "Incorrect MB type code\n");
124  return -1;
125  }
126  if(code > 5){
127  av_log(s->avctx, AV_LOG_ERROR, "dquant needed\n");
128  code -= 6;
129  }
130  if(s->pict_type != AV_PICTURE_TYPE_B)
131  return rv30_p_types[code];
132  else
133  return rv30_b_types[code];
134 }
135 
136 static inline void rv30_weak_loop_filter(uint8_t *src, const int step,
137  const int stride, const int lim)
138 {
139  const uint8_t *cm = ff_crop_tab + MAX_NEG_CROP;
140  int i, diff;
141 
142  for(i = 0; i < 4; i++){
143  diff = ((src[-2*step] - src[1*step]) - (src[-1*step] - src[0*step])*4) >> 3;
144  diff = av_clip(diff, -lim, lim);
145  src[-1*step] = cm[src[-1*step] + diff];
146  src[ 0*step] = cm[src[ 0*step] - diff];
147  src += stride;
148  }
149 }
150 
151 static void rv30_loop_filter(RV34DecContext *r, int row)
152 {
153  MpegEncContext *s = &r->s;
154  int mb_pos, mb_x;
155  int i, j, k;
156  uint8_t *Y, *C;
157  int loc_lim, cur_lim, left_lim = 0, top_lim = 0;
158 
159  mb_pos = row * s->mb_stride;
160  for(mb_x = 0; mb_x < s->mb_width; mb_x++, mb_pos++){
161  int mbtype = s->current_picture_ptr->mb_type[mb_pos];
162  if(IS_INTRA(mbtype) || IS_SEPARATE_DC(mbtype))
163  r->deblock_coefs[mb_pos] = 0xFFFF;
164  if(IS_INTRA(mbtype))
165  r->cbp_chroma[mb_pos] = 0xFF;
166  }
167 
168  /* all vertical edges are filtered first
169  * and horizontal edges are filtered on the next iteration
170  */
171  mb_pos = row * s->mb_stride;
172  for(mb_x = 0; mb_x < s->mb_width; mb_x++, mb_pos++){
173  cur_lim = rv30_loop_filt_lim[s->current_picture_ptr->qscale_table[mb_pos]];
174  if(mb_x)
175  left_lim = rv30_loop_filt_lim[s->current_picture_ptr->qscale_table[mb_pos - 1]];
176  for(j = 0; j < 16; j += 4){
177  Y = s->current_picture_ptr->f->data[0] + mb_x*16 + (row*16 + j) * s->linesize + 4 * !mb_x;
178  for(i = !mb_x; i < 4; i++, Y += 4){
179  int ij = i + j;
180  loc_lim = 0;
181  if(r->deblock_coefs[mb_pos] & (1 << ij))
182  loc_lim = cur_lim;
183  else if(!i && r->deblock_coefs[mb_pos - 1] & (1 << (ij + 3)))
184  loc_lim = left_lim;
185  else if( i && r->deblock_coefs[mb_pos] & (1 << (ij - 1)))
186  loc_lim = cur_lim;
187  if(loc_lim)
188  rv30_weak_loop_filter(Y, 1, s->linesize, loc_lim);
189  }
190  }
191  for(k = 0; k < 2; k++){
192  int cur_cbp, left_cbp = 0;
193  cur_cbp = (r->cbp_chroma[mb_pos] >> (k*4)) & 0xF;
194  if(mb_x)
195  left_cbp = (r->cbp_chroma[mb_pos - 1] >> (k*4)) & 0xF;
196  for(j = 0; j < 8; j += 4){
197  C = s->current_picture_ptr->f->data[k + 1] + mb_x*8 + (row*8 + j) * s->uvlinesize + 4 * !mb_x;
198  for(i = !mb_x; i < 2; i++, C += 4){
199  int ij = i + (j >> 1);
200  loc_lim = 0;
201  if (cur_cbp & (1 << ij))
202  loc_lim = cur_lim;
203  else if(!i && left_cbp & (1 << (ij + 1)))
204  loc_lim = left_lim;
205  else if( i && cur_cbp & (1 << (ij - 1)))
206  loc_lim = cur_lim;
207  if(loc_lim)
208  rv30_weak_loop_filter(C, 1, s->uvlinesize, loc_lim);
209  }
210  }
211  }
212  }
213  mb_pos = row * s->mb_stride;
214  for(mb_x = 0; mb_x < s->mb_width; mb_x++, mb_pos++){
215  cur_lim = rv30_loop_filt_lim[s->current_picture_ptr->qscale_table[mb_pos]];
216  if(row)
217  top_lim = rv30_loop_filt_lim[s->current_picture_ptr->qscale_table[mb_pos - s->mb_stride]];
218  for(j = 4*!row; j < 16; j += 4){
219  Y = s->current_picture_ptr->f->data[0] + mb_x*16 + (row*16 + j) * s->linesize;
220  for(i = 0; i < 4; i++, Y += 4){
221  int ij = i + j;
222  loc_lim = 0;
223  if(r->deblock_coefs[mb_pos] & (1 << ij))
224  loc_lim = cur_lim;
225  else if(!j && r->deblock_coefs[mb_pos - s->mb_stride] & (1 << (ij + 12)))
226  loc_lim = top_lim;
227  else if( j && r->deblock_coefs[mb_pos] & (1 << (ij - 4)))
228  loc_lim = cur_lim;
229  if(loc_lim)
230  rv30_weak_loop_filter(Y, s->linesize, 1, loc_lim);
231  }
232  }
233  for(k = 0; k < 2; k++){
234  int cur_cbp, top_cbp = 0;
235  cur_cbp = (r->cbp_chroma[mb_pos] >> (k*4)) & 0xF;
236  if(row)
237  top_cbp = (r->cbp_chroma[mb_pos - s->mb_stride] >> (k*4)) & 0xF;
238  for(j = 4*!row; j < 8; j += 4){
239  C = s->current_picture_ptr->f->data[k+1] + mb_x*8 + (row*8 + j) * s->uvlinesize;
240  for(i = 0; i < 2; i++, C += 4){
241  int ij = i + (j >> 1);
242  loc_lim = 0;
243  if (r->cbp_chroma[mb_pos] & (1 << ij))
244  loc_lim = cur_lim;
245  else if(!j && top_cbp & (1 << (ij + 2)))
246  loc_lim = top_lim;
247  else if( j && cur_cbp & (1 << (ij - 2)))
248  loc_lim = cur_lim;
249  if(loc_lim)
250  rv30_weak_loop_filter(C, s->uvlinesize, 1, loc_lim);
251  }
252  }
253  }
254  }
255 }
256 
257 /**
258  * Initialize decoder.
259  */
261 {
262  RV34DecContext *r = avctx->priv_data;
263  int ret;
264 
265  r->orig_width = avctx->coded_width;
266  r->orig_height = avctx->coded_height;
267 
268  if (avctx->extradata_size < 2) {
269  av_log(avctx, AV_LOG_ERROR, "Extradata is too small.\n");
270  return AVERROR(EINVAL);
271  }
272  r->rv30 = 1;
273  if ((ret = ff_rv34_decode_init(avctx)) < 0)
274  return ret;
275 
276  r->max_rpr = avctx->extradata[1] & 7;
277  if(avctx->extradata_size < 2*r->max_rpr + 8){
278  av_log(avctx, AV_LOG_WARNING, "Insufficient extradata - need at least %d bytes, got %d\n",
279  2*r->max_rpr + 8, avctx->extradata_size);
280  }
281 
288  return 0;
289 }
290 
292  .name = "rv30",
293  .long_name = NULL_IF_CONFIG_SMALL("RealVideo 3.0"),
294  .type = AVMEDIA_TYPE_VIDEO,
295  .id = AV_CODEC_ID_RV30,
296  .priv_data_size = sizeof(RV34DecContext),
298  .close = ff_rv34_decode_end,
300  .capabilities = AV_CODEC_CAP_DR1 | AV_CODEC_CAP_DELAY |
302  .flush = ff_mpeg_flush,
303  .pix_fmts = (const enum AVPixelFormat[]) {
306  },
309 };
static const uint8_t rv30_luma_dc_quant[32]
DC quantizer mapping for RV30.
Definition: rv30data.h:33
int orig_width
Definition: rv34.h:112
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
static void flush(AVCodecContext *avctx)
int coded_width
Bitstream width / height, may be different from width/height e.g.
Definition: avcodec.h:1753
#define IS_SEPARATE_DC(a)
Definition: rv34.h:37
static unsigned int get_bits(GetBitContext *s, int n)
Read 1-25 bits.
Definition: get_bits.h:379
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:182
B-frame macroblock, forward prediction.
Definition: rv34.h:47
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
MpegEncContext s
Definition: rv34.h:85
static const uint8_t rv30_loop_filt_lim[32]
Loop filter limits are taken from this table.
Definition: rv30data.h:178
int height
coded height
Definition: rv34.h:79
Bidirectionally predicted B-frame macroblock, no motion vectors.
Definition: rv34.h:50
int av_log2(unsigned v)
Definition: intmath.c:26
#define MAX_NEG_CROP
Definition: mathops.h:31
AVCodec ff_rv30_decoder
Definition: rv30.c:291
mpegvideo header.
static av_cold int rv30_decode_init(AVCodecContext *avctx)
Initialize decoder.
Definition: rv30.c:260
RV30 and RV40 decoder common data declarations.
#define src
Definition: vp8dsp.c:254
int start
Definition: rv34.h:77
AVCodec.
Definition: avcodec.h:3477
const uint8_t * luma_dc_quant_p
luma subblock DC quantizer for interframes
Definition: rv34.h:91
static void decode(AVCodecContext *dec_ctx, AVPacket *pkt, AVFrame *frame, FILE *outfile)
Definition: decode_audio.c:42
static int rv30_decode_intra_types(RV34DecContext *r, GetBitContext *gb, int8_t *dst)
Decode 4x4 intra types array.
Definition: rv30.c:86
#define AV_CODEC_CAP_DELAY
Encoder or decoder requires flushing with NULL input at the end in order to give the complete and cor...
Definition: avcodec.h:1006
uint8_t
#define av_cold
Definition: attributes.h:82
int width
coded width
Definition: rv34.h:78
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:1666
uint16_t * deblock_coefs
deblock coefficients for each macroblock
Definition: rv34.h:116
int max_rpr
Definition: rv34.h:105
static int rv30_decode_mb_info(RV34DecContext *r)
Decode macroblock information.
Definition: rv30.c:114
Skipped block.
Definition: rv34.h:49
#define A(x)
Definition: vp56_arith.h:28
#define av_log(a,...)
#define cm
Definition: dvbsubdec.c:37
#define U(x)
Definition: vp56_arith.h:37
int quant
quantizer used for this slice
Definition: rv34.h:75
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:260
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
static const uint8_t rv30_itype_from_context[900]
This table is used for retrieving the current intra type based on its neighbors and adjustment provid...
Definition: rv30data.h:63
#define B
Definition: huffyuvdsp.h:32
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:186
const char * r
Definition: vf_curves.c:114
const char * name
Name of the codec implementation.
Definition: avcodec.h:3484
GetBitContext gb
Definition: mpegvideo.h:448
#define AV_CODEC_CAP_FRAME_THREADS
Codec supports frame-level multithreading.
Definition: avcodec.h:1037
void ff_mpeg_flush(AVCodecContext *avctx)
Definition: mpegvideo.c:2307
#define ONLY_IF_THREADS_ENABLED(x)
Define a function with only the non-default version specified.
Definition: internal.h:225
int(* parse_slice_header)(struct RV34DecContext *r, GetBitContext *gb, SliceInfo *si)
Definition: rv34.h:126
Intra macroblock with DCs in a separate 4x4 block.
Definition: rv34.h:44
#define Y
Definition: boxblur.h:38
int orig_height
Definition: rv34.h:112
uint8_t w
Definition: llviddspenc.c:38
Picture * current_picture_ptr
pointer to the current picture
Definition: mpegvideo.h:184
#define s(width, name)
Definition: cbs_vp9.c:257
static const uint8_t rv30_itype_code[9 *9 *2]
This table is used for storing the differences between the predicted and the real intra type...
Definition: rv30data.h:42
s EdgeDetect Foobar g libavfilter vf_edgedetect c libavfilter vf_foobar c edit libavfilter and add an entry for foobar following the pattern of the other filters edit libavfilter allfilters and add an entry for foobar following the pattern of the other filters configure make j< whatever > ffmpeg ffmpeg i you should get a foobar png with Lena edge detected That s your new playground is ready Some little details about what s going which in turn will define variables for the build system and the C
int(* decode_mb_info)(struct RV34DecContext *r)
Definition: rv34.h:127
int ff_rv34_decode_init_thread_copy(AVCodecContext *avctx)
Definition: rv34.c:1534
essential slice information
Definition: rv34.h:73
Libavcodec external API header.
static void rv30_loop_filter(RV34DecContext *r, int row)
Definition: rv30.c:151
ptrdiff_t linesize
line size, in bytes, may be different from width
Definition: mpegvideo.h:134
main external API structure.
Definition: avcodec.h:1565
int height
picture size. must be a multiple of 16
Definition: mpegvideo.h:100
static void rv30_weak_loop_filter(uint8_t *src, const int step, const int stride, const int lim)
Definition: rv30.c:136
int extradata_size
Definition: avcodec.h:1667
P-frame macroblock, 8x8 motion compensation partitions.
Definition: rv34.h:46
static unsigned int get_bits1(GetBitContext *s)
Definition: get_bits.h:498
static void skip_bits1(GetBitContext *s)
Definition: get_bits.h:538
int coded_height
Definition: avcodec.h:1753
struct AVFrame * f
Definition: mpegpicture.h:46
av_cold int ff_rv34_decode_init(AVCodecContext *avctx)
Initialize decoder.
Definition: rv34.c:1492
ptrdiff_t uvlinesize
line size, for chroma in bytes, may be different from width
Definition: mpegvideo.h:135
int ff_rv34_decode_frame(AVCodecContext *avctx, void *data, int *got_picture_ptr, AVPacket *avpkt)
Definition: rv34.c:1643
int intra_types_stride
block types array stride
Definition: rv34.h:89
int pict_type
AV_PICTURE_TYPE_I, AV_PICTURE_TYPE_P, AV_PICTURE_TYPE_B, ...
Definition: mpegvideo.h:212
static enum AVPixelFormat pix_fmts[]
Definition: libkvazaar.c:275
int(* decode_intra_types)(struct RV34DecContext *r, GetBitContext *gb, int8_t *dst)
Definition: rv34.h:128
and forward the test the status of outputs and forward it to the corresponding return FFERROR_NOT_READY If the filters stores internally one or a few frame for some it can consider them to be part of the FIFO and delay acknowledging a status change accordingly Example code
P-frame macroblock, one motion frame.
Definition: rv34.h:45
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:282
MpegEncContext.
Definition: mpegvideo.h:81
av_cold int ff_rv34_decode_end(AVCodecContext *avctx)
Definition: rv34.c:1849
int8_t * qscale_table
Definition: mpegpicture.h:50
struct AVCodecContext * avctx
Definition: mpegvideo.h:98
GLint GLenum GLboolean GLsizei stride
Definition: opengl_enc.c:104
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:66
int mb_stride
mb_width+1 used for some arrays to allow simple addressing of left & top MBs without sig11 ...
Definition: mpegvideo.h:130
B-frame macroblock, backward prediction.
Definition: rv34.h:48
int ff_rv34_decode_update_thread_context(AVCodecContext *dst, const AVCodecContext *src)
Definition: rv34.c:1562
Bi-dir predicted.
Definition: avutil.h:276
#define ff_crop_tab
int ff_rv34_get_start_offset(GetBitContext *gb, int mb_size)
Decode starting slice position.
Definition: rv34.c:330
#define IS_INTRA(x, y)
decoder context
Definition: rv34.h:84
void * priv_data
Definition: avcodec.h:1592
static av_always_inline int diff(const uint32_t a, const uint32_t b)
static int rv30_parse_slice_header(RV34DecContext *r, GetBitContext *gb, SliceInfo *si)
Definition: rv30.c:36
const uint8_t * luma_dc_quant_i
luma subblock DC quantizer for intraframes
Definition: rv34.h:90
uint32_t * mb_type
types and macros are defined in mpegutils.h
Definition: mpegpicture.h:56
int type
slice type (intra, inter)
Definition: rv34.h:74
static unsigned get_interleaved_ue_golomb(GetBitContext *gb)
Definition: golomb.h:141
#define stride
miscellaneous RV30 tables
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later.That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another.Frame references ownership and permissions
int rv30
indicates which RV variant is currently decoded
Definition: rv34.h:104
exp golomb vlc stuff
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
Intra macroblock.
Definition: rv34.h:43
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() for allocating buffers and supports custom allocators.
Definition: avcodec.h:981
void(* loop_filter)(struct RV34DecContext *r, int row)
Definition: rv34.h:129
int pts
frame timestamp
Definition: rv34.h:80
trying all byte sequences megabyte in length and selecting the best looking sequence will yield cases to try But a word about which is also called distortion Distortion can be quantified by almost any quality measurement one chooses the sum of squared differences is used but more complex methods that consider psychovisual effects can be used as well It makes no difference in this discussion First step
uint8_t * cbp_chroma
CBP values for chroma subblocks.
Definition: rv34.h:115