SupTitle: an AviSynth PGS (.SUP) Subtitle Plugin

[Zachs]

I've changed the code so it would read the SUP format you posted.
It'll be available soon.

With regards to the framework dependency issue though, there's really not much I could do besides incorporating the dotnet bootstrap into a proper installer. I'm not keen on doing that as it would increase the download size to a few MBs from ~40KB. I'd rather have the framework as a separate download so users only need to download it once.

[Zachs]

v1.0.8 is now available.
Adds support for the SUP file format found here (http://forum.doom9.org/showthread.php?p=1325236#post1325236).

Head over to http://www.zachsaw.co.cc/?pg=suptitle_pgs_avisynth_plugin to download.

[Red Leader]

Great! It works perfectly now, you have redefined the word responsive! Many many thanks. Now we can read the graphics commentaries demuxed from blurays. You just added a major feature that was lacking since the introduction of hidef media. Maybe you could talk to the media player classic developers, it would be fantastic to include SUP reading directly from MPC, what do you think?

[vwpassion]

Thank you for this filter! Great work.

[Blue_MiSfit]

This plugin is a lifesaver!

Thanks so much!

[Zachs]

Maybe you could talk to the media player classic developers, it would be fantastic to include SUP reading directly from MPC, what do you think?

It'll be a lot easier if MPC-HC has some sort of plug-in support which would allow developers to build upon the subtitles rendering part of the software. For now though, you can use AviSynth to do the same and use MPC-HC to play the script.

[Zachs]

Just wanted to drop a line to inform all Suptitle users that an updated version (v1.0.9) is now available.
It fixes a problem with some SUP files not loading properly.

[ChldsPlay]

I'm getting a syntax error. It says: "Script error: syntax error" Then below that is the location of the script followed by line 3, column 0.

I'm not really sure I know what I'm doing, but I think I don't see what I'm doing wrong. I installed everything mentioned.

[Zachs]

What's your script?

[ChldsPlay]

LoadPlugin("SupTitle.dll")
clip = MPEG2Source("C:\Users\Kevin\Documents\NeroVision\ExportedVideo\avatar.mpg")
return clip.SupTitle("D:\Avatar\00002.track_4608.sup", forcedOnly=false,
swapCbCr=false, relocate=false, relocOffset="")

For all I know, everything about it is wrong. This is my first time working with AviSynth and scripts.

[Zachs]

You didn't insert a line break in the middle of the clip.SupTitle statement did you?

[ChldsPlay]

You didn't insert a line break in the middle of the clip.SupTitle statement did you?

Yes, actually I just copied and pasted the example and changed the file names etc.

I fixed that and now whichever program I use to open it stops working and has to close.

[Zachs]

Try your script without SupTitle first. Isolate the problem.

[ChldsPlay]

Try your script without SupTitle first. Isolate the problem.

If I do just:

DirectShowSource("C:\Users\Kevin\Documents\NeroVision\ExportedVideo\avatar.mpg")

It will cause the program to shut down.

[Zachs]

There you go.

[lotrmith]

Hello,

I'm trying to embed the forced subtitles of Avatar (the alien language ones) into a .mp4 of the movie that I have converted from the main .m2ts using HDConverttoX.

As of last week I've had zero experience doing anything thing complex, but what I've been able to do so far with HDConverttoX is successfully convert a half dozen other .m2ts sources into .mp4, and in some I've been able to locate forced subtitle tracks and convert with those embedded (using HDConverttoX). The problem I've run into is with movies that don't have a separate track for just the forced subtitles but instead use a forced flag for the individual subtitles in the main subtitle track. I am able to extract the main subtitle track using tsMuxer and then open it with BDSup2Sub and copy it with only the forced subtitles, and now I think I'm on the last step of just trying to put 2 and 2 together.

The guys at HDConverttoX sent me here.

Here's what I've got:
A playable .m2ts source: C:\Users\M\Documents\Avatar\RED_BIRD_2D_WW\BDMV\STREAM\0002.m2ts
A playable .mp4 conversion without any subtitles: C:\Users\M\Documents\Avatar\Avatar.mp4
A forced subtitle track that I want to embed: C:\Users\M\Documents\Avatar\ForcedFinal.sup

Could you help? I understand that your program here is what I need. My difficulty is that I have no idea how to use it, because I am totally inexperienced at all manner of this kind of stuff. I guess what I need are step by step instructions, and talk to me like I'm a 5-year-old (for example, I don't know if your program runs on its own or if I have to write the script lines in Avisynth, and I don't even know how to do that if that's the case). Sorry if I sound dumb! I'm really getting my feet wet here.

