SupTitle is an AviSynth plugin that renders Blu-ray PGS .SUP subtitles.
SUP files can be extracted from a BD or HD DVD movie using
eac3to.
Usage in AviSynth Script:
clip.SupTitle(string-filename, bool-forcedOnly,
bool-swapCbCr, bool-relocate, string-relocOffset)
Arguments:
filename
Full path and filename to your .SUP file.
forcedOnly -
Optional, default = false
Displays forced subtitles only.
swapCbCr -
Optional, default = false
Swap Cb/Cr when decoding subtitle stream.
relocate -
Optional, default = true
Relocate out of position subtitles (e.g. cropping the source usually causes
the subs to go out of viewable rect).
relocOffset -
Optional, default = ""
This is to let SupTitle know how to properly position subs, particularly
with subs that are supposed to appear in the middle of the screen. By
supplying the cropped offsets from the original video, SupTitle can work out
how to reposition the subs to most accurately place the repositioned subs.
Syntax: "x1, y1, x2, y2", where x1, y1 are the number of pixels cropped left
and top respectively; and, x2, y2 are the number of pixels cropped right
and bottom respectively. Use positive integers only. The default value of
"" is syntactically similar to "0, 0, 0, 0", which means the source is not
cropped.
Note: You should
always specify a relocOffset unless you are
certain all your subs only appear at the bottom of the video.
Example:
LoadPlugin("C:\SupTitle\SupTitle.dll")
DirectShowSource("C:\movie.avi")
SupTitle("C:\sub.sup", forcedOnly=false, \
swapCbCr=false, relocate=true, \
relocOffset="0,140,0,140")
The following is a screenshot of a subtitle from a movie overlayed on top of
an arbitrary screen capture for demo purposes. Click image for larger view.
Features summary:
- Freeware
- Supported colorspace - YV12
- SIMD optimizations (Minimum requirements: SSE2 capable CPU)
- Alpha channel transparency blending
- Handles both HD-DVD and Blu-ray .SUP subtitle files extracted by eac3to
- Perfect for hardsubbing forced subtitles with forced flag detection
(e.g. subs for foreign dialogues)
- Supports seek and jump