FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
nuv.c
Go to the documentation of this file.
1 /*
2  * NuppelVideo decoder
3  * Copyright (c) 2006 Reimar Doeffinger
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 #include <stdio.h>
23 #include <stdlib.h>
24 #include <limits.h>
25 
26 #include "libavutil/bswap.h"
27 #include "libavutil/common.h"
28 #include "libavutil/intreadwrite.h"
29 #include "libavutil/lzo.h"
30 #include "libavutil/imgutils.h"
31 #include "avcodec.h"
32 #include "idctdsp.h"
33 #include "internal.h"
34 #include "rtjpeg.h"
35 
36 typedef struct NuvContext {
39  int quality;
40  int width, height;
41  unsigned int decomp_size;
42  unsigned char *decomp_buf;
43  uint32_t lq[64], cq[64];
45 } NuvContext;
46 
47 static const uint8_t fallback_lquant[] = {
48  16, 11, 10, 16, 24, 40, 51, 61,
49  12, 12, 14, 19, 26, 58, 60, 55,
50  14, 13, 16, 24, 40, 57, 69, 56,
51  14, 17, 22, 29, 51, 87, 80, 62,
52  18, 22, 37, 56, 68, 109, 103, 77,
53  24, 35, 55, 64, 81, 104, 113, 92,
54  49, 64, 78, 87, 103, 121, 120, 101,
55  72, 92, 95, 98, 112, 100, 103, 99
56 };
57 
58 static const uint8_t fallback_cquant[] = {
59  17, 18, 24, 47, 99, 99, 99, 99,
60  18, 21, 26, 66, 99, 99, 99, 99,
61  24, 26, 56, 99, 99, 99, 99, 99,
62  47, 66, 99, 99, 99, 99, 99, 99,
63  99, 99, 99, 99, 99, 99, 99, 99,
64  99, 99, 99, 99, 99, 99, 99, 99,
65  99, 99, 99, 99, 99, 99, 99, 99,
66  99, 99, 99, 99, 99, 99, 99, 99
67 };
68 
69 /**
70  * @brief copy frame data from buffer to AVFrame, handling stride.
71  * @param f destination AVFrame
72  * @param src source buffer, does not use any line-stride
73  * @param width width of the video frame
74  * @param height height of the video frame
75  */
76 static void copy_frame(AVFrame *f, const uint8_t *src, int width, int height)
77 {
78  uint8_t *src_data[4];
79  int src_linesize[4];
80  av_image_fill_arrays(src_data, src_linesize, src,
81  f->format, width, height, 1);
82  av_image_copy(f->data, f->linesize, (const uint8_t **)src_data, src_linesize,
83  f->format, width, height);
84 }
85 
86 /**
87  * @brief extract quantization tables from codec data into our context
88  */
89 static int get_quant(AVCodecContext *avctx, NuvContext *c, const uint8_t *buf,
90  int size)
91 {
92  int i;
93  if (size < 2 * 64 * 4) {
94  av_log(avctx, AV_LOG_ERROR, "insufficient rtjpeg quant data\n");
95  return AVERROR_INVALIDDATA;
96  }
97  for (i = 0; i < 64; i++, buf += 4)
98  c->lq[i] = AV_RL32(buf);
99  for (i = 0; i < 64; i++, buf += 4)
100  c->cq[i] = AV_RL32(buf);
101  return 0;
102 }
103 
104 /**
105  * @brief set quantization tables from a quality value
106  */
107 static void get_quant_quality(NuvContext *c, int quality)
108 {
109  int i;
110  quality = FFMAX(quality, 1);
111  for (i = 0; i < 64; i++) {
112  c->lq[i] = (fallback_lquant[i] << 7) / quality;
113  c->cq[i] = (fallback_cquant[i] << 7) / quality;
114  }
115 }
116 
117 static int codec_reinit(AVCodecContext *avctx, int width, int height,
118  int quality)
119 {
120  NuvContext *c = avctx->priv_data;
121  int ret;
122 
123  width = FFALIGN(width, 2);
124  height = FFALIGN(height, 2);
125  if (quality >= 0)
126  get_quant_quality(c, quality);
127  if (width != c->width || height != c->height) {
128  // also reserve space for a possible additional header
129  int buf_size = height * width * 3 / 2
132  if (buf_size > INT_MAX/8)
133  return -1;
134  if ((ret = av_image_check_size(height, width, 0, avctx)) < 0)
135  return ret;
136  avctx->width = c->width = width;
137  avctx->height = c->height = height;
139  buf_size);
140  if (!c->decomp_buf) {
141  av_log(avctx, AV_LOG_ERROR,
142  "Can't allocate decompression buffer.\n");
143  return AVERROR(ENOMEM);
144  }
145  ff_rtjpeg_decode_init(&c->rtj, c->width, c->height, c->lq, c->cq);
146  av_frame_unref(c->pic);
147  return 1;
148  } else if (quality != c->quality)
149  ff_rtjpeg_decode_init(&c->rtj, c->width, c->height, c->lq, c->cq);
150 
151  return 0;
152 }
153 
154 static int decode_frame(AVCodecContext *avctx, void *data, int *got_frame,
155  AVPacket *avpkt)
156 {
157  const uint8_t *buf = avpkt->data;
158  int buf_size = avpkt->size;
159  NuvContext *c = avctx->priv_data;
160  AVFrame *picture = data;
161  int orig_size = buf_size;
162  int keyframe, ret;
163  int size_change = 0;
164  int result, init_frame = !avctx->frame_number;
165  enum {
166  NUV_UNCOMPRESSED = '0',
167  NUV_RTJPEG = '1',
168  NUV_RTJPEG_IN_LZO = '2',
169  NUV_LZO = '3',
170  NUV_BLACK = 'N',
171  NUV_COPY_LAST = 'L'
172  } comptype;
173 
174  if (buf_size < 12) {
175  av_log(avctx, AV_LOG_ERROR, "coded frame too small\n");
176  return AVERROR_INVALIDDATA;
177  }
178 
179  // codec data (rtjpeg quant tables)
180  if (buf[0] == 'D' && buf[1] == 'R') {
181  int ret;
182  // Skip the rest of the frame header.
183  buf = &buf[12];
184  buf_size -= 12;
185  ret = get_quant(avctx, c, buf, buf_size);
186  if (ret < 0)
187  return ret;
188  ff_rtjpeg_decode_init(&c->rtj, c->width, c->height, c->lq, c->cq);
189  return orig_size;
190  }
191 
192  if (buf_size < 12 || buf[0] != 'V') {
193  av_log(avctx, AV_LOG_ERROR, "not a nuv video frame\n");
194  return AVERROR_INVALIDDATA;
195  }
196  comptype = buf[1];
197  switch (comptype) {
198  case NUV_RTJPEG_IN_LZO:
199  case NUV_RTJPEG:
200  keyframe = !buf[2];
201  break;
202  case NUV_COPY_LAST:
203  keyframe = 0;
204  break;
205  default:
206  keyframe = 1;
207  break;
208  }
209 retry:
210  // Skip the rest of the frame header.
211  buf = &buf[12];
212  buf_size -= 12;
213  if (comptype == NUV_RTJPEG_IN_LZO || comptype == NUV_LZO) {
215  int inlen = buf_size;
216  if (av_lzo1x_decode(c->decomp_buf, &outlen, buf, &inlen)) {
217  av_log(avctx, AV_LOG_ERROR, "error during lzo decompression\n");
218  return AVERROR_INVALIDDATA;
219  }
220  buf = c->decomp_buf;
222  memset(c->decomp_buf + buf_size, 0, AV_INPUT_BUFFER_PADDING_SIZE);
223  }
224  if (c->codec_frameheader) {
225  int w, h, q;
226  if (buf_size < RTJPEG_HEADER_SIZE) {
227  av_log(avctx, AV_LOG_ERROR, "Too small NUV video frame\n");
228  return AVERROR_INVALIDDATA;
229  }
230  // There seem to exist two variants of this header: one starts with 'V'
231  // and 5 bytes unknown, the other matches current MythTV and is 4 bytes size,
232  // 1 byte header size (== 12), 1 byte version (== 0)
233  if (buf[0] != 'V' && AV_RL16(&buf[4]) != 0x000c) {
234  av_log(avctx, AV_LOG_ERROR, "Unknown secondary frame header (wrong codec_tag?)\n");
235  return AVERROR_INVALIDDATA;
236  }
237  w = AV_RL16(&buf[6]);
238  h = AV_RL16(&buf[8]);
239  q = buf[10];
240  if ((result = codec_reinit(avctx, w, h, q)) < 0)
241  return result;
242  if (result) {
243  buf = avpkt->data;
244  buf_size = avpkt->size;
245  size_change = 1;
246  goto retry;
247  }
248  buf = &buf[RTJPEG_HEADER_SIZE];
249  buf_size -= RTJPEG_HEADER_SIZE;
250  }
251 
252  if (size_change || keyframe) {
253  av_frame_unref(c->pic);
254  init_frame = 1;
255  }
256 
257  if ((result = ff_reget_buffer(avctx, c->pic)) < 0)
258  return result;
259  if (init_frame) {
260  memset(c->pic->data[0], 0, avctx->height * c->pic->linesize[0]);
261  memset(c->pic->data[1], 0x80, avctx->height * c->pic->linesize[1] / 2);
262  memset(c->pic->data[2], 0x80, avctx->height * c->pic->linesize[2] / 2);
263  }
264 
266  c->pic->key_frame = keyframe;
267  // decompress/copy/whatever data
268  switch (comptype) {
269  case NUV_LZO:
270  case NUV_UNCOMPRESSED: {
271  int height = c->height;
272  if (buf_size < c->width * height * 3 / 2) {
273  av_log(avctx, AV_LOG_ERROR, "uncompressed frame too short\n");
274  height = buf_size / c->width / 3 * 2;
275  }
276  if(height > 0)
277  copy_frame(c->pic, buf, c->width, height);
278  break;
279  }
280  case NUV_RTJPEG_IN_LZO:
281  case NUV_RTJPEG:
282  ret = ff_rtjpeg_decode_frame_yuv420(&c->rtj, c->pic, buf, buf_size);
283  if (ret < 0)
284  return ret;
285  break;
286  case NUV_BLACK:
287  memset(c->pic->data[0], 0, c->width * c->height);
288  memset(c->pic->data[1], 128, c->width * c->height / 4);
289  memset(c->pic->data[2], 128, c->width * c->height / 4);
290  break;
291  case NUV_COPY_LAST:
292  /* nothing more to do here */
293  break;
294  default:
295  av_log(avctx, AV_LOG_ERROR, "unknown compression\n");
296  return AVERROR_INVALIDDATA;
297  }
298 
299  if ((result = av_frame_ref(picture, c->pic)) < 0)
300  return result;
301 
302  *got_frame = 1;
303  return orig_size;
304 }
305 
307 {
308  NuvContext *c = avctx->priv_data;
309  int ret;
310 
311  c->pic = av_frame_alloc();
312  if (!c->pic)
313  return AVERROR(ENOMEM);
314 
315  avctx->pix_fmt = AV_PIX_FMT_YUV420P;
316  c->decomp_buf = NULL;
317  c->quality = -1;
318  c->width = 0;
319  c->height = 0;
320 
321  c->codec_frameheader = avctx->codec_tag == MKTAG('R', 'J', 'P', 'G');
322 
323  if (avctx->extradata_size)
324  get_quant(avctx, c, avctx->extradata, avctx->extradata_size);
325 
326  ff_rtjpeg_init(&c->rtj, avctx);
327 
328  if ((ret = codec_reinit(avctx, avctx->width, avctx->height, -1)) < 0)
329  return ret;
330 
331  return 0;
332 }
333 
335 {
336  NuvContext *c = avctx->priv_data;
337 
338  av_freep(&c->decomp_buf);
339  av_frame_free(&c->pic);
340 
341  return 0;
342 }
343 
345  .name = "nuv",
346  .long_name = NULL_IF_CONFIG_SMALL("NuppelVideo/RTJPEG"),
347  .type = AVMEDIA_TYPE_VIDEO,
348  .id = AV_CODEC_ID_NUV,
349  .priv_data_size = sizeof(NuvContext),
350  .init = decode_init,
351  .close = decode_end,
352  .decode = decode_frame,
353  .capabilities = AV_CODEC_CAP_DR1,
354 };
#define NULL
Definition: coverity.c:32
static av_cold int decode_end(AVCodecContext *avctx)
Definition: nuv.c:334
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
int width
Definition: nuv.c:40
This structure describes decoded (raw) audio or video data.
Definition: frame.h:201
int height
Definition: nuv.c:40
ptrdiff_t const GLvoid * data
Definition: opengl_enc.c:101
misc image utilities
static av_cold int init(AVCodecContext *avctx)
Definition: avrndec.c:35
int size
Definition: avcodec.h:1680
int av_image_fill_arrays(uint8_t *dst_data[4], int dst_linesize[4], const uint8_t *src, enum AVPixelFormat pix_fmt, int width, int height, int align)
Setup the data pointers and linesizes based on the specified image parameters and the provided array...
Definition: imgutils.c:409
static int get_quant(AVCodecContext *avctx, NuvContext *c, const uint8_t *buf, int size)
extract quantization tables from codec data into our context
Definition: nuv.c:89
int codec_frameheader
Definition: nuv.c:38
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:1989
static void get_quant_quality(NuvContext *c, int quality)
set quantization tables from a quality value
Definition: nuv.c:107
static const uint8_t fallback_lquant[]
Definition: nuv.c:47
#define src
Definition: vp8dsp.c:254
AVCodec.
Definition: avcodec.h:3739
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_WL32 unsigned int_TMPL AV_WL24 unsigned int_TMPL AV_RL16
Definition: bytestream.h:87
static void decode(AVCodecContext *dec_ctx, AVPacket *pkt, AVFrame *frame, FILE *outfile)
Definition: decode_audio.c:42
int ff_reget_buffer(AVCodecContext *avctx, AVFrame *frame)
Identical in function to av_frame_make_writable(), except it uses ff_get_buffer() to allocate the buf...
Definition: decode.c:1718
int quality
Definition: nuv.c:39
Definition: nuv.c:36
uint8_t
#define av_cold
Definition: attributes.h:82
AVFrame * av_frame_alloc(void)
Allocate an AVFrame and set its fields to default values.
Definition: frame.c:150
int ff_rtjpeg_decode_frame_yuv420(RTJpegContext *c, AVFrame *f, const uint8_t *buf, int buf_size)
decode one rtjpeg YUV420 frame
Definition: rtjpeg.c:106
void ff_rtjpeg_init(RTJpegContext *c, AVCodecContext *avctx)
Definition: rtjpeg.c:170
int av_frame_ref(AVFrame *dst, const AVFrame *src)
Set up a new reference to the data described by the source frame.
Definition: frame.c:395
#define AV_LZO_OUTPUT_PADDING
Definition: lzo.h:47
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:1876
#define height
uint8_t * data
Definition: avcodec.h:1679
ptrdiff_t size
Definition: opengl_enc.c:101
#define FFALIGN(x, a)
Definition: macros.h:48
#define av_log(a,...)
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
#define AVERROR(e)
Definition: error.h:43
void av_frame_free(AVFrame **frame)
Free the frame and any dynamically allocated objects in it, e.g.
Definition: frame.c:163
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:179
uint16_t width
Definition: gdv.c:47
const char * name
Name of the codec implementation.
Definition: avcodec.h:3746
#define FFMAX(a, b)
Definition: common.h:94
void av_image_copy(uint8_t *dst_data[4], int dst_linesizes[4], const uint8_t *src_data[4], const int src_linesizes[4], enum AVPixelFormat pix_fmt, int width, int height)
Copy image in src_data to dst_data.
Definition: imgutils.c:385
static av_cold int decode_init(AVCodecContext *avctx)
Definition: nuv.c:306
AVCodec ff_nuv_decoder
Definition: nuv.c:344
void av_fast_malloc(void *ptr, unsigned int *size, size_t min_size)
Allocate a buffer, reusing the given one if large enough.
Definition: mem.c:469
unsigned char * decomp_buf
Definition: nuv.c:42
int av_image_check_size(unsigned int w, unsigned int h, int log_offset, void *log_ctx)
Check if the given dimension of an image is valid, meaning that all bytes of the image can be address...
Definition: imgutils.c:281
enum AVPictureType pict_type
Picture type of the frame.
Definition: frame.h:284
int width
picture width / height.
Definition: avcodec.h:1948
void ff_rtjpeg_decode_init(RTJpegContext *c, int width, int height, const uint32_t *lquant, const uint32_t *cquant)
initialize an RTJpegContext, may be called multiple times
Definition: rtjpeg.c:158
int av_lzo1x_decode(void *out, int *outlen, const void *in, int *inlen)
Decodes LZO 1x compressed data.
Definition: lzo.c:134
int format
format of the frame, -1 if unknown or unset Values correspond to enum AVPixelFormat for video frames...
Definition: frame.h:274
Libavcodec external API header.
int linesize[AV_NUM_DATA_POINTERS]
For video, size in bytes of each picture line.
Definition: frame.h:232
main external API structure.
Definition: avcodec.h:1761
static void copy_frame(AVFrame *f, const uint8_t *src, int width, int height)
copy frame data from buffer to AVFrame, handling stride.
Definition: nuv.c:76
unsigned int codec_tag
fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
Definition: avcodec.h:1793
void * buf
Definition: avisynth_c.h:690
int extradata_size
Definition: avcodec.h:1877
byte swapping routines
unsigned int decomp_size
Definition: nuv.c:41
void av_frame_unref(AVFrame *frame)
Unreference all the buffers referenced by frame and reset the frame fields.
Definition: frame.c:505
uint8_t * data[AV_NUM_DATA_POINTERS]
pointer to the picture/channel planes.
Definition: frame.h:215
static const uint8_t fallback_cquant[]
Definition: nuv.c:58
planar YUV 4:2:0, 12bpp, (1 Cr & Cb sample per 2x2 Y samples)
Definition: pixfmt.h:62
common internal api header.
common internal and external API header
static double c[64]
AVFrame * pic
Definition: nuv.c:37
#define AV_INPUT_BUFFER_PADDING_SIZE
Required number of additionally allocated bytes at the end of the input bitstream for decoding...
Definition: avcodec.h:777
void * priv_data
Definition: avcodec.h:1803
static int codec_reinit(AVCodecContext *avctx, int width, int height, int quality)
Definition: nuv.c:117
uint32_t lq[64]
Definition: nuv.c:43
#define RTJPEG_HEADER_SIZE
Definition: rtjpeg.h:31
int key_frame
1 -> keyframe, 0-> not
Definition: frame.h:279
int frame_number
Frame counter, set by libavcodec.
Definition: avcodec.h:2554
#define av_freep(p)
static void init_frame(FlacEncodeContext *s, int nb_samples)
Definition: flacenc.c:470
static int decode_frame(AVCodecContext *avctx, void *data, int *got_frame, AVPacket *avpkt)
Definition: nuv.c:154
RTJpegContext rtj
Definition: nuv.c:44
#define MKTAG(a, b, c, d)
Definition: common.h:342
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_RL32
Definition: bytestream.h:87
This structure stores compressed data.
Definition: avcodec.h:1656
#define AV_CODEC_CAP_DR1
Codec uses get_buffer() for allocating buffers and supports custom allocators.
Definition: avcodec.h:1002
uint32_t cq[64]
Definition: nuv.c:43
Predicted.
Definition: avutil.h:275