Aegisub Manual

8/10/2019 Aegisub Manual

1/13

Aegisub

0000000004


2/13

Aegisub

Aegisub ASSAdvanced Substation Alpha

Aegisub

Aegisub 2.102.20

Aegisub2.10

Aegisub

1(Video BOX)

2(Audio BOX)

3(Edit BOX)

4(Subtitles Grid)


3/13

1

2 Style

3

4

5

6

7

8

9Left margin for this line. 0 means use the margin specified in the style.

10Right margin for this line. 0 means use the margin specified in the style.

11Vertical margin for this line. 0 means use the margin specified in the style.

12

13

14

15

16

1718

19

20

21

22


4/13

1

OK

Style

Edit


5/13

2

Audio OpenAudioFromVedio

OK

3 OK

Accept Split


6/13

4

Aegisub

Accept Split

OK OK K


7/13

Aegisub OK

OK

1 karaoke template

karaoke template template line{\kXX}5j/ >

Style OKeffecttemplate line

STARTEND

$STARTEX{\k10}A A

$ENDEX{\k10}A A

$MID$START+$END/2

$DUREX{\k10}ADUR=100ms

2

template lineEXtemplate syl

AutomationAplly karaoke template


8/13

\n - Soft line break

Makes the line "break" (i.e. skip to the next line) using mode \q2 (see\q). Using any other mode, it's

replaced by a space.

\N - Hard line break\h - Hard space

Override tags

\i - Italic

Toggles italicsin following text. Set to 0 to disable italics or to 1 to enable them. e.g.:

\b- Bold

Toggles boldin the following text. Set to 0 to disable bold or to 1 to enable.

\u- Underline

Toggles underline in the following text, like this. See description for italics.

\s- Strikeout

Toggles strikeout in the following text. See description for italics. Strikeout means that there will be a line

crossing the text, like this.

\bord - Border

Sets the width of border around text. Value is given in pixels and can have decimal places. e.g.:

\shad- Shadow

Sets the offset that shadow is drawn from the main text. Think of the shadow as the text+outlines in a single

color, drawn behind text, and offset by depth pixels to the right and bottom. This tag works similarly to \bord.

\be- Blur edges

This tag enables or disables edge blurring. This is a subtle effect, and is not very visible for large text. See

description of italics tag for usage.

\fn- Font name

This sets the font face name for the following text. Note that there is no space between \fn and the parameter

name. e.g.:

\fnArial

(uses "Arial" font)

\fnTimes New Roman

(uses "Times New Roman" font)

\fs- Font size

Specifies the font size, in points. This is the same unit that most text processors use. e.g.:

\fscx- Font scale in X axis

Sets the font scale for the X (horizontal) axis.

\fscy- Font scale in Y axis

Same as\fscx, but for the vertical axis.

\fsp- Font spacingSets the spacing between characters, in pixels. This allows you to make the text look something like "t h i s".

Some fonts might look bad because the characters are too close to each other. This tag might help in such cases.

Also, if used in moderation, it can give the illusion that the font is wider.


9/13

\fr[]- Font rotation

Rotates the text by the specified number of degrees, in the specified axis. If axis is omitted, then "z" is used as

\fe - Font encoding

For non-Unicode subtitles, this sets the character encoding to the specified page number.

\fe0

(sets to ANSI extended, the standard for the USA)

\fe128

(sets to SHIFT_JIS extended, the standard for Japan)

\c&H&- Set primary color

Sets the primary color (i.e. the fill color) of the text. Color tags in ASS are in Visual Basic hexadecimal style,

which is similar to HTML hexadecimal. It always starts with &H, and ends with &. Between those, are the

color values in hexadecimal: two characters for blue, two for green and two for red, in that order (i.e.

BBGGRR). Any zero color at the start may be ommited. Also note that saying just \c has the same result as

Aegisub has a Color Pickerthat can help you generate these hexadecimal numbers.

\1c&H& - Set primary color

Sets primary color. See\cfor full description.

\2c&H&- Set secondary color

Sets secondary color. This is the color that primary changes from during karaoke effects (i.e. karaoke starts at

this color and then changes to primary). See \c for full description.

\3c&H&- Set outline colorSets outline (border) color. See \c for full description.

\4c&H&- Set shadow color

Sets shadow color. You almost always want this to be black, but see \c for full description.


10/13

\alpha&H& - Set alpha

This sets the alpha value (i.e. the transparency) of the line.

(makes text 50% translucent)

\alpha&HEF&

(makes text almost invisible)

Tag affects (ASS) affects (SSA)

\alpha the line in its entirety

\1a the text

\2a karaoke secondary

\3a border tertiary

\4a shadow border and shadow

\a&H&- Set Primary/secondary/outline/shadow alpha

Sets alpha value for the specified color. Works the same as the variations of \c. See\alphafor a complete

description.

\an- Numpad Text Alignment

Sets text alignment relative to numpad layout. Note that this has the interesting property of changing the text

"anchor point" as well; a line with \an5 and \pos(320,240) will have its exact center on the coordinate (320,240)

while a line with \an7 will have its upper left corner on (320,240). See\posfor a full explanation of this. e.g.:

\an7

(aligns text on top-left. Note that the "7" key on numpad is at the top-left)

\an5

(aligns text on center)

\an2

(aligns text on bottom-center)

\a- SSA Text Alignment

Sets text alignment based on the old SSA scheme. This is specified by a sum: 1 equals left, 2 equals middle, 3

equals right. Then add 4 to get top alignment, 8 to get vertical middle alignment, or leave as is for bottom

\k- Karaoke effect

This makes the following text start at the secondary color immediately, and change to the primary color afterthe sum of duration (in centiseconds) of all previous karaoke effects has elapsed. e.g.:

{\k32}Ko{\k27}ko{\k27}ro

(Shows "Ko" with the primary color immediately and other two syllables with the secondary, then "ko" changes

to primary 32 centiseconds (320 milliseconds or 0.32 seconds) later, then "ro" changes to primary 27

centiseconds after)

\kf- Filled karaoke

Similar to\k, but instead of immediately setting color from secondary to primary, it "fills" it from left to right.

\K- Filled karaoke

Same as\kf.

\ko- Filled outline karaoke

Similar to\kf, but the effect is only applied to the outline (border).


11/13

\q- Wrap style

Sets the line wrapping style as follows:

0:Smart wrapping, top line is wider

1:End-of-line word wrapping, only \N breaks

2:No word wrapping, both \n and \N break

3:Smart wrapping, bottom line is wider

\r[]- Reset styleThis resets the style to the specified one. If none is given, it resets to this line's original style. e.g.:

-Hey\N{\rAlternate}-Huh?\N{\r}-Who are you?

(this has the middle line in the style "Alternate", while first and third are in the originally set style)

\pos(,) - Position

\move(,,,[,,])- Move

Moves the text from the original position, defined by x1,y1, to the destination, defined by x2,y2.

\org(,) - Origin

Sets the screen coordinates of the origin (or pivot point) for rotation and scaling tags.

\fade(,,,,,,) - Fade

Fades text.

\fad(,)- Fade (simplified)A less powerful, but more practical version of\fade.

\t([,,][,])- Transform

This is perhaps the most powerful override tag available. It does nothing by itself; instead, it animates


12/13

(transforms) other tags. The animation will start at t1 milliseconds and end at t2 milliseconds, in much the same

way as\move. If either of those parameters are omitted or zero, then start and end of the line respectively are

assumed, as with \move.

The optional acceleration parameter allows the transformation to be non-linear. Think of it as the exponent on a

x^n. Acceleration = 1 is linear. Acceleration between 0 and 1 starts fast and ends slow. Acceleration larger than

1 starts slower and ends fast.

The following tags are supported by \t:\c

\1-4c

\alpha

\1-4a

\fs

\fr

\frx

\fry

\frz

\fscx

\fscy

\fsp

\bord

\shad

\clip (rectangle version only).

e.g.:

{\c&H0000FF&\t(\c&HFF0000)}Hello!

(Starts text at a red colour and fades it to blue)

{\an5\t(0,5000,\frz3600)}Woo!

(Makes the text rotate 10 times, counterclockwise, lasting for 5 seconds)

{\an5\t(0,5000,0.5,\frz3600)}Woo!

(Same as before, but it will start fast and slow down, still doing the 10 rotations in 5 seconds)

{\an5\fscx0\fscy0\t(0,500,\fscx100\fscy100)}

(Text starts at zero size, ie. invisible, then grows to 100% size in both X and Y direction.)

\clip(,,,) - Set clipping rectangle

This sets the clipping rectangle of the text, so that it will onlybe drawn insidethis rectangle. For example, if

you had a resolution of 640x480 and set \clip(0,0,320,240), then text would only be drawn on top-left quadrant

- anything outside it would be "clipped" and would be invisible. This tag is useful for when some object moves

in front of text: you can use\tto animate the "window" where the text is visible. e.g.:

\clip(0,0,320,240)

(Areas of text will only be drawn if they are on top-left quadrant)

\clip(100,300,540,480)

(Areas of text will only be drawn if they are on center-bottom)Sample screenshot (with \clip(0,0,704,245) on a 704x480 video):


13/13

\clip([,])- Set clipping vector

Same as before, but it uses drawing vectors instead of a rectangle. See the drawing section below for more

information. Note that, unlike the previous tag, this may notbe animated with\t. The optional scale argument is

equivalent to the value passed to\pon the drawing tag. On an unrelated note, this tag makes me wonder if

Gabest was actively trying to prevent other people from writing ASS parsers by creating an overloaded tag. e.g.:

\clip(1,m 50 0 b 100 0 100 100 50 100 b 0 100 0 0 50 0)

(Limits clip to pseudo-circle defined)

Documents

Aegisub Manual