SupTitle

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
(redirect for convenient searching)
 
(add documentation from archived webpage)
Line 1: Line 1:
#REDIRECT [[External_filters#Subtitling]]
+
{{FilterCat4|External_filters|Plugins|Adjustment_filters|Subtitling}}
{{FilterCat|External_filters|Adjustment_filters|Subtitling}}
+
{{Filter3
 +
| Zachs
 +
| v2.0.8
 +
| [https://web.archive.org/web/20180302191910/http://www.zachsaw.com/downloads/suptitle_v2.0.8_x86.zip suptitle_v2.0.8_x86.zip] [https://web.archive.org/web/20180302191910/http://www.zachsaw.com/downloads/suptitle_v2.0.8_x64.zip suptitle_v2.0.8_x64.zip]
 +
| Subtitling
 +
| Closed source
 +
|6=[http://forum.doom9.org/showthread.php?t=148167 Doom9 Thread]}}
 +
<br>
 +
== Description ==
 +
SupTitle is an AviSynth plugin that renders Blu-ray PGS .SUP subtitles. See [https://web.archive.org/web/20180302191910/http://www.zachsaw.com/?pg=suptitle_pgs_avisynth_plugin official documentation].
 +
 
 +
Features summary:
 +
* SIMD optimizations
 +
* 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
 +
<br>
 +
== Requirements ==
 +
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
 +
* Supported color formats: [[YV12]]
 +
* [[SSE2]] capable CPU
 +
* You'll need Microsoft .NET Framework 4 installed.
 +
<br>
 +
 
 +
== [[Script variables|Syntax and Parameters]] ==
 +
:{{Template:FuncDef|SupTitle (clip, string filename, bool "forcedOnly", bool "swapCbCr", bool "relocate", string "relocOffset") }}
 +
<br>
 +
::{{Par2||clip| }}
 +
:::Input clip.
 +
<br>
 +
::{{Par2||string|}}
 +
:::Full path and filename to your .SUP file
 +
<br>
 +
::{{Par2|forcedOnly|bool|false}}
 +
:::Displays forced subtitles only.
 +
<br>
 +
::{{Par2|swapCbCr|bool|false}}
 +
:::Swap Cb/Cr when decoding subtitle stream.
 +
<br>
 +
::{{Par2|relocate|bool|true}}
 +
:::Relocate out of position subtitles (e.g. cropping the source usually causes the subs to go out of viewable rect).
 +
<br>
 +
::{{Par2|relocOffset|string|""}}
 +
:::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 <tt>relocOffset</tt> unless you are certain all your subs only appear at the bottom of the video.
 +
<br>
 +
 
 +
== Examples ==
 +
SupTitle with defaults settings:
 +
[[AviSource]]("Blah.avi")
 +
SupTitle("C:\sub.sup", forcedOnly=false, swapCbCr=false, relocate=true, relocOffset="")
 +
 
 +
<br>
 +
 
 +
== Changelog ==
 +
<pre>
 +
Version 2.0.8
 +
 
 +
    Blu-ray SUP file format handling improvement.
 +
 
 +
Version 2.0.7
 +
 
 +
    Removed all colorspaces to only support YV12. Other colorspaces were not properly supported anyway.
 +
    Memory usage optimizations - reduced peak memory usage.
 +
 
 +
Version 2.0.6
 +
 
 +
    Performance optimizations - converted all MMX routines to SSE2.
 +
 
 +
Version 2.0.5
 +
 
 +
    Fixed issue where the first subtitle in a SUP file is not displayed.
 +
 
 +
Version 2.0.4
 +
 
 +
    Removed ability to adjust fadeShowRatio (now fixed to 0.0) - decoding of animated subs are not fully understood yet.
 +
 
 +
Version 2.0.3
 +
 
 +
    Fixed animated subtitles being displayed with incorrect start/end time.
 +
    Align handling of animated SUPs to that of BDSup2Sub so users know what to expect.
 +
 
 +
Version 2.0.2
 +
 
 +
    Workaround for animated SUPs (fade-in/out etc.). Animation isn't supported yet but at least SupTitle won't blow up upon loading such files.
 +
 
 +
Version 2.0.1
 +
 
 +
    Work around for .NET 4.0's removal of sandbox support for partial trust assemblies.
 +
 
 +
Version 2.0.0
 +
 
 +
    More Blu-ray SUP file format handling improvement (e.g. Avatar forced subtitles).
 +
    Pilot release of x64 version.
 +
 
 +
Version 1.0.9
 +
 
 +
    More Blu-ray SUP file format handling improvement.
 +
 
 +
Version 1.0.8
 +
 
 +
    Improved support of Blu-ray SUP file format - it now handles a wider variety of BD SUPs.
 +
 
 +
Version 1.0.7
 +
 
 +
    Fixed a bug introduced in 1.0.6 where some subtitles would not appear.
 +
    Improved frame accuracy (fixed one frame late issue).
 +
 
 +
Version 1.0.6
 +
 
 +
    Faster load and verify algo leads to shorter load time for huge sup files (>1GB).
 +
 
 +
Version 1.0.5
 +
 
 +
    Fixed RGB colorspaces image blending issues again (introduced in v1.0.4 due to an optimization).
 +
    More optimizations.
 +
 
 +
Version 1.0.4
 +
 
 +
    Added support for subtitle relocation.
 +
 
 +
Version 1.0.3
 +
 
 +
    Fixed image blending issues with RGB24/32.
 +
 
 +
Version 1.0.2
 +
 
 +
    Changed the way Ycbcr is decoded (you can still switch back to the original method by setting swapCbCr to true).
 +
    Additionally, it now uses the ITU BT.709 colormetry.
 +
    Function arguments forcedOnly and swapCbCr (new) are now named and optional.
 +
 
 +
Version 1.0.1
 +
 
 +
    Added Features:
 +
    Speed Optimizations
 +
 
 +
Version 1.0.0
 +
 
 +
    Pilot Release
 +
</pre>
 +
<br>
 +
== Archived Downloads ==
 +
{| class="wikitable" border="1"; width="600px"
 +
|-
 +
!!width="100px"| Version
 +
!!width="150px"| Download
 +
!!width="150px"| Mirror
 +
|-
 +
!v0.95
 +
|
 +
*[https://web.archive.org/web/20180302191910/http://www.zachsaw.com/downloads/suptitle_v2.0.8_x86.zip suptitle_v2.0.8_x86.zip]
 +
*[https://web.archive.org/web/20180302191910/http://www.zachsaw.com/downloads/suptitle_v2.0.8_x64.zip suptitle_v2.0.8_x64.zip]
 +
 
 +
|
 +
|}
 +
<br>
 +
== External Links ==
 +
*[http://forum.doom9.org/showthread.php?t=148167 Doom9 Forum] - SupTitle discussion.
 +
<br>
 +
<br>
 +
-----------------------------------------------
 +
'''Back to [[External_filters#Subtitling|External Filters]] &larr;'''

Revision as of 20:46, 17 March 2019

Abstract
Author Zachs
Version v2.0.8
Download suptitle_v2.0.8_x86.zip suptitle_v2.0.8_x64.zip
Category Subtitling
License Closed source
Discussion Doom9 Thread


Contents

Description

SupTitle is an AviSynth plugin that renders Blu-ray PGS .SUP subtitles. See official documentation.

Features summary:

  • SIMD optimizations
  • 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


Requirements

  • AviSynth 2.5.8 or greater
  • Supported color formats: YV12
  • SSE2 capable CPU
  • You'll need Microsoft .NET Framework 4 installed.


Syntax and Parameters

SupTitle (clip, string filename, bool "forcedOnly", bool "swapCbCr", bool "relocate", string "relocOffset")


clip   =
Input clip.


string   =
Full path and filename to your .SUP file


bool  forcedOnly = false
Displays forced subtitles only.


bool  swapCbCr = false
Swap Cb/Cr when decoding subtitle stream.


bool  relocate = true
Relocate out of position subtitles (e.g. cropping the source usually causes the subs to go out of viewable rect).


string  relocOffset = ""
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.


Examples

SupTitle with defaults settings:

AviSource("Blah.avi")
SupTitle("C:\sub.sup", forcedOnly=false, swapCbCr=false, relocate=true, relocOffset="")


Changelog

 Version 2.0.8

    Blu-ray SUP file format handling improvement.

Version 2.0.7

    Removed all colorspaces to only support YV12. Other colorspaces were not properly supported anyway.
    Memory usage optimizations - reduced peak memory usage.

Version 2.0.6

    Performance optimizations - converted all MMX routines to SSE2.

Version 2.0.5

    Fixed issue where the first subtitle in a SUP file is not displayed.

Version 2.0.4

    Removed ability to adjust fadeShowRatio (now fixed to 0.0) - decoding of animated subs are not fully understood yet.

Version 2.0.3

    Fixed animated subtitles being displayed with incorrect start/end time.
    Align handling of animated SUPs to that of BDSup2Sub so users know what to expect.

Version 2.0.2

    Workaround for animated SUPs (fade-in/out etc.). Animation isn't supported yet but at least SupTitle won't blow up upon loading such files.

Version 2.0.1

    Work around for .NET 4.0's removal of sandbox support for partial trust assemblies.

Version 2.0.0

    More Blu-ray SUP file format handling improvement (e.g. Avatar forced subtitles).
    Pilot release of x64 version.

Version 1.0.9

    More Blu-ray SUP file format handling improvement.

Version 1.0.8

    Improved support of Blu-ray SUP file format - it now handles a wider variety of BD SUPs.

Version 1.0.7

    Fixed a bug introduced in 1.0.6 where some subtitles would not appear.
    Improved frame accuracy (fixed one frame late issue).

Version 1.0.6

    Faster load and verify algo leads to shorter load time for huge sup files (>1GB).

Version 1.0.5

    Fixed RGB colorspaces image blending issues again (introduced in v1.0.4 due to an optimization).
    More optimizations.

Version 1.0.4

    Added support for subtitle relocation.

Version 1.0.3

    Fixed image blending issues with RGB24/32.

Version 1.0.2

    Changed the way Ycbcr is decoded (you can still switch back to the original method by setting swapCbCr to true).
    Additionally, it now uses the ITU BT.709 colormetry.
    Function arguments forcedOnly and swapCbCr (new) are now named and optional.

Version 1.0.1

    Added Features:
    Speed Optimizations

Version 1.0.0

    Pilot Release


Archived Downloads

Version Download Mirror
v0.95


External Links




Back to External Filters

Personal tools