git.sesse.net Git - vlc/blob - doc/subtitles/svcd-ogt-subtitles.txt

   1 $Id$
   2
   3 The following information is culled from information from Julio
   4 Sanchez Fernandez [1] by Rocky Bernstein.
   5
   6 SVCD subtitles (Philips Overlay Graphics Text or OGT) are transported
   7 in an MPEG private stream with stream id 0x70. AC3 subtitle stream
   8 numbers start at 0,x80 and go to 0,x87. (CVD subtitle stream numbers
   9 start at stream ID 0 and go to 3.)
  10
  11 All numbers are in big-endian and the image is interlaced with a
  12 resolution of 720x480 for NTSC streams or 720x576 for PAL streams.
  13
  14 Data packets start with a 4-byte header:
  15
  16     * Stream number (1 byte). Only bits 0-3 are used as there can only
  17       be up to 8 subtitles.
  18
  19     * Packet number(1 byte). The first packet starts at 0; the last
  20       packet of a subtitle has the 7th bit set. A subtitle can be
  21       broken up into several packets when it is multiplexed into the
  22       MPEG stream.
  23
  24     * Subtitle image number (2 bytes).
  25
  26     * Length of the rest of the packet (described in the next section).
  27
  28 ================
  29 SUBTITLE PACKETS
  30 ================
  31
  32 The information below comes immediately after the packet header in the
  33 same packet.
  34
  35 * Packet length (2 bytes)
  36
  37 The assembled subtitle, with stripped sequence numbers
  38
  39 * Option byte (1 byte)
  40
  41 This is normally set to 0x2e; bit 3 indicates that a field with the
  42 display-time of the subtitle is present. What the other bits do is not
  43 known.
  44
  45 * Time to display the subtitle (4 bytes)
  46
  47 This in 1/90000'th of a second. This is only present if bit 3 above is
  48 set. This value specifies how long the subtitle will be shown, not
  49 when. When the subtitle is to be shown is specified in the PTS in the
  50 PES header.
  51
  52 * X position (2 bytes)
  53
  54 * Y position (2 bytes)
  55
  56 * Width (2 bytes)
  57
  58 This value must be even.
  59
  60 * Height (2 bytes)
  61
  62 This value must be even.
  63
  64 * Unknown (1 byte)
  65
  66 * 4 Color Palette Entries (16 bytes)
  67
  68 * A pallette entry has the following format:
  69
  70     * Y (1 byte)
  71     * U (1 byte)
  72     * V (1 byte)
  73     * Transparency (1 byte). A 0 value means totally transparent and
  74       255 totally opaque.
  75
  76 * Command (1 byte)
  77
  78   >>6: 1 shift command, (cmd>>4)&3 is the direction (0=top, 1=left, 2 = right, 3 >>= bottom)
  79
  80 * Odd-field data offset (2 bytes)
  81
  82 Image data is stored interlaced with the even lines first. This offset
  83 specifies where the first odd-line image data starts.
  84
  85 IMAGE DATA
  86
  87 Then subtitle image data follows the above control information. Image
  88 lines are interlaced. That is line 0 is comes first, then line 2, then
  89 line 4. After all of the even lines, comes line 1, then line 3,
  90 etc.. The subtitle aspect ratio is not to be scaled. It is independent
  91 of the aspect ratio of the underlying image which it is to be
  92 overlayed on top of.
  93
  94 The image is encoded using two bits per pixel that select a palette
  95 entry except that value 0 starts a limited run-length encoding for
  96 color 0. When 0 is seen, the next two bits encode one less than
  97 thenumber of pixels, so we can encode run lengths from 1 to 4. These
  98 get filled with the color in palette entry 0.
  99
 100 The encoding of each line is padded to a whole number of bytes. The
 101 first field is padded to an even byte length and the complete subtitle
 102 is padded to a 4-byte multiple that always include one zero byte at
 103 the end.
 104
 105 ================
 106 SUBTITLING TOOLS
 107 ================
 108
 109 Philips SVCD tools can create SVCD subtitles, but it only works under
 110 NT4. It is not that easy to find anymore. (dvd.da.ru, doom9.net or
 111 similar perhaps?). It can create good subtitled SVCDs. Subtitles are
 112 created in a text editor. Another tool is called submux. Last version
 113 I tried doesn't do renumber presentation time stamps properly, but
 114 many media players (now) can tolerate this.
 115
 116 The subtitles you get from tools like "I-author" are not SVCD
 117 subtitles, they are CVD subtitles. They look similar to DVD subtitles,
 118 but the run-length encoding (RLE) and command format are different.