Karaoke tutorial

Part 3: Filters and tags

Subtitle filters:

A subtitle filter also called "Caption provider" is a file with extension ".Ddl"
for Windows. It displays the subtitles on a video. It offers a library of commands, allowing you to work on
rendering the text at the style level or on the possibility of adding effects to it. All filters have differences !!!

So it is an abuse of language to say that Aegisub displays the subtitles. It is not him, but the selected filter !!!

The best known filters at the time this tutorial is written, this number four:

Filtered Specifications

vsfilter Basic filter in Aegisub. He is behind the tags. It is

present in all basic media players.

libass Filter present during the installation of Aegisub. It is

faster than " vsfilter ". It contains bug fixes and
various improvements.

vsfiltermod Filter mainly intended for the use of karaoke

effects. It includes the addition of new tags, in
order to facilitate the work of the karamaker.
However it is not necessary to use it all the time.

xy-vsfilter Filter present during the installation of Aegisub. It is

faster than "Vsfilter". It contains bug fixes and many
other improvements.

Note regarding “vsfiltermod”: It is strictly forbidden to use "Vsfiltermod" when you work in " softsub "( subtitles
not embedded in the video). Indeed it is not possible to view the effects contained in the ASS script, since all the
multimedia players display the subtitles with the filter "Vsfilter" or "Libass" by default. In addition, even if you find
how to display your subtitles with the filter "Vsfiltermod" on a media player, it will not be possible to certify that the
people with whom you share the video do the same on their side.

The latest version of the filter presents a problem when using one or more tags. It is advisable to use an earlier
version:

VSFilterMod 1.0.0
VSFilterMod 1.0.10

Tutorial by Spyne21
Note regarding "xy-vsfilter": When you create an effect that includes a lot of
\ clip, "Vsfilter" will tend to be unstable and crash when encoding. This is why it is advisable when you encounter
this problem to use the filter "Xy-vsfilter" for more stability and a better chance of success.

The Aegisub parameters - Part 2:

Here we will discuss the advanced options of Aegisub.

As you can see, when we click on "Advanced", A warning appears:

If you change something and after you notice more bugs or crashes, go back to Aegisub settings, and click on "Reset".

In any case, what we are going to do represents no danger for the stability of the application.

In part "Audio", if you have a sound problem loading an audio track, try changing the setting "Audio Provider" of "FFmpegSourc
at "Avisynth".

You should have two choices:

Warning : It is best, after working on the problematic audio track, to return the parameter to its original state.

Tutorial by Spyne21
Now let's take a look at the part " Video " :

Tutorial by Spyne21
Same remark for the part " Video ", if you have a problem with the image while loading a video track, try changing
the setting "Video provider" of
"FFmpegSource" at "Avisynth". You can also change the "Subtitle provider", if you think the problem is with the
filter.

Now let's add the filter "Vsfiltermod" in Aegisub. Close the program.

We will choose the version VSFilterMod 1.0.0

Let's place the filter "Vsfiltermod" in "C: \ Program Files (x86) \ Aegisub \ csri".

Note : You can download the file csri.rar, and extract it directly to the folder
"C: \ Program Files (x86) \ Aegisub" replacing it with the old one. However the first method is preferable in order to have
the latest filters up to date for those provided during the installation of Aegisub.

For further information: Options

The two predefined effects (obsolete):

In order for this tutorial to be as complete as possible, we cannot omit the existence of these two old effects.

Text scroll vertically with / without fade

- The "Scroll" allows vertical scrolling with or without fade.

scroll up / down; y1; y2; delay [; fadeawayheight]

"Scroll": Corresponds to the name of the effect.

"Up" or "Down": Allows you to choose the direction of scrolling of the text. It is only possible to do, " from high to low "
or "From bottom to top" "y1; y2": Corresponds to the starting position and the arriving position.

"Delay": Corresponds to the scrolling speed. The number must be between "1 and 100".
The higher the number, the slower the scrolling speed.
"[; Fadeawayheight]": It is a complementary and not compulsory parameter. It allows you to adjust the transparency gradient
when the text appears / disappears. If you don't put anything, the gradient will be fixed by default at "50".

Notes: Parameters are separated by semicolons. Do not add brackets

"[]" to the additional parameters. In addition, scroll down does not work with "Vsfiltermod"

Examples: scroll_up_down

Text scroll horizontally with / without fade

Tutorial by Spyne21
- The "Banner" which is a variant of "Scroll" but horizontally. The only difference is that here we do not define a point of
departure or arrival. The starting and ending position of the text depends on the horizontal resolution of the video.

banner; delay [; lefttoright; fadeawaywidth]

"Banner": Corresponds to the name of the effect.

"Delay": Corresponds to the scrolling speed. The number must be between "1 and 100".
The higher the number, the slower the scrolling speed.
"[; Lefttoright]" It is an additional parameter and not compulsory. It allows you to define the scrolling direction of the text.
The number "0" corresponds to a scroll of "Right to left". The number "1" corresponds to a scroll of "Left to right". If you
do not put anything the value will be fixed by default at "0". "[; Fadeawaywidth]": It is a complementary and not
compulsory parameter. It allows you to adjust the transparency gradient when the text appears / disappears. If you don't
put anything, the gradient will be fixed by default at "50".

