Coverage Report

Created: 2025-12-31 07:57

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/ffmpeg/libavcodec/xsubenc.c
Line
Count
Source
1
/*
2
 * DivX (XSUB) subtitle encoder
3
 * Copyright (c) 2005 DivX, Inc.
4
 * Copyright (c) 2009 Bjorn Axelsson
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 "avcodec.h"
24
#include "bytestream.h"
25
#include "codec_internal.h"
26
#include "put_bits.h"
27
28
/**
29
 * Number of pixels to pad left and right.
30
 *
31
 * The official encoder pads the subtitles with two pixels on either side,
32
 * but until we find out why, we won't do it (we will pad to have width
33
 * divisible by 2 though).
34
 */
35
0
#define PADDING 0
36
0
#define PADDING_COLOR 0
37
38
/**
39
 * Encode a single color run. At most 16 bits will be used.
40
 * @param len   length of the run, values > 255 mean "until end of line", may not be < 0.
41
 * @param color color to encode, only the lowest two bits are used and all others must be 0.
42
 */
43
static void put_xsub_rle(PutBitContext *pb, int len, int color)
44
0
{
45
0
    if (len <= 255)
46
0
        put_bits(pb, 2 + ((ff_log2_tab[len] >> 1) << 2), len);
47
0
    else
48
0
        put_bits(pb, 14, 0);
49
0
    put_bits(pb, 2, color);
50
0
}
51
52
/**
53
 * Encode a 4-color bitmap with XSUB rle.
54
 *
55
 * The encoded bitmap may be wider than the source bitmap due to padding.
56
 */
57
static int xsub_encode_rle(PutBitContext *pb, const uint8_t *bitmap,
58
                           int linesize, int w, int h)
59
0
{
60
0
    int x0, x1, y, len, color = PADDING_COLOR;
61
62
0
    for (y = 0; y < h; y++) {
63
0
        x0 = 0;
64
0
        while (x0 < w) {
65
            // Make sure we have enough room for at least one run and padding
66
0
            if (put_bytes_left(pb, 1) < 7)
67
0
                return AVERROR_BUFFER_TOO_SMALL;
68
69
0
            x1 = x0;
70
0
            color = bitmap[x1++] & 3;
71
0
            while (x1 < w && (bitmap[x1] & 3) == color)
72
0
                x1++;
73
0
            len = x1 - x0;
74
0
            if (PADDING && x0 == 0) {
75
0
                if (color == PADDING_COLOR) {
76
0
                    len += PADDING;
77
0
                    x0  -= PADDING;
78
0
                } else
79
0
                    put_xsub_rle(pb, PADDING, PADDING_COLOR);
80
0
            }
81
82
            // Run can't be longer than 255, unless it is the rest of a row
83
0
            if (x1 == w && color == PADDING_COLOR) {
84
0
                len += PADDING + (w&1);
85
0
            } else
86
0
                len = FFMIN(len, 255);
87
0
            put_xsub_rle(pb, len, color);
88
89
0
            x0 += len;
90
0
        }
91
0
        if (color != PADDING_COLOR && (PADDING + (w&1)))
92
0
            put_xsub_rle(pb, PADDING + (w&1), PADDING_COLOR);
93
94
0
        align_put_bits(pb);
95
96
0
        bitmap += linesize;
97
0
    }
98
99
0
    return 0;
100
0
}
101
102
static int make_tc(uint64_t ms, int *tc)
103
0
{
104
0
    static const int tc_divs[3] = { 1000, 60, 60 };
105
0
    int i;
106
0
    for (i=0; i<3; i++) {
107
0
        tc[i] = ms % tc_divs[i];
108
0
        ms /= tc_divs[i];
109
0
    }
110
0
    tc[3] = ms;
111
0
    return ms > 99;
112
0
}
113
114
static int xsub_encode(AVCodecContext *avctx, unsigned char *buf,
115
                       int bufsize, const AVSubtitle *h)
116
0
{
117
0
    uint64_t startTime = h->pts / 1000; // FIXME: need better solution...
118
0
    uint64_t endTime = startTime + h->end_display_time - h->start_display_time;
119
0
    int start_tc[4], end_tc[4];
120
0
    uint8_t *hdr = buf + 27; // Point behind the timestamp
121
0
    uint8_t *rlelenptr;
122
0
    uint16_t width, height;
123
0
    int i;
124
0
    PutBitContext pb;
125
126
0
    if (bufsize < 27 + 7*2 + 4*3) {
127
0
        av_log(avctx, AV_LOG_ERROR, "Buffer too small for XSUB header.\n");
128
0
        return AVERROR_BUFFER_TOO_SMALL;
129
0
    }
130
131
    // TODO: support multiple rects
132
0
    if (h->num_rects != 1)
133
0
        av_log(avctx, AV_LOG_WARNING, "Only single rects supported (%d in subtitle.)\n", h->num_rects);
134
135
    // TODO: render text-based subtitles into bitmaps
136
0
    if (!h->rects[0]->data[0] || !h->rects[0]->data[1]) {
137
0
        av_log(avctx, AV_LOG_WARNING, "No subtitle bitmap available.\n");
138
0
        return AVERROR(EINVAL);
139
0
    }
140
141
    // TODO: color reduction, similar to dvdsub encoder
142
0
    if (h->rects[0]->nb_colors > 4)
143
0
        av_log(avctx, AV_LOG_WARNING, "No more than 4 subtitle colors supported (%d found.)\n", h->rects[0]->nb_colors);
144
145
    // TODO: Palette swapping if color zero is not transparent
146
0
    if (((uint32_t *)h->rects[0]->data[1])[0] & 0xff000000)
147
0
        av_log(avctx, AV_LOG_WARNING, "Color index 0 is not transparent. Transparency will be messed up.\n");
148
149
0
    if (make_tc(startTime, start_tc) || make_tc(endTime, end_tc)) {
150
0
        av_log(avctx, AV_LOG_WARNING, "Time code >= 100 hours.\n");
151
0
        return AVERROR(EINVAL);
152
0
    }
153
154
0
    snprintf(buf, 28,
155
0
        "[%02d:%02d:%02d.%03d-%02d:%02d:%02d.%03d]",
156
0
        start_tc[3], start_tc[2], start_tc[1], start_tc[0],
157
0
        end_tc[3],   end_tc[2],   end_tc[1],   end_tc[0]);
158
159
    // Width and height must probably be multiples of 2.
160
    // 2 pixels required on either side of subtitle.
161
    // Possibly due to limitations of hardware renderers.
162
    // TODO: check if the bitmap is already padded
163
0
    width  = FFALIGN(h->rects[0]->w, 2) + PADDING * 2;
164
0
    height = FFALIGN(h->rects[0]->h, 2);
165
166
0
    bytestream_put_le16(&hdr, width);
167
0
    bytestream_put_le16(&hdr, height);
168
0
    bytestream_put_le16(&hdr, h->rects[0]->x);
169
0
    bytestream_put_le16(&hdr, h->rects[0]->y);
170
0
    bytestream_put_le16(&hdr, h->rects[0]->x + width -1);
171
0
    bytestream_put_le16(&hdr, h->rects[0]->y + height -1);
172
173
0
    rlelenptr = hdr; // Will store length of first field here later.
174
0
    hdr+=2;
175
176
    // Palette
177
0
    for (i=0; i<4; i++)
178
0
        bytestream_put_be24(&hdr, ((uint32_t *)h->rects[0]->data[1])[i]);
179
180
    // Bitmap
181
    // RLE buffer. Reserve 2 bytes for possible padding after the last row.
182
0
    init_put_bits(&pb, hdr, bufsize - (hdr - buf) - 2);
183
0
    if (xsub_encode_rle(&pb, h->rects[0]->data[0],
184
0
                        h->rects[0]->linesize[0] * 2,
185
0
                        h->rects[0]->w, (h->rects[0]->h + 1) >> 1))
186
0
        return AVERROR_BUFFER_TOO_SMALL;
187
0
    bytestream_put_le16(&rlelenptr, put_bytes_count(&pb, 0)); // Length of first field
188
189
0
    if (xsub_encode_rle(&pb, h->rects[0]->data[0] + h->rects[0]->linesize[0],
190
0
                        h->rects[0]->linesize[0] * 2,
191
0
                        h->rects[0]->w, h->rects[0]->h >> 1))
192
0
        return AVERROR_BUFFER_TOO_SMALL;
193
194
    // Enforce total height to be a multiple of 2
195
0
    if (h->rects[0]->h & 1) {
196
0
        put_xsub_rle(&pb, h->rects[0]->w, PADDING_COLOR);
197
0
    }
198
199
0
    flush_put_bits(&pb);
200
201
0
    return hdr - buf + put_bytes_output(&pb);
202
0
}
203
204
static av_cold int xsub_encoder_init(AVCodecContext *avctx)
205
0
{
206
0
    if (!avctx->codec_tag)
207
0
        avctx->codec_tag = MKTAG('D','X','S','B');
208
209
0
    avctx->bits_per_coded_sample = 4;
210
211
0
    return 0;
212
0
}
213
214
const FFCodec ff_xsub_encoder = {
215
    .p.name     = "xsub",
216
    CODEC_LONG_NAME("DivX subtitles (XSUB)"),
217
    .p.type     = AVMEDIA_TYPE_SUBTITLE,
218
    .p.id       = AV_CODEC_ID_XSUB,
219
    .init       = xsub_encoder_init,
220
    FF_CODEC_ENCODE_SUB_CB(xsub_encode),
221
};