FFmpeg
vb.c
Go to the documentation of this file.
1 /*
2  * Beam Software VB 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  * VB Video decoder
25  */
26 
27 #include "libavutil/mem.h"
28 #include "avcodec.h"
29 #include "bytestream.h"
30 #include "codec_internal.h"
31 #include "decode.h"
32 
33 enum VBFlags {
34  VB_HAS_GMC = 0x01,
35  VB_HAS_AUDIO = 0x04,
36  VB_HAS_VIDEO = 0x08,
39 };
40 
41 typedef struct VBDecContext {
43 
44  uint8_t *frame, *prev_frame;
45  uint32_t pal[AVPALETTE_COUNT];
47 } VBDecContext;
48 
49 static const uint16_t vb_patterns[64] = {
50  0x0660, 0xFF00, 0xCCCC, 0xF000, 0x8888, 0x000F, 0x1111, 0xFEC8,
51  0x8CEF, 0x137F, 0xF731, 0xC800, 0x008C, 0x0013, 0x3100, 0xCC00,
52  0x00CC, 0x0033, 0x3300, 0x0FF0, 0x6666, 0x00F0, 0x0F00, 0x2222,
53  0x4444, 0xF600, 0x8CC8, 0x006F, 0x1331, 0x318C, 0xC813, 0x33CC,
54  0x6600, 0x0CC0, 0x0066, 0x0330, 0xF900, 0xC88C, 0x009F, 0x3113,
55  0x6000, 0x0880, 0x0006, 0x0110, 0xCC88, 0xFC00, 0x00CF, 0x88CC,
56  0x003F, 0x1133, 0x3311, 0xF300, 0x6FF6, 0x0603, 0x08C6, 0x8C63,
57  0xC631, 0x6310, 0xC060, 0x0136, 0x136C, 0x36C8, 0x6C80, 0x324C
58 };
59 
60 static void vb_decode_palette(VBDecContext *c, int data_size)
61 {
62  int start, size, i;
63 
64  start = bytestream2_get_byte(&c->stream);
65  size = (bytestream2_get_byte(&c->stream) - 1) & 0xFF;
66  if (start + size > 255) {
67  av_log(c->avctx, AV_LOG_ERROR, "Palette change runs beyond entry 256\n");
68  return;
69  }
70  if (size*3+2 > data_size) {
71  av_log(c->avctx, AV_LOG_ERROR, "Palette data runs beyond chunk size\n");
72  return;
73  }
74  for (i = start; i <= start + size; i++)
75  c->pal[i] = 0xFFU << 24 | bytestream2_get_be24(&c->stream);
76 }
77 
78 static inline int check_pixel(uint8_t *buf, uint8_t *start, uint8_t *end)
79 {
80  return buf >= start && buf < end;
81 }
82 
83 static inline int check_line(uint8_t *buf, uint8_t *start, uint8_t *end)
84 {
85  return buf >= start && (buf + 4) <= end;
86 }
87 
89 {
91  uint8_t *prev, *cur;
92  int blk, blocks, t, blk2;
93  int blocktypes = 0;
94  int x, y, a, b;
95  int pattype, pattern;
96  const int width = c->avctx->width;
97  uint8_t *pstart = c->prev_frame;
98  uint8_t *pend = c->prev_frame + width*c->avctx->height;
99 
100  g = c->stream;
101 
102  prev = c->prev_frame + offset;
103  cur = c->frame;
104 
105  blocks = (c->avctx->width >> 2) * (c->avctx->height >> 2);
106  blk2 = 0;
107  for (blk = 0; blk < blocks; blk++) {
108  if (!(blk & 3)) {
109  if (bytestream2_get_bytes_left(&g) < 1) {
110  av_log(c->avctx, AV_LOG_ERROR, "Insufficient data\n");
111  return AVERROR_INVALIDDATA;
112  }
113  blocktypes = bytestream2_get_byte(&g);
114  }
115  switch (blocktypes & 0xC0) {
116  case 0x00: //skip
117  for (y = 0; y < 4; y++)
118  if (check_line(prev + y*width, pstart, pend))
119  memcpy(cur + y*width, prev + y*width, 4);
120  else
121  memset(cur + y*width, 0, 4);
122  break;
123  case 0x40:
124  t = bytestream2_get_byte(&g);
125  if (!t) { //raw block
126  if (bytestream2_get_bytes_left(&g) < 16) {
127  av_log(c->avctx, AV_LOG_ERROR, "Insufficient data\n");
128  return AVERROR_INVALIDDATA;
129  }
130  for (y = 0; y < 4; y++)
131  bytestream2_get_buffer(&g, cur + y * width, 4);
132  } else { // motion compensation
133  x = ((t & 0xF)^8) - 8;
134  y = ((t >> 4) ^8) - 8;
135  t = x + y*width;
136  for (y = 0; y < 4; y++)
137  if (check_line(prev + t + y*width, pstart, pend))
138  memcpy(cur + y*width, prev + t + y*width, 4);
139  else
140  memset(cur + y*width, 0, 4);
141  }
142  break;
143  case 0x80: // fill
144  t = bytestream2_get_byte(&g);
145  for (y = 0; y < 4; y++)
146  memset(cur + y*width, t, 4);
147  break;
148  case 0xC0: // pattern fill
149  t = bytestream2_get_byte(&g);
150  pattype = t >> 6;
151  pattern = vb_patterns[t & 0x3F];
152  switch (pattype) {
153  case 0:
154  a = bytestream2_get_byte(&g);
155  b = bytestream2_get_byte(&g);
156  for (y = 0; y < 4; y++)
157  for (x = 0; x < 4; x++, pattern >>= 1)
158  cur[x + y*width] = (pattern & 1) ? b : a;
159  break;
160  case 1:
161  pattern = ~pattern;
162  case 2:
163  a = bytestream2_get_byte(&g);
164  for (y = 0; y < 4; y++)
165  for (x = 0; x < 4; x++, pattern >>= 1)
166  if (pattern & 1 && check_pixel(prev + x + y*width, pstart, pend))
167  cur[x + y*width] = prev[x + y*width];
168  else
169  cur[x + y*width] = a;
170  break;
171  case 3:
172  av_log(c->avctx, AV_LOG_ERROR, "Invalid opcode seen @%d\n", blk);
173  return AVERROR_INVALIDDATA;
174  }
175  break;
176  }
177  blocktypes <<= 2;
178  cur += 4;
179  prev += 4;
180  blk2++;
181  if (blk2 == (width >> 2)) {
182  blk2 = 0;
183  cur += width * 3;
184  prev += width * 3;
185  }
186  }
187  return 0;
188 }
189 
191  int *got_frame, AVPacket *avpkt)
192 {
193  VBDecContext * const c = avctx->priv_data;
194  uint8_t *outptr, *srcptr;
195  int i, j, ret;
196  int flags;
197  uint32_t size;
198  int offset = 0;
199 
200  if (avpkt->size < 2)
201  return AVERROR_INVALIDDATA;
202 
203  bytestream2_init(&c->stream, avpkt->data, avpkt->size);
204 
205  if ((ret = ff_get_buffer(avctx, frame, 0)) < 0)
206  return ret;
207 
208  flags = bytestream2_get_le16(&c->stream);
209 
210  if (flags & VB_HAS_GMC) {
211  i = (int16_t)bytestream2_get_le16(&c->stream);
212  j = (int16_t)bytestream2_get_le16(&c->stream);
213  if (FFABS(j) > avctx->height) {
214  av_log(avctx, AV_LOG_ERROR, "GMV out of range\n");
215  return AVERROR_INVALIDDATA;
216  }
217  offset = i + j * avctx->width;
218  }
219  if (flags & VB_HAS_VIDEO) {
220  size = bytestream2_get_le32(&c->stream);
221  if(size > bytestream2_get_bytes_left(&c->stream)+4 || size<4){
222  av_log(avctx, AV_LOG_ERROR, "Frame size invalid\n");
223  return -1;
224  }
226  bytestream2_skip(&c->stream, size - 4);
227  }
228  if (flags & VB_HAS_PALETTE) {
229  size = bytestream2_get_le32(&c->stream);
231  }
232 
233  memcpy(frame->data[1], c->pal, AVPALETTE_SIZE);
234 #if FF_API_PALETTE_HAS_CHANGED
236  frame->palette_has_changed = flags & VB_HAS_PALETTE;
238 #endif
239 
240  outptr = frame->data[0];
241  srcptr = c->frame;
242 
243  for (i = 0; i < avctx->height; i++) {
244  memcpy(outptr, srcptr, avctx->width);
245  srcptr += avctx->width;
246  outptr += frame->linesize[0];
247  }
248 
249  FFSWAP(uint8_t*, c->frame, c->prev_frame);
250 
251  *got_frame = 1;
252 
253  /* always report that the buffer was completely consumed */
254  return avpkt->size;
255 }
256 
258 {
259  VBDecContext * const c = avctx->priv_data;
260 
261  c->avctx = avctx;
262  avctx->pix_fmt = AV_PIX_FMT_PAL8;
263 
264  c->frame = av_mallocz(avctx->width * avctx->height);
265  c->prev_frame = av_mallocz(avctx->width * avctx->height);
266 
267  if (!c->frame || !c->prev_frame)
268  return AVERROR(ENOMEM);
269 
270  return 0;
271 }
272 
274 {
275  VBDecContext *c = avctx->priv_data;
276 
277  av_freep(&c->frame);
278  av_freep(&c->prev_frame);
279 
280  return 0;
281 }
282 
284  .p.name = "vb",
285  CODEC_LONG_NAME("Beam Software VB"),
286  .p.type = AVMEDIA_TYPE_VIDEO,
287  .p.id = AV_CODEC_ID_VB,
288  .priv_data_size = sizeof(VBDecContext),
289  .init = decode_init,
290  .close = decode_end,
292  .p.capabilities = AV_CODEC_CAP_DR1,
293  .caps_internal = FF_CODEC_CAP_INIT_CLEANUP,
294 };
FF_ENABLE_DEPRECATION_WARNINGS
#define FF_ENABLE_DEPRECATION_WARNINGS
Definition: internal.h:73
FF_CODEC_CAP_INIT_CLEANUP
#define FF_CODEC_CAP_INIT_CLEANUP
The codec allows calling the close function for deallocation even if the init function returned a fai...
Definition: codec_internal.h:42
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
GetByteContext
Definition: bytestream.h:33
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:374
AVPacket::data
uint8_t * data
Definition: packet.h:524
b
#define b
Definition: input.c:41
FFCodec
Definition: codec_internal.h:126
AV_CODEC_ID_VB
@ AV_CODEC_ID_VB
Definition: codec_id.h:160
vb_decode_palette
static void vb_decode_palette(VBDecContext *c, int data_size)
Definition: vb.c:60
bytestream2_skip
static av_always_inline void bytestream2_skip(GetByteContext *g, unsigned int size)
Definition: bytestream.h:168
VBFlags
VBFlags
Definition: vb.c:33
FFCodec::p
AVCodec p
The public AVCodec.
Definition: codec_internal.h:130
VBDecContext::avctx
AVCodecContext * avctx
Definition: vb.c:42
vb_patterns
static const uint16_t vb_patterns[64]
Definition: vb.c:49
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
decode_frame
static int decode_frame(AVCodecContext *avctx, AVFrame *frame, int *got_frame, AVPacket *avpkt)
Definition: vb.c:190
width
#define width
FF_CODEC_DECODE_CB
#define FF_CODEC_DECODE_CB(func)
Definition: codec_internal.h:286
g
const char * g
Definition: vf_curves.c:128
VB_HAS_PALETTE
@ VB_HAS_PALETTE
Definition: vb.c:37
decode.h
blk
#define blk(i)
Definition: sha.c:186
CODEC_LONG_NAME
#define CODEC_LONG_NAME(str)
Definition: codec_internal.h:271
VBDecContext::stream
GetByteContext stream
Definition: vb.c:46
check_line
static int check_line(uint8_t *buf, uint8_t *start, uint8_t *end)
Definition: vb.c:83
FFABS
#define FFABS(a)
Absolute value, Note, INT_MIN / INT64_MIN result in undefined behavior as they are not representable ...
Definition: common.h:73
ff_vb_decoder
const FFCodec ff_vb_decoder
Definition: vb.c:283
AVPALETTE_SIZE
#define AVPALETTE_SIZE
Definition: pixfmt.h:32
bytestream2_get_buffer
static av_always_inline unsigned int bytestream2_get_buffer(GetByteContext *g, uint8_t *dst, unsigned int size)
Definition: bytestream.h:267
decode_init
static av_cold int decode_init(AVCodecContext *avctx)
Definition: vb.c:257
c
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
Definition: undefined.txt:32
AVPALETTE_COUNT
#define AVPALETTE_COUNT
Definition: pixfmt.h:33
VB_HAS_LENGTH
@ VB_HAS_LENGTH
Definition: vb.c:38
bytestream2_get_bytes_left
static av_always_inline int bytestream2_get_bytes_left(GetByteContext *g)
Definition: bytestream.h:158
check_pixel
static int check_pixel(uint8_t *buf, uint8_t *start, uint8_t *end)
Definition: vb.c:78
VB_HAS_AUDIO
@ VB_HAS_AUDIO
Definition: vb.c:35
ff_get_buffer
int ff_get_buffer(AVCodecContext *avctx, AVFrame *frame, int flags)
Get a buffer for a frame.
Definition: decode.c:1556
init
int(* init)(AVBSFContext *ctx)
Definition: dts2pts.c:366
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
AVPacket::size
int size
Definition: packet.h:525
codec_internal.h
size
int size
Definition: twinvq_data.h:10344
VBDecContext
Definition: vb.c:41
a
The reader does not expect b to be semantically here and if the code is changed by maybe adding a a division or other the signedness will almost certainly be mistaken To avoid this confusion a new type was SUINT is the C unsigned type but it holds a signed int to use the same example SUINT a
Definition: undefined.txt:41
offset
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf offset
Definition: writing_filters.txt:86
VBDecContext::pal
uint32_t pal[AVPALETTE_COUNT]
Definition: vb.c:45
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:256
av_mallocz
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
Definition: mem.c:256
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:194
AVCodecContext::height
int height
Definition: avcodec.h:618
AVCodecContext::pix_fmt
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:657
avcodec.h
AV_PIX_FMT_PAL8
@ AV_PIX_FMT_PAL8
8 bits with AV_PIX_FMT_RGB32 palette
Definition: pixfmt.h:84
ret
ret
Definition: filter_design.txt:187
FFSWAP
#define FFSWAP(type, a, b)
Definition: macros.h:52
frame
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a it should directly call filter_frame on the corresponding output For a if there are queued frames already one of these frames should be pushed If the filter should request a frame on one of its repeatedly until at least one frame has been pushed Return or at least make progress towards producing a frame
Definition: filter_design.txt:264
vb_decode_framedata
static int vb_decode_framedata(VBDecContext *c, int offset)
Definition: vb.c:88
AVCodecContext
main external API structure.
Definition: avcodec.h:445
VB_HAS_GMC
@ VB_HAS_GMC
Definition: vb.c:34
decode_end
static av_cold int decode_end(AVCodecContext *avctx)
Definition: vb.c:273
FF_DISABLE_DEPRECATION_WARNINGS
#define FF_DISABLE_DEPRECATION_WARNINGS
Definition: internal.h:72
VBDecContext::frame
uint8_t * frame
Definition: vb.c:44
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
mem.h
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:472
AVPacket
This structure stores compressed data.
Definition: packet.h:501
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:34
VBDecContext::prev_frame
uint8_t * prev_frame
Definition: vb.c:44
AVCodecContext::width
int width
picture width / height.
Definition: avcodec.h:618
bytestream.h
bytestream2_init
static av_always_inline void bytestream2_init(GetByteContext *g, const uint8_t *buf, int buf_size)
Definition: bytestream.h:137
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:474
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
VB_HAS_VIDEO
@ VB_HAS_VIDEO
Definition: vb.c:36