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 "codec_internal.h"
29 #include "mpegutils.h"
30 #include "mpegvideo.h"
31 #include "mpegvideodec.h"
32 #include "golomb.h"
33 
34 #include "rv34.h"
35 #include "rv30data.h"
36 
37 
39 {
40  AVCodecContext *avctx = r->s.avctx;
41  int mb_bits;
42  int w = r->s.width, h = r->s.height;
43  int mb_size;
44  int rpr;
45 
46  memset(si, 0, sizeof(SliceInfo));
47  if(get_bits(gb, 3))
48  return -1;
49  si->type = get_bits(gb, 2);
50  if(si->type == 1) si->type = 0;
51  if(get_bits1(gb))
52  return -1;
53  si->quant = get_bits(gb, 5);
54  skip_bits1(gb);
55  si->pts = get_bits(gb, 13);
56  rpr = get_bits(gb, av_log2(r->max_rpr) + 1);
57  if(rpr){
58  if (rpr > r->max_rpr) {
59  av_log(avctx, AV_LOG_ERROR, "rpr too large\n");
60  return AVERROR_INVALIDDATA;
61  }
62 
63  if (avctx->extradata_size < rpr * 2 + 8) {
64  av_log(avctx, AV_LOG_ERROR,
65  "Insufficient extradata - need at least %d bytes, got %d\n",
66  8 + rpr * 2, avctx->extradata_size);
67  return AVERROR(EINVAL);
68  }
69 
70  w = r->s.avctx->extradata[6 + rpr*2] << 2;
71  h = r->s.avctx->extradata[7 + rpr*2] << 2;
72  } else {
73  w = r->orig_width;
74  h = r->orig_height;
75  }
76  si->width = w;
77  si->height = h;
78  mb_size = ((w + 15) >> 4) * ((h + 15) >> 4);
79  mb_bits = ff_rv34_get_start_offset(gb, mb_size);
80  si->start = get_bits(gb, mb_bits);
81  skip_bits1(gb);
82  return 0;
83 }
84 
85 /**
86  * Decode 4x4 intra types array.
87  */
88 static int rv30_decode_intra_types(RV34DecContext *r, GetBitContext *gb, int8_t *dst)
89 {
90  int i, j, k;
91 
92  for(i = 0; i < 4; i++, dst += r->intra_types_stride - 4){
93  for(j = 0; j < 4; j+= 2){
94  unsigned code = get_interleaved_ue_golomb(gb) << 1;
95  if (code > 80U*2U) {
96  av_log(r->s.avctx, AV_LOG_ERROR, "Incorrect intra prediction code\n");
97  return -1;
98  }
99  for(k = 0; k < 2; k++){
100  int A = dst[-r->intra_types_stride] + 1;
101  int B = dst[-1] + 1;
102  *dst++ = rv30_itype_from_context[A * 90 + B * 9 + rv30_itype_code[code + k]];
103  if(dst[-1] == 9){
104  av_log(r->s.avctx, AV_LOG_ERROR, "Incorrect intra prediction mode\n");
105  return -1;
106  }
107  }
108  }
109  }
110  return 0;
111 }
112 
113 /**
114  * Decode macroblock information.
115  */
117 {
118  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 };
120  MpegEncContext *s = &r->s;
121  GetBitContext *gb = &s->gb;
122  unsigned code = get_interleaved_ue_golomb(gb);
123 
124  if (code > 11) {
125  av_log(s->avctx, AV_LOG_ERROR, "Incorrect MB type code\n");
126  return -1;
127  }
128  if(code > 5){
129  av_log(s->avctx, AV_LOG_ERROR, "dquant needed\n");
130  code -= 6;
131  }
132  if(s->pict_type != AV_PICTURE_TYPE_B)
133  return rv30_p_types[code];
134  else
135  return rv30_b_types[code];
136 }
137 
138 static inline void rv30_weak_loop_filter(uint8_t *src, const int step,
139  const int stride, const int lim)
140 {
141  const uint8_t *cm = ff_crop_tab + MAX_NEG_CROP;
142  int i, diff;
143 
144  for(i = 0; i < 4; i++){
145  diff = ((src[-2*step] - src[1*step]) - (src[-1*step] - src[0*step])*4) >> 3;
146  diff = av_clip(diff, -lim, lim);
147  src[-1*step] = cm[src[-1*step] + diff];
148  src[ 0*step] = cm[src[ 0*step] - diff];
149  src += stride;
150  }
151 }
152 
153 static void rv30_loop_filter(RV34DecContext *r, int row)
154 {
155  MpegEncContext *s = &r->s;
156  int mb_pos, mb_x;
157  int i, j, k;
158  uint8_t *Y, *C;
159  int loc_lim, cur_lim, left_lim = 0, top_lim = 0;
160 
161  mb_pos = row * s->mb_stride;
162  for(mb_x = 0; mb_x < s->mb_width; mb_x++, mb_pos++){
163  int mbtype = s->current_picture_ptr->mb_type[mb_pos];
164  if(IS_INTRA(mbtype) || IS_SEPARATE_DC(mbtype))
165  r->deblock_coefs[mb_pos] = 0xFFFF;
166  if(IS_INTRA(mbtype))
167  r->cbp_chroma[mb_pos] = 0xFF;
168  }
169 
170  /* all vertical edges are filtered first
171  * and horizontal edges are filtered on the next iteration
172  */
173  mb_pos = row * s->mb_stride;
174  for(mb_x = 0; mb_x < s->mb_width; mb_x++, mb_pos++){
175  cur_lim = rv30_loop_filt_lim[s->current_picture_ptr->qscale_table[mb_pos]];
176  if(mb_x)
177  left_lim = rv30_loop_filt_lim[s->current_picture_ptr->qscale_table[mb_pos - 1]];
178  for(j = 0; j < 16; j += 4){
179  Y = s->current_picture_ptr->f->data[0] + mb_x*16 + (row*16 + j) * s->linesize + 4 * !mb_x;
180  for(i = !mb_x; i < 4; i++, Y += 4){
181  int ij = i + j;
182  loc_lim = 0;
183  if(r->deblock_coefs[mb_pos] & (1 << ij))
184  loc_lim = cur_lim;
185  else if(!i && r->deblock_coefs[mb_pos - 1] & (1 << (ij + 3)))
186  loc_lim = left_lim;
187  else if( i && r->deblock_coefs[mb_pos] & (1 << (ij - 1)))
188  loc_lim = cur_lim;
189  if(loc_lim)
190  rv30_weak_loop_filter(Y, 1, s->linesize, loc_lim);
191  }
192  }
193  for(k = 0; k < 2; k++){
194  int cur_cbp, left_cbp = 0;
195  cur_cbp = (r->cbp_chroma[mb_pos] >> (k*4)) & 0xF;
196  if(mb_x)
197  left_cbp = (r->cbp_chroma[mb_pos - 1] >> (k*4)) & 0xF;
198  for(j = 0; j < 8; j += 4){
199  C = s->current_picture_ptr->f->data[k + 1] + mb_x*8 + (row*8 + j) * s->uvlinesize + 4 * !mb_x;
200  for(i = !mb_x; i < 2; i++, C += 4){
201  int ij = i + (j >> 1);
202  loc_lim = 0;
203  if (cur_cbp & (1 << ij))
204  loc_lim = cur_lim;
205  else if(!i && left_cbp & (1 << (ij + 1)))
206  loc_lim = left_lim;
207  else if( i && cur_cbp & (1 << (ij - 1)))
208  loc_lim = cur_lim;
209  if(loc_lim)
210  rv30_weak_loop_filter(C, 1, s->uvlinesize, loc_lim);
211  }
212  }
213  }
214  }
215  mb_pos = row * s->mb_stride;
216  for(mb_x = 0; mb_x < s->mb_width; mb_x++, mb_pos++){
217  cur_lim = rv30_loop_filt_lim[s->current_picture_ptr->qscale_table[mb_pos]];
218  if(row)
219  top_lim = rv30_loop_filt_lim[s->current_picture_ptr->qscale_table[mb_pos - s->mb_stride]];
220  for(j = 4*!row; j < 16; j += 4){
221  Y = s->current_picture_ptr->f->data[0] + mb_x*16 + (row*16 + j) * s->linesize;
222  for(i = 0; i < 4; i++, Y += 4){
223  int ij = i + j;
224  loc_lim = 0;
225  if(r->deblock_coefs[mb_pos] & (1 << ij))
226  loc_lim = cur_lim;
227  else if(!j && r->deblock_coefs[mb_pos - s->mb_stride] & (1 << (ij + 12)))
228  loc_lim = top_lim;
229  else if( j && r->deblock_coefs[mb_pos] & (1 << (ij - 4)))
230  loc_lim = cur_lim;
231  if(loc_lim)
232  rv30_weak_loop_filter(Y, s->linesize, 1, loc_lim);
233  }
234  }
235  for(k = 0; k < 2; k++){
236  int cur_cbp, top_cbp = 0;
237  cur_cbp = (r->cbp_chroma[mb_pos] >> (k*4)) & 0xF;
238  if(row)
239  top_cbp = (r->cbp_chroma[mb_pos - s->mb_stride] >> (k*4)) & 0xF;
240  for(j = 4*!row; j < 8; j += 4){
241  C = s->current_picture_ptr->f->data[k+1] + mb_x*8 + (row*8 + j) * s->uvlinesize;
242  for(i = 0; i < 2; i++, C += 4){
243  int ij = i + (j >> 1);
244  loc_lim = 0;
245  if (r->cbp_chroma[mb_pos] & (1 << ij))
246  loc_lim = cur_lim;
247  else if(!j && top_cbp & (1 << (ij + 2)))
248  loc_lim = top_lim;
249  else if( j && cur_cbp & (1 << (ij - 2)))
250  loc_lim = cur_lim;
251  if(loc_lim)
252  rv30_weak_loop_filter(C, s->uvlinesize, 1, loc_lim);
253  }
254  }
255  }
256  }
257 }
258 
259 /**
260  * Initialize decoder.
261  */
263 {
264  RV34DecContext *r = avctx->priv_data;
265  int ret;
266 
267  r->orig_width = avctx->coded_width;
268  r->orig_height = avctx->coded_height;
269 
270  if (avctx->extradata_size < 2) {
271  av_log(avctx, AV_LOG_ERROR, "Extradata is too small.\n");
272  return AVERROR(EINVAL);
273  }
274  r->rv30 = 1;
275  if ((ret = ff_rv34_decode_init(avctx)) < 0)
276  return ret;
277 
278  r->max_rpr = avctx->extradata[1] & 7;
279  if(avctx->extradata_size < 2*r->max_rpr + 8){
280  av_log(avctx, AV_LOG_WARNING, "Insufficient extradata - need at least %d bytes, got %d\n",
281  2*r->max_rpr + 8, avctx->extradata_size);
282  }
283 
284  r->parse_slice_header = rv30_parse_slice_header;
285  r->decode_intra_types = rv30_decode_intra_types;
286  r->decode_mb_info = rv30_decode_mb_info;
287  r->loop_filter = rv30_loop_filter;
288  r->luma_dc_quant_i = rv30_luma_dc_quant;
289  r->luma_dc_quant_p = rv30_luma_dc_quant;
290  ff_rv30dsp_init(&r->rdsp);
291  return 0;
292 }
293 
295  .p.name = "rv30",
296  CODEC_LONG_NAME("RealVideo 3.0"),
297  .p.type = AVMEDIA_TYPE_VIDEO,
298  .p.id = AV_CODEC_ID_RV30,
299  .priv_data_size = sizeof(RV34DecContext),
301  .close = ff_rv34_decode_end,
303  .p.capabilities = AV_CODEC_CAP_DR1 | AV_CODEC_CAP_DELAY |
305  .flush = ff_mpeg_flush,
307  .caps_internal = FF_CODEC_CAP_ALLOCATE_PROGRESS,
308 };
RV34DecContext
decoder context
Definition: rv34.h:86
A
#define A(x)
Definition: vpx_arith.h:28
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:186
av_clip
#define av_clip
Definition: common.h:98
r
const char * r
Definition: vf_curves.c:126
ff_rv34_decode_end
av_cold int ff_rv34_decode_end(AVCodecContext *avctx)
Definition: rv34.c:1816
AVERROR
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
ff_rv34_get_start_offset
int ff_rv34_get_start_offset(GetBitContext *gb, int mb_size)
Decode starting slice position.
Definition: rv34.c:336
get_interleaved_ue_golomb
static unsigned get_interleaved_ue_golomb(GetBitContext *gb)
Definition: golomb.h:143
step
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
Definition: rate_distortion.txt:58
w
uint8_t w
Definition: llviddspenc.c:38
ff_rv34_decode_update_thread_context
int ff_rv34_decode_update_thread_context(AVCodecContext *dst, const AVCodecContext *src)
Definition: rv34.c:1529
FFCodec
Definition: codec_internal.h:127
mpegvideo.h
mpegutils.h
ff_crop_tab
#define ff_crop_tab
Definition: motionpixels_tablegen.c:26
golomb.h
exp golomb vlc stuff
get_bits
static unsigned int get_bits(GetBitContext *s, int n)
Read 1-25 bits.
Definition: get_bits.h:335
RV34_MB_B_FORWARD
@ RV34_MB_B_FORWARD
B-frame macroblock, forward prediction.
Definition: rv34.h:49
FFCodec::p
AVCodec p
The public AVCodec.
Definition: codec_internal.h:131
ff_rv30dsp_init
av_cold void ff_rv30dsp_init(RV34DSPContext *c)
Definition: rv30dsp.c:268
GetBitContext
Definition: get_bits.h:108
RV34_MB_B_DIRECT
@ RV34_MB_B_DIRECT
Bidirectionally predicted B-frame macroblock, no motion vectors.
Definition: rv34.h:52
AVCodecContext::coded_height
int coded_height
Definition: avcodec.h:633
rv30_parse_slice_header
static int rv30_parse_slice_header(RV34DecContext *r, GetBitContext *gb, SliceInfo *si)
Definition: rv30.c:38
C
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
Definition: writing_filters.txt:58
mpegvideodec.h
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
av_cold
#define av_cold
Definition: attributes.h:90
ff_rv34_decode_init
av_cold int ff_rv34_decode_init(AVCodecContext *avctx)
Initialize decoder.
Definition: rv34.c:1500
AVCodecContext::extradata_size
int extradata_size
Definition: avcodec.h:524
FF_CODEC_DECODE_CB
#define FF_CODEC_DECODE_CB(func)
Definition: codec_internal.h:287
s
#define s(width, name)
Definition: cbs_vp9.c:198
B
#define B
Definition: huffyuv.h:42
rv30_loop_filter
static void rv30_loop_filter(RV34DecContext *r, int row)
Definition: rv30.c:153
IS_INTRA
#define IS_INTRA(x, y)
CODEC_LONG_NAME
#define CODEC_LONG_NAME(str)
Definition: codec_internal.h:272
AV_CODEC_CAP_FRAME_THREADS
#define AV_CODEC_CAP_FRAME_THREADS
Codec supports frame-level multithreading.
Definition: codec.h:110
ff_rv30_decoder
const FFCodec ff_rv30_decoder
Definition: rv30.c:294
RV34_MB_SKIP
@ RV34_MB_SKIP
Skipped block.
Definition: rv34.h:51
rv30_decode_mb_info
static int rv30_decode_mb_info(RV34DecContext *r)
Decode macroblock information.
Definition: rv30.c:116
SliceInfo::type
int type
slice type (intra, inter)
Definition: rv34.h:76
rv30_decode_intra_types
static int rv30_decode_intra_types(RV34DecContext *r, GetBitContext *gb, int8_t *dst)
Decode 4x4 intra types array.
Definition: rv30.c:88
get_bits1
static unsigned int get_bits1(GetBitContext *s)
Definition: get_bits.h:388
rv30data.h
UPDATE_THREAD_CONTEXT
#define UPDATE_THREAD_CONTEXT(func)
Definition: codec_internal.h:281
rv30_weak_loop_filter
static void rv30_weak_loop_filter(uint8_t *src, const int step, const int stride, const int lim)
Definition: rv30.c:138
rv34.h
SliceInfo::quant
int quant
quantizer used for this slice
Definition: rv34.h:77
RV34_MB_P_8x8
@ RV34_MB_P_8x8
P-frame macroblock, 8x8 motion compensation partitions.
Definition: rv34.h:48
init
int(* init)(AVBSFContext *ctx)
Definition: dts2pts.c:365
AV_CODEC_CAP_DR1
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() or get_encode_buffer() for allocating buffers and supports custom allocators.
Definition: codec.h:52
RV34_MB_B_BACKWARD
@ RV34_MB_B_BACKWARD
B-frame macroblock, backward prediction.
Definition: rv34.h:50
codec_internal.h
ff_rv34_decode_frame
int ff_rv34_decode_frame(AVCodecContext *avctx, AVFrame *pict, int *got_picture_ptr, AVPacket *avpkt)
Definition: rv34.c:1609
FF_CODEC_CAP_ALLOCATE_PROGRESS
#define FF_CODEC_CAP_ALLOCATE_PROGRESS
Definition: codec_internal.h:69
diff
static av_always_inline int diff(const struct color_info *a, const struct color_info *b, const int trans_thresh)
Definition: vf_paletteuse.c:164
ff_mpeg_flush
void ff_mpeg_flush(AVCodecContext *avctx)
Definition: mpegvideo_dec.c:543
SliceInfo::pts
int pts
frame timestamp
Definition: rv34.h:82
AV_CODEC_ID_RV30
@ AV_CODEC_ID_RV30
Definition: codec_id.h:120
skip_bits1
static void skip_bits1(GetBitContext *s)
Definition: get_bits.h:413
Y
#define Y
Definition: boxblur.h:37
RV34_MB_TYPE_INTRA16x16
@ RV34_MB_TYPE_INTRA16x16
Intra macroblock with DCs in a separate 4x4 block.
Definition: rv34.h:46
SliceInfo::height
int height
coded height
Definition: rv34.h:81
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:255
code
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
Definition: filter_design.txt:178
AVCodecContext::extradata
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:523
RV34_MB_TYPE_INTRA
@ RV34_MB_TYPE_INTRA
Intra macroblock.
Definition: rv34.h:45
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:194
rv30_luma_dc_quant
static const uint8_t rv30_luma_dc_quant[32]
DC quantizer mapping for RV30.
Definition: rv30data.h:33
SliceInfo
essential slice information
Definition: rv34.h:75
avcodec.h
stride
#define stride
Definition: h264pred_template.c:537
ret
ret
Definition: filter_design.txt:187
U
#define U(x)
Definition: vpx_arith.h:37
AVCodecContext
main external API structure.
Definition: avcodec.h:445
SliceInfo::start
int start
Definition: rv34.h:79
AV_PICTURE_TYPE_B
@ AV_PICTURE_TYPE_B
Bi-dir predicted.
Definition: avutil.h:281
IS_SEPARATE_DC
#define IS_SEPARATE_DC(a)
Definition: rv34.h:39
rv30_loop_filt_lim
static const uint8_t rv30_loop_filt_lim[32]
Loop filter limits are taken from this table.
Definition: rv30data.h:178
cm
#define cm
Definition: dvbsubdec.c:39
AV_CODEC_CAP_DELAY
#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: codec.h:76
rv30_decode_init
static av_cold int rv30_decode_init(AVCodecContext *avctx)
Initialize decoder.
Definition: rv30.c:262
AVCodecContext::coded_width
int coded_width
Bitstream width / height, may be different from width/height e.g.
Definition: avcodec.h:633
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:472
src
INIT_CLIP pixel * src
Definition: h264pred_template.c:418
SliceInfo::width
int width
coded width
Definition: rv34.h:80
RV34_MB_P_16x16
@ RV34_MB_P_16x16
P-frame macroblock, one motion frame.
Definition: rv34.h:47
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
h
h
Definition: vp9dsp_template.c:2038
MAX_NEG_CROP
#define MAX_NEG_CROP
Definition: mathops.h:31
MpegEncContext
MpegEncContext.
Definition: mpegvideo.h:67
rv30_itype_from_context
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
av_log2
int av_log2(unsigned v)
Definition: intmath.c:26
rv30_itype_code
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