Notes: Parameters are separated by semicolons. Do not add brackets

"[]" to the additional parameters. For more convenience, it will be better to use the tag
\ move and \ fad to perform these two types of effect.

Examples: banner_left_right

Special characters :

Special characters are to be used inside the text and not in braces "{}".
They start with a forward slash "\" (backslash), followed by the special character.

Line break / Space

\not

Allows you to insert a forced line break, but only in mode 2 of the \ tag q. In all other modes of the \ tag q, it is
replaced by a regular space.

To see the image and the ASS script, go to the sub-section " Line break "

Note : If you are not sure whether you want to use this tag or \ NOT, is that you probably want to use \ NOT.

Forced line break

\NOT

Insert a forced line break. It is not affected by the \ tag q.

Example: special_character_backslash_N.ass

Tutorial by Spyne21
Space

\h

Allows you to insert a space " strength ". The line will never break automatically just before or after a forced space.

Example: special_character_backslash_h.ass

For further information: ASS Tags

The “vsfilter” tags:

Tags must be inside the braces "{}". If you use a tag without it being in the curly braces, it will be ignored and visible
as text. In addition, these braces are also used to write comments in the lines.

Warning : It is not recommended to mix tags with comments inside the same braces.

The tags always follow the same form. They start with a forward slash "\" (backslash), then the name of the
tag and finally its parameter (s). If the parameter (s) is / are omitted, the default value of the line style is used.

Some tags are "Complex" and take more than one parameter. In this case, the parameters are put inside
parentheses "()" with commas between the parameters to separate them.

Note : Decimals are not written with a comma but with a period. Indeed in English, Decimal numbers are preceded
by a point.

The number "Pi" for example will therefore be written: "3.14159265359"

Italics

\ i1 \
i0

Allows you to put the text in italics. Use \ i1 to activate the text in italics. Conversely, use \ i0 to deactivate the italics of
the text.

Possibility of use via the button

Example: balise_i.ass

Tutorial by Spyne21
Fat

\ b1 \ b0 \ b < value>

Allows the text to be bold. Use \ b1 to activate the bold text. Conversely, use \ b0 to turn off bold text.

Possibility of use via the button

\ b < value> allows to adjust the fat value of "100 to 900". These are multiples of "100".

- "100": Text lower than normal text. It is the lowest possible value.
- "400": Normal text,
- "700": Bold text,
- "900": Text in bold but heavier than the value "700".

Note : Most fonts have no more than one or two types of bold. So the interest of this tag is limited. It is
recommended to use only the \ b1 and \ b0.

Example: balise_b.ass

Highlighted

\ u1 \
u0

Used to underline the text. Use \ u1 to underline the text. Conversely, use \ u0 to deactivate the fact that the text is
underlined.

Possibility of use via the button

Example: balise_u.ass

Closed off

\ s1 \
s0

Lets strike out the text. Use \ s1 to strike out the text. Conversely, use \ s0 to deactivate the fact that the text is crossed out.

Possibility of use via the button

Tutorial by Spyne21
Example: balise_s.ass

Line break

\ q < 0-3>

Used to manage line breaks.

There are 4 different modes:

- "0": Adjust the lines so that they are roughly the same length. If equality is impossible, then it will
leave the first line longer than the second.
- "1": Will use the space as much as possible, then wrap, even if the second line contains only one word.

- "2": Block line break.

- "3": Same function as \ q0 but it is impossible to equalize the lines. It will leave the second line longer
than the first.

Examples: balise_q.ass

Outline size

\ edge < size>

Allows you to set the size of the border around the text. To have no border, just set the size to "0". The size of a
border can be a whole or decimal number. It cannot be negative.

Tutorial by Spyne21
Examples: edge_beacon.ass

\ x edge < size>

Used to fix the size of the border along the X axis (horizontally). If you put \ xbord at
"0", this disables the border on the X axis.

Examples: balise_xbord.ass

\ ybord < size>

Used to fix the size of the border along the Y axis (vertically). If you put \ port at "0",
this disables the border on the Y axis.

Note : The two tags \ xbord and \ port can be used in the same line. If you use the \ tag edge after \ xbord or \ port in
the same line, it will replace the two previous tags.

Examples: balise_ybord.ass

Shadow distance

\ shad < distance>

Used to set the distance between the text and the shadow. To have no shade, just set the distance to "0". The
distance from the shadow can be a whole or decimal number. It cannot be negative.

Examples: balise_shad.ass

Tutorial by Spyne21
\ xshad < distance>

Used to set the distance of the shadow along the X axis (horizontally). If you put \ xbord at
"0", this disables the shadow on the X axis.

Examples: balise_xshad.ass

\ yshad < distance>

Used to set the distance of the shadow along the Y axis (vertically). If you put \ port at "0",
this disables the shadow on the Y axis.