I'm supposing that I just enter your script into the script generated by HDConverttoX? Here's an example of the script it runs to convert the m2ts into the mp4:

prompt $d $t $_$P$G

echo job number: 1
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\eac3to.exe" "c:\users\M\documents\avatar\red_bird_2d_ww\bdmv\stream\00002.m2ts" 3: stdout.wav -down16 -down2 | "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\lame.exe" - -h --abr 256 "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdencodertox-pid3.mp3"
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\xvid_encraw.exe" -progress 50 -i "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avs" -avi "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avi" -max_bframes 2 -vhqmode 1 -quality 6 -max_key_interval 125 -lumimasking -bquant_ratio 150 -framerate 23.976 -threads 6 -bitrate 9871 -pass1 -turbo -par 1:1
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\xvid_encraw.exe" -progress 50 -i "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avs" -avi "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avi" -max_bframes 2 -vhqmode 1 -quality 6 -max_key_interval 125 -lumimasking -bquant_ratio 150 -framerate 23.976 -threads 6 -bitrate 9871 -pass2 -par 1:1
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\eac3to.exe" "c:\users\M\documents\avatar\red_bird_2d_ww\bdmv\stream\00002.m2ts" 1:"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\chapters.txt"
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\mp4box.exe" -add "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avi" -fps 23.976 -add "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdencodertox-pid3.mp3":lang=eng -chap "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\chapters.txt" "C:\Users\M\Documents\Avatar\RED_BIRD_2D_WW\BDMV\STREAM\Avatar.mp4"

And here's a sample if I had chosen to embed the main english subtitle track, so you can see when and where it runs it's subtitle operation:

prompt $d $t $_$P$G

echo job number: 1
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\eac3to.exe" "c:\users\M\documents\avatar\red_bird_2d_ww\bdmv\stream\00002.m2ts" 9:"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdencodertox__subs_9.sup"
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\eac3to.exe" "c:\users\M\documents\avatar\red_bird_2d_ww\bdmv\stream\00002.m2ts" 3: stdout.wav -down16 -down2 | "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\lame.exe" - -h --abr 256 "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdencodertox-pid3.mp3"
java -jar "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\BDSup2Sub.jar" "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdencodertox__subs_9.sup" "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdencodertox__subs_9.idx" /res:1080p
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\xvid_encraw.exe" -progress 50 -i "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avs" -avi "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avi" -max_bframes 2 -vhqmode 1 -quality 6 -max_key_interval 125 -lumimasking -bquant_ratio 150 -framerate 23.976 -threads 6 -bitrate 9871 -pass1 -turbo -par 1:1
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\xvid_encraw.exe" -progress 50 -i "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avs" -avi "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avi" -max_bframes 2 -vhqmode 1 -quality 6 -max_key_interval 125 -lumimasking -bquant_ratio 150 -framerate 23.976 -threads 6 -bitrate 9871 -pass2 -par 1:1
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\eac3to.exe" "c:\users\M\documents\avatar\red_bird_2d_ww\bdmv\stream\00002.m2ts" 1:"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\chapters.txt"
"C:\Users\M\Documents\HDConvertToX_2.5.624.4217\applications\mp4box.exe" -add "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdconverttox_00002.avi" -fps 23.976 -add "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\hdencodertox-pid3.mp3":lang=eng -chap "C:\Users\M\Documents\HDConvertToX_2.5.624.4217\job1\chapters.txt" "C:\Users\M\Documents\Avatar\RED_BIRD_2D_WW\BDMV\STREAM\Avatar.mp4"

Am I correct that I have to insert your plugin script somewhere into this mess? If so, what exact script and where would I insert it?

[sneaker_ger]

You need to install AviSynth and write an avs-script (Just use Windows notepad and save the file as "filename.avs") which should look something like this:
FFVideoSource("0002.m2ts")
SupTitle("ForcedFinal.sup", forcedOnly=False)

