libavformat/bethsoftvid.c
1e6c6759
 /*
  * Bethsoft VID format Demuxer
  * Copyright (c) 2007 Nicholas Tung
  *
  * This file is part of FFmpeg.
  *
  * FFmpeg is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
  * version 2.1 of the License, or (at your option) any later version.
  *
  * FFmpeg is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
  * License along with FFmpeg; if not, write to the Free Software
  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  */
 
 /**
ba87f080
  * @file
1e6c6759
  * @brief Bethesda Softworks VID (.vid) file demuxer
  * @author Nicholas Tung [ntung (at. ntung com] (2007-03)
bee6d2fd
  * @see http://wiki.multimedia.cx/index.php?title=Bethsoft_VID
  * @see http://www.svatopluk.com/andux/docs/dfvid.html
1e6c6759
  */
 
b5d1a15d
 #include "libavutil/channel_layout.h"
6a5d31ac
 #include "libavutil/intreadwrite.h"
1e6c6759
 #include "avformat.h"
c3f9ebf7
 #include "internal.h"
245976da
 #include "libavcodec/bethsoftvideo.h"
1e6c6759
 
f320fb89
 #define BVID_PALETTE_SIZE 3 * 256
 
773ff823
 #define DEFAULT_SAMPLE_RATE 11111
 
1e6c6759
 typedef struct BVID_DemuxContext
 {
     int nframes;
773ff823
     int sample_rate;        /**< audio sample rate */
c9fdf324
     int width;              /**< video width       */
     int height;             /**< video height      */
1e6c6759
     /** delay value between frames, added to individual frame delay.
      * custom units, which will be added to other custom units (~=16ms according
      * to free, unofficial documentation) */
     int bethsoft_global_delay;
773ff823
     int video_index;        /**< video stream index */
     int audio_index;        /**< audio stream index */
f320fb89
     uint8_t *palette;
1e6c6759
 
     int is_finished;
 
 } BVID_DemuxContext;
 
 static int vid_probe(AVProbeData *p)
 {
523c7bd2
     // little-endian VID tag, file starts with "VID\0"
87e87886
     if (AV_RL32(p->buf) != MKTAG('V', 'I', 'D', 0))
1e6c6759
         return 0;
 
f66f3819
     if (p->buf[4] != 2)
         return AVPROBE_SCORE_MAX / 4;
 
1e6c6759
     return AVPROBE_SCORE_MAX;
 }
 
6e9651d1
 static int vid_read_header(AVFormatContext *s)
1e6c6759
 {
8bb57775
     BVID_DemuxContext *vid = s->priv_data;
471fe57e
     AVIOContext *pb = s->pb;
1e6c6759
 
     /* load main header. Contents:
     *    bytes: 'V' 'I' 'D'
     *    int16s: always_512, nframes, width, height, delay, always_14
     */
45a8a02a
     avio_skip(pb, 5);
e63a3628
     vid->nframes = avio_rl16(pb);
c9fdf324
     vid->width   = avio_rl16(pb);
     vid->height  = avio_rl16(pb);
e63a3628
     vid->bethsoft_global_delay = avio_rl16(pb);
     avio_rl16(pb);
1e6c6759
 
c9fdf324
     // wait until the first packet to create each stream
     vid->video_index = -1;
773ff823
     vid->audio_index = -1;
c9fdf324
     vid->sample_rate = DEFAULT_SAMPLE_RATE;
773ff823
     s->ctx_flags |= AVFMTCTX_NOHEADER;
1e6c6759
 
     return 0;
 }
 
 #define BUFFER_PADDING_SIZE 1000
471fe57e
 static int read_frame(BVID_DemuxContext *vid, AVIOContext *pb, AVPacket *pkt,
c9fdf324
                       uint8_t block_type, AVFormatContext *s)
