libavformat/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 "internal.h"
30 
31 typedef struct {
33  unsigned int nb_records;
34  int size;
35 } Page;
36 
37 typedef struct {
38  unsigned int nb_pages; /**< total pages in file */
39  unsigned int nb_records; /**< total records in file */
41 #define MAX_PAGES 256 /**< Deluxe Paint hardcoded value */
42  Page pt[MAX_PAGES]; /**< page table */
43  int page; /**< current page (or AVERROR_xxx code) */
44  int record; /**< current record (with in page) */
46 
47 #define LPF_TAG MKTAG('L','P','F',' ')
48 #define ANIM_TAG MKTAG('A','N','I','M')
49 
50 static int probe(AVProbeData *p)
51 {
52  /* verify tags and video dimensions */
53  if (AV_RL32(&p->buf[0]) == LPF_TAG &&
54  AV_RL32(&p->buf[16]) == ANIM_TAG &&
55  AV_RL16(&p->buf[20]) && AV_RL16(&p->buf[22]))
56  return AVPROBE_SCORE_MAX;
57  return 0;
58 }
59 
60 /**
61  * @return page containing the requested record or AVERROR_XXX
62  */
63 static int find_record(const AnmDemuxContext *anm, int record)
64 {
65  int i;
66 
67  if (record >= anm->nb_records)
68  return AVERROR_EOF;
69 
70  for (i = 0; i < MAX_PAGES; i++) {
71  const Page *p = &anm->pt[i];
72  if (p->nb_records > 0 && record >= p->base_record && record < p->base_record + p->nb_records)
73  return i;
74  }
75 
76  return AVERROR_INVALIDDATA;
77 }
78 
80 {
81  AnmDemuxContext *anm = s->priv_data;
82  AVIOContext *pb = s->pb;
83  AVStream *st;
84  int i, ret;
85 
86  avio_skip(pb, 4); /* magic number */
87  if (avio_rl16(pb) != MAX_PAGES) {
88  avpriv_request_sample(s, "max_pages != " AV_STRINGIFY(MAX_PAGES));
89  return AVERROR_PATCHWELCOME;
90  }
91 
92  anm->nb_pages = avio_rl16(pb);
93  anm->nb_records = avio_rl32(pb);
94  avio_skip(pb, 2); /* max records per page */
95  anm->page_table_offset = avio_rl16(pb);
96  if (avio_rl32(pb) != ANIM_TAG)
97  return AVERROR_INVALIDDATA;
98 
99  /* video stream */
100  st = avformat_new_stream(s, NULL);
101  if (!st)
102  return AVERROR(ENOMEM);
105  st->codec->codec_tag = 0; /* no fourcc */
106  st->codec->width = avio_rl16(pb);
107  st->codec->height = avio_rl16(pb);
108  if (avio_r8(pb) != 0)
109  goto invalid;
110  avio_skip(pb, 1); /* frame rate multiplier info */
111 
112  /* ignore last delta record (used for looping) */
113  if (avio_r8(pb)) /* has_last_delta */
114  anm->nb_records = FFMAX(anm->nb_records - 1, 0);
115 
116  avio_skip(pb, 1); /* last_delta_valid */
117 
118  if (avio_r8(pb) != 0)
119  goto invalid;
120 
121  if (avio_r8(pb) != 1)
122  goto invalid;
123 
124  avio_skip(pb, 1); /* other recs per frame */
125 
126  if (avio_r8(pb) != 1)
127  goto invalid;
128 
129  avio_skip(pb, 32); /* record_types */
130  st->nb_frames = avio_rl32(pb);
131  avpriv_set_pts_info(st, 64, 1, avio_rl16(pb));
132  avio_skip(pb, 58);
133 
134  /* color cycling and palette data */
135  st->codec->extradata_size = 16*8 + 4*256;
137  if (!st->codec->extradata) {
138  return AVERROR(ENOMEM);
139  }
140  ret = avio_read(pb, st->codec->extradata, st->codec->extradata_size);
141  if (ret < 0)
142  return ret;
143 
144  /* read page table */
145  ret = avio_seek(pb, anm->page_table_offset, SEEK_SET);
146  if (ret < 0)
147  return ret;
148 
149  for (i = 0; i < MAX_PAGES; i++) {
150  Page *p = &anm->pt[i];
151  p->base_record = avio_rl16(pb);
152  p->nb_records = avio_rl16(pb);
153  p->size = avio_rl16(pb);
154  }
155 
156  /* find page of first frame */
157  anm->page = find_record(anm, 0);
158  if (anm->page < 0) {
159  return anm->page;
160  }
161 
162  anm->record = -1;
163  return 0;
164 
165 invalid:
166  avpriv_request_sample(s, "Invalid header element");
167  return AVERROR_PATCHWELCOME;
168 }
169 
171  AVPacket *pkt)
172 {
173  AnmDemuxContext *anm = s->priv_data;
174  AVIOContext *pb = s->pb;
175  Page *p;
176  int tmp, record_size;
177 
178  if (url_feof(s->pb))
179  return AVERROR(EIO);
180 
181  if (anm->page < 0)
182  return anm->page;
183 
184 repeat:
185  p = &anm->pt[anm->page];
186 
187  /* parse page header */
188  if (anm->record < 0) {
189  avio_seek(pb, anm->page_table_offset + MAX_PAGES*6 + (anm->page<<16), SEEK_SET);
190  avio_skip(pb, 8 + 2*p->nb_records);
191  anm->record = 0;
192  }
193 
194  /* if we have fetched all records in this page, then find the
195  next page and repeat */
196  if (anm->record >= p->nb_records) {
197  anm->page = find_record(anm, p->base_record + p->nb_records);
198  if (anm->page < 0)
199  return anm->page;
200  anm->record = -1;
201  goto repeat;
202  }
203 
204  /* fetch record size */
205  tmp = avio_tell(pb);
206  avio_seek(pb, anm->page_table_offset + MAX_PAGES*6 + (anm->page<<16) +
207  8 + anm->record * 2, SEEK_SET);
208  record_size = avio_rl16(pb);
209  avio_seek(pb, tmp, SEEK_SET);
210 
211  /* fetch record */
212  pkt->size = av_get_packet(s->pb, pkt, record_size);
213  if (pkt->size < 0)
214  return pkt->size;
215  if (p->base_record + anm->record == 0)
216  pkt->flags |= AV_PKT_FLAG_KEY;
217 
218  anm->record++;
219  return 0;
220 }
221 
223  .name = "anm",
224  .long_name = NULL_IF_CONFIG_SMALL("Deluxe Paint Animation"),
225  .priv_data_size = sizeof(AnmDemuxContext),
226  .read_probe = probe,
229 };
static int read_header(AVFormatContext *s)
void * av_mallocz(size_t size)
Allocate a block of size bytes with alignment suitable for all memory accesses (including vectors if ...
Definition: mem.c:205
const char * s
Definition: avisynth_c.h:668
Bytestream IO Context.
Definition: avio.h:68
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
void avpriv_set_pts_info(AVStream *s, int pts_wrap_bits, unsigned int pts_num, unsigned int pts_den)
Set the time base and wrapping info for a given stream.
int64_t avio_seek(AVIOContext *s, int64_t offset, int whence)
fseek() equivalent for AVIOContext.
Definition: aviobuf.c:199
#define AV_RL16
int64_t avio_skip(AVIOContext *s, int64_t offset)
Skip given number of bytes forward.
Definition: aviobuf.c:256
Format I/O context.
Definition: avformat.h:944
void void avpriv_request_sample(void *avc, const char *msg,...) av_printf_format(2
Log a generic warning message about a missing feature.
Page pt[MAX_PAGES]
page table
int base_record
static AVPacket pkt
Definition: demuxing.c:56
int record
current record (with in page)
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
#define MAX_PAGES
Deluxe Paint hardcoded value.
int pt
Definition: rtp.c:34
#define AVERROR_EOF
End of file.
Definition: error.h:55
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.
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:248
int avio_read(AVIOContext *s, unsigned char *buf, int size)
Read size bytes from AVIOContext into buf.
Definition: aviobuf.c:478
#define AV_PKT_FLAG_KEY
The packet contains a keyframe.
AVInputFormat ff_anm_demuxer
unsigned int avio_rl32(AVIOContext *s)
Definition: aviobuf.c:579
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
int size
#define LPF_TAG
#define FFMAX(a, b)
Definition: common.h:56
int flags
A combination of AV_PKT_FLAG values.
int avio_r8(AVIOContext *s)
Definition: aviobuf.c:469
AVCodecContext * codec
Codec context associated with this stream.
Definition: avformat.h:662
static int probe(AVProbeData *p)
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
Definition: avformat.h:336
#define FF_INPUT_BUFFER_PADDING_SIZE
Required number of additionally allocated bytes at the end of the input bitstream for decoding...
static int read_probe(AVProbeData *pd)
ret
Definition: avfilter.c:821
int width
picture width / height.
int page
current page (or AVERROR_xxx code)
static int read_packet(AVFormatContext *s, AVPacket *pkt)
#define AV_RL32
int url_feof(AVIOContext *s)
feof() equivalent for AVIOContext.
Definition: aviobuf.c:280
Stream structure.
Definition: avformat.h:643
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:62
NULL
Definition: eval.c:55
enum AVMediaType codec_type
enum AVCodecID codec_id
AVIOContext * pb
I/O context.
Definition: avformat.h:977
#define ANIM_TAG
unsigned int codec_tag
fourcc (LSB first, so "ABCD" -> (&#39;D&#39;<<24) + (&#39;C&#39;<<16) + (&#39;B&#39;<<8) + &#39;A&#39;).
#define AV_STRINGIFY(s)
synthesis window for stochastic i
unsigned int nb_records
total records in file
This structure contains the data a format has to probe a file.
Definition: avformat.h:334
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFilterBuffer 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.Buffer references ownership and permissions
static int find_record(const AnmDemuxContext *anm, int record)
#define AVPROBE_SCORE_MAX
maximum score, half of that is used for file-extension-based detection
Definition: avformat.h:340
unsigned int avio_rl16(AVIOContext *s)
Definition: aviobuf.c:563
unsigned int nb_pages
total pages in file
Main libavformat public API header.
About Git write you should know how to use GIT properly Luckily Git comes with excellent documentation git help man git shows you the available git< command > help man git< command > shows information about the subcommand< command > The most comprehensive manual is the website Git Reference visit they are quite exhaustive You do not need a special username or password All you need is to provide a ssh public key to the Git server admin What follows now is a basic introduction to Git and some FFmpeg specific guidelines Read it at least if you are granted commit privileges to the FFmpeg project you are expected to be familiar with these rules I if not You can get git from etc no matter how small Every one of them has been saved from looking like a fool by this many times It s very easy for stray debug output or cosmetic modifications to slip please avoid problems through this extra level of scrutiny For cosmetics only commits you should e g by running git config global user name My Name git config global user email my email invalid(--global to set the global configuration for all your git checkouts).Git will select the changes to the files for commit.Optionally you can use the interactive or the patch mode to select hunk by hunk what should be added to the commit.git commit Git will commit the selected changes to your current local branch.You will be prompted for a log message in an editor
unsigned int nb_records
int64_t nb_frames
number of frames in this stream if known or 0
Definition: avformat.h:698
void * priv_data
Format private data.
Definition: avformat.h:964
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:461
This structure stores compressed data.