From Avisynth wiki
Jump to: navigation, search
Author basilik
Version v0.1.1
Category Subtitling
License Open source (source code N/A)



The SubtitleEx is an AviSynth plugin to show a text over any video clip with one function inside: SubtitleEx. It is an extension of an existing Subtitle function of the AviSynth. Many of the parameters of the SubtitleEx have the same meaning as a original Subtitle function. See official documentation and examples.


Syntax and Parameters

SubtitleEx (clip, string, int "x", int "y", int "firstframe", int "lastframe", string "font", string "effects", int "size", int "textcolor", int "halocolor")

clip   =
Input clip.

string   =
Text - obligatory parameter; no default value; can be multiline, to split a text into lines a "|" symbol is used.

int  x = -clipWidth * 0.11
int  y = -clipHeight * 0.17
Text position (default values: x = -clipWidth * 0.11, y = -clipHeight * 0.17). Following picture helps to understand how x and y to be defined:
Subtitleex textmetrics .jpg
Top left corner coordinates are (0, 0), x growth to the right, y growth down.
Value A defines vertical text position if (y >= 0) and then y = A
Value B defines vertical text position if (y < 0) and then y = -B
Value C defines horizontal text position if (x >= 0) and then x = C, text is left aligned
Value D defines horizontal text position if (x < 0) and then x = -D, text is right aligned

int  firstframe = 0
int  lastframe = -1
A range to which the text is applied (default values: firstframe = 0, lastframe = -1); if lastframe = -1 then last clip frame number is used.

string  font = "Arial"
Font name (default value: "Arial")

string  effects = "b"
Effects applied to the text.
Following control letter are used for the font and text appearance (order and position in the effects string do not matter):
b - bold
i - italic
u - underlined
c - centered

Dynamic effects usually have own parameters in the parentheses. Some parameters can be omitted, then they have default values (currently all of them are zeros). Following letters are used for dynamic effects:
f - fading; the effect has following parameters:
inFrames - number of fade-in frames
outFrames - number of fade-out frames

m - motion; the effect has following parameters:
moveInFrames - number of frames for move-in effect
xPosFrom, yPosFrom - starting point of move-in movement
moveOutFrames - number of frames for move-out effect
xPosTo, yPosTo - final point after move-out

Following letters are used for usage of different filters:
s - soft blur
g - gaussian blur
e - emboss filter
l - laplacian filter (edge detection)

The order, in which filters letters are, is important. A filter can be applied several times and previous filter result is used for the current filter. The usage of the effects string is shown in very details in the Examples section.

int  size = 36
Size of the font.

int  textcolor = $00FFFFFF
Text color.

int  halocolor = $00000000
This parameter defines a color of letters border in most of the cases (default value: $00000000). When the emboss filter is applied the parameter defines the darken side of letters
The color values have the following format (in hex): $TTRRGGBB, where TT stands for a transparency, $00 - opaque, $FF - completely transparent; RR - red color value, GG - green color value, BB - blue color value.




See examples section here to have a look the possibilities of the plugin.


 v0.1.1        2004/09/12      - Latest release.
 v0.1.0        2004/05/24      - Initial release.

Archived Downloads

Version Download Mirror

External Links

Back to External Filters

Personal tools