Xy-VSFilter
From Avisynth wiki
Abstract | |
---|---|
Author | Gabest, guliverkli2, cyberbeing, pinterf |
Version | 3.2.0.809 |
Download | xyVSFilterSubFilter-pfmod-3.2.0.809.7z |
Category | Subtitling |
License | GPLv2 |
Discussion | Doom9 Forum |
Contents |
Description
xy-VSFilter Project (High Performance VSFilter Compatible Subtitle Filters). Based on VSFilter 2.39 Guliverkli2 with various important changes from VSFilter 2.41 MPC-HC.
VSFilter includes the following functions:
- VobSub
- TextSub
- TextSubSwapUV
- MaskSub
Requirements
- [x86]: AviSynth+ or AviSynth 2.6
- [x64]: AviSynth+
- Supported color formats: RGB24, RGB32, YUY2, YV12, YV16, YV24
- AviSynth+:
TextSub
accepts YUV420P10, YUV420P16, YUV422P10 and YUV422P16 formats
- AviSynth+:
Syntax and Parameters
TextSub
Adds subtitles from text-based subtitle formats.
Format name |
Extension |
---|---|
SubStation Alpha / Advanced SubStation Alpha | .ssa / .ass |
SubRip | .srt |
MicroDVD | .sub |
SAMI | .smi |
PowerDivX | .psb |
Universal Subtitle Format | .usf |
Structured Subtitle Format | .ssf |
WebVTT | .vtt |
- TextSub (clip, string "file", int "charset", float "fps", string "vfr")
- clip =
- Input clip.
- clip =
- string file =
- Path to subtitles file.
- string file =
- int charset = 1
- charset is the encoding to assume the file is in, if it's not Unicode UTF-8 or UTF-16. (If you need to use this you're doing something wrong.)
- int charset = 1
- float fps = -1.0
- fps is the FPS to assume the video is at. You could just as well just use
AssumeFPS
instead of using this. VFR overrides this.
- fps is the FPS to assume the video is at. You could just as well just use
- float fps = -1.0
- string vfr = ""
- vfr is the path to the VFR timecodes file (format 1 or 2) to use for frame times. If set, overrides all other FPS specifications.
- string vfr = ""
VobSub
Adds image-based subtitles in VobSub format. It consists of an *.idx file that stores the subtitle properties and a .sub file that contains the binary data..
- VobSub (clip, string)
- clip =
- Input clip.
- clip =
- string =
- Path to subtitles file, only .idx and .sub files supported.
- string =
MaskSub
Creates a subtitle mask.
- MaskSub (string "file", int "width", int "height", float "fps", int "length", int "charset", string "vfr", string "pixel_type")
- string file =
- Path to subtitles file.
- string file =
- int width =
- int height =
- width and height specify the size of the generated clip, in pixels.
- int width =
- float fps =
- fps specifies the framerate of the generated clip.
- float fps =
- int length =
- length is the number of frames to produce in the clip.
- int length =
- int charset =
- charset is the encoding to assume the file is in, if it's not Unicode UTF-8 or UTF-16. (If you need to use this you're doing something wrong.)
- int charset =
- string vfr = ""
- vfr is the path to the VFR timecodes file (format 1 or 2) to use for frame times.
- string vfr = ""
- string pixel_type = "RGB32"
- Pixel type, can be set to:
"RGB32", "YUV420P10" or "YUV420P16"
Note: With "RGB32" output the mask is flipped vertically, use- Fixed in v3.2.0.808FlipVertical()
to correct it.
- Pixel type, can be set to:
- string pixel_type = "RGB32"
TextSubSwapUV
- TextSubSwapUV (bool)
- clip =
- Input clip.
- clip =
- bool = false
- Toggles (globally) whether to swap assume the U and V planes are swapped in YV12 video when rendering subtitles. Default is false.
- bool = false
Examples
AviSource("Blah.avi") TextSub(file="subtitle.ass")
#Assume clip is 1280x720, 24fps, and 3,000 frames total MaskSub(file="subtitle.ass", width=1280, height=720, fps=24, length=3000)
#or alternatively you can get the clip properties video = AviSource("Blah.avi") MaskSub(file="subtitle.ass", width=video.Width(), height=video.Height(), fps=video.FrameRate(), length=video.FrameCount())
AviSource("Blah.avi") VobSub("subtitle.sub")
Changelog
See GitHub releases page: https://github.com/pinterf/xy-VSFilter/releases
External Links
- GitHub - Source code repository (latest version from pinterf).
- GitHub - xy-VSFilter with VapourSynth interface added, based on pinterf's fork
Back to External Filters ←