FFmpeg  4.4.4
jacosubdec.c
Go to the documentation of this file.
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 "internal.h"
30 #include "subtitles.h"
31 #include "libavcodec/internal.h"
32 #include "libavcodec/jacosub.h"
33 #include "libavutil/avstring.h"
34 #include "libavutil/bprint.h"
35 #include "libavutil/intreadwrite.h"
36 
37 typedef struct {
38  int shift;
39  unsigned timeres;
42 
43 static int timed_line(const char *ptr)
44 {
45  char c;
46  int fs, fe;
47  return (sscanf(ptr, "%*u:%*u:%*u.%*u %*u:%*u:%*u.%*u %c", &c) == 1 ||
48  (sscanf(ptr, "@%u @%u %c", &fs, &fe, &c) == 3 && fs < fe));
49 }
50 
51 static int jacosub_probe(const AVProbeData *p)
52 {
53  const char *ptr = p->buf;
54  const char *ptr_end = p->buf + p->buf_size;
55 
56  if (AV_RB24(ptr) == 0xEFBBBF)
57  ptr += 3; /* skip UTF-8 BOM */
58 
59  while (ptr < ptr_end) {
60  while (jss_whitespace(*ptr))
61  ptr++;
62  if (*ptr != '#' && *ptr != '\n') {
63  if (timed_line(ptr))
64  return AVPROBE_SCORE_EXTENSION + 1;
65  return 0;
66  }
67  ptr += ff_subtitles_next_line(ptr);
68  }
69  return 0;
70 }
71 
72 static const char * const cmds[] = {
73  "CLOCKPAUSE",
74  "DIRECTIVE",
75  "FONT",
76  "HRES",
77  "INCLUDE",
78  "PALETTE",
79  "QUANTIZE",
80  "RAMP",
81  "SHIFT",
82  "TIMERES",
83 };
84 
85 static int get_jss_cmd(char k)
86 {
87  int i;
88 
89  k = av_toupper(k);
90  for (i = 0; i < FF_ARRAY_ELEMS(cmds); i++)
91  if (k == cmds[i][0])
92  return i;
93  return -1;
94 }
95 
97 {
98  JACOsubContext *jacosub = s->priv_data;
99  ff_subtitles_queue_clean(&jacosub->q);
100  return 0;
101 }
102 
103 static const char *read_ts(JACOsubContext *jacosub, const char *buf,
104  int64_t *start, int64_t *duration)
105 {
106  int len;
107  unsigned hs, ms, ss, fs; // hours, minutes, seconds, frame start
108  unsigned he, me, se, fe; // hours, minutes, seconds, frame end
109  int ts_start, ts_end;
110  int64_t ts_start64, ts_end64;
111 
112  /* timed format */
113  if (sscanf(buf, "%u:%u:%u.%u %u:%u:%u.%u %n",
114  &hs, &ms, &ss, &fs,
115  &he, &me, &se, &fe, &len) == 8) {
116  ts_start = (hs*3600 + ms*60 + ss) * jacosub->timeres + fs;
117  ts_end = (he*3600 + me*60 + se) * jacosub->timeres + fe;
118  goto shift_and_ret;
119  }
120 
121  /* timestamps format */
122  if (sscanf(buf, "@%u @%u %n", &ts_start, &ts_end, &len) == 2)
123  goto shift_and_ret;
124 
125  return NULL;
126 
127 shift_and_ret:
128  ts_start64 = (ts_start + (int64_t)jacosub->shift) * 100LL / jacosub->timeres;
129  ts_end64 = (ts_end + (int64_t)jacosub->shift) * 100LL / jacosub->timeres;
130  *start = ts_start64;
131  *duration = ts_end64 - ts_start64;
132  return buf + len;
133 }
134 
135 static int get_shift(int timeres, const char *buf)
136 {
137  int sign = 1;
138  int a = 0, b = 0, c = 0, d = 0;
139  int64_t ret;
140 #define SSEP "%*1[.:]"
141  int n = sscanf(buf, "%d"SSEP"%d"SSEP"%d"SSEP"%d", &a, &b, &c, &d);
142 #undef SSEP
143 
144  if (a == INT_MIN)
145  return 0;
146 
147  if (*buf == '-' || a < 0) {
148  sign = -1;
149  a = FFABS(a);
150  }
151 
152  ret = 0;
153  switch (n) {
154  case 4:
155  ret = sign * (((int64_t)a*3600 + (int64_t)b*60 + c) * timeres + d);
156  break;
157  case 3:
158  ret = sign * (( (int64_t)a*60 + b) * timeres + c);
159  break;
160  case 2:
161  ret = sign * (( (int64_t)a) * timeres + b);
162  break;
163  }
164  if ((int)ret != ret)
165  ret = 0;
166 
167  return ret;
168 }
169 
171 {
172  AVBPrint header;
173  AVIOContext *pb = s->pb;
174  char line[JSS_MAX_LINESIZE];
175  JACOsubContext *jacosub = s->priv_data;
176  int shift_set = 0; // only the first shift matters
177  int merge_line = 0;
178  int i, ret;
179 
181  if (!st)
182  return AVERROR(ENOMEM);
183  avpriv_set_pts_info(st, 64, 1, 100);
186 
187  jacosub->timeres = 30;
188 
190 
191  while (!avio_feof(pb)) {
192  int cmd_len;
193  const char *p = line;
194  int64_t pos = avio_tell(pb);
195  int len = ff_get_line(pb, line, sizeof(line));
196 
197  p = jss_skip_whitespace(p);
198 
199  /* queue timed line */
200  if (merge_line || timed_line(p)) {
201  AVPacket *sub;
202 
203  sub = ff_subtitles_queue_insert(&jacosub->q, line, len, merge_line);
204  if (!sub) {
206  ret = AVERROR(ENOMEM);
207  goto fail;
208  }
209  sub->pos = pos;
210  merge_line = len > 1 && !strcmp(&line[len - 2], "\\\n");
211  continue;
212  }
213 
214  /* skip all non-compiler commands and focus on the command */
215  if (*p != '#')
216  continue;
217  p++;
218  i = get_jss_cmd(p[0]);
219  if (i == -1)
220  continue;
221 
222  /* trim command + spaces */
223  cmd_len = strlen(cmds[i]);
224  if (av_strncasecmp(p, cmds[i], cmd_len) == 0)
225  p += cmd_len;
226  else
227  p++;
228  p = jss_skip_whitespace(p);
229 
230  /* handle commands which affect the whole script */
231  switch (cmds[i][0]) {
232  case 'S': // SHIFT command affect the whole script...
233  if (!shift_set) {
234  jacosub->shift = get_shift(jacosub->timeres, p);
235  shift_set = 1;
236  }
237  av_bprintf(&header, "#S %s", p);
238  break;
239  case 'T': // ...but must be placed after TIMERES
240  jacosub->timeres = strtol(p, NULL, 10);
241  if (!jacosub->timeres)
242  jacosub->timeres = 30;
243  else
244  av_bprintf(&header, "#T %s", p);
245  break;
246  }
247  }
248 
249  /* general/essential directives in the extradata */
251  if (ret < 0)
252  goto fail;
253 
254  /* SHIFT and TIMERES affect the whole script so packet timing can only be
255  * done in a second pass */
256  for (i = 0; i < jacosub->q.nb_subs; i++) {
257  AVPacket *sub = jacosub->q.subs[i];
258  read_ts(jacosub, sub->data, &sub->pts, &sub->duration);
259  }
260  ff_subtitles_queue_finalize(s, &jacosub->q);
261 
262  return 0;
263 fail:
265  return ret;
266 }
267 
269 {
270  JACOsubContext *jacosub = s->priv_data;
271  return ff_subtitles_queue_read_packet(&jacosub->q, pkt);
272 }
273 
274 static int jacosub_read_seek(AVFormatContext *s, int stream_index,
275  int64_t min_ts, int64_t ts, int64_t max_ts, int flags)
276 {
277  JACOsubContext *jacosub = s->priv_data;
278  return ff_subtitles_queue_seek(&jacosub->q, s, stream_index,
279  min_ts, ts, max_ts, flags);
280 }
281 
283  .name = "jacosub",
284  .long_name = NULL_IF_CONFIG_SMALL("JACOsub subtitle format"),
285  .priv_data_size = sizeof(JACOsubContext),
289  .read_seek2 = jacosub_read_seek,
291 };
Main libavformat public API header.
#define AVPROBE_SCORE_EXTENSION
score for file extension
Definition: avformat.h:451
int avio_feof(AVIOContext *s)
Similar to feof() but also returns nonzero on read errors.
Definition: aviobuf.c:364
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:557
static int read_packet(void *opaque, uint8_t *buf, int buf_size)
Definition: avio_reading.c:42
int ff_get_line(AVIOContext *s, char *buf, int maxlen)
Read a whole line of text from AVIOContext.
Definition: aviobuf.c:789
#define AV_RB24
Definition: intreadwrite.h:64
void av_bprintf(AVBPrint *buf, const char *fmt,...)
Definition: bprint.c:94
void av_bprint_init(AVBPrint *buf, unsigned size_init, unsigned size_max)
Definition: bprint.c:69
int av_bprint_finalize(AVBPrint *buf, char **ret_str)
Finalize a print buffer.
Definition: bprint.c:235
#define flags(name, subs,...)
Definition: cbs_av1.c:561
#define se(name, range_min, range_max)
Definition: cbs_h2645.c:275
#define ss(width, name, subs,...)
Definition: cbs_vp9.c:261
#define s(width, name)
Definition: cbs_vp9.c:257
#define fs(width, name, subs,...)
Definition: cbs_vp9.c:259
#define fail()
Definition: checkasm.h:133
#define FFABS(a)
Absolute value, Note, INT_MIN / INT64_MIN result in undefined behavior as they are not representable ...
Definition: common.h:72
#define NULL
Definition: coverity.c:32
static float sub(float src0, float src1)
static int read_header(FFV1Context *f)
Definition: ffv1dec.c:545
@ AV_CODEC_ID_JACOSUB
Definition: codec_id.h:535
#define AV_INPUT_BUFFER_PADDING_SIZE
Required number of additionally allocated bytes at the end of the input bitstream for decoding.
Definition: avcodec.h:215
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:4509
#define AVERROR(e)
Definition: error.h:43
@ AVMEDIA_TYPE_SUBTITLE
Definition: avutil.h:204
static av_const int av_toupper(int c)
Locale-independent conversion of ASCII characters to uppercase.
Definition: avstring.h:236
int av_strncasecmp(const char *a, const char *b, size_t n)
Locale-independent case-insensitive compare.
Definition: avstring.c:225
int i
Definition: input.c:407
JACOsub shared utils.
static av_always_inline int jss_whitespace(char c)
Definition: jacosub.h:33
#define JSS_MAX_LINESIZE
Definition: jacosub.h:31
static av_always_inline const char * jss_skip_whitespace(const char *p)
Definition: jacosub.h:38
common internal api header.
int ff_bprint_to_codecpar_extradata(AVCodecParameters *par, struct AVBPrint *buf)
Finalize buf into extradata and set its size appropriately.
Definition: utils.c:5755
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.
Definition: utils.c:4945
static int get_jss_cmd(char k)
Definition: jacosubdec.c:85
static int get_shift(int timeres, const char *buf)
Definition: jacosubdec.c:135
static const char *const cmds[]
Definition: jacosubdec.c:72
static int jacosub_probe(const AVProbeData *p)
Definition: jacosubdec.c:51
#define SSEP
static int jacosub_read_seek(AVFormatContext *s, int stream_index, int64_t min_ts, int64_t ts, int64_t max_ts, int flags)
Definition: jacosubdec.c:274
static int jacosub_read_packet(AVFormatContext *s, AVPacket *pkt)
Definition: jacosubdec.c:268
static const char * read_ts(JACOsubContext *jacosub, const char *buf, int64_t *start, int64_t *duration)
Definition: jacosubdec.c:103
static int jacosub_read_header(AVFormatContext *s)
Definition: jacosubdec.c:170
static int timed_line(const char *ptr)
Definition: jacosubdec.c:43
static int jacosub_read_close(AVFormatContext *s)
Definition: jacosubdec.c:96
AVInputFormat ff_jacosub_demuxer
Definition: jacosubdec.c:282
static int read_probe(const AVProbeData *pd)
Definition: jvdec.c:55
common internal API header
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:117
static av_cold int read_close(AVFormatContext *ctx)
Definition: libcdio.c:145
static const uint8_t header[24]
Definition: sdr2.c:67
#define FF_ARRAY_ELEMS(a)
unsigned int pos
Definition: spdifenc.c:412
enum AVMediaType codec_type
General type of the encoded data.
Definition: codec_par.h:56
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: codec_par.h:60
Format I/O context.
Definition: avformat.h:1232
Bytestream IO Context.
Definition: avio.h:161
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:645
This structure stores compressed data.
Definition: packet.h:346
This structure contains the data a format has to probe a file.
Definition: avformat.h:441
int buf_size
Size of buf except extra allocated bytes.
Definition: avformat.h:444
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
Definition: avformat.h:443
Stream structure.
Definition: avformat.h:873
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Definition: avformat.h:1038
int nb_subs
number of subtitles packets
Definition: subtitles.h:104
AVPacket ** subs
array of subtitles packets
Definition: subtitles.h:103
unsigned timeres
Definition: jacosubdec.c:39
FFDemuxSubtitlesQueue q
Definition: jacosubdec.c:40
Definition: graph2dot.c:48
int ff_subtitles_queue_seek(FFDemuxSubtitlesQueue *q, AVFormatContext *s, int stream_index, int64_t min_ts, int64_t ts, int64_t max_ts, int flags)
Update current_sub_idx to emulate a seek.
Definition: subtitles.c:255
int ff_subtitles_queue_read_packet(FFDemuxSubtitlesQueue *q, AVPacket *pkt)
Generic read_packet() callback for subtitles demuxers using this queue system.
Definition: subtitles.c:216
void ff_subtitles_queue_finalize(void *log_ctx, FFDemuxSubtitlesQueue *q)
Set missing durations, sort subtitles by PTS (and then byte position), and drop duplicated events.
Definition: subtitles.c:198
void ff_subtitles_queue_clean(FFDemuxSubtitlesQueue *q)
Remove and destroy all the subtitles packets.
Definition: subtitles.c:307
AVPacket * ff_subtitles_queue_insert(FFDemuxSubtitlesQueue *q, const uint8_t *event, size_t len, int merge)
Insert a new subtitle event.
Definition: subtitles.c:111
static av_always_inline int ff_subtitles_next_line(const char *ptr)
Get the number of characters to increment to jump to the next line, or to the end of the string.
Definition: subtitles.h:187
int64_t duration
Definition: movenc.c:64
AVPacket * pkt
Definition: movenc.c:59
#define me
const char * b
Definition: vf_curves.c:118
int len
static double c[64]