FFmpeg coverage


Directory: ../../../ffmpeg/
File: src/libavformat/alp.c
Date: 2026-04-23 21:43:00
Exec Total Coverage
Lines: 62 86 72.1%
Functions: 5 6 83.3%
Branches: 26 48 54.2%

Line Branch Exec Source
1 /*
2 * LEGO Racers ALP (.tun & .pcm) (de)muxer
3 *
4 * Copyright (C) 2020 Zane van Iperen (zane@zanevaniperen.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 #include "config_components.h"
24
25 #include "libavutil/channel_layout.h"
26 #include "avformat.h"
27 #include "avio_internal.h"
28 #include "demux.h"
29 #include "internal.h"
30 #include "mux.h"
31 #include "rawenc.h"
32 #include "libavutil/intreadwrite.h"
33 #include "libavutil/internal.h"
34 #include "libavutil/opt.h"
35
36 #define ALP_TAG MKTAG('A', 'L', 'P', ' ')
37 #define ALP_MAX_READ_SIZE 4096
38
39 typedef struct ALPHeader {
40 uint32_t magic; /*< Magic Number, {'A', 'L', 'P', ' '} */
41 uint32_t header_size; /*< Header size (after this). */
42 char adpcm[6]; /*< "ADPCM" */
43 uint8_t unk1; /*< Unknown */
44 uint8_t num_channels; /*< Channel Count. */
45 uint32_t sample_rate; /*< Sample rate, only if header_size >= 12. */
46 } ALPHeader;
47
48 typedef enum ALPType {
49 ALP_TYPE_AUTO = 0, /*< Autodetect based on file extension. */
50 ALP_TYPE_TUN = 1, /*< Force a .TUN file. */
51 ALP_TYPE_PCM = 2, /*< Force a .PCM file. */
52 } ALPType;
53
54 typedef struct ALPMuxContext {
55 const AVClass *class;
56 ALPType type;
57 } ALPMuxContext;
58
59 #if CONFIG_ALP_DEMUXER
60 7474 static int alp_probe(const AVProbeData *p)
61 {
62 uint32_t i;
63
64
2/2
✓ Branch 0 taken 7471 times.
✓ Branch 1 taken 3 times.
7474 if (AV_RL32(p->buf) != ALP_TAG)
65 7471 return 0;
66
67 /* Only allowed header sizes are 8 and 12. */
68 3 i = AV_RL32(p->buf + 4);
69
3/4
✓ Branch 0 taken 2 times.
✓ Branch 1 taken 1 times.
✗ Branch 2 not taken.
✓ Branch 3 taken 2 times.
3 if (i != 8 && i != 12)
70 return 0;
71
72
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 3 times.
3 if (strncmp("ADPCM", p->buf + 8, 6) != 0)
73 return 0;
74
75 3 return AVPROBE_SCORE_MAX - 1;
76 }
77
78 3 static int alp_read_header(AVFormatContext *s)
79 {
80 int ret;
81 AVStream *st;
82 3 ALPHeader *hdr = s->priv_data;
83 AVCodecParameters *par;
84
85
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 3 times.
3 if ((hdr->magic = avio_rl32(s->pb)) != ALP_TAG)
86 return AVERROR_INVALIDDATA;
87
88 3 hdr->header_size = avio_rl32(s->pb);
89
90
3/4
✓ Branch 0 taken 2 times.
✓ Branch 1 taken 1 times.
✗ Branch 2 not taken.
✓ Branch 3 taken 2 times.
3 if (hdr->header_size != 8 && hdr->header_size != 12) {
91 return AVERROR_INVALIDDATA;
92 }
93
94
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 3 times.
3 if ((ret = ffio_read_size(s->pb, hdr->adpcm, sizeof(hdr->adpcm))) < 0)
95 return ret;
96
97
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 3 times.
3 if (strncmp("ADPCM", hdr->adpcm, sizeof(hdr->adpcm)) != 0)
98 return AVERROR_INVALIDDATA;
99
100 3 hdr->unk1 = avio_r8(s->pb);
101 3 hdr->num_channels = avio_r8(s->pb);
102
103
2/2
✓ Branch 0 taken 1 times.
✓ Branch 1 taken 2 times.
3 if (hdr->header_size == 8) {
104 /* .TUN music file */
105 1 hdr->sample_rate = 22050;
106
107 } else {
108 /* .PCM sound file */
109 2 hdr->sample_rate = avio_rl32(s->pb);
110 }
111
112
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 3 times.
3 if (hdr->sample_rate > 44100) {
113 avpriv_request_sample(s, "Sample Rate > 44100");
114 return AVERROR_PATCHWELCOME;
115 }
116
117
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 3 times.
3 if (!(st = avformat_new_stream(s, NULL)))
118 return AVERROR(ENOMEM);
119
120 3 par = st->codecpar;
121 3 par->codec_type = AVMEDIA_TYPE_AUDIO;
122 3 par->codec_id = AV_CODEC_ID_ADPCM_IMA_ALP;
123 3 par->format = AV_SAMPLE_FMT_S16;
124 3 par->sample_rate = hdr->sample_rate;
125
126
2/4
✓ Branch 0 taken 3 times.
✗ Branch 1 not taken.
✗ Branch 2 not taken.
✓ Branch 3 taken 3 times.
3 if (hdr->num_channels > 2 || hdr->num_channels == 0)
127 return AVERROR_INVALIDDATA;
128
129 3 av_channel_layout_default(&par->ch_layout, hdr->num_channels);
130 3 par->bits_per_coded_sample = 4;
131 3 par->block_align = 1;
132 3 par->bit_rate = par->ch_layout.nb_channels *
133 3 par->sample_rate *
134 3 par->bits_per_coded_sample;
135
136 3 avpriv_set_pts_info(st, 64, 1, par->sample_rate);
137 3 return 0;
138 }
139
140 90 static int alp_read_packet(AVFormatContext *s, AVPacket *pkt)
141 {
142 int ret;
143 90 AVCodecParameters *par = s->streams[0]->codecpar;
144
145
2/2
✓ Branch 1 taken 5 times.
✓ Branch 2 taken 85 times.
90 if ((ret = av_get_packet(s->pb, pkt, ALP_MAX_READ_SIZE)) < 0)
146 5 return ret;
147
148 85 pkt->flags &= ~AV_PKT_FLAG_CORRUPT;
149 85 pkt->stream_index = 0;
150 85 pkt->duration = ret * 2 / par->ch_layout.nb_channels;
151
152 85 return 0;
153 }
154
155 static int alp_seek(AVFormatContext *s, int stream_index,
156 int64_t pts, int flags)
157 {
158 const ALPHeader *hdr = s->priv_data;
159
160 if (pts != 0)
161 return AVERROR(EINVAL);
162
163 return avio_seek(s->pb, hdr->header_size + 8, SEEK_SET);
164 }
165
166 const FFInputFormat ff_alp_demuxer = {
167 .p.name = "alp",
168 .p.long_name = NULL_IF_CONFIG_SMALL("LEGO Racers ALP"),
169 .priv_data_size = sizeof(ALPHeader),
170 .read_probe = alp_probe,
171 .read_header = alp_read_header,
172 .read_packet = alp_read_packet,
173 .read_seek = alp_seek,
174 };
175 #endif
176
177 #if CONFIG_ALP_MUXER
178
179 1 static int alp_write_init(AVFormatContext *s)
180 {
181 1 ALPMuxContext *alp = s->priv_data;
182 AVCodecParameters *par;
183
184
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 1 times.
1 if (alp->type == ALP_TYPE_AUTO) {
185 if (av_match_ext(s->url, "pcm"))
186 alp->type = ALP_TYPE_PCM;
187 else
188 alp->type = ALP_TYPE_TUN;
189 }
190
191 1 par = s->streams[0]->codecpar;
192
193
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 1 times.
1 if (par->ch_layout.nb_channels > 2) {
194 av_log(s, AV_LOG_ERROR, "A maximum of 2 channels are supported\n");
195 return AVERROR(EINVAL);
196 }
197
198
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 1 times.
1 if (par->sample_rate > 44100) {
199 av_log(s, AV_LOG_ERROR, "Sample rate too large\n");
200 return AVERROR(EINVAL);
201 }
202
203
1/4
✗ Branch 0 not taken.
✓ Branch 1 taken 1 times.
✗ Branch 2 not taken.
✗ Branch 3 not taken.
1 if (alp->type == ALP_TYPE_TUN && par->sample_rate != 22050) {
204 av_log(s, AV_LOG_ERROR, "Sample rate must be 22050 for TUN files\n");
205 return AVERROR(EINVAL);
206 }
207 1 return 0;
208 }
209
210 1 static int alp_write_header(AVFormatContext *s)
211 {
212 1 ALPMuxContext *alp = s->priv_data;
213 1 AVCodecParameters *par = s->streams[0]->codecpar;
214
215 1 avio_wl32(s->pb, ALP_TAG);
216
1/2
✓ Branch 0 taken 1 times.
✗ Branch 1 not taken.
1 avio_wl32(s->pb, alp->type == ALP_TYPE_PCM ? 12 : 8);
217 1 avio_write(s->pb, "ADPCM", 6);
218 1 avio_w8(s->pb, 0);
219 1 avio_w8(s->pb, par->ch_layout.nb_channels);
220
1/2
✓ Branch 0 taken 1 times.
✗ Branch 1 not taken.
1 if (alp->type == ALP_TYPE_PCM)
221 1 avio_wl32(s->pb, par->sample_rate);
222
223 1 return 0;
224 }
225
226 enum { AE = AV_OPT_FLAG_AUDIO_PARAM | AV_OPT_FLAG_ENCODING_PARAM };
227
228 static const AVOption alp_options[] = {
229 {
230 .name = "type",
231 .help = "set file type",
232 .offset = offsetof(ALPMuxContext, type),
233 .type = AV_OPT_TYPE_INT,
234 .default_val = {.i64 = ALP_TYPE_AUTO},
235 .min = ALP_TYPE_AUTO,
236 .max = ALP_TYPE_PCM,
237 .flags = AE,
238 .unit = "type",
239 },
240 {
241 .name = "auto",
242 .help = "autodetect based on file extension",
243 .offset = 0,
244 .type = AV_OPT_TYPE_CONST,
245 .default_val = {.i64 = ALP_TYPE_AUTO},
246 .min = 0,
247 .max = 0,
248 .flags = AE,
249 .unit = "type"
250 },
251 {
252 .name = "tun",
253 .help = "force .tun, used for music",
254 .offset = 0,
255 .type = AV_OPT_TYPE_CONST,
256 .default_val = {.i64 = ALP_TYPE_TUN},
257 .min = 0,
258 .max = 0,
259 .flags = AE,
260 .unit = "type"
261 },
262 {
263 .name = "pcm",
264 .help = "force .pcm, used for sfx",
265 .offset = 0,
266 .type = AV_OPT_TYPE_CONST,
267 .default_val = {.i64 = ALP_TYPE_PCM},
268 .min = 0,
269 .max = 0,
270 .flags = AE,
271 .unit = "type"
272 },
273 { NULL }
274 };
275
276 static const AVClass alp_muxer_class = {
277 .class_name = "alp",
278 .item_name = av_default_item_name,
279 .option = alp_options,
280 .version = LIBAVUTIL_VERSION_INT
281 };
282
283 const FFOutputFormat ff_alp_muxer = {
284 .p.name = "alp",
285 .p.long_name = NULL_IF_CONFIG_SMALL("LEGO Racers ALP"),
286 .p.extensions = "tun,pcm",
287 .p.audio_codec = AV_CODEC_ID_ADPCM_IMA_ALP,
288 .p.video_codec = AV_CODEC_ID_NONE,
289 .p.subtitle_codec = AV_CODEC_ID_NONE,
290 .p.priv_class = &alp_muxer_class,
291 .flags_internal = FF_OFMT_FLAG_MAX_ONE_OF_EACH |
292 FF_OFMT_FLAG_ONLY_DEFAULT_CODECS,
293 .init = alp_write_init,
294 .write_header = alp_write_header,
295 .write_packet = ff_raw_write_packet,
296 .priv_data_size = sizeof(ALPMuxContext)
297 };
298 #endif
299