FFmpeg
fraps.c
Go to the documentation of this file.
1 /*
2  * Fraps FPS1 decoder
3  * Copyright (c) 2005 Roine Gustafsson
4  * Copyright (c) 2006 Konstantin Shishkov
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 /**
24  * @file
25  * Lossless Fraps 'FPS1' decoder
26  * @author Roine Gustafsson (roine at users sf net)
27  * @author Konstantin Shishkov
28  *
29  * Codec algorithm for version 0 is taken from Transcode <www.transcoding.org>
30  *
31  * Version 2 files support by Konstantin Shishkov
32  */
33 
34 #include "config.h"
35 
36 #define CACHED_BITSTREAM_READER HAVE_FAST_64BIT
37 #define UNCHECKED_BITSTREAM_READER 1
38 #include "avcodec.h"
39 #include "get_bits.h"
40 #include "huffman.h"
41 #include "bytestream.h"
42 #include "bswapdsp.h"
43 #include "codec_internal.h"
44 #include "thread.h"
45 
46 #define FPS_TAG MKTAG('F', 'P', 'S', 'x')
47 #define VLC_BITS 11
48 
49 /**
50  * local variable storage
51  */
52 typedef struct FrapsContext {
55  uint8_t *tmpbuf;
57 } FrapsContext;
58 
59 
60 /**
61  * initializes decoder
62  * @param avctx codec context
63  * @return 0 on success or negative if fails
64  */
66 {
67  FrapsContext * const s = avctx->priv_data;
68 
69  s->avctx = avctx;
70  s->tmpbuf = NULL;
71 
72  ff_bswapdsp_init(&s->bdsp);
73 
74  return 0;
75 }
76 
77 /**
78  * Comparator - our nodes should ascend by count
79  * but with preserved symbol order
80  */
81 static int huff_cmp(const void *va, const void *vb)
82 {
83  const Node *a = va, *b = vb;
84  return (a->count - b->count)*256 + a->sym - b->sym;
85 }
86 
87 /**
88  * decode Fraps v2 packed plane
89  */
90 static int fraps2_decode_plane(FrapsContext *s, uint8_t *dst, int stride, int w,
91  int h, const uint8_t *src, int size, int Uoff,
92  const int step)
93 {
94  int i, j, ret;
95  GetBitContext gb;
96  VLC vlc;
97  Node nodes[512];
98 
99  for (i = 0; i < 256; i++)
100  nodes[i].count = bytestream_get_le32(&src);
101  size -= 1024;
102  if ((ret = ff_huff_build_tree(s->avctx, &vlc, 256, VLC_BITS,
103  nodes, huff_cmp,
105  return ret;
106  /* we have built Huffman table and are ready to decode plane */
107 
108  /* convert bits so they may be used by standard bitreader */
109  s->bdsp.bswap_buf((uint32_t *) s->tmpbuf,
110  (const uint32_t *) src, size >> 2);
111 
112  if ((ret = init_get_bits8(&gb, s->tmpbuf, size)) < 0)
113  return ret;
114 
115  for (j = 0; j < h; j++) {
116  for (i = 0; i < w*step; i += step) {
117  dst[i] = get_vlc2(&gb, vlc.table, VLC_BITS, 3);
118  /* lines are stored as deltas between previous lines
119  * and we need to add 0x80 to the first lines of chroma planes
120  */
121  if (j)
122  dst[i] += dst[i - stride];
123  else if (Uoff)
124  dst[i] += 0x80;
125  if (get_bits_left(&gb) < 0) {
126  ff_free_vlc(&vlc);
127  return AVERROR_INVALIDDATA;
128  }
129  }
130  dst += stride;
131  }
132  ff_free_vlc(&vlc);
133  return 0;
134 }
135 
136 static int decode_frame(AVCodecContext *avctx, AVFrame *f,
137  int *got_frame, AVPacket *avpkt)
138 {
139  FrapsContext * const s = avctx->priv_data;
140  const uint8_t *buf = avpkt->data;
141  int buf_size = avpkt->size;
142  uint32_t header;
143  unsigned int version,header_size;
144  unsigned int x, y;
145  const uint32_t *buf32;
146  uint32_t *luma1,*luma2,*cb,*cr;
147  uint32_t offs[4];
148  int i, j, ret, is_chroma;
149  const int planes = 3;
150  int is_pal;
151  uint8_t *out;
152 
153  if (buf_size < 4) {
154  av_log(avctx, AV_LOG_ERROR, "Packet is too short\n");
155  return AVERROR_INVALIDDATA;
156  }
157 
158  header = AV_RL32(buf);
159  version = header & 0xff;
160  is_pal = buf[1] == 2 && version == 1;
161  header_size = (header & (1<<30))? 8 : 4; /* bit 30 means pad to 8 bytes */
162 
163  if (version > 5) {
164  avpriv_report_missing_feature(avctx, "Fraps version %u", version);
165  return AVERROR_PATCHWELCOME;
166  }
167 
168  buf += header_size;
169 
170  if (is_pal) {
171  unsigned needed_size = avctx->width * avctx->height + 1024;
172  needed_size += header_size;
173  if (buf_size != needed_size) {
174  av_log(avctx, AV_LOG_ERROR,
175  "Invalid frame length %d (should be %d)\n",
176  buf_size, needed_size);
177  return AVERROR_INVALIDDATA;
178  }
179  } else if (version < 2) {
180  unsigned needed_size = avctx->width * avctx->height * 3;
181  if (version == 0) needed_size /= 2;
182  needed_size += header_size;
183  /* bit 31 means same as previous pic */
184  if (header & (1U<<31)) {
185  *got_frame = 0;
186  return buf_size;
187  }
188  if (buf_size != needed_size) {
189  av_log(avctx, AV_LOG_ERROR,
190  "Invalid frame length %d (should be %d)\n",
191  buf_size, needed_size);
192  return AVERROR_INVALIDDATA;
193  }
194  } else {
195  /* skip frame */
196  if (buf_size == 8) {
197  *got_frame = 0;
198  return buf_size;
199  }
200  if (AV_RL32(buf) != FPS_TAG || buf_size < planes*1024 + 24) {
201  av_log(avctx, AV_LOG_ERROR, "error in data stream\n");
202  return AVERROR_INVALIDDATA;
203  }
204  for (i = 0; i < planes; i++) {
205  offs[i] = AV_RL32(buf + 4 + i * 4);
206  if (offs[i] >= buf_size - header_size || (i && offs[i] <= offs[i - 1] + 1024)) {
207  av_log(avctx, AV_LOG_ERROR, "plane %i offset is out of bounds\n", i);
208  return AVERROR_INVALIDDATA;
209  }
210  }
211  offs[planes] = buf_size - header_size;
212  for (i = 0; i < planes; i++) {
213  av_fast_padded_malloc(&s->tmpbuf, &s->tmpbuf_size, offs[i + 1] - offs[i] - 1024);
214  if (!s->tmpbuf)
215  return AVERROR(ENOMEM);
216  }
217  }
218 
219  f->pict_type = AV_PICTURE_TYPE_I;
220  f->key_frame = 1;
221 
226 
227  if ((ret = ff_thread_get_buffer(avctx, f, 0)) < 0)
228  return ret;
229 
230  switch (version) {
231  case 0:
232  default:
233  /* Fraps v0 is a reordered YUV420 */
234  if (((avctx->width % 8) != 0) || ((avctx->height % 2) != 0)) {
235  av_log(avctx, AV_LOG_ERROR, "Invalid frame size %dx%d\n",
236  avctx->width, avctx->height);
237  return AVERROR_INVALIDDATA;
238  }
239 
240  buf32 = (const uint32_t*)buf;
241  for (y = 0; y < avctx->height / 2; y++) {
242  luma1 = (uint32_t*)&f->data[0][ y * 2 * f->linesize[0] ];
243  luma2 = (uint32_t*)&f->data[0][ (y * 2 + 1) * f->linesize[0] ];
244  cr = (uint32_t*)&f->data[1][ y * f->linesize[1] ];
245  cb = (uint32_t*)&f->data[2][ y * f->linesize[2] ];
246  for (x = 0; x < avctx->width; x += 8) {
247  *luma1++ = *buf32++;
248  *luma1++ = *buf32++;
249  *luma2++ = *buf32++;
250  *luma2++ = *buf32++;
251  *cr++ = *buf32++;
252  *cb++ = *buf32++;
253  }
254  }
255  break;
256 
257  case 1:
258  if (is_pal) {
259  uint32_t *pal = (uint32_t *)f->data[1];
260 
261  for (y = 0; y < 256; y++) {
262  pal[y] = AV_RL32(buf) | 0xFF000000;
263  buf += 4;
264  }
265 
266  for (y = 0; y <avctx->height; y++)
267  memcpy(&f->data[0][y * f->linesize[0]],
268  &buf[y * avctx->width],
269  avctx->width);
270  } else {
271  /* Fraps v1 is an upside-down BGR24 */
272  for (y = 0; y<avctx->height; y++)
273  memcpy(&f->data[0][(avctx->height - y - 1) * f->linesize[0]],
274  &buf[y * avctx->width * 3],
275  3 * avctx->width);
276  }
277  break;
278 
279  case 2:
280  case 4:
281  /**
282  * Fraps v2 is Huffman-coded YUV420 planes
283  * Fraps v4 is virtually the same
284  */
285  for (i = 0; i < planes; i++) {
286  is_chroma = !!i;
287  if ((ret = fraps2_decode_plane(s, f->data[i], f->linesize[i],
288  avctx->width >> is_chroma,
289  avctx->height >> is_chroma,
290  buf + offs[i], offs[i + 1] - offs[i],
291  is_chroma, 1)) < 0) {
292  av_log(avctx, AV_LOG_ERROR, "Error decoding plane %i\n", i);
293  return ret;
294  }
295  }
296  break;
297  case 3:
298  case 5:
299  /* Virtually the same as version 4, but is for RGB24 */
300  for (i = 0; i < planes; i++) {
301  if ((ret = fraps2_decode_plane(s, f->data[0] + i + (f->linesize[0] * (avctx->height - 1)),
302  -f->linesize[0], avctx->width, avctx->height,
303  buf + offs[i], offs[i + 1] - offs[i], 0, 3)) < 0) {
304  av_log(avctx, AV_LOG_ERROR, "Error decoding plane %i\n", i);
305  return ret;
306  }
307  }
308  out = f->data[0];
309  // convert pseudo-YUV into real RGB
310  for (j = 0; j < avctx->height; j++) {
311  uint8_t *line_end = out + 3*avctx->width;
312  while (out < line_end) {
313  out[0] += out[1];
314  out[2] += out[1];
315  out += 3;
316  }
317  out += f->linesize[0] - 3*avctx->width;
318  }
319  break;
320  }
321 
322  *got_frame = 1;
323 
324  return buf_size;
325 }
326 
327 
328 /**
329  * closes decoder
330  * @param avctx codec context
331  * @return 0 on success or negative if fails
332  */
334 {
335  FrapsContext *s = (FrapsContext*)avctx->priv_data;
336 
337  av_freep(&s->tmpbuf);
338  return 0;
339 }
340 
341 
343  .p.name = "fraps",
344  .p.long_name = NULL_IF_CONFIG_SMALL("Fraps"),
345  .p.type = AVMEDIA_TYPE_VIDEO,
346  .p.id = AV_CODEC_ID_FRAPS,
347  .priv_data_size = sizeof(FrapsContext),
348  .init = decode_init,
349  .close = decode_end,
351  .p.capabilities = AV_CODEC_CAP_DR1 | AV_CODEC_CAP_FRAME_THREADS,
352  .caps_internal = FF_CODEC_CAP_INIT_THREADSAFE,
353 };
bswapdsp.h
FrapsContext::avctx
AVCodecContext * avctx
Definition: fraps.c:53
get_bits_left
static int get_bits_left(GetBitContext *gb)
Definition: get_bits.h:839
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
AVCodecContext::colorspace
enum AVColorSpace colorspace
YUV colorspace type.
Definition: avcodec.h:966
out
FILE * out
Definition: movenc.c:54
Node
Definition: agm.c:916
cb
static double cb(void *priv, double x, double y)
Definition: vf_geq.c:239
ff_fraps_decoder
const FFCodec ff_fraps_decoder
Definition: fraps.c:342
FrapsContext::tmpbuf_size
int tmpbuf_size
Definition: fraps.c:56
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:325
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
AVCOL_RANGE_JPEG
@ AVCOL_RANGE_JPEG
Full range content.
Definition: pixfmt.h:599
AVPacket::data
uint8_t * data
Definition: packet.h:374
b
#define b
Definition: input.c:34
FFCodec
Definition: codec_internal.h:112
AV_PIX_FMT_BGR24
@ AV_PIX_FMT_BGR24
packed RGB 8:8:8, 24bpp, BGRBGR...
Definition: pixfmt.h:69
decode_end
static av_cold int decode_end(AVCodecContext *avctx)
closes decoder
Definition: fraps.c:333
thread.h
init
static int init
Definition: av_tx.c:47
FFCodec::p
AVCodec p
The public AVCodec.
Definition: codec_internal.h:116
FF_HUFFMAN_FLAG_ZERO_COUNT
#define FF_HUFFMAN_FLAG_ZERO_COUNT
Definition: huffman.h:40
U
#define U(x)
Definition: vp56_arith.h:37
GetBitContext
Definition: get_bits.h:61
ff_thread_get_buffer
the pkt_dts and pkt_pts fields in AVFrame will work as usual Restrictions on codec whose streams don t reset across will not work because their bitstreams cannot be decoded in parallel *The contents of buffers must not be read before as well as code calling up to before the decode process starts Call have so the codec calls ff_thread_report set FF_CODEC_CAP_ALLOCATE_PROGRESS in AVCodec caps_internal and use ff_thread_get_buffer() to allocate frames. The frames must then be freed with ff_thread_release_buffer(). Otherwise decode directly into the user-supplied frames. Call ff_thread_report_progress() after some part of the current picture has decoded. A good place to put this is where draw_horiz_band() is called - add this if it isn 't called anywhere
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
init_get_bits8
static int init_get_bits8(GetBitContext *s, const uint8_t *buffer, int byte_size)
Initialize GetBitContext.
Definition: get_bits.h:667
FF_CODEC_DECODE_CB
#define FF_CODEC_DECODE_CB(func)
Definition: codec_internal.h:254
s
#define s(width, name)
Definition: cbs_vp9.c:256
FrapsContext
local variable storage
Definition: fraps.c:52
get_bits.h
AV_CODEC_CAP_FRAME_THREADS
#define AV_CODEC_CAP_FRAME_THREADS
Codec supports frame-level multithreading.
Definition: codec.h:113
FPS_TAG
#define FPS_TAG
Definition: fraps.c:46
ff_bswapdsp_init
av_cold void ff_bswapdsp_init(BswapDSPContext *c)
Definition: bswapdsp.c:49
NULL
#define NULL
Definition: coverity.c:32
AVERROR_PATCHWELCOME
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:64
AVCodecContext::color_range
enum AVColorRange color_range
MPEG vs JPEG YUV range.
Definition: avcodec.h:973
fraps2_decode_plane
static int fraps2_decode_plane(FrapsContext *s, uint8_t *dst, int stride, int w, int h, const uint8_t *src, int size, int Uoff, const int step)
decode Fraps v2 packed plane
Definition: fraps.c:90
AV_PIX_FMT_YUVJ420P
@ AV_PIX_FMT_YUVJ420P
planar YUV 4:2:0, 12bpp, full scale (JPEG), deprecated in favor of AV_PIX_FMT_YUV420P and setting col...
Definition: pixfmt.h:78
AV_PICTURE_TYPE_I
@ AV_PICTURE_TYPE_I
Intra.
Definition: avutil.h:274
get_vlc2
static av_always_inline int get_vlc2(GetBitContext *s, const VLCElem *table, int bits, int max_depth)
Parse a vlc code.
Definition: get_bits.h:787
AVCOL_RANGE_UNSPECIFIED
@ AVCOL_RANGE_UNSPECIFIED
Definition: pixfmt.h:565
decode_frame
static int decode_frame(AVCodecContext *avctx, AVFrame *f, int *got_frame, AVPacket *avpkt)
Definition: fraps.c:136
planes
static const struct @328 planes[]
AV_CODEC_ID_FRAPS
@ AV_CODEC_ID_FRAPS
Definition: codec_id.h:126
f
f
Definition: af_crystalizer.c:122
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:375
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:117
codec_internal.h
for
for(k=2;k<=8;++k)
Definition: h264pred_template.c:425
size
int size
Definition: twinvq_data.h:10344
avpriv_report_missing_feature
void avpriv_report_missing_feature(void *avc, const char *msg,...) av_printf_format(2
Log a generic warning message about a missing feature.
header
static const uint8_t header[24]
Definition: sdr2.c:67
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
FrapsContext::bdsp
BswapDSPContext bdsp
Definition: fraps.c:54
version
version
Definition: libkvazaar.c:313
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:269
av_fast_padded_malloc
void av_fast_padded_malloc(void *ptr, unsigned int *size, size_t min_size)
Same behaviour av_fast_malloc but the buffer has additional AV_INPUT_BUFFER_PADDING_SIZE at the end w...
Definition: utils.c:48
FF_CODEC_CAP_INIT_THREADSAFE
#define FF_CODEC_CAP_INIT_THREADSAFE
The codec does not modify any global variables in the init function, allowing to call the init functi...
Definition: codec_internal.h:31
AVCodec::name
const char * name
Name of the codec implementation.
Definition: codec.h:203
AVCOL_SPC_UNSPECIFIED
@ AVCOL_SPC_UNSPECIFIED
Definition: pixfmt.h:528
AVCodecContext::height
int height
Definition: avcodec.h:562
AVCodecContext::pix_fmt
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:599
ff_free_vlc
void ff_free_vlc(VLC *vlc)
Definition: vlc.c:375
avcodec.h
stride
#define stride
Definition: h264pred_template.c:537
AV_PIX_FMT_PAL8
@ AV_PIX_FMT_PAL8
8 bits with AV_PIX_FMT_RGB32 palette
Definition: pixfmt.h:77
ret
ret
Definition: filter_design.txt:187
ff_huff_build_tree
int ff_huff_build_tree(void *logctx, VLC *vlc, int nb_codes, int nb_bits, Node *nodes, HuffCmp cmp, int flags)
nodes size must be 2*nb_codes first nb_codes nodes.count must be set
Definition: huffman.c:159
AV_RL32
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_RL32
Definition: bytestream.h:92
FrapsContext::tmpbuf
uint8_t * tmpbuf
Definition: fraps.c:55
huff_cmp
static int huff_cmp(const void *va, const void *vb)
Comparator - our nodes should ascend by count but with preserved symbol order.
Definition: fraps.c:81
AVCodecContext
main external API structure.
Definition: avcodec.h:389
VLC
Definition: vlc.h:31
huffman.h
decode_init
static av_cold int decode_init(AVCodecContext *avctx)
initializes decoder
Definition: fraps.c:65
VLC::table
VLCElem * table
Definition: vlc.h:33
VLC_BITS
#define VLC_BITS
Definition: fraps.c:47
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
AVPacket
This structure stores compressed data.
Definition: packet.h:351
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:416
cr
static double cr(void *priv, double x, double y)
Definition: vf_geq.c:240
av_freep
#define av_freep(p)
Definition: tableprint_vlc.h:34
src
INIT_CLIP pixel * src
Definition: h264pred_template.c:418
AVCodecContext::width
int width
picture width / height.
Definition: avcodec.h:562
bytestream.h
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
BswapDSPContext
Definition: bswapdsp.h:24
h
h
Definition: vp9dsp_template.c:2038
AVCOL_SPC_BT709
@ AVCOL_SPC_BT709
also ITU-R BT1361 / IEC 61966-2-4 xvYCC709 / derived in SMPTE RP 177 Annex B
Definition: pixfmt.h:527