Examples: balise_yshad.ass

Blurring

\ be0 \ be1 \ be < strength>

Apply a slight blurring on the border of the text or directly on the text itself, if the border is at "0".

You can activate or deactivate the blurring effect or specify an integer. The effect is not always very noticeable, but
it can in some cases make the text more pleasant to look at. It is generally more visible with a small text size.

Tutorial by Spyne21
Examples: balise_be.ass

\ blur < strength>

Applies much more blurring on the border of the text or directly on the text itself, if the border is at "0". The value of
the blurring can be a whole or decimal number. It cannot be negative.

Note : By putting a value of \ blur too high, your CPU may take a long time to render.

Examples: balise_blur.ass

Name of the police

\ fn < name>

Allows you to define a font for a text. There should be no spaces, parentheses or otherwise, between the \ tag fn and the
name of the police.

Possibility of use via the button . This will open a window for you to choose your font,
with various options and an overview.

Tutorial by Spyne21
Example: balise_fn.ass

Font size

\ fs < size>

Allows you to define the font size. The size can only be whole.

Examples: balise_fs.ass

\ fscx < scale in%>

Allows you to change the size of the text along the X axis (horizontally). Size is defined as a percentage. A percentage of "100",
corresponds to the original size of the text on the X axis. Only whole numbers are possible.

Possibility of use via the button . This button is only available after loading a
video track.

Examples: balise_fscx.ass

\ fscy < scale in%>

Allows you to change the size of the text along the Y axis (vertically). Size is defined as a percentage. A percentage of "100"
corresponds to the original size of the text on the Y axis. Only whole numbers are possible.

Possibility of use via the button . This button is only available after loading a
video track.

Examples: balise_fscy.ass

Tutorial by Spyne21
\ fscx < scale in%> \ fscy < scale in%>

Allows you to change the size of the text along the X and Y axis. Both together with the same values ​in the two tags,
allows you to change the size like the \ tag fs. Size is defined as a percentage. A percentage of "100" on the two tags,
corresponds to the original size of the text on the X and Y axis (the size of the text itself). Only whole numbers are
possible.

Possibility of use via the button . This button is only available after loading a
video track.

Note : When you want to change the size of the text using the \ tag t, it is best not to use \ fs < value>, but to use \ fscx
< value in%> \ fscy < value in%>. In addition, it also allows you to define the size of a text more precisely than the \
tag. fs.

Examples: balise_fscx_fscy.ass

Complement:

The following images are examples of use between the different ratios of vertical and horizontal scales:

Source of the two images: "Karalaura KaraBook".

Letter spacing

\ fsp < spacing>

Allows you to change the spacing between the letters of a text. Spacing can be an integer or decimal. It can also be
negative.

Tutorial by Spyne21
Examples: balise_fsp.ass

Text rotation

\ frx < degree>

Allows you to perform a rotation along the X axis. The value of the rotations is expressed in mathematical degrees. "360
degrees" corresponds to a full rotation on the X axis. It can also be negative. Go beyond "360 degrees" is
irrelevant, since it's like rotating "0 to 360 degrees" again. On the other hand, it becomes interesting to go beyond

"360 degrees" as soon as you use the \ tag t.

The rotation is performed around the point of origin of the subtitle line. It is described with the tag \ org.

Possibility of use via the button . This button is only available after loading a
video track.

Examples: balise_frx.ass

\ fry < degree>

Allows you to perform a rotation along the Y axis. The value of rotations is expressed in mathematical degrees. "360
degrees" corresponds to a complete rotation on the Y axis. It can also be negative. Go beyond "360 degrees" is
irrelevant, since it's like rotating "0 to 360 degrees" again. On the other hand, it becomes interesting to go beyond

"360 degrees" as soon as you use the \ tag t.

Tutorial by Spyne21
The rotation is performed around the point of origin of the subtitle line. It is described with the tag \ org.

Possibility of use via the button . This button is only available after loading a
video track.

Examples: balise_fry.ass

\ frz < degree> or \ fr < degrees>

Allows you to rotate along the Z axis. The \ tag Fr is a shortcut of the \ tag frz.
The value of rotations is expressed in mathematical degrees. "360 degrees" corresponds to a full rotation on the
X axis. It can also be negative. Go beyond "360 degrees" is irrelevant, since it's like rotating "0 to 360 degrees" again.
On the other hand, it becomes interesting to go beyond "360 degrees" as soon as you use the \ tag t.

The rotation is performed around the point of origin of the subtitle line. It is described with the tag \ org.

Possibility of use via the button . This button is only available after loading a
video track.

Examples: balise_frz.ass

Tutorial by Spyne21
Note : You can use the 3 tags at the same time.

Text shearing

\ fax < factor>

Enables shearing (perspective distortion) on the text along the X axis (horizontally). A factor of "0" means there is
no distortion of the perspective. It must be a small whole or decimal number, positive or negative. The value
must be between "-2 and 2" for best results.

Examples: balise_fax.ass

\ fay < factor>

