FFmpeg coverage

Directory: ../../../ffmpeg/
File: src/libavformat/jacosubdec.c
Date: 2026-05-03 18:45:46
Exec Total Coverage
Lines: 104 117 88.9%
Functions: 6 6 100.0%
Branches: 53 73 72.6%
Line Branch Exec Source
1 /*
2 * Copyright (c) 2012 Clément Bœsch
3 *
4 * This file is part of FFmpeg.
5 *
6 * FFmpeg is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
10 *
11 * FFmpeg is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with FFmpeg; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19 */
20
21 /**
22 * @file
23 * JACOsub subtitle demuxer
24 * @see http://unicorn.us.com/jacosub/jscripts.html
25 * @todo Support P[ALETTE] directive.
26 */
27
28 #include "avformat.h"
29 #include "demux.h"
30 #include "internal.h"
31 #include "libavutil/attributes.h"
32 #include "subtitles.h"
33 #include "libavcodec/jacosub.h"
34 #include "libavutil/avstring.h"
35 #include "libavutil/bprint.h"
36 #include "libavutil/intreadwrite.h"
37
38 typedef struct {
39 FFDemuxSubtitlesQueue q;
40 int shift;
41 unsigned timeres;
42 } JACOsubContext;
43
44 7546 static int timed_line(const char *ptr)
45 {
46 char c;
47 int fs, fe;
48
2/2
✓ Branch 0 taken 7517 times.
✓ Branch 1 taken 29 times.
 15063 return (sscanf(ptr, "%*u:%*u:%*u.%*u %*u:%*u:%*u.%*u %c", &c) == 1 ||
49
3/4
✓ Branch 0 taken 6 times.
✓ Branch 1 taken 7511 times.
✓ Branch 2 taken 6 times.
✗ Branch 3 not taken.
 7517 (sscanf(ptr, "@%u @%u %c", &fs, &fe, &c) == 3 && fs < fe));
50 }
51
52 7480 static int jacosub_probe(const AVProbeData *p)
53 {
54 7480 const char *ptr = p->buf;
55 7480 const char *ptr_end = p->buf + p->buf_size;
56
57
2/2
✓ Branch 0 taken 9 times.
✓ Branch 1 taken 7471 times.
 7480 if (AV_RB24(ptr) == 0xEFBBBF)
58 9 ptr += 3; /* skip UTF-8 BOM */
59
60
1/2
✓ Branch 0 taken 7595 times.
✗ Branch 1 not taken.
 7595 while (ptr < ptr_end) {
61
2/2
✓ Branch 1 taken 87 times.
✓ Branch 2 taken 7595 times.
 7682 while (jss_whitespace(*ptr))
62 87 ptr++;
63
3/4
✓ Branch 0 taken 7480 times.
✓ Branch 1 taken 115 times.
✓ Branch 2 taken 7480 times.
✗ Branch 3 not taken.
 7595 if (*ptr != '#' && *ptr != '\n') {
64
2/2
✓ Branch 1 taken 2 times.
✓ Branch 2 taken 7478 times.
 7480 if (timed_line(ptr))
65 2 return AVPROBE_SCORE_EXTENSION + 1;
66 7478 return 0;
67 }
68 115 ptr += ff_subtitles_next_line(ptr);
69 }
70 ✗ return 0;
71 }
72
73 static const char * const cmds[] = {
74 "CLOCKPAUSE",
75 "DIRECTIVE",
76 "FONT",
77 "HRES",
78 "INCLUDE",
79 "PALETTE",
80 "QUANTIZE",
81 "RAMP",
82 "SHIFT",
83 "TIMERES",
84 };
85
86 12 static int get_jss_cmd(char k)
87 {
88 int i;
89
90 12 k = av_toupper(k);
91
2/2
✓ Branch 0 taken 117 times.
✓ Branch 1 taken 6 times.
 123 for (i = 0; i < FF_ARRAY_ELEMS(cmds); i++)
92
2/2
✓ Branch 0 taken 6 times.
✓ Branch 1 taken 111 times.
 117 if (k == cmds[i][0])
93 6 return i;
94 6 return -1;
95 }
96
97 33 static const char *read_ts(JACOsubContext *jacosub, const char *buf,
98 int64_t *start, int64_t *duration)
99 {
100 int len;
101 unsigned hs, ms, ss, fs; // hours, minutes, seconds, frame start
102 unsigned he, me, se, fe; // hours, minutes, seconds, frame end
103 int ts_start, ts_end;
104 int64_t ts_start64, ts_end64;
105
106 /* timed format */
107
2/2
✓ Branch 0 taken 27 times.
✓ Branch 1 taken 6 times.
 33 if (sscanf(buf, "%u:%u:%u.%u %u:%u:%u.%u %n",
108 &hs, &ms, &ss, &fs,
109 &he, &me, &se, &fe, &len) == 8) {
110 27 ts_start = (hs*3600 + ms*60 + ss) * jacosub->timeres + fs;
111 27 ts_end = (he*3600 + me*60 + se) * jacosub->timeres + fe;
112 27 goto shift_and_ret;
113 }
114
115 /* timestamps format */
116
1/2
✓ Branch 0 taken 6 times.
✗ Branch 1 not taken.
 6 if (sscanf(buf, "@%u @%u %n", &ts_start, &ts_end, &len) == 2)
117 6 goto shift_and_ret;
118
119 ✗ return NULL;
120
121 33 shift_and_ret:
122 33 ts_start64 = (ts_start + (int64_t)jacosub->shift) * 100LL / jacosub->timeres;
123 33 ts_end64 = (ts_end + (int64_t)jacosub->shift) * 100LL / jacosub->timeres;
124 33 *start = ts_start64;
125 33 *duration = ts_end64 - ts_start64;
126 33 return buf + len;
127 }
128
129 3 static int get_shift(unsigned timeres, const char *buf)
130 {
131 3 int sign = 1;
132 3 int h = 0, m = 0, s = 0, d = 0;
133 int64_t ret;
134 #define SSEP "%*1[.:]"
135 3 int n = sscanf(buf, "%d"SSEP"%d"SSEP"%d"SSEP"%d", &h, &m, &s, &d);
136 #undef SSEP
137
138
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 3 times.
 3 if (h == INT_MIN)
139 ✗ return 0;
140
141
2/4
✓ Branch 0 taken 3 times.
✗ Branch 1 not taken.
✗ Branch 2 not taken.
✓ Branch 3 taken 3 times.
 3 if (*buf == '-' || h < 0) {
142 ✗ sign = -1;
143 ✗ h = FFABS(h);
144 }
145
146 3 ret = 0;
147
1/4
✗ Branch 0 not taken.
✓ Branch 1 taken 3 times.
✗ Branch 2 not taken.
✗ Branch 3 not taken.
 3 switch (n) {
148 ✗ case 1: h = 0; av_fallthrough; //clear all in case of a single parameter
149 3 case 2: s = m; m = h; h = 0; av_fallthrough; //shift into second subsecondd
150 3 case 3: d = s; s = m; m = h; h = 0; //shift into minute second subsecond
151 }
152
153 3 ret = (int64_t)h*3600 + (int64_t)m*60 + s;
154
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 3 times.
 3 if (FFABS(ret) > (INT64_MAX - FFABS((int64_t)d)) / timeres)
155 ✗ return 0;
156 3 ret = sign * (ret * timeres + d);
157
158
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 3 times.
 3 if ((int)ret != ret)
159 ✗ ret = 0;
160
161 3 return ret;
162 }
163
164 3 static int jacosub_read_header(AVFormatContext *s)
165 {
166 AVBPrint header;
167 3 AVIOContext *pb = s->pb;
168 char line[JSS_MAX_LINESIZE];
169 3 JACOsubContext *jacosub = s->priv_data;
170 3 int shift_set = 0; // only the first shift matters
171 3 int merge_line = 0;
172 int i, ret;
173
174 3 AVStream *st = avformat_new_stream(s, NULL);
175
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 3 times.
 3 if (!st)
176 ✗ return AVERROR(ENOMEM);
177 3 avpriv_set_pts_info(st, 64, 1, 100);
178 3 st->codecpar->codec_type = AVMEDIA_TYPE_SUBTITLE;
179 3 st->codecpar->codec_id = AV_CODEC_ID_JACOSUB;
180
181 3 jacosub->timeres = 30;
182
183 3 av_bprint_init(&header, 1024+AV_INPUT_BUFFER_PADDING_SIZE, 4096);
184
185
2/2
✓ Branch 1 taken 87 times.
✓ Branch 2 taken 3 times.
 90 while (!avio_feof(pb)) {
186 int cmd_len;
187 87 const char *p = line;
188 87 int64_t pos = avio_tell(pb);
189 87 int len = ff_get_line(pb, line, sizeof(line));
190
191 87 p = jss_skip_whitespace(p);
192
193 /* queue timed line */
194
4/4
✓ Branch 0 taken 66 times.
✓ Branch 1 taken 21 times.
✓ Branch 3 taken 33 times.
✓ Branch 4 taken 33 times.
 87 if (merge_line || timed_line(p)) {
195 AVPacket *sub;
196
197 54 sub = ff_subtitles_queue_insert(&jacosub->q, line, len, merge_line);
198
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 54 times.
 54 if (!sub) {
199 ✗ av_bprint_finalize(&header, NULL);
200 ✗ return AVERROR(ENOMEM);
201 }
202 54 sub->pos = pos;
203
3/4
✓ Branch 0 taken 54 times.
✗ Branch 1 not taken.
✓ Branch 2 taken 21 times.
✓ Branch 3 taken 33 times.
 54 merge_line = len > 1 && !strcmp(&line[len - 2], "\\\n");
204 54 continue;
205 }
206
207 /* skip all non-compiler commands and focus on the command */
208
2/2
✓ Branch 0 taken 21 times.
✓ Branch 1 taken 12 times.
 33 if (*p != '#')
209 21 continue;
210 12 p++;
211 12 i = get_jss_cmd(p[0]);
212
2/2
✓ Branch 0 taken 6 times.
✓ Branch 1 taken 6 times.
 12 if (i == -1)
213 6 continue;
214
215 /* trim command + spaces */
216 6 cmd_len = strlen(cmds[i]);
217
2/2
✓ Branch 1 taken 2 times.
✓ Branch 2 taken 4 times.
 6 if (av_strncasecmp(p, cmds[i], cmd_len) == 0)
218 2 p += cmd_len;
219 else
220 4 p++;
221 6 p = jss_skip_whitespace(p);
222
223 /* handle commands which affect the whole script */
224
2/3
✓ Branch 0 taken 3 times.
✓ Branch 1 taken 3 times.
✗ Branch 2 not taken.
 6 switch (cmds[i][0]) {
225 3 case 'S': // SHIFT command affect the whole script...
226
1/2
✓ Branch 0 taken 3 times.
✗ Branch 1 not taken.
 3 if (!shift_set) {
227 3 jacosub->shift = get_shift(jacosub->timeres, p);
228 3 shift_set = 1;
229 }
230 3 av_bprintf(&header, "#S %s", p);
231 3 break;
232 3 case 'T': { // ...but must be placed after TIMERES
233 3 int64_t timeres = strtol(p, NULL, 10);
234
2/4
✓ Branch 0 taken 3 times.
✗ Branch 1 not taken.
✗ Branch 2 not taken.
✓ Branch 3 taken 3 times.
 3 if (timeres <= 0 || timeres > UINT32_MAX) {
235 ✗ jacosub->timeres = 30;
236 } else {
237 3 jacosub->timeres = timeres;
238 3 av_bprintf(&header, "#T %s", p);
239 }
240 3 break;
241 }
242 }
243 }
244
245 /* general/essential directives in the extradata */
246 3 ret = ff_bprint_to_codecpar_extradata(st->codecpar, &header);
247
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 3 times.
 3 if (ret < 0)
248 ✗ return ret;
249
250 /* SHIFT and TIMERES affect the whole script so packet timing can only be
251 * done in a second pass */
252
2/2
✓ Branch 0 taken 33 times.
✓ Branch 1 taken 3 times.
 36 for (i = 0; i < jacosub->q.nb_subs; i++) {
253 33 AVPacket *sub = jacosub->q.subs[i];
254 33 read_ts(jacosub, sub->data, &sub->pts, &sub->duration);
255 }
256 3 ff_subtitles_queue_finalize(s, &jacosub->q);
257
258 3 return 0;
259 }
260
261 const FFInputFormat ff_jacosub_demuxer = {
262 .p.name = "jacosub",
263 .p.long_name = NULL_IF_CONFIG_SMALL("JACOsub subtitle format"),
264 .priv_data_size = sizeof(JACOsubContext),
265 .flags_internal = FF_INFMT_FLAG_INIT_CLEANUP,
266 .read_probe = jacosub_probe,
267 .read_header = jacosub_read_header,
268 .read_packet = ff_subtitles_read_packet,
269 .read_seek2 = ff_subtitles_read_seek,
270 .read_close = ff_subtitles_read_close,
271 };
272