You can now open this file in any AviSynth-capable GUI like StaxRip, RipBot, MeGUI etc. (I don't know anything about HDConverttoX).
Notice that the SupTitle function already has an argument called "forcedOnly". If you set it to "true" you can skip the BDSup2Sub step you have been doing until now.
For "FFVideoSource" and "SupTitle" to work you have to download the plugins and copy the included dlls to the avisynth\plugins dir. (Download ffmpegsource here (http://code.google.com/p/ffmpegsource/))

Hope that helps to get you started.

[Zachs]

This is a good place to start learning about AviSynth.

http://en.wikipedia.org/wiki/AviSynth

You'll need to be familiar with AviSynth and how its plugins are used to work a script before you'll be able to understand how to use SupTitle.

[lotrmith]

Alright I made some headway with instrutions from the author of HDConverttoX, and here's what's happened:

I edited an avs file associated with the job to be performed by HDC, to include this code:
LoadPlugin("C:\Program Files\AviSynth 2.5\plugins\SupTitle.dll")
SupTitle("C:\Users\M\Documents\Avatar\ForcedFinal.sup", forcedOnly=false, swapCbCr=false, relocate=true, relocOffset="")


Running the job resulted in it encoding as it normally does without any errors during the entire process, but the final output .mp4 file had no video image except a black screen with an error message embedded that ran for the length of the film. The error message is as follows:

System.AccessViolationException: Attempted to read or write protected memory. This is often an indication that other memory is corrupt.

at SupTitle.GetFrame(SupTitle* , PVideoFrame* , Int32 n, IScriptEnvironment* env)

Anyone know what that might indicate?

Here's our thread with HDC: http://forum.doom9.org/showthread.php?p=1401582#post1401582

[Zachs]

Yes. v1.0.9 has an issue with Avatar's forced subs. Head over to SupTitle's forum (http://www.zachsaw.co.cc/forum/viewtopic.php?f=14&t=83) to grab the latest version (beta).

[lotrmith]

Yes. v1.0.9 has an issue with Avatar's forced subs. Head over to SupTitle's forum (http://www.zachsaw.co.cc/forum/viewtopic.php?f=14&t=83) to grab the latest version (beta).

I'll give that a shot. Thanks!

[sneaker_ger]

For the future: you might want to preview your script in Media Player Classic, VirtualDub or something else before encoding, to see if something's wrong. Saves a lot of time.

[asarian]

Dude, just wanted to say: doumo arigatou gozaimasu! :) Just the program I've been waiting for for ages!

[asarian]

Hmm, seems I'm not so happy, after all. Just installed .NET 4, for the latest suptitle 2.0.1, and now I get the following error on the plugin:

"Evaluate: Unrecognized Exception"

I followed your installation guide to the letter, and call the plugin like this:

LoadPlugin("C:\Program Files\AviSynth 2.5\plugins\FFMS2.dll")
LoadPlugin("C:\Program Files\AviSynth 2.5\plugins\SupTitle.dll")

video=FFVideoSource("D:\Temp\video.mkv").ConvertToYV12().Crop(0, 142, 0, -142)
video=SupTitle(video, "D:\subs\00004 - 11 - Subtitle (PGS).sup", forcedOnly=true, swapCbCr=false, relocate=true, relocOffset="0,140,0,140")

(I eventually need to return 'video' in this script, is why). With relocate off or on, makes no difference.

Any suggestions as to what is going on?

Thanks.

EDIT: Yes, without the plugin everything works fine.

[Zachs]

It should work.
You did return 'video' at the end of your script right?

I found this thread (http://forum.doom9.org/showthread.php?t=80737) describing the error message you're seeing.
It looks like it's an AviSynth exception. You might want to try grabbing a more stable release of AviSynth.
I can't reproduce the problem on either of my machines (XP-32 and Win7-64).

[asarian]

It should work.
You did return 'video' at the end of your script right?

I found this thread (http://forum.doom9.org/showthread.php?t=80737) describing the error message you're seeing.
It looks like it's an AviSynth exception. You might want to try grabbing a more stable release of AviSynth.
I can't reproduce the problem on either of my machines (XP-32 and Win7-64).
Zachs, thanks for looking into this.

I have the latest AviSynth, version 2.5.8; not sure how much more stable it will get. :( I even grabbed the latest replacement DirectShowSource.dll for Avisynth 2.5.8 (didn't even know it existed); that makes no difference, either (then again, I'm not even using DirectShowSource here at all, but FFVideoSource). And the "Evaluate: Unrecognized Exception" thread you showed is from 2004; seems unlike 2.5.8 would still be plagued by the same issue; but I can ask around.

[Zachs]

Can you try with just a blankclip + suptitle?

Also, try that with AviSynth 2.5.8 MT build - that's what I'm using. I have a feeling that it's your build, as others and myself have managed to get it working just fine.

[asarian]

Can you try with just a blankclip + suptitle?

Also, try that with AviSynth 2.5.8 MT build - that's what I'm using. I have a feeling that it's your build, as others and myself have managed to get it working just fine.
I tried the AviSynth 2.5.8 MT build tonight; no go, alas. :( This time around the Media Player Classic (associated with my avs files, for playing) doesn't even show an error any more, but just collapses into oblivion after 1 or so seconds of blackness.

According to IanB, of avisynth, a plugin would have to behave severely out of bounds for this last-resort exception to occur. My guess is that it's caused by the manifold layered requirements for .NET Framework installs, and that it's somewhere missing something. I have 2 + 4 installed (and 3.5 too, actually). I can't reinstall 2 again, as XP won't let me any more after later updates.

You wouldn't have a debug build lying around, would ya? :)

[foxyshadis]

Unrecognized Exception always means someone screwed up the memory access in either a codec or a plugin, or it ran out of memory and forgot to crash. I've made it happen more often than I can count. (It could be FFVideoSource as well, don't forget to check that.) It's usually not very hard to catch in a debugger because it'll blow up as soon as it tries to write outside of its allocated structure, but you need the source for that.

[asarian]

Unrecognized Exception always means someone screwed up the memory access in either a codec or a plugin, or it ran out of memory and forgot to crash. I've made it happen more often than I can count. (It could be FFVideoSource as well, don't forget to check that.) It's usually not very hard to catch in a debugger because it'll blow up as soon as it tries to write outside of its allocated structure, but you need the source for that.
Yeah, I thought of FFVideoSource, and eliminated it as possible cause by using both BlankClip and the script simply without the SupTitle line; both run fine that way.

My setup is a dedicated XP SP3 partition, just for rendering. Other than avisynth, ffdshow, haali media splitter, and a few degrain filters, it's not cluttered by anything else, and generally renders flawlessly. In fact, SupTitle is really the only plugin so far that really seems to freak out.

[Zachs]

Could you try with just a BlankClip followed SupTitle?

I really can't see how it would only fail on your machine when so many others have reported that it works just fine.

[Zachs]

Also, have you tried with other SUP files?

[asarian]

Could you try with just a BlankClip followed SupTitle?

I really can't see how it would only fail on your machine when so many others have reported that it works just fine.
Already tried it with BlankClip (see my previous post; I think we were just writing a post at the same time); makes no difference, unfortunately.

Yeah, I was just gonna say: might be it's tripping over the SUP-file; then I saw you post the same question just now. :) It's a SUP from 2010, the Blu-Ray, extracted with eac3to. I'll try some others, and see how that works out.

Thanks for your continued help, at least.

[Zachs]

Post the SUP file somewhere and I'll take a look into it.
It could be that SupTitle's run out of memory.

[Zachs]

When you tried blankclip, did you have other plugins loaded as well or just SupTitle?

[asarian]

Post the SUP file somewhere and I'll take a look into it.
It could be that SupTitle's run out of memory.
Good call, Zachs! :) Turns out it actually was the SUP file causing the crash! I tried the first one (faulting Japanese (http://rapidshare.com/files/396931948/00004_-_11_-_Subtitle__PGS_.rar.html)), and that's the one which crashes. I then just now tried the English SUP (http://rapidshare.com/files/396927647/00004_-_12_-_Subtitle__PGS_.rar.html) , and that one doesn't crash; but it doesn't show the subs either, whichever mode I try (forcedOnly true/false, relocate true/false). It doesn't cause a crash, though; so at least that impossible part is solved. I feel we're nearing a solution. :)

This is the exact script I use:

LoadPlugin("C:\Program Files\AviSynth 2.5\plugins\FFMS2.dll")
LoadPlugin("C:\Program Files\AviSynth 2.5\plugins\SupTitle.dll")

video=FFVideoSource("D:\Temp\video.mkv").ConvertToYV12()
video=SupTitle(video, "D:\subs\00004 - 12 - Subtitle (PGS).sup", forcedOnly=false, swapCbCr=false, relocate=true, relocOffset="0,142,0,142")
video=Crop(video, 0, 142, 0, -142)
video=ConvertToRGB(video)

return video

[sneaker_ger]

I can't get the new version running: "LoadPlugin: unable to load"
Windows XP SP3 32bit
.NET 4.0 (and all the older ones) is installed

[Zachs]

Try copying the two MS Visual C++ CRT dll files into your system32 folder.

[sneaker_ger]

That did it, thank you. :o

[asarian]

Post the SUP file somewhere and I'll take a look into it.
It could be that SupTitle's run out of memory.
Zach, any verdict yet on the SUP samples I posted? :)

[asarian]

Zachs, I just tried SupTitle on my Avatar Blu-Ray, and it works flawlessly there. :) So, we have established that my install is working now.

Only thing that rests now is for you (or any other volunteer, for that matter) to kindly have a look at the two SUPS which I posted above, onegai shimasu! :) :thanks:

EDIT: Also, relocOffset doesn't appear to be working on the Avatar SUP file (version 2.0.1): no matter how hard I try, I can't lower the subs.

[Zachs]

Will take a look at the SUPs later if I've got some time to spare.
Avatar's forced subs are 1920x1080, relocOffset can't move it since it's taking up the full screen already.

[asarian]

Will take a look at the SUPs later if I've got some time to spare.
Avatar's forced subs are 1920x1080, relocOffset can't move it since it's taking up the full screen already.
Thanks, Zachs. Wakatta!

Would make for an interesting feature request, though: to be able to move the SUPS, regardless of whether they already fill the screen (like crop them internally first, then position them to allow for the relocation). The Avatar subs, for one, appear too high up in the screen, for my taste.

Overall, I don't understand why this thread is so short. Your plugin really was a godsent to me, and I don't get why it isn't wildly popular here. :) To be able to add subs in their original, non-fubarred, non-OCR-ed, shape really is a major thing.

[Zachs]

crop them internally first, then position them to allow for the relocation

The biggest issue I have with that is you won't know if you've over cropped until you review all the frames with subs of the entire movie.

I've had a quick look at the faulting sup - the previous versions would've thrown an exception with message saying the sup's format is unexpected (i.e. I haven't written the part of code that handles that particular format).

The english sup is fine though - perhaps you've cropped away the sup?

[asarian]

Thank for looking into it, Zachs.

The biggest issue I have with that is you won't know if you've over cropped until you review all the frames with subs of the entire movie.
Does it matter? I mean, cropping is just the user's responsibility anyway, right? In the case of Avatar, the subs appear unusually high; I wouldn't have minded lowering them substantially. Should it turn out I had overcropped somewhere after all, I'd just re-encode.

I've had a quick look at the faulting sup - the previous versions would've thrown an exception with message saying the sup's format is unexpected (i.e. I haven't written the part of code that handles that particular format).

The english sup is fine though - perhaps you've cropped away the sup?
Could very well be, come to think of it. :) I tried it as follows:

LoadPlugin("C:\Program Files\AviSynth 2.5\plugins\FFMS2.dll")
LoadPlugin("C:\Program Files\AviSynth 2.5\plugins\SupTitle.dll")

video=FFVideoSource("D:\Temp\video.mkv").ConvertToYV12()
video=SupTitle(video, "D:\subs\2.sup", forcedOnly=true, swapCbCr=false, relocate=true, relocOffset="0,142,0,142")
video=Crop(video, 0, 142, 0, -142)
video=ConvertToRGB(video)

return video

That may actually be wrong, as relocOffset shouldn't be applicable at that stage yet (after all, I only crop afterwards). I can't test it yet, as the only machine available to me which has a working SupTitle install on it is doing Avatar now. But I bet that was wrong.

[deank]

@asarian: You can accomplish what you want by loading your SUP file in BDsup2sub, and select "EDIT/Move all captions". Then select "Move outside bounds" and set "Offset Y:" to bottom offset of your choice.

You'll get a new SUP file, which you can then use with SupTitle plugin.

http://javaforge.com/displayDocument/scrn_move.png?doc_id=76806

Dean

[asarian]

@asarian: You can accomplish what you want by loading your SUP file in BDsup2sub, and select "EDIT/Move all captions". Then select "Move outside bounds" and set "Offset Y:" to bottom offset of your choice.

You'll get a new SUP file, which you can then use with SupTitle plugin.
:thanks:, Dean! This is exactly what I was looking for! :)

[asarian]

The english sup is fine though - perhaps you've cropped away the sup?
Hmm, trying this again, and I still can't get the English subs to show, try as I might. This should have worked:

LoadPlugin("C:\Program Files\AviSynth 2.5\plugins\FFMS2.dll")
LoadPlugin("C:\Program Files\AviSynth 2.5\plugins\SupTitle.dll")

video=FFVideoSource("D:\Temp\video.mkv").ConvertToYV12()
video=SupTitle(video, "D:\subs\2010.sup", forcedOnly=true, swapCbCr=false, relocate=false)
video=Crop(video, 0, 142, 0, -142)
video=ConvertToRGB(video)

return video

Even without the crop, the subs are still a no-show. :( May I ask, what script did you use to get the subs I posted to work?

[sneaker_ger]

Are you sure that these are forced subs? Try "forcedOnly=false" if you haven't.

[asarian]

Are you sure that these are forced subs? Try "forcedOnly=false" if you haven't.
I tried them every which way I could think of: forced on/off, relocate on/off, etc. They just don't show up ever, under any circumstance.