Enables shearing (perspective distortion) on the text along the Y axis (vertically). A factor of "0" means there is no
distortion of the perspective. It must be a small whole or decimal number, positive or negative. The value must be
between "-2 and 2"
for best results.

Examples: balise_fay.ass

Notes: You can use both tags at the same time. They are not affected by the use of the \ tag org.

Police encoding

\ fe < id>

Tutorial by Spyne21
Allows you to define the encoding of Windows fonts. It can be used to read different languages.

Complete list in "The style editor":

Note : It is recommended to always use the coding " Unicode UTF-8 " used by default by Aegisub.

Examples: balise_fe.ass

Set color

\ 1c & H < bb> <vv> <rr> & or \ c & h < bb> <vv> <rr> &

Allows you to define the primary color of the text.

Possibility of use via the button

Tutorial by Spyne21
Examples: balise_1c.ass

\ 2c & H < bb> <vv> <rr> &

Allows you to define the secondary color of the text. It is only used when you have standard karaoke.

Possibility of use via the button

Examples: balise_2c.ass

\ 3c & H < bb> <vv> <rr> &

Allows you to define the color of the text border.

Possibility of use via the button

Examples: balise_3c.ass

\ 4c & H < bb> <vv> <rr> &

Allows you to define the color of the text shading.

Possibility of use via the button

Tutorial by Spyne21
Examples: balise_4c.ass

Note : The color codes are given in hexadecimal in order: " Blue Green Red » . Note that this is the reverse order of
the color codes in HTML. Color codes should always start with "& H" and end with "&".

Define transparency

\ 1a & H < aa> &

Allows you to define the transparency of the primary color of the text.

Examples: balise_1a.ass

\ 2a & H < aa> &

Allows to define the transparency of the secondary color of the text.

Examples: balise_2a.ass

\ 3a & H < aa> &

Allows you to define the transparency of the text border.

Tutorial by Spyne21
Examples: balise_3a.ass

\ 4a & H < aa> &

Allows you to define the transparency of the text shadow.

Examples: balise_4a.ass

\ alpha & H < aa> &

Allows you to define the total transparency of the text.

Examples: balise_alpha.ass

Notes: The value " aa »Is expressed in Hexadecimal. Transparency of "00" means opaque / completely visible, and a
transparency of "FF" ( 255 in decimal) means completely transparent / invisible. The value "80" makes the text
transparent to 50% in general.

Line alignment

\ a < pos>

Sets the alignment of the text on the video.

Specify line alignment using the old SubStation Alpha (SSA) alignment code.

The calculation of the alignment is carried out as below:

1) Use "1" for bottom left alignment, "2" for alignment at the bottom center and "3"
for bottom right alignment.
Tutorial by Spyne21
2) If you want the line to be at the top, just add "4" to the number you have chosen
in the 1) .
3) If you want the line to be in the middle, just add "8" to the number you have chosen
in the 1) .

So the alignment values ​are:

- 1: Bottom left
- 2: Bottom in the middle
- 3: Bottom right
- 5: Top left
- 6: Top in the middle
- 7: Top right
- 9: Center left
- 10: Center in the middle
- 11: Center right

Examples: balise_a.ass

\ an < pos>

Sets the alignment of the text on the video.

The tag \ year use the values "On the numeric keypad" to set the alignment. The alignment values ​correspond to the
positions of the fingers on the numeric keypad of a keyboard.

So the alignment values ​are:

- 1: Bottom left
- 2: Bottom in the middle
- 3: Bottom right
- 4: Top left
- 5: Top in the middle
- 6: Top right

Tutorial by Spyne21
- 7: Center left
- 8: Center in the middle
- 9: Center right

Examples: balise_an.ass

Notes: The tag \ at is still supported, but it is considered obsolete . You should use the \ year since she is more intuitive
. The alignment specifies the position of the line in the absence of the \ tags pos or \ move.

Warning : You can only define one alignment per line !!! In addition, these two tags cannot be used at the same
time.

Reset style

\ r \ r < style>

The tag \ r resets the default style. It cancels all the other tags defined before, including the animations. So all the
text that will be after this tag, will have the default style without the effects defined before this tag.

The tag \ r < style> allows you to cancel all the tags before this tag and replaces the style you had, with the style you
indicate to it.

Tutorial by Spyne21
Note : Tags \ a, \ an, \ pos, \ move, \ org, \ clip and \ iclip are not canceled since they can be defined only
once per line.

Examples: balise_r.ass

Define position

\ pos (< X>, <Y>)

Used to define the position of the line. The X and Y coordinates depend on the video resolution defined in the ASS
script. In principle the coordinates must be integers, however since version 2.39 of " vsfilter ", you can use decimal
numbers. They cannot be negative.

Possibility of use via the button . This button is only available after loading a
video track.

The meaning of the coordinates "X" and "Y" changes slightly depending on alignment. Here in the following
example, the text "Test" is placed at position \ pos (640,360) with alignment \ an5. The numbers correspond to the
different alignment changes we can make to the text. However, this image does not accurately reflect the position
of the text. "Test" if we put it in these different alignments. Indeed we have space for better understanding.

