FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
iff.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2008 Jaikrishnan Menon <realityman@gmx.net>
3  * Copyright (c) 2010 Peter Ross <pross@xvid.org>
4  * Copyright (c) 2010 Sebastian Vater <cdgs.basty@googlemail.com>
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  * IFF file demuxer
26  * by Jaikrishnan Menon
27  * for more information on the .iff file format, visit:
28  * http://wiki.multimedia.cx/index.php?title=IFF
29  */
30 
31 #include "libavutil/avassert.h"
33 #include "libavutil/intreadwrite.h"
34 #include "libavutil/dict.h"
35 #include "libavcodec/bytestream.h"
36 #include "avformat.h"
37 #include "internal.h"
38 
39 #define ID_8SVX MKTAG('8','S','V','X')
40 #define ID_16SV MKTAG('1','6','S','V')
41 #define ID_MAUD MKTAG('M','A','U','D')
42 #define ID_MHDR MKTAG('M','H','D','R')
43 #define ID_MDAT MKTAG('M','D','A','T')
44 #define ID_VHDR MKTAG('V','H','D','R')
45 #define ID_ATAK MKTAG('A','T','A','K')
46 #define ID_RLSE MKTAG('R','L','S','E')
47 #define ID_CHAN MKTAG('C','H','A','N')
48 #define ID_PBM MKTAG('P','B','M',' ')
49 #define ID_ILBM MKTAG('I','L','B','M')
50 #define ID_BMHD MKTAG('B','M','H','D')
51 #define ID_DGBL MKTAG('D','G','B','L')
52 #define ID_CAMG MKTAG('C','A','M','G')
53 #define ID_CMAP MKTAG('C','M','A','P')
54 #define ID_ACBM MKTAG('A','C','B','M')
55 #define ID_DEEP MKTAG('D','E','E','P')
56 #define ID_RGB8 MKTAG('R','G','B','8')
57 #define ID_RGBN MKTAG('R','G','B','N')
58 
59 #define ID_FORM MKTAG('F','O','R','M')
60 #define ID_ANNO MKTAG('A','N','N','O')
61 #define ID_AUTH MKTAG('A','U','T','H')
62 #define ID_CHRS MKTAG('C','H','R','S')
63 #define ID_COPYRIGHT MKTAG('(','c',')',' ')
64 #define ID_CSET MKTAG('C','S','E','T')
65 #define ID_FVER MKTAG('F','V','E','R')
66 #define ID_NAME MKTAG('N','A','M','E')
67 #define ID_TEXT MKTAG('T','E','X','T')
68 #define ID_ABIT MKTAG('A','B','I','T')
69 #define ID_BODY MKTAG('B','O','D','Y')
70 #define ID_DBOD MKTAG('D','B','O','D')
71 #define ID_DPEL MKTAG('D','P','E','L')
72 #define ID_DLOC MKTAG('D','L','O','C')
73 #define ID_TVDC MKTAG('T','V','D','C')
74 
75 #define LEFT 2
76 #define RIGHT 4
77 #define STEREO 6
78 
79 /**
80  * This number of bytes if added at the beginning of each AVPacket
81  * which contain additional information about video properties
82  * which has to be shared between demuxer and decoder.
83  * This number may change between frames, e.g. the demuxer might
84  * set it to smallest possible size of 2 to indicate that there's
85  * no extradata changing in this frame.
86  */
87 #define IFF_EXTRA_VIDEO_SIZE 41
88 
89 typedef enum {
94 
95 typedef struct {
96  int64_t body_pos;
97  int64_t body_end;
98  uint32_t body_size;
100  unsigned maud_bits;
102  unsigned bitmap_compression; ///< delta compression method used
103  unsigned bpp; ///< bits per plane to decode (differs from bits_per_coded_sample if HAM)
104  unsigned ham; ///< 0 if non-HAM or number of hold bits (6 for bpp > 6, 4 otherwise)
105  unsigned flags; ///< 1 for EHB, 0 is no extra half darkening
106  unsigned transparency; ///< transparency color index in palette
107  unsigned masking; ///< masking method used
108  uint8_t tvdc[32]; ///< TVDC lookup table
110 
111 /* Metadata string read */
113  const char *const tag,
114  const unsigned data_size)
115 {
116  uint8_t *buf = ((data_size + 1) == 0) ? NULL : av_malloc(data_size + 1);
117 
118  if (!buf)
119  return AVERROR(ENOMEM);
120 
121  if (avio_read(s->pb, buf, data_size) != data_size) {
122  av_free(buf);
123  return AVERROR(EIO);
124  }
125  buf[data_size] = 0;
127  return 0;
128 }
129 
130 static int iff_probe(AVProbeData *p)
131 {
132  const uint8_t *d = p->buf;
133 
134  if ( AV_RL32(d) == ID_FORM &&
135  (AV_RL32(d+8) == ID_8SVX ||
136  AV_RL32(d+8) == ID_16SV ||
137  AV_RL32(d+8) == ID_MAUD ||
138  AV_RL32(d+8) == ID_PBM ||
139  AV_RL32(d+8) == ID_ACBM ||
140  AV_RL32(d+8) == ID_DEEP ||
141  AV_RL32(d+8) == ID_ILBM ||
142  AV_RL32(d+8) == ID_RGB8 ||
143  AV_RL32(d+8) == ID_RGBN) )
144  return AVPROBE_SCORE_MAX;
145  return 0;
146 }
147 
148 static const uint8_t deep_rgb24[] = {0, 0, 0, 3, 0, 1, 0, 8, 0, 2, 0, 8, 0, 3, 0, 8};
149 static const uint8_t deep_rgba[] = {0, 0, 0, 4, 0, 1, 0, 8, 0, 2, 0, 8, 0, 3, 0, 8};
150 static const uint8_t deep_bgra[] = {0, 0, 0, 4, 0, 3, 0, 8, 0, 2, 0, 8, 0, 1, 0, 8};
151 static const uint8_t deep_argb[] = {0, 0, 0, 4, 0,17, 0, 8, 0, 1, 0, 8, 0, 2, 0, 8};
152 static const uint8_t deep_abgr[] = {0, 0, 0, 4, 0,17, 0, 8, 0, 3, 0, 8, 0, 2, 0, 8};
153 
155 {
156  IffDemuxContext *iff = s->priv_data;
157  AVIOContext *pb = s->pb;
158  AVStream *st;
159  uint8_t *buf;
160  uint32_t chunk_id, data_size;
161  uint32_t screenmode = 0, num, den;
162  unsigned transparency = 0;
163  unsigned masking = 0; // no mask
164  uint8_t fmt[16];
165  int fmt_size;
166 
167  st = avformat_new_stream(s, NULL);
168  if (!st)
169  return AVERROR(ENOMEM);
170 
171  st->codec->channels = 1;
173  avio_skip(pb, 8);
174  // codec_tag used by ByteRun1 decoder to distinguish progressive (PBM) and interlaced (ILBM) content
175  st->codec->codec_tag = avio_rl32(pb);
176  iff->bitmap_compression = -1;
177  iff->svx8_compression = -1;
178  iff->maud_bits = -1;
179  iff->maud_compression = -1;
180 
181  while(!url_feof(pb)) {
182  uint64_t orig_pos;
183  int res;
184  const char *metadata_tag = NULL;
185  chunk_id = avio_rl32(pb);
186  data_size = avio_rb32(pb);
187  orig_pos = avio_tell(pb);
188 
189  switch(chunk_id) {
190  case ID_VHDR:
192 
193  if (data_size < 14)
194  return AVERROR_INVALIDDATA;
195  avio_skip(pb, 12);
196  st->codec->sample_rate = avio_rb16(pb);
197  if (data_size >= 16) {
198  avio_skip(pb, 1);
199  iff->svx8_compression = avio_r8(pb);
200  }
201  break;
202 
203  case ID_MHDR:
205 
206  if (data_size < 32)
207  return AVERROR_INVALIDDATA;
208  avio_skip(pb, 4);
209  iff->maud_bits = avio_rb16(pb);
210  avio_skip(pb, 2);
211  num = avio_rb32(pb);
212  den = avio_rb16(pb);
213  if (!den)
214  return AVERROR_INVALIDDATA;
215  avio_skip(pb, 2);
216  st->codec->sample_rate = num / den;
217  st->codec->channels = avio_rb16(pb);
218  iff->maud_compression = avio_rb16(pb);
219  if (st->codec->channels == 1)
221  else if (st->codec->channels == 2)
223  break;
224 
225  case ID_ABIT:
226  case ID_BODY:
227  case ID_DBOD:
228  case ID_MDAT:
229  iff->body_pos = avio_tell(pb);
230  iff->body_end = iff->body_pos + data_size;
231  iff->body_size = data_size;
232  break;
233 
234  case ID_CHAN:
235  if (data_size < 4)
236  return AVERROR_INVALIDDATA;
237  if (avio_rb32(pb) < 6) {
238  st->codec->channels = 1;
240  } else {
241  st->codec->channels = 2;
243  }
244  break;
245 
246  case ID_CAMG:
247  if (data_size < 4)
248  return AVERROR_INVALIDDATA;
249  screenmode = avio_rb32(pb);
250  break;
251 
252  case ID_CMAP:
253  if (data_size < 3 || data_size > 768 || data_size % 3) {
254  av_log(s, AV_LOG_ERROR, "Invalid CMAP chunk size %d\n",
255  data_size);
256  return AVERROR_INVALIDDATA;
257  }
258  st->codec->extradata_size = data_size + IFF_EXTRA_VIDEO_SIZE;
259  st->codec->extradata = av_malloc(data_size + IFF_EXTRA_VIDEO_SIZE + FF_INPUT_BUFFER_PADDING_SIZE);
260  if (!st->codec->extradata)
261  return AVERROR(ENOMEM);
262  if (avio_read(pb, st->codec->extradata + IFF_EXTRA_VIDEO_SIZE, data_size) < 0)
263  return AVERROR(EIO);
264  break;
265 
266  case ID_BMHD:
268  if (data_size <= 8)
269  return AVERROR_INVALIDDATA;
270  st->codec->width = avio_rb16(pb);
271  st->codec->height = avio_rb16(pb);
272  avio_skip(pb, 4); // x, y offset
274  if (data_size >= 10)
275  masking = avio_r8(pb);
276  if (data_size >= 11)
277  iff->bitmap_compression = avio_r8(pb);
278  if (data_size >= 14) {
279  avio_skip(pb, 1); // padding
280  transparency = avio_rb16(pb);
281  }
282  if (data_size >= 16) {
283  st->sample_aspect_ratio.num = avio_r8(pb);
284  st->sample_aspect_ratio.den = avio_r8(pb);
285  }
286  break;
287 
288  case ID_DPEL:
289  if (data_size < 4 || (data_size & 3))
290  return AVERROR_INVALIDDATA;
291  if ((fmt_size = avio_read(pb, fmt, sizeof(fmt))) < 0)
292  return fmt_size;
293  if (fmt_size == sizeof(deep_rgb24) && !memcmp(fmt, deep_rgb24, sizeof(deep_rgb24)))
295  else if (fmt_size == sizeof(deep_rgba) && !memcmp(fmt, deep_rgba, sizeof(deep_rgba)))
297  else if (fmt_size == sizeof(deep_bgra) && !memcmp(fmt, deep_bgra, sizeof(deep_bgra)))
299  else if (fmt_size == sizeof(deep_argb) && !memcmp(fmt, deep_argb, sizeof(deep_argb)))
301  else if (fmt_size == sizeof(deep_abgr) && !memcmp(fmt, deep_abgr, sizeof(deep_abgr)))
303  else {
304  avpriv_request_sample(s, "color format %.16s", fmt);
305  return AVERROR_PATCHWELCOME;
306  }
307  break;
308 
309  case ID_DGBL:
311  if (data_size < 8)
312  return AVERROR_INVALIDDATA;
313  st->codec->width = avio_rb16(pb);
314  st->codec->height = avio_rb16(pb);
315  iff->bitmap_compression = avio_rb16(pb);
316  st->sample_aspect_ratio.num = avio_r8(pb);
317  st->sample_aspect_ratio.den = avio_r8(pb);
318  st->codec->bits_per_coded_sample = 24;
319  break;
320 
321  case ID_DLOC:
322  if (data_size < 4)
323  return AVERROR_INVALIDDATA;
324  st->codec->width = avio_rb16(pb);
325  st->codec->height = avio_rb16(pb);
326  break;
327 
328  case ID_TVDC:
329  if (data_size < sizeof(iff->tvdc))
330  return AVERROR_INVALIDDATA;
331  res = avio_read(pb, iff->tvdc, sizeof(iff->tvdc));
332  if (res < 0)
333  return res;
334  break;
335 
336  case ID_ANNO:
337  case ID_TEXT: metadata_tag = "comment"; break;
338  case ID_AUTH: metadata_tag = "artist"; break;
339  case ID_COPYRIGHT: metadata_tag = "copyright"; break;
340  case ID_NAME: metadata_tag = "title"; break;
341  }
342 
343  if (metadata_tag) {
344  if ((res = get_metadata(s, metadata_tag, data_size)) < 0) {
345  av_log(s, AV_LOG_ERROR, "cannot allocate metadata tag %s!\n", metadata_tag);
346  return res;
347  }
348  }
349  avio_skip(pb, data_size - (avio_tell(pb) - orig_pos) + (data_size & 1));
350  }
351 
352  avio_seek(pb, iff->body_pos, SEEK_SET);
353 
354  switch(st->codec->codec_type) {
355  case AVMEDIA_TYPE_AUDIO:
356  avpriv_set_pts_info(st, 32, 1, st->codec->sample_rate);
357 
358  if (st->codec->codec_tag == ID_16SV)
360  else if (st->codec->codec_tag == ID_MAUD) {
361  if (iff->maud_bits == 8 && !iff->maud_compression) {
363  } else if (iff->maud_bits == 16 && !iff->maud_compression) {
365  } else if (iff->maud_bits == 8 && iff->maud_compression == 2) {
367  } else if (iff->maud_bits == 8 && iff->maud_compression == 3) {
369  } else {
370  avpriv_request_sample(s, "compression %d and bit depth %d", iff->maud_compression, iff->maud_bits);
371  return AVERROR_PATCHWELCOME;
372  }
373 
376 
377  st->codec->block_align =
378  st->codec->bits_per_coded_sample * st->codec->channels / 8;
379  } else {
380  switch (iff->svx8_compression) {
381  case COMP_NONE:
383  break;
384  case COMP_FIB:
386  break;
387  case COMP_EXP:
389  break;
390  default:
391  av_log(s, AV_LOG_ERROR,
392  "Unknown SVX8 compression method '%d'\n", iff->svx8_compression);
393  return -1;
394  }
395  }
396 
400  break;
401 
402  case AVMEDIA_TYPE_VIDEO:
403  iff->bpp = st->codec->bits_per_coded_sample;
404  if ((screenmode & 0x800 /* Hold And Modify */) && iff->bpp <= 8) {
405  iff->ham = iff->bpp > 6 ? 6 : 4;
406  st->codec->bits_per_coded_sample = 24;
407  }
408  iff->flags = (screenmode & 0x80 /* Extra HalfBrite */) && iff->bpp <= 8;
409  iff->masking = masking;
410  iff->transparency = transparency;
411 
412  if (!st->codec->extradata) {
415  if (!st->codec->extradata)
416  return AVERROR(ENOMEM);
417  }
419  buf = st->codec->extradata;
420  bytestream_put_be16(&buf, IFF_EXTRA_VIDEO_SIZE);
421  bytestream_put_byte(&buf, iff->bitmap_compression);
422  bytestream_put_byte(&buf, iff->bpp);
423  bytestream_put_byte(&buf, iff->ham);
424  bytestream_put_byte(&buf, iff->flags);
425  bytestream_put_be16(&buf, iff->transparency);
426  bytestream_put_byte(&buf, iff->masking);
427  bytestream_put_buffer(&buf, iff->tvdc, sizeof(iff->tvdc));
429  break;
430  default:
431  return -1;
432  }
433 
434  return 0;
435 }
436 
438  AVPacket *pkt)
439 {
440  IffDemuxContext *iff = s->priv_data;
441  AVIOContext *pb = s->pb;
442  AVStream *st = s->streams[0];
443  int ret;
444  int64_t pos = avio_tell(pb);
445 
446  if (pos >= iff->body_end)
447  return AVERROR_EOF;
448 
449  if (st->codec->codec_type == AVMEDIA_TYPE_AUDIO) {
450  if (st->codec->codec_tag == ID_MAUD) {
451  ret = av_get_packet(pb, pkt, FFMIN(iff->body_end - pos, 1024 * st->codec->block_align));
452  } else {
453  ret = av_get_packet(pb, pkt, iff->body_size);
454  }
455  } else if (st->codec->codec_type == AVMEDIA_TYPE_VIDEO) {
456  uint8_t *buf;
457 
458  if (av_new_packet(pkt, iff->body_size + 2) < 0) {
459  return AVERROR(ENOMEM);
460  }
461 
462  buf = pkt->data;
463  bytestream_put_be16(&buf, 2);
464  ret = avio_read(pb, buf, iff->body_size);
465  if (ret<0) {
466  av_free_packet(pkt);
467  } else if (ret < iff->body_size)
468  av_shrink_packet(pkt, ret + 2);
469  } else {
470  av_assert0(0);
471  }
472 
473  if (pos == iff->body_pos)
474  pkt->flags |= AV_PKT_FLAG_KEY;
475  if (ret < 0)
476  return ret;
477  pkt->stream_index = 0;
478  return ret;
479 }
480 
482  .name = "iff",
483  .long_name = NULL_IF_CONFIG_SMALL("IFF (Interchange File Format)"),
484  .priv_data_size = sizeof(IffDemuxContext),
489 };