Remove angular brackets from Doxygen comments; Doxygen confuses them for HTML.
[libav.git] / libavcodec / fraps.c
CommitLineData
b81f8949
MM
1/*
2 * Fraps FPS1 decoder
3 * Copyright (c) 2005 Roine Gustafsson
08a4c4bf 4 * Copyright (c) 2006 Konstantin Shishkov
b81f8949 5 *
b78e7197
DB
6 * This file is part of FFmpeg.
7 *
8 * FFmpeg is free software; you can redistribute it and/or
b81f8949
MM
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
b78e7197 11 * version 2.1 of the License, or (at your option) any later version.
b81f8949 12 *
b78e7197 13 * FFmpeg is distributed in the hope that it will be useful,
b81f8949
MM
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
b78e7197 19 * License along with FFmpeg; if not, write to the Free Software
5509bffa 20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
b81f8949 21 */
115329f1 22
b81f8949 23/**
ba87f080 24 * @file
b81f8949 25 * Lossless Fraps 'FPS1' decoder
0baf34d8 26 * @author Roine Gustafsson (roine at users sf net)
08a4c4bf 27 * @author Konstantin Shishkov
115329f1 28 *
b81f8949
MM
29 * Codec algorithm for version 0 is taken from Transcode <www.transcoding.org>
30 *
08a4c4bf 31 * Version 2 files support by Konstantin Shishkov
b81f8949 32 */
115329f1 33
b81f8949 34#include "avcodec.h"
9106a698 35#include "get_bits.h"
437c2079
AJ
36#include "huffman.h"
37#include "bytestream.h"
08a4c4bf 38#include "dsputil.h"
b81f8949 39
4935b1b9 40#define FPS_TAG MKTAG('F', 'P', 'S', 'x')
b81f8949
MM
41
42/**
43 * local variable storage
44 */
45typedef struct FrapsContext{
46 AVCodecContext *avctx;
47 AVFrame frame;
08a4c4bf
KS
48 uint8_t *tmpbuf;
49 DSPContext dsp;
b81f8949
MM
50} FrapsContext;
51
52
53/**
54 * initializes decoder
55 * @param avctx codec context
56 * @return 0 on success or negative if fails
57 */
98a6fff9 58static av_cold int decode_init(AVCodecContext *avctx)
b81f8949
MM
59{
60 FrapsContext * const s = avctx->priv_data;
61
62 avctx->coded_frame = (AVFrame*)&s->frame;
b81f8949
MM
63 avctx->pix_fmt= PIX_FMT_NONE; /* set in decode_frame */
64
65 s->avctx = avctx;
08a4c4bf
KS
66 s->tmpbuf = NULL;
67
68 dsputil_init(&s->dsp, avctx);
b81f8949
MM
69
70 return 0;
71}
72
08a4c4bf
KS
73/**
74 * Comparator - our nodes should ascend by count
75 * but with preserved symbol order
76 */
859cfdc0
MR
77static int huff_cmp(const void *va, const void *vb){
78 const Node *a = va, *b = vb;
08a4c4bf
KS
79 return (a->count - b->count)*256 + a->sym - b->sym;
80}
81
08a4c4bf
KS
82/**
83 * decode Fraps v2 packed plane
84 */
85static int fraps2_decode_plane(FrapsContext *s, uint8_t *dst, int stride, int w,
6a02cb82
KS
86 int h, const uint8_t *src, int size, int Uoff,
87 const int step)
08a4c4bf
KS
88{
89 int i, j;
08a4c4bf
KS
90 GetBitContext gb;
91 VLC vlc;
437c2079 92 Node nodes[512];
08a4c4bf 93
437c2079
AJ
94 for(i = 0; i < 256; i++)
95 nodes[i].count = bytestream_get_le32(&src);
96 size -= 1024;
a73cbf97
AJ
97 if (ff_huff_build_tree(s->avctx, &vlc, 256, nodes, huff_cmp,
98 FF_HUFFMAN_FLAG_ZERO_COUNT) < 0)
08a4c4bf 99 return -1;
08a4c4bf
KS
100 /* we have built Huffman table and are ready to decode plane */
101
102 /* convert bits so they may be used by standard bitreader */
721052e9 103 s->dsp.bswap_buf((uint32_t *)s->tmpbuf, (const uint32_t *)src, size >> 2);
08a4c4bf
KS
104
105 init_get_bits(&gb, s->tmpbuf, size * 8);
106 for(j = 0; j < h; j++){
6a02cb82 107 for(i = 0; i < w*step; i += step){
437c2079 108 dst[i] = get_vlc2(&gb, vlc.table, 9, 3);
08a4c4bf
KS
109 /* lines are stored as deltas between previous lines
110 * and we need to add 0x80 to the first lines of chroma planes
111 */
112 if(j) dst[i] += dst[i - stride];
113 else if(Uoff) dst[i] += 0x80;
114 }
115 dst += stride;
116 }
117 free_vlc(&vlc);
118 return 0;
119}
b81f8949
MM
120
121/**
122 * decode a frame
123 * @param avctx codec context
124 * @param data output AVFrame
125 * @param data_size size of output data or 0 if no picture is returned
b81f8949
MM
126 * @return number of consumed bytes on success or negative if decode fails
127 */
115329f1 128static int decode_frame(AVCodecContext *avctx,
b81f8949 129 void *data, int *data_size,
7a00bbad 130 AVPacket *avpkt)
b81f8949 131{
7a00bbad
TB
132 const uint8_t *buf = avpkt->data;
133 int buf_size = avpkt->size;
b81f8949
MM
134 FrapsContext * const s = avctx->priv_data;
135 AVFrame *frame = data;
136 AVFrame * const f = (AVFrame*)&s->frame;
137 uint32_t header;
138 unsigned int version,header_size;
139 unsigned int x, y;
1855abe5 140 const uint32_t *buf32;
b81f8949 141 uint32_t *luma1,*luma2,*cb,*cr;
08a4c4bf 142 uint32_t offs[4];
af176191 143 int i, j, is_chroma, planes;
b81f8949
MM
144
145
fead30d4 146 header = AV_RL32(buf);
b81f8949
MM
147 version = header & 0xff;
148 header_size = (header & (1<<30))? 8 : 4; /* bit 30 means pad to 8 bytes */
149
675f7114 150 if (version > 5) {
115329f1 151 av_log(avctx, AV_LOG_ERROR,
b81f8949 152 "This file is encoded with Fraps version %d. " \
675f7114 153 "This codec can only decode versions <= 5.\n", version);
b81f8949
MM
154 return -1;
155 }
156
157 buf+=4;
158 if (header_size == 8)
159 buf+=4;
115329f1 160
b81f8949
MM
161 switch(version) {
162 case 0:
163 default:
164 /* Fraps v0 is a reordered YUV420 */
165 avctx->pix_fmt = PIX_FMT_YUV420P;
166
115329f1 167 if ( (buf_size != avctx->width*avctx->height*3/2+header_size) &&
b81f8949
MM
168 (buf_size != header_size) ) {
169 av_log(avctx, AV_LOG_ERROR,
115329f1 170 "Invalid frame length %d (should be %d)\n",
b81f8949
MM
171 buf_size, avctx->width*avctx->height*3/2+header_size);
172 return -1;
173 }
115329f1 174
b81f8949 175 if (( (avctx->width % 8) != 0) || ( (avctx->height % 2) != 0 )) {
115329f1 176 av_log(avctx, AV_LOG_ERROR, "Invalid frame size %dx%d\n",
b81f8949
MM
177 avctx->width, avctx->height);
178 return -1;
179 }
180
115329f1
DB
181 f->reference = 1;
182 f->buffer_hints = FF_BUFFER_HINTS_VALID |
183 FF_BUFFER_HINTS_PRESERVE |
b81f8949
MM
184 FF_BUFFER_HINTS_REUSABLE;
185 if (avctx->reget_buffer(avctx, f)) {
186 av_log(avctx, AV_LOG_ERROR, "reget_buffer() failed\n");
187 return -1;
115329f1 188 }
b81f8949 189 /* bit 31 means same as previous pic */
115329f1 190 f->pict_type = (header & (1<<31))? FF_P_TYPE : FF_I_TYPE;
b81f8949
MM
191 f->key_frame = f->pict_type == FF_I_TYPE;
192
115329f1 193 if (f->pict_type == FF_I_TYPE) {
1855abe5 194 buf32=(const uint32_t*)buf;
b81f8949
MM
195 for(y=0; y<avctx->height/2; y++){
196 luma1=(uint32_t*)&f->data[0][ y*2*f->linesize[0] ];
197 luma2=(uint32_t*)&f->data[0][ (y*2+1)*f->linesize[0] ];
198 cr=(uint32_t*)&f->data[1][ y*f->linesize[1] ];
199 cb=(uint32_t*)&f->data[2][ y*f->linesize[2] ];
200 for(x=0; x<avctx->width; x+=8){
201 *(luma1++) = *(buf32++);
202 *(luma1++) = *(buf32++);
203 *(luma2++) = *(buf32++);
204 *(luma2++) = *(buf32++);
205 *(cr++) = *(buf32++);
206 *(cb++) = *(buf32++);
207 }
208 }
209 }
210 break;
211
212 case 1:
213 /* Fraps v1 is an upside-down BGR24 */
214 avctx->pix_fmt = PIX_FMT_BGR24;
215
115329f1 216 if ( (buf_size != avctx->width*avctx->height*3+header_size) &&
b81f8949 217 (buf_size != header_size) ) {
115329f1 218 av_log(avctx, AV_LOG_ERROR,
b81f8949
MM
219 "Invalid frame length %d (should be %d)\n",
220 buf_size, avctx->width*avctx->height*3+header_size);
221 return -1;
222 }
223
224 f->reference = 1;
225 f->buffer_hints = FF_BUFFER_HINTS_VALID |
226 FF_BUFFER_HINTS_PRESERVE |
227 FF_BUFFER_HINTS_REUSABLE;
228 if (avctx->reget_buffer(avctx, f)) {
229 av_log(avctx, AV_LOG_ERROR, "reget_buffer() failed\n");
230 return -1;
231 }
232 /* bit 31 means same as previous pic */
233 f->pict_type = (header & (1<<31))? FF_P_TYPE : FF_I_TYPE;
234 f->key_frame = f->pict_type == FF_I_TYPE;
235
236 if (f->pict_type == FF_I_TYPE) {
237 for(y=0; y<avctx->height; y++)
238 memcpy(&f->data[0][ (avctx->height-y)*f->linesize[0] ],
239 &buf[y*avctx->width*3],
de5922f1 240 3*avctx->width);
b81f8949
MM
241 }
242 break;
243
244 case 2:
08a4c4bf 245 case 4:
b81f8949 246 /**
08a4c4bf 247 * Fraps v2 is Huffman-coded YUV420 planes
75a71b6c 248 * Fraps v4 is virtually the same
b81f8949 249 */
75a71b6c
KS
250 avctx->pix_fmt = PIX_FMT_YUV420P;
251 planes = 3;
08a4c4bf
KS
252 f->reference = 1;
253 f->buffer_hints = FF_BUFFER_HINTS_VALID |
254 FF_BUFFER_HINTS_PRESERVE |
255 FF_BUFFER_HINTS_REUSABLE;
256 if (avctx->reget_buffer(avctx, f)) {
257 av_log(avctx, AV_LOG_ERROR, "reget_buffer() failed\n");
258 return -1;
259 }
260 /* skip frame */
261 if(buf_size == 8) {
262 f->pict_type = FF_P_TYPE;
263 f->key_frame = 0;
264 break;
265 }
266 f->pict_type = FF_I_TYPE;
267 f->key_frame = 1;
fead30d4 268 if ((AV_RL32(buf) != FPS_TAG)||(buf_size < (planes*1024 + 24))) {
b81f8949
MM
269 av_log(avctx, AV_LOG_ERROR, "Fraps: error in data stream\n");
270 return -1;
271 }
08a4c4bf 272 for(i = 0; i < planes; i++) {
fead30d4 273 offs[i] = AV_RL32(buf + 4 + i * 4);
08a4c4bf
KS
274 if(offs[i] >= buf_size || (i && offs[i] <= offs[i - 1] + 1024)) {
275 av_log(avctx, AV_LOG_ERROR, "Fraps: plane %i offset is out of bounds\n", i);
276 return -1;
277 }
278 }
279 offs[planes] = buf_size;
280 for(i = 0; i < planes; i++){
281 is_chroma = !!i;
75a71b6c 282 s->tmpbuf = av_realloc(s->tmpbuf, offs[i + 1] - offs[i] - 1024 + FF_INPUT_BUFFER_PADDING_SIZE);
08a4c4bf 283 if(fraps2_decode_plane(s, f->data[i], f->linesize[i], avctx->width >> is_chroma,
6a02cb82 284 avctx->height >> is_chroma, buf + offs[i], offs[i + 1] - offs[i], is_chroma, 1) < 0) {
08a4c4bf
KS
285 av_log(avctx, AV_LOG_ERROR, "Error decoding plane %i\n", i);
286 return -1;
287 }
288 }
b81f8949 289 break;
675f7114 290 case 3:
8c908d7d
KS
291 case 5:
292 /* Virtually the same as version 4, but is for RGB24 */
293 avctx->pix_fmt = PIX_FMT_BGR24;
294 planes = 3;
295 f->reference = 1;
296 f->buffer_hints = FF_BUFFER_HINTS_VALID |
297 FF_BUFFER_HINTS_PRESERVE |
298 FF_BUFFER_HINTS_REUSABLE;
299 if (avctx->reget_buffer(avctx, f)) {
300 av_log(avctx, AV_LOG_ERROR, "reget_buffer() failed\n");
301 return -1;
302 }
303 /* skip frame */
304 if(buf_size == 8) {
305 f->pict_type = FF_P_TYPE;
306 f->key_frame = 0;
307 break;
308 }
309 f->pict_type = FF_I_TYPE;
310 f->key_frame = 1;
311 if ((AV_RL32(buf) != FPS_TAG)||(buf_size < (planes*1024 + 24))) {
312 av_log(avctx, AV_LOG_ERROR, "Fraps: error in data stream\n");
313 return -1;
314 }
315 for(i = 0; i < planes; i++) {
316 offs[i] = AV_RL32(buf + 4 + i * 4);
317 if(offs[i] >= buf_size || (i && offs[i] <= offs[i - 1] + 1024)) {
318 av_log(avctx, AV_LOG_ERROR, "Fraps: plane %i offset is out of bounds\n", i);
319 return -1;
320 }
321 }
322 offs[planes] = buf_size;
323 for(i = 0; i < planes; i++){
324 s->tmpbuf = av_realloc(s->tmpbuf, offs[i + 1] - offs[i] - 1024 + FF_INPUT_BUFFER_PADDING_SIZE);
325 if(fraps2_decode_plane(s, f->data[0] + i + (f->linesize[0] * (avctx->height - 1)), -f->linesize[0],
af176191 326 avctx->width, avctx->height, buf + offs[i], offs[i + 1] - offs[i], 0, 3) < 0) {
8c908d7d
KS
327 av_log(avctx, AV_LOG_ERROR, "Error decoding plane %i\n", i);
328 return -1;
329 }
330 }
af176191
KS
331 // convert pseudo-YUV into real RGB
332 for(j = 0; j < avctx->height; j++){
333 for(i = 0; i < avctx->width; i++){
76c655fb
KS
334 f->data[0][0 + i*3 + j*f->linesize[0]] += f->data[0][1 + i*3 + j*f->linesize[0]];
335 f->data[0][2 + i*3 + j*f->linesize[0]] += f->data[0][1 + i*3 + j*f->linesize[0]];
af176191
KS
336 }
337 }
8c908d7d 338 break;
b81f8949
MM
339 }
340
341 *frame = *f;
342 *data_size = sizeof(AVFrame);
343
344 return buf_size;
345}
346
347
348/**
349 * closes decoder
350 * @param avctx codec context
351 * @return 0 on success or negative if fails
352 */
98a6fff9 353static av_cold int decode_end(AVCodecContext *avctx)
b81f8949
MM
354{
355 FrapsContext *s = (FrapsContext*)avctx->priv_data;
356
357 if (s->frame.data[0])
358 avctx->release_buffer(avctx, &s->frame);
359
08a4c4bf 360 av_freep(&s->tmpbuf);
b81f8949
MM
361 return 0;
362}
363
364
365AVCodec fraps_decoder = {
366 "fraps",
72415b2a 367 AVMEDIA_TYPE_VIDEO,
b81f8949
MM
368 CODEC_ID_FRAPS,
369 sizeof(FrapsContext),
370 decode_init,
371 NULL,
372 decode_end,
373 decode_frame,
374 CODEC_CAP_DR1,
fe4bf374 375 .long_name = NULL_IF_CONFIG_SMALL("Fraps"),
b81f8949 376};