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 };
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 
282  r->parse_slice_header = rv30_parse_slice_header;
283  r->decode_intra_types = rv30_decode_intra_types;
284  r->decode_mb_info = rv30_decode_mb_info;
285  r->loop_filter = rv30_loop_filter;
286  r->luma_dc_quant_i = rv30_luma_dc_quant;
287  r->luma_dc_quant_p = rv30_luma_dc_quant;
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  },
308  .caps_internal = FF_CODEC_CAP_ALLOCATE_PROGRESS,
309 };
RV34DecContext
decoder context
Definition: rv34.h:84
AVCodec
AVCodec.
Definition: codec.h:190
stride
int stride
Definition: mace.c:144
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:182
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
init
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
r
const char * r
Definition: vf_curves.c:114
ff_rv34_decode_end
av_cold int ff_rv34_decode_end(AVCodecContext *avctx)
Definition: rv34.c:1819
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:330
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:1532
mpegvideo.h
mpegutils.h
ff_crop_tab
#define ff_crop_tab
Definition: motionpixels_tablegen.c:26
A
#define A(x)
Definition: vp56_arith.h:28
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:379
RV34_MB_B_FORWARD
@ RV34_MB_B_FORWARD
B-frame macroblock, forward prediction.
Definition: rv34.h:47
U
#define U(x)
Definition: vp56_arith.h:37
GetBitContext
Definition: get_bits.h:61
RV34_MB_B_DIRECT
@ RV34_MB_B_DIRECT
Bidirectionally predicted B-frame macroblock, no motion vectors.
Definition: rv34.h:50
AVCodecContext::coded_height
int coded_height
Definition: avcodec.h:714
rv30_parse_slice_header
static int rv30_parse_slice_header(RV34DecContext *r, GetBitContext *gb, SliceInfo *si)
Definition: rv30.c:36
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
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
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:1492
decode
static void decode(AVCodecContext *dec_ctx, AVPacket *pkt, AVFrame *frame, FILE *outfile)
Definition: decode_audio.c:71
AVCodecContext::extradata_size
int extradata_size
Definition: avcodec.h:628
s
#define s(width, name)
Definition: cbs_vp9.c:257
pix_fmts
static enum AVPixelFormat pix_fmts[]
Definition: libkvazaar.c:275
rv30_loop_filter
static void rv30_loop_filter(RV34DecContext *r, int row)
Definition: rv30.c:151
IS_INTRA
#define IS_INTRA(x, y)
AV_PIX_FMT_YUV420P
@ AV_PIX_FMT_YUV420P
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:66
AV_CODEC_CAP_FRAME_THREADS
#define AV_CODEC_CAP_FRAME_THREADS
Codec supports frame-level multithreading.
Definition: codec.h:106
flush
static void flush(AVCodecContext *avctx)
Definition: aacdec_template.c:500
RV34_MB_SKIP
@ RV34_MB_SKIP
Skipped block.
Definition: rv34.h:49
rv30_decode_mb_info
static int rv30_decode_mb_info(RV34DecContext *r)
Decode macroblock information.
Definition: rv30.c:114
SliceInfo::type
int type
slice type (intra, inter)
Definition: rv34.h:74
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:86
ff_rv34_decode_frame
int ff_rv34_decode_frame(AVCodecContext *avctx, void *data, int *got_picture_ptr, AVPacket *avpkt)
Definition: rv34.c:1613
get_bits1
static unsigned int get_bits1(GetBitContext *s)
Definition: get_bits.h:498
src
#define src
Definition: vp8dsp.c:254
rv30data.h
ONLY_IF_THREADS_ENABLED
#define ONLY_IF_THREADS_ENABLED(x)
Define a function with only the non-default version specified.
Definition: internal.h:227
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:136
rv34.h
SliceInfo::quant
int quant
quantizer used for this slice
Definition: rv34.h:75
RV34_MB_P_8x8
@ RV34_MB_P_8x8
P-frame macroblock, 8x8 motion compensation partitions.
Definition: rv34.h:46
AV_CODEC_CAP_DR1
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() for allocating buffers and supports custom allocators.
Definition: codec.h:50
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:188
RV34_MB_B_BACKWARD
@ RV34_MB_B_BACKWARD
B-frame macroblock, backward prediction.
Definition: rv34.h:48
ff_mpeg_flush
void ff_mpeg_flush(AVCodecContext *avctx)
Definition: mpegvideo.c:2312
SliceInfo::pts
int pts
frame timestamp
Definition: rv34.h:80
AV_CODEC_ID_RV30
@ AV_CODEC_ID_RV30
Definition: codec_id.h:117
skip_bits1
static void skip_bits1(GetBitContext *s)
Definition: get_bits.h:538
Y
#define Y
Definition: boxblur.h:38
RV34_MB_TYPE_INTRA16x16
@ RV34_MB_TYPE_INTRA16x16
Intra macroblock with DCs in a separate 4x4 block.
Definition: rv34.h:44
SliceInfo::height
int height
coded height
Definition: rv34.h:79
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:269
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:627
RV34_MB_TYPE_INTRA
@ RV34_MB_TYPE_INTRA
Intra macroblock.
Definition: rv34.h:43
uint8_t
uint8_t
Definition: audio_convert.c:194
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:197
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:73
avcodec.h
ret
ret
Definition: filter_design.txt:187
B
#define B
Definition: huffyuvdsp.h:32
AVCodecContext
main external API structure.
Definition: avcodec.h:526
SliceInfo::start
int start
Definition: rv34.h:77
AV_PICTURE_TYPE_B
@ AV_PICTURE_TYPE_B
Bi-dir predicted.
Definition: avutil.h:276
IS_SEPARATE_DC
#define IS_SEPARATE_DC(a)
Definition: rv34.h:37
AV_PIX_FMT_NONE
@ AV_PIX_FMT_NONE
Definition: pixfmt.h:65
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:37
ff_rv30_decoder
AVCodec ff_rv30_decoder
Definition: rv30.c:291
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:75
rv30_decode_init
static av_cold int rv30_decode_init(AVCodecContext *avctx)
Initialize decoder.
Definition: rv30.c:260
AVCodecContext::coded_width
int coded_width
Bitstream width / height, may be different from width/height e.g.
Definition: avcodec.h:714
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
FF_CODEC_CAP_ALLOCATE_PROGRESS
#define FF_CODEC_CAP_ALLOCATE_PROGRESS
Definition: internal.h:75
diff
static av_always_inline int diff(const uint32_t a, const uint32_t b)
Definition: vf_palettegen.c:136
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:553
SliceInfo::width
int width
coded width
Definition: rv34.h:78
RV34_MB_P_16x16
@ RV34_MB_P_16x16
P-frame macroblock, one motion frame.
Definition: rv34.h:45
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:28
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
h
h
Definition: vp9dsp_template.c:2038
MAX_NEG_CROP
#define MAX_NEG_CROP
Definition: mathops.h:31
MpegEncContext
MpegEncContext.
Definition: mpegvideo.h:81
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