FFmpeg
anm.c
Go to the documentation of this file.
1 /*
2  * Deluxe Paint Animation demuxer
3  * Copyright (c) 2009 Peter Ross
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 /**
23  * @file
24  * Deluxe Paint Animation demuxer
25  */
26 
27 #include "libavutil/intreadwrite.h"
28 #include "avformat.h"
29 #include "demux.h"
30 #include "internal.h"
31 
32 typedef struct Page {
34  unsigned int nb_records;
35  int size;
36 } Page;
37 
38 typedef struct AnmDemuxContext {
39  unsigned int nb_pages; /**< total pages in file */
40  unsigned int nb_records; /**< total records in file */
42 #define MAX_PAGES 256 /**< Deluxe Paint hardcoded value */
43  Page pt[MAX_PAGES]; /**< page table */
44  int page; /**< current page (or AVERROR_xxx code) */
45  int record; /**< current record (with in page) */
47 
48 #define LPF_TAG MKTAG('L','P','F',' ')
49 #define ANIM_TAG MKTAG('A','N','I','M')
50 
51 static int probe(const AVProbeData *p)
52 {
53  /* verify tags and video dimensions */
54  if (AV_RL32(&p->buf[0]) == LPF_TAG &&
55  AV_RL32(&p->buf[16]) == ANIM_TAG &&
56  AV_RL16(&p->buf[20]) && AV_RL16(&p->buf[22]))
57  return AVPROBE_SCORE_MAX;
58  return 0;
59 }
60 
61 /**
62  * @return page containing the requested record or AVERROR_XXX
63  */
64 static int find_record(const AnmDemuxContext *anm, int record)
65 {
66  int i;
67 
68  if (record >= anm->nb_records)
69  return AVERROR_EOF;
70 
71  for (i = 0; i < MAX_PAGES; i++) {
72  const Page *p = &anm->pt[i];
73  if (p->nb_records > 0 && record >= p->base_record && record < p->base_record + p->nb_records)
74  return i;
75  }
76 
77  return AVERROR_INVALIDDATA;
78 }
79 
81 {
82  AnmDemuxContext *anm = s->priv_data;
83  AVIOContext *pb = s->pb;
84  AVStream *st;
85  int i, ret;
86 
87  avio_skip(pb, 4); /* magic number */
88  if (avio_rl16(pb) != MAX_PAGES) {
89  avpriv_request_sample(s, "max_pages != " AV_STRINGIFY(MAX_PAGES));
90  return AVERROR_PATCHWELCOME;
91  }
92 
93  anm->nb_pages = avio_rl16(pb);
94  anm->nb_records = avio_rl32(pb);
95  avio_skip(pb, 2); /* max records per page */
96  anm->page_table_offset = avio_rl16(pb);
97  if (avio_rl32(pb) != ANIM_TAG)
98  return AVERROR_INVALIDDATA;
99 
100  /* video stream */
101  st = avformat_new_stream(s, NULL);
102  if (!st)
103  return AVERROR(ENOMEM);
106  st->codecpar->codec_tag = 0; /* no fourcc */
107  st->codecpar->width = avio_rl16(pb);
108  st->codecpar->height = avio_rl16(pb);
109  if (avio_r8(pb) != 0)
110  goto invalid;
111  avio_skip(pb, 1); /* frame rate multiplier info */
112 
113  /* ignore last delta record (used for looping) */
114  if (avio_r8(pb)) /* has_last_delta */
115  anm->nb_records = FFMAX(anm->nb_records - 1, 0);
116 
117  avio_skip(pb, 1); /* last_delta_valid */
118 
119  if (avio_r8(pb) != 0)
120  goto invalid;
121 
122  if (avio_r8(pb) != 1)
123  goto invalid;
124 
125  avio_skip(pb, 1); /* other recs per frame */
126 
127  if (avio_r8(pb) != 1)
128  goto invalid;
129 
130  avio_skip(pb, 32); /* record_types */
131  st->nb_frames = avio_rl32(pb);
132  avpriv_set_pts_info(st, 64, 1, avio_rl16(pb));
133  avio_skip(pb, 58);
134 
135  /* color cycling and palette data */
136  ret = ff_get_extradata(s, st->codecpar, s->pb, 16*8 + 4*256);
137  if (ret < 0)
138  return ret;
139 
140  /* read page table */
141  ret = avio_seek(pb, anm->page_table_offset, SEEK_SET);
142  if (ret < 0)
143  return ret;
144 
145  for (i = 0; i < MAX_PAGES; i++) {
146  Page *p = &anm->pt[i];
147  p->base_record = avio_rl16(pb);
148  p->nb_records = avio_rl16(pb);
149  p->size = avio_rl16(pb);
150  }
151 
152  /* find page of first frame */
153  anm->page = find_record(anm, 0);
154  if (anm->page < 0) {
155  return anm->page;
156  }
157 
158  anm->record = -1;
159  return 0;
160 
161 invalid:
162  avpriv_request_sample(s, "Invalid header element");
163  return AVERROR_PATCHWELCOME;
164 }
165 
167  AVPacket *pkt)
168 {
169  AnmDemuxContext *anm = s->priv_data;
170  AVIOContext *pb = s->pb;
171  Page *p;
172  int tmp, record_size;
173 
174  if (avio_feof(s->pb))
175  return AVERROR_EOF;
176 
177  if (anm->page < 0)
178  return anm->page;
179 
180 repeat:
181  p = &anm->pt[anm->page];
182 
183  /* parse page header */
184  if (anm->record < 0) {
185  avio_seek(pb, anm->page_table_offset + MAX_PAGES*6 + (anm->page<<16), SEEK_SET);
186  avio_skip(pb, 8 + 2*p->nb_records);
187  anm->record = 0;
188  }
189 
190  /* if we have fetched all records in this page, then find the
191  next page and repeat */
192  if (anm->record >= p->nb_records) {
193  anm->page = find_record(anm, p->base_record + p->nb_records);
194  if (anm->page < 0)
195  return anm->page;
196  anm->record = -1;
197  goto repeat;
198  }
199 
200  /* fetch record size */
201  tmp = avio_tell(pb);
202  avio_seek(pb, anm->page_table_offset + MAX_PAGES*6 + (anm->page<<16) +
203  8 + anm->record * 2, SEEK_SET);
204  record_size = avio_rl16(pb);
205  avio_seek(pb, tmp, SEEK_SET);
206 
207  /* fetch record */
208  pkt->size = av_get_packet(s->pb, pkt, record_size);
209  if (pkt->size < 0)
210  return pkt->size;
211  if (p->base_record + anm->record == 0)
213 
214  anm->record++;
215  return 0;
216 }
217 
219  .name = "anm",
220  .long_name = NULL_IF_CONFIG_SMALL("Deluxe Paint Animation"),
221  .priv_data_size = sizeof(AnmDemuxContext),
222  .read_probe = probe,
225 };
AnmDemuxContext
Definition: anm.c:38
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
AVCodecParameters::codec_type
enum AVMediaType codec_type
General type of the encoded data.
Definition: codec_par.h:51
avformat_new_stream
AVStream * avformat_new_stream(AVFormatContext *s, const struct AVCodec *c)
Add a new stream to a media file.
AVERROR_EOF
#define AVERROR_EOF
End of file.
Definition: error.h:57
read_header
static int read_header(AVFormatContext *s)
Definition: anm.c:80
AnmDemuxContext::pt
Page pt[MAX_PAGES]
page table
Definition: anm.c:43
tmp
static uint8_t tmp[11]
Definition: aes_ctr.c:28
AVCodecParameters::codec_tag
uint32_t codec_tag
Additional information about the codec (corresponds to the AVI FOURCC).
Definition: codec_par.h:59
FFMAX
#define FFMAX(a, b)
Definition: macros.h:47
AV_PKT_FLAG_KEY
#define AV_PKT_FLAG_KEY
The packet contains a keyframe.
Definition: packet.h:546
ff_get_extradata
int ff_get_extradata(void *logctx, AVCodecParameters *par, AVIOContext *pb, int size)
Allocate extradata with additional AV_INPUT_BUFFER_PADDING_SIZE at end which is always set to 0 and f...
Definition: demux_utils.c:355
AVPROBE_SCORE_MAX
#define AVPROBE_SCORE_MAX
maximum score
Definition: avformat.h:464
avpriv_set_pts_info
void avpriv_set_pts_info(AVStream *st, int pts_wrap_bits, unsigned int pts_num, unsigned int pts_den)
Set the time base and wrapping info for a given stream.
Definition: avformat.c:761
avio_tell
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:513
Page::size
int size
Definition: anm.c:35
avio_rl16
unsigned int avio_rl16(AVIOContext *s)
Definition: aviobuf.c:761
Page::base_record
int base_record
Definition: anm.c:33
MAX_PAGES
#define MAX_PAGES
Deluxe Paint hardcoded value.
Definition: anm.c:42
pkt
AVPacket * pkt
Definition: movenc.c:59
AVInputFormat
Definition: avformat.h:549
AnmDemuxContext::page_table_offset
int page_table_offset
Definition: anm.c:41
AnmDemuxContext::record
int record
current record (with in page)
Definition: anm.c:45
intreadwrite.h
s
#define s(width, name)
Definition: cbs_vp9.c:198
AVInputFormat::name
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:554
AVProbeData::buf
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
Definition: avformat.h:454
AVCodecParameters::width
int width
Video only.
Definition: codec_par.h:121
AnmDemuxContext::page
int page
current page (or AVERROR_xxx code)
Definition: anm.c:44
AV_RL16
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_WL32 unsigned int_TMPL AV_WL24 unsigned int_TMPL AV_RL16
Definition: bytestream.h:94
AVFormatContext
Format I/O context.
Definition: avformat.h:1115
internal.h
AVStream::codecpar
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Definition: avformat.h:864
find_record
static int find_record(const AnmDemuxContext *anm, int record)
Definition: anm.c:64
NULL
#define NULL
Definition: coverity.c:32
AVERROR_PATCHWELCOME
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:64
ANIM_TAG
#define ANIM_TAG
Definition: anm.c:49
AVProbeData
This structure contains the data a format has to probe a file.
Definition: avformat.h:452
AV_CODEC_ID_ANM
@ AV_CODEC_ID_ANM
Definition: codec_id.h:186
AVStream::nb_frames
int64_t nb_frames
number of frames in this stream if known or 0
Definition: avformat.h:902
read_packet
static int read_packet(AVFormatContext *s, AVPacket *pkt)
Definition: anm.c:166
avio_rl32
unsigned int avio_rl32(AVIOContext *s)
Definition: aviobuf.c:777
AVIOContext
Bytestream IO Context.
Definition: avio.h:166
AVPacket::size
int size
Definition: packet.h:492
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:106
avio_r8
int avio_r8(AVIOContext *s)
Definition: aviobuf.c:650
AVPacket::flags
int flags
A combination of AV_PKT_FLAG values.
Definition: packet.h:497
Page
Definition: anm.c:32
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:255
AVCodecParameters::height
int height
Definition: codec_par.h:122
AV_STRINGIFY
#define AV_STRINGIFY(s)
Definition: macros.h:66
demux.h
AnmDemuxContext::nb_pages
unsigned int nb_pages
total pages in file
Definition: anm.c:39
av_get_packet
int av_get_packet(AVIOContext *s, AVPacket *pkt, int size)
Allocate and read the payload of a packet and initialize its fields with default values.
Definition: utils.c:103
ret
ret
Definition: filter_design.txt:187
AVStream
Stream structure.
Definition: avformat.h:841
ff_anm_demuxer
const AVInputFormat ff_anm_demuxer
Definition: anm.c:218
avio_seek
int64_t avio_seek(AVIOContext *s, int64_t offset, int whence)
fseek() equivalent for AVIOContext.
Definition: aviobuf.c:278
avformat.h
AV_RL32
uint64_t_TMPL AV_WL64 unsigned int_TMPL AV_RL32
Definition: bytestream.h:92
avio_skip
int64_t avio_skip(AVIOContext *s, int64_t offset)
Skip given number of bytes forward.
Definition: aviobuf.c:365
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
read_probe
static int read_probe(const AVProbeData *p)
Definition: cdg.c:29
AnmDemuxContext::nb_records
unsigned int nb_records
total records in file
Definition: anm.c:40
Page::nb_records
unsigned int nb_records
Definition: anm.c:34
avpriv_request_sample
#define avpriv_request_sample(...)
Definition: tableprint_vlc.h:36
AVCodecParameters::codec_id
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: codec_par.h:55
AVPacket
This structure stores compressed data.
Definition: packet.h:468
LPF_TAG
#define LPF_TAG
Definition: anm.c:48
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
probe
static int probe(const AVProbeData *p)
Definition: anm.c:51
avio_feof
int avio_feof(AVIOContext *s)
Similar to feof() but also returns nonzero on read errors.
Definition: aviobuf.c:393