1e6c6759
 {
     uint8_t * vidbuf_start = NULL;
     int vidbuf_nbytes = 0;
3e62d187
     int code;
1e6c6759
     int bytes_copied = 0;
c9fdf324
     int position, duration, npixels;
fae3a361
     unsigned int vidbuf_capacity;
17b11559
     int ret = 0;
c9fdf324
     AVStream *st;
 
     if (vid->video_index < 0) {
         st = avformat_new_stream(s, NULL);
         if (!st)
             return AVERROR(ENOMEM);
         vid->video_index = st->index;
         if (vid->audio_index < 0) {
1ecdf891
             avpriv_request_sample(s, "Using default video time base since "
                                   "having no audio packet before the first "
                                   "video packet");
c9fdf324
         }
         avpriv_set_pts_info(st, 64, 185, vid->sample_rate);
         st->codec->codec_type = AVMEDIA_TYPE_VIDEO;
36ef5369
         st->codec->codec_id   = AV_CODEC_ID_BETHSOFTVID;
c9fdf324
         st->codec->width      = vid->width;
         st->codec->height     = vid->height;
     }
     st      = s->streams[vid->video_index];
     npixels = st->codec->width * st->codec->height;
1e6c6759
 
     vidbuf_start = av_malloc(vidbuf_capacity = BUFFER_PADDING_SIZE);
d5c5c8b4
     if(!vidbuf_start)
769e10f0
         return AVERROR(ENOMEM);
1e6c6759
 
     // save the file position for the packet, include block type
384c9c2f
     position = avio_tell(pb) - 1;
1e6c6759
 
     vidbuf_start[vidbuf_nbytes++] = block_type;
 
9546f331
     // get the current packet duration
     duration = vid->bethsoft_global_delay + avio_rl16(pb);
1e6c6759
 
     // set the y offset if it exists (decoder header data should be in data section)
d7cf4489
     if(block_type == VIDEO_YOFF_P_FRAME){
17b11559
         if (avio_read(pb, &vidbuf_start[vidbuf_nbytes], 2) != 2) {
             ret = AVERROR(EIO);
373209f8
             goto fail;
17b11559
         }
1e6c6759
         vidbuf_nbytes += 2;
     }
 
d5c5c8b4
     do{
1e6c6759
         vidbuf_start = av_fast_realloc(vidbuf_start, &vidbuf_capacity, vidbuf_nbytes + BUFFER_PADDING_SIZE);
d5c5c8b4
         if(!vidbuf_start)
769e10f0
             return AVERROR(ENOMEM);
1e6c6759
 
e63a3628
         code = avio_r8(pb);
3e62d187
         vidbuf_start[vidbuf_nbytes++] = code;
1e6c6759
 
3e62d187
         if(code >= 0x80){ // rle sequence
d7cf4489
             if(block_type == VIDEO_I_FRAME)
e63a3628
                 vidbuf_start[vidbuf_nbytes++] = avio_r8(pb);
3e62d187
         } else if(code){ // plain sequence
17b11559
             if (avio_read(pb, &vidbuf_start[vidbuf_nbytes], code) != code) {
                 ret = AVERROR(EIO);
373209f8
                 goto fail;
17b11559
             }
3e62d187
             vidbuf_nbytes += code;
1e6c6759
         }
3e62d187
         bytes_copied += code & 0x7F;
d5c5c8b4
         if(bytes_copied == npixels){ // sometimes no stop character is given, need to keep track of bytes copied
1e6c6759
             // may contain a 0 byte even if read all pixels
e63a3628
             if(avio_r8(pb))
f59d8ff8
                 avio_seek(pb, -1, SEEK_CUR);
1e6c6759
             break;
         }
17b11559
         if (bytes_copied > npixels) {
             ret = AVERROR_INVALIDDATA;
373209f8
             goto fail;
17b11559
         }
3e62d187
     } while(code);
1e6c6759
 
     // copy data into packet
17b11559
     if ((ret = av_new_packet(pkt, vidbuf_nbytes)) < 0)
373209f8
         goto fail;
1e6c6759
     memcpy(pkt->data, vidbuf_start, vidbuf_nbytes);
     av_free(vidbuf_start);
 
     pkt->pos = position;
773ff823
     pkt->stream_index = vid->video_index;
9546f331
     pkt->duration = duration;
05e4ae83
     if (block_type == VIDEO_I_FRAME)
         pkt->flags |= AV_PKT_FLAG_KEY;
1e6c6759
 
f320fb89
     /* if there is a new palette available, add it to packet side data */
     if (vid->palette) {
         uint8_t *pdata = av_packet_new_side_data(pkt, AV_PKT_DATA_PALETTE,
                                                  BVID_PALETTE_SIZE);
3632f35c
         if (pdata)
             memcpy(pdata, vid->palette, BVID_PALETTE_SIZE);
f320fb89
         av_freep(&vid->palette);
     }
1e6c6759
 
     vid->nframes--;  // used to check if all the frames were read
17b11559
     return 0;
373209f8
 fail:
     av_free(vidbuf_start);
17b11559
     return ret;
1e6c6759
 }
 
 static int vid_read_packet(AVFormatContext *s,
                            AVPacket *pkt)
 {
8bb57775
     BVID_DemuxContext *vid = s->priv_data;
471fe57e
     AVIOContext *pb = s->pb;
8bb57775
     unsigned char block_type;
1e6c6759
     int audio_length;
     int ret_value;
 
d5c5c8b4
     if(vid->is_finished || url_feof(pb))
1ed7ca00
         return AVERROR_EOF;
1e6c6759
 
e63a3628
     block_type = avio_r8(pb);
d5c5c8b4
     switch(block_type){
1e6c6759
         case PALETTE_BLOCK:
f320fb89
             if (vid->palette) {
                 av_log(s, AV_LOG_WARNING, "discarding unused palette\n");
                 av_freep(&vid->palette);
             }
             vid->palette = av_malloc(BVID_PALETTE_SIZE);
             if (!vid->palette)
                 return AVERROR(ENOMEM);
             if (avio_read(pb, vid->palette, BVID_PALETTE_SIZE) != BVID_PALETTE_SIZE) {
                 av_freep(&vid->palette);
6f3e0b21
                 return AVERROR(EIO);
d5c5c8b4
             }
f320fb89
             return vid_read_packet(s, pkt);
1e6c6759
 
         case FIRST_AUDIO_BLOCK:
e63a3628
             avio_rl16(pb);
1e6c6759
             // soundblaster DAC used for sample rate, as on specification page (link above)
773ff823
             vid->sample_rate = 1000000 / (256 - avio_r8(pb));
1e6c6759
         case AUDIO_BLOCK:
773ff823
             if (vid->audio_index < 0) {
                 AVStream *st = avformat_new_stream(s, NULL);
                 if (!st)
                     return AVERROR(ENOMEM);
                 vid->audio_index                 = st->index;
                 st->codec->codec_type            = AVMEDIA_TYPE_AUDIO;
36ef5369
                 st->codec->codec_id              = AV_CODEC_ID_PCM_U8;
773ff823
                 st->codec->channels              = 1;
b5d1a15d
                 st->codec->channel_layout        = AV_CH_LAYOUT_MONO;
773ff823
                 st->codec->bits_per_coded_sample = 8;
                 st->codec->sample_rate           = vid->sample_rate;
                 st->codec->bit_rate              = 8 * st->codec->sample_rate;
                 st->start_time                   = 0;
                 avpriv_set_pts_info(st, 64, 1, vid->sample_rate);
             }
e63a3628
             audio_length = avio_rl16(pb);
17b11559
             if ((ret_value = av_get_packet(pb, pkt, audio_length)) != audio_length) {
                 if (ret_value < 0)
                     return ret_value;
                 av_log(s, AV_LOG_ERROR, "incomplete audio block\n");
                 return AVERROR(EIO);
             }
773ff823
             pkt->stream_index = vid->audio_index;
             pkt->duration     = audio_length;
05e4ae83
             pkt->flags |= AV_PKT_FLAG_KEY;
17b11559
             return 0;
1e6c6759
 
d7cf4489
         case VIDEO_P_FRAME:
         case VIDEO_YOFF_P_FRAME:
         case VIDEO_I_FRAME:
c9fdf324
             return read_frame(vid, pb, pkt, block_type, s);
1e6c6759
 
d7cf4489
         case EOF_BLOCK:
1e6c6759
             if(vid->nframes != 0)
                 av_log(s, AV_LOG_VERBOSE, "reached terminating character but not all frames read.\n");
             vid->is_finished = 1;
6f3e0b21
             return AVERROR(EIO);
1e6c6759
         default:
             av_log(s, AV_LOG_ERROR, "unknown block (character = %c, decimal = %d, hex = %x)!!!\n",
17b11559
                    block_type, block_type, block_type);
             return AVERROR_INVALIDDATA;
1e6c6759
     }
 }
 
f320fb89
 static int vid_read_close(AVFormatContext *s)
 {
     BVID_DemuxContext *vid = s->priv_data;
     av_freep(&vid->palette);
     return 0;
 }
 
66355be3
 AVInputFormat ff_bethsoftvid_demuxer = {
dfc2c4d9
     .name           = "bethsoftvid",
6774247a
     .long_name      = NULL_IF_CONFIG_SMALL("Bethesda Softworks VID"),
dfc2c4d9
     .priv_data_size = sizeof(BVID_DemuxContext),
     .read_probe     = vid_probe,
     .read_header    = vid_read_header,
     .read_packet    = vid_read_packet,
f320fb89
     .read_close     = vid_read_close,
1e6c6759
 };