The spaced version gives:

Tutorial by Spyne21
The real version without spacing gives:

Warning : You can only define one position per line !!!

Examples: balise_pos.ass

Movement

\ move (< x1>, <y1>, <x2>, <y2>)

\ move (< x1>, <y1>, <x2>, <y2>, <t1>, <t2>)

The tag \ move works similar to the \ tag pos, since it allows you to position the text, but above all it allows you to
move the text.

The first version of \ move allows you to move for the entire duration of the line. The second version allows you to
move as a function of a time between "T1" and
"T2". In principle the coordinates must be integers, however since version 2.39 of
"Vsfilter", you can use decimal numbers. They cannot be negative.

The coordinates "X1", "y1", "x2" and "Y2" depend on the video resolution defined in the ASS script, such as the \ pos.
The text begins at point (x1, y1) and moves at constant speed until it reaches point (x2, y2). The alignment also
influences the movement as for the beacon
\ pos.

In the second version, the times "T1" and "T2" express in milliseconds.

Note : 1 second corresponds to 1000 milliseconds. If you have trouble converting the seconds you
have in mind to a millisecond, make a rule of three.

1 second • 1000 milliseconds

"Your seconds" • "? " milliseconds

Then you calculate: "Your seconds" * 1000 milliseconds = "Your milliseconds"

When you specify times for movement, the position of the text changes as follows:

1) Before "T1", the text is at position (x1, y1)

Tutorial by Spyne21
2) Between "T1" and "T2", the text moves constantly from (x1, y1) to (x2, y2)
3) After "T2", the text is found at position (x2, y2) Note that it is possible to have times "T1" and "T2" greater than the
duration of the line, but the utility is variable. To put "T1" and "T2" at "0" comes back to the same thing as the first version
of
\ move. The movement will take place for the duration of the line.

There are several things that \ move cannot do:

- Travel at non-constant speed is not possible. That is to say that the movement cannot start slowly and end
quickly.

- It is not possible to use the \ tag move and \ pos at the same time, it is one or the other.

If you need to make more than one movement constantly or not, you will have to separate your movement into
several lines.

Possibility of use via the button then by clicking on . This button is not available
only after loading a video track.

Note : If you only want to position your text, there is no point in using this tag.

Warning : You can only define one movement per line !!!

Examples: balise_move.ass

Origin of a line (center of gravity)

\ org (< X>, <Y>)

Used to define the point of origin (center of gravity) for the rotations. It can therefore be used with the \ tags frx, \ fry and
\ frz. This tag affects all line rotations. In principle the coordinates must be integers, however since version 2.39 of "Vsfilter",
you can use decimal numbers. They cannot be negative.

When there is no tag \ org in a line, The origin of the rotation is implicitly the same as the position's anchor point (In
the middle of the text). This means that the origin of the rotation will move, if the line is in motion and if there is no tag
\ org specified. In addition, it is not possible to animate the \ tag org, you are therefore limited to a fixed point of origin.

Possibility of use via the button or . This button is only available after loading
a video track.

Tutorial by Spyne21
Warning : You can only define one point of origin per line !!! If you put several, the last bet will be taken
into account.

Examples: balise_org.ass

Molten

\ fad (< start time>, <end time>)

Allows you to define a blend of the text when it appears and / or when it disappears. In other words, the text will
appear following a "Start time" and disappear according to a "End time". Times are expressed in milliseconds. It is
possible to set a fade for the start time or for the end time only. To do this, simply put "0" in where you don't want to
apply a fade.

Adding a blend effect does not increase the length of the line. The start and / or end time of the line is used for the fade effect.
It is for this reason that we must pay attention to the fact that the sum of the
"Start time" and "End time" fade is not greater than the duration of the line.

Examples: balise_fad.ass

\ fade (< a1>, <a2>, <a3>, <t1>, <t2>, <t3>, <t4>)

Allows you to fade in five parts, using three transparency values "A1", "a2" and
"A3" and four times "T1", "t2", "t3" and "T4".

Transparency values ​are given in decimal and are between "0 and 255". The value
"0" corresponds to the state "Completely visible" and "255" in the state "Completely invisible".
The time values ​are expressed in milliseconds. In addition, the seven parameters are required for the operation of the
tag.

Explanation on its use:

- Before "T1", the line has value as transparency "A1"

- Between "T1" and "T2", line goes from transparency state "A1" transparent "A2"
- Between "T2" and "T3", the line has value as transparency "A2"
- Between "T3" and "T4", line goes from transparency state "A2" transparent "A3"
- After "T4", the line has value as transparency "A3"

Tutorial by Spyne21
Examples: balise_fade.ass

Note : 1 second corresponds to 1000 milliseconds. If you have trouble converting the seconds you
have in mind to a millisecond, make a rule of three.

1 second • 1000 milliseconds

"Your seconds" • "? " milliseconds

Then you calculate: "Your seconds" * 1000 milliseconds = "Your milliseconds"

Warning : You can only use these tags once per line !!! In addition, these two tags cannot be used at the same
time. To use the fade several times in the same line, you will need to use the \ t and the tag \ alpha or \ < 1-4> a

Animation function

\ t (< tags>)
\ t (< acceleration>, <tags>)
\ t (< t1>, <t2>, <tags>)
\ t (< t1>, <t2>, <acceleration>, <tags>)

Allows you to perform a progressive transformation animated from one / several tag (s) to one / several other tag (s).

The settings "T1 and t2" specifies the time interval to perform the transformation. In versions without "T1 and t2", the
transformation takes place according to the length of the line. The times are expressed in milliseconds and its relative to
the start and end time of the line.

The acceleration setting can be used to make the animation non-linear. An acceleration parameter of "1" corresponds
to a linear animation speed. A value between "0 and 1"
corresponds to an animation that begins quickly and ends slowly. A value greater than "1" corresponds to an
animation that begins slowly and ends quickly. Obviously, the acceleration values ​can be positive decimals.

Before "T1", the line style corresponds to the tags initialized before the \ tag t. After "T2", the line style corresponds to the
new tags defined in the \ tag t, and those defined before the \ tag t that have not been replaced. Between "T1" and "T2", the
animation changes the style gradually according to the acceleration described above.

Note : 1 second corresponds to 1000 milliseconds. If you have trouble converting the seconds you have in mind to
a millisecond, make a rule of three.

1 second • 1000 milliseconds

"Your seconds" • "? " milliseconds

Then you calculate: "Your seconds" * 1000 milliseconds = "Your milliseconds"

The "vsfilter" tags which can be animated with the \ tag t:

Font style Geometry Other effects

\ fs \ fscx \edge

Tutorial by Spyne21
 \ fsp \ fscy \ x edge

\vs \ frx \ ybord

\1 C \ fry \ shad
\ 2c \ frz \ xshad
\ 3c \Fr \ yshad
\ 4c \fax \ clip (rectangle)
\alpha \ fay \ iclip (rectangle)
\ 1a \ be
\ 2a \ blur
\ 3a \
4a

Note : Regarding the tags \ clip and \ iclip, only the rectangle version can be animated, not the \ clip and \ iclip vector.
Also mix the tags \ clip and \ iclip ( rectangle) in tags \ t is not recommended as it causes undesirable results.

The “vsfiltermod” tags which can be animated with the \ tag t:

Font style Geometry Other effects

\ fsc \ fsvp \ distort

\ 1vc \ frs \ rnd
\ 2vc \z \ rndx
\ 3vc \ rndy
\ 4vc \ rndz
\ 1va \ jitter
\ 2va \
3va \
4va \
1img \
2img \
3img \
4img

Note : It is not recommended to use the \ tag jitter with the tag \ t under penalty of crashing Aegisub or your
encoding software.

Examples: balise_t.ass

Clip (rectangle)

\ clip (< x1>, <y1>, <x2>, <y2>)

Allows you to define a rectangle that makes part of the line visible or invisible. Only the part of the line that is inside
the rectangle is visible. The other part is invisible.

Possibility of use via the button . This button is only available after loading a
video track.

Tutorial by Spyne21
Examples: beacon_clip.ass

\ iclip (< x1>, <y1>, <x2>, <y2>)

The tag \ iclip is the opposite of the \ clip. It makes it possible to make visible the part of the line which is not inside the
rectangle. The other part will be invisible

Possibility of use via the button . This button is only available after loading a
video track.

Examples: balise_iclip.ass

Notes: The coordinates "X1", "y1", "x2" and "Y2" depend on the video resolution defined in the ASS script. The
coordinates must be integers. It is not possible to specify decimal numbers in coordinates. A rectangle consists of
four points. As soon as you add an additional point, the \ clip rectangular changes to \ clip vector. There is no limit to
the number of points you can add.

Clip (vector drawing)

\ clip (< drawing orders>)

\ clip (< scale>, <drawing commands>)

Displays part of the line, using a drawing created as a vector drawing.

Possibility of use via the button . This button is only available after loading a
video track.

Examples: balise_clip_shape.ass

\ iclip (< drawing orders>)

\ iclip (< scale>, <drawing commands>)

Used to hide part of the line, using a drawing created as a vector drawing.

Possibility of use via the button . This button is only available after loading a
video track.

Tutorial by Spyne21
Examples: balise_iclip_shape.ass

Note : The drawing commands are the same as those used with the \ tag p. The coordinates of a vector drawing
depends on the video resolution defined in the ASS script. If the scale is not specified, then it is "1" by default.
This means that the coordinates correspond directly to the pixels. The scale of the tag \ clip works the same way
as the scale for vector drawings of the tag \ p. Contrary to \ clip rectangular, the \ clip

vector cannot be animated with the \ tag t. If you want to animate a \ clip vector, you must create several similar lines
"Frame by frame" with the animation changes you want to make.

Karaoke effects

\ k < duration>
\ K < duration>
\ kf < duration>
\ ko < duration>

The different tags \ k are used for karaoke effects by specifying the duration of each syllable. To do this,
place a tag \ k before each syllable on the same line.

The duration is expressed in hundredths of a second, i.e. "1 second" equals

"100 hundredths of a second". Typically, you don't enter the \ k with their durations manually, but using karaoke
synchronization tools like Aegisub's karaoke mode.

The different tags \ k created different effects:

- \ k: All syllables start with the secondary color. When a syllable begins, it instantly changes to the primary
color.
- \ K and \ kf: These two tags are identical. All syllables start with the secondary color. When a syllable begins, the
secondary color gradually changes to the primary color from left to right. The progressive change takes place
during the duration of the syllable.

- \ ko: Similar to the \ tag k, except the fact that the syllables start with the secondary color but without border. When
a syllable begins, it instantly changes to the primary color and finds a border.

Tutorial by Spyne21
Examples: tags_karaoke.ass

Notes: These tags are used to create only very specific effects while all other effects are created with a
combination of several different tags. There is an additional karaoke tag, \ kt which is very different from the others.
It is not really useful and Aegisub does not support this tag, so it is not documented.

For further information: ASS Tags

The “vsfiltermod” tags:

Font size

\ fsc < scale>

Allows you to change the size of the text. It is a version which brings together the two tags \ fscx < scale in%> \ fscy < scale
in%> in a single tag. It does nothing more. The tag can be animated with the \ tag t. The scale is an integer. It cannot
be negative.

Examples: beacon_fsc.ass

Define vertical position

\ fsvp < Y>

Allows you to change the vertical position of the text. It can be used with in a line containing a \ tag pos or \ move. The
tag can be animated with the \ tag t. The vertical position can be a whole or decimal number. It can also be
negative.

Examples: balise_fsvp.ass

Rotating letters

\ frs < angle>

Tutorial by Spyne21
Allows you to rotate the letters of the following text. It can be used with the rotation tags on the X, Y and Z axes. The
tag can be animated with the \ tag t. The angle can be a whole or decimal number. It can also be negative.

Examples: balise_frs.ass

Z coordinate

\ z < arg>

Used to fix the coordinates on the Z axis. That is to say, to define a distance between the screen and the text. It can be
used with the \ tags frx and \ fry. The tag can be animated with the \ tag t. The argument can be a whole number or a
decimal number. It can also be negative.

Examples: balise_z.ass

Text distortion

\ distort (< u1>, <v1>, <u2>, <v2>, <u3>, <v3>)

Distorts text by moving corner marks to the specified coordinates. The tag can be animated with the \ tag t. Coordinates
can be whole or decimal numbers. They can also be negative.

Tutorial by Spyne21
Here is a picture showing how it works:

As you can see, the initial position of the tag is \ distort (1,0,1,1,0,1). Once you understand this, all you have to
do is think about what you want to do while keeping this diagram in mind.

Note : The tag does not work with the version of "Vsfiltermod 1.1.0"

Examples: balise_distort.ass

Text outline distortion

\ rnd < arg>

\ rndx < arg>
\ rndy < arg>
\ rndz < arg>

Allows you to distort the outline of the text, by moving the border points over a random number of pixels (-arg, arg). The
deformation takes place during an interval, in an X, Y or Z direction. The tag can be animated with the \ tag t. The argument
can be a whole number or a decimal number. It can also be negative.

Tutorial by Spyne21
Examples: balise_rndxyz.ass

Color gradients

\ 1vc (< top left color>, <top right color>, <bottom left color>, <bottom right color>)

Allows you to perform a gradient of the primary color. The tag can be animated with the \ tag t.

Examples: balise_1vc.ass

\ 2vc (< top left color>, <top right color>, <bottom left color>, <bottom right color>)

Allows you to perform a gradation of the secondary color. The tag can be animated with the \ tag t.

Examples: balise_2vc.ass

\ 3vc (< top left color>, <top right color>, <bottom left color>, <bottom right color>)

Allows you to perform a gradient of the border color. The tag can be animated with the tag
\ t.

Examples: balise_3vc.ass

\ 4vc (< top left color>, <top right color>, <bottom left color>, <bottom right color>)

Allows you to perform a gradient of the shadow color. The tag can be animated with the \ tag t.

Examples: balise_4vc.ass

Note : The colors must be in hexadecimal.

Tutorial by Spyne21
Transparency gradients

\ 1va (< top left transparency>, <top right transparency>, <bottom left transparency>, <bottom right transparency>)

Allows you to perform a transparency gradient of the primary color. The tag can be animated with the \ tag t.

Examples: balise_1va.ass

\ 3va (< top left transparency>, <top right transparency>, <bottom left transparency>, <bottom right transparency>)

Allows you to perform a transparency gradient of the border color. The tag can be animated with the \ tag t.

Examples: balise_3va.ass

\ 4va (< top left transparency>, <top right transparency>, <bottom left transparency>, <bottom right transparency>)

Allows you to perform a transparency gradient of the color of the shadow. The tag can be animated with the \ tag t.

Examples: balise_4va.ass

Notes: The tag does not work with the version of "Vsfiltermod 1.0.10". The transparencies must be in
hexadecimal. The tag \ 2va does much the same thing as the \ tag 1va, except that it is intended for karaoke.

Set an image as color

\ < 1-4> img (< chemin_de_l'image_png> [, <X>, <Y>])

Allows you to define an image as primary, secondary, border or shadow color of the text. The tag can be animated
with the \ tag t.

Tutorial by Spyne21
Two ways to define the path:

- so relative : For that you need "Link" the image to the ASS script in the "List of assignments". Consult the "Karaoke
Tutorial - Part 1" for more information on how to do this.

- so absolute : specifying the full path to the image. You will have to separate the different directories leading to
your image by slashes "/".

Indeed "Vsfiltermod" first try to load the image in the "List of assignments". If it does not find the image this way,
then it searches for the image locally. Additional parameters can be animated with the \ tag t. Values "X" and "Y" can
be positive or negative whole numbers.

Examples: balise_img.ass

Notes: When you use this tag with a \ tag t, it is necessary to initialize it before introducing it into the \ tag t. The tag \ 2img
intended for karaoke. However, you can find an example in the ASS file.

Display an image

We have already discussed the display of an image in Aegisub via a small program in the first part. But as
you can imagine, it is also possible to do it with the tag:

\ < 1-4> img (< chemin_de_l'image_png> [, <X>, <Y>])

What do we need to do this?

- From our image,

- A rectangle of the same size as the image or a rectangle of 1x1 size. In the case of a rectangle of identical size
to the image, the X and Y scale will be 100% by default, without the need to change it to have the original
dimensions of the image. In the case of a rectangle of dimension 1x1, there it will be up to you to fix an X and Y
scale to manage to find the original dimensions of the image.

- From the tag "\ img » and more particularly of "\ 1img".

Examples: balise_1img_image.ass

Trembling

Tutorial by Spyne21
\ jitter (< left>, <right>, <up>, <down> [, <period>, <base>])

It creates a tremor effect across the board. The first 4 parameters are mandatory and are intended for the
direction of the tremor effect. The fifth parameter allows you to set a tremor period. So all " not " periods, the text
will change position. Finally, the sixth parameter allows you to set a "Base" for pseudo-random generation. Equal
bases produce equal orders of numbers. The last two parameters are not mandatory. The different parameters
can be whole or decimal numbers. They can also be negative.

Note : The tag can be animated with the \ tag t. However, it is not recommended to do so under penalty of crashing
your encoding software or Aegisub.

The image does not show the tremor effect, so it is useless.

Examples: balise_jitter.ass

Angular movement

\ mover (< x1>, <y1>, <x2>, <y2>, <angle1>, <angle2>, <distance1>, <distance2> [, <t1>, <t2>])

Allows movement using rounded, oval or spiral paths.

The image does not show movement, so it is useless.

Examples: None, the tag has a rather bizarre behavior. If you have examples to suggest, please share
them.

Curved trajectory movement

\ moves3 (< x1>, <y1>, <x2>, <y2>, <x3>, <y3> [, <t1>, <t2>])
\ moves4 (< x1>, <y1>, <x2>, <y2>, <x3>, <y3>, <x4>, <y4> [, <t1>, <t2>])

The image does not show movement, so it is useless.

Allows to perform a curved trajectory movement in spline on 3 or 4 points. They produce a Bézier curve with a
cubic or bicubic trajectory.

Examples: balise_moves.ass

Clip movement (vector drawing)

\ movevc (< x1>, <y1>, <x2>, <y2> [, <t1>, <t2>])

Move the tags \ vector clip independently. That is, this tag is not affected by the \ tag pos or \ move. The parameters
are the same as the \ tag move.

The image does not show movement, so it is useless.

Examples: balise_movevc.ass

For further information: NewTags and Modifications

Tutorial by Spyne21
Drawing tags:

The command to display drawings (object) on the screen is as follows:

{\ p <1 ... n>} <drawing commands> {\ p0}

• The tag {\ p <1 ... n>} (\ p < value > strictly greater than 0) activates the drawing mode. The
value enclosed in square brackets defines the scale of the object, using the following formula: 2 ^ ( value -1).

For example, for {\ p4}, we have 2 ^ (4-1) = 2 ^ 3 = 8. All the coordinates of the object will be divided by 8.

• The tag {\ p0} deactivates the drawing mode. Everything after this command will be interpreted as text.

\ pbo <y>: baseline offset (offset from baseline of " y " pixels).

By default all objects are placed on the current baseline (it is defined by the position of the subtitles in the video and by
the vertical margins). The code \ pbo <y> allows to offset by " y " pixels, the current baseline. It is thus possible to lower
(y> 0) or raise (y <0) the objects.

Example:

Note : If you only display one drawing in a line, it is not vital to put the tag {\ p0}
at the end.

Examples: balise_p.ass

Source: SweetKaraoke

For further information: ASS Tags

Tutorial by Spyne21