aboutsummaryrefslogtreecommitdiffstats
path: root/src/jogl/classes/com/jogamp/opengl/util/av/SubtitleEvent.java
blob: e75fff3f86eecd36e8a60c1ecf1479937ba7249b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
package com.jogamp.opengl.util.av;

import com.jogamp.common.av.PTS;

/**
 * Generic subtitle event
 * <p>
 * It is mandatory that the receiver {@link #release()} this instance
 * after processing, allowing the resource owner to free or reuse it.
 * </p>
 */
public abstract class SubtitleEvent {
    /** {@link SubtitleEvent} Implementation Type */
    public enum Type {
        /** {@link SubTextEvent} */
        Text,
        /** {@link SubBitmapEvent} */
        Bitmap,
        /** {@link SubEmptyEvent} */
        Empty
    };
    /** Implementation {@link Type} of this instance. */
    public final Type type;
    /** {@link CodecID} of this subtitle event. */
    public final CodecID codec;
    /** PTS start time in milliseconds to start showing this subtitle event. */
    public final int pts_start;
    /**
     * PTS end time in milliseconds to end showing this subtitle event.
     * <p>
     * {@link SubBitmapEvent} often (e.g. {@link CodecID#HDMV_PGS}) have an infinite end-time, i.e. ({@link Integer#MAX_VALUE},
     * and shall be overwritten by the next one or {@link SubEmptyEvent}.
     * </p>
     * @see #isEndDefined()
     */
    public final int pts_end;

    public SubtitleEvent(final Type type, final CodecID codec, final int pts_start, final int pts_end) {
        this.type = type;
        this.codec = codec;
        this.pts_start = pts_start;
        this.pts_end = pts_end;
    }

    /** Release the resources, if any, back to the owner. */
    public abstract void release();

    public final int getDuration() { return pts_end - pts_start + 1; }

    /** See {@link #pts_end}. */
    public final boolean isEndDefined() { return pts_end < Integer.MAX_VALUE; }

    public final String getStartString() {
        final boolean ied = isEndDefined();
        final String pts_start_s = 0 <= pts_start ? PTS.toTimeStr(pts_start, true) : "undef";
        final String pts_end_s = 0 <= pts_end && ied ? PTS.toTimeStr(pts_end, true) : "undef";
        return "Sub[codec "+codec+", type "+type+", ["+pts_start_s+".."+pts_end_s+"] "+(ied?getDuration():"undef")+" ms";
    }


}