### [yv12][yuy2][rgb32][rgb24]

# Subtitle

## Subtitle(clip, string text, int "x", int "y", int "first_frame", int "last_frame", string "font", int "size", int "text_color", int "halo_color" int "align" int "spc")
Subtitle(clip, string "text")

text: wyświetlany tekst
x, y: pozycja tekstu (wartość -1 dla obu argumentów wyświetli tekst na środku klipu); domyślnie x=8 (gdy align=1,4,7 lub gdy nie jest on określony), x=-1 (gdy align=2,5,8) lub x=8 (gdy align=3,6,9), y=size (gdy align=4,5,6 lub gdy nie jest on określony) y=0 (gdy align=7,8,9) lub y=-1 (gdy align=1,2,3)
first_frame/last_frame: pierwsza/ostatnia klatka, na której podany tekst jest wyświetlany; domyślnie first_frame=0, a last_frame=ilość_klatek_klipu-1
font: krój czcionki; domyślnie "Arial"
size: wielkość czcionki; domyślnie 18
text_color: kolor wyświetlanego tekstu; domyślnie $FFFF00 (żółty)
halo_color: kolor obramowania wyświetlanego tekstu; domyślnie 0 (czarny)
algin: wyrównanie; domyślnie align=4 (lewo i linia bazowa), align=5 (gdy x=-1, środek w poziomie i linia bazowa)
spc: odstępy pomiędzy znakami; domyślnie 0 (brak zmiany odstępów pomiędzy znakami)

Filtr Subtitle wstawia pojedynczą linię wygładzonego tekstu dla określonego przedziału klatek. Jeżeli chcesz wstawić więcej niż jeden napis lub napis zawierający kilka linijek, to należy umieścić kilka kopii tego filtru pod rząd. Z tego względu filtr ten nadaje się głównie do sporadycznego użytku. Wszystkie parametry występujące po text są nieobowiązkowe i można je pominąć.
Kolory tekstu i obramowania powinny być podane jako wartości szesnastkowe w postaci $RRGGBB, gdzie R, G, B oznaczają natężenie kolorów składowych: czerwonego, zielonego i niebieskiego.
Parametrom x i y mogą zostać przypisane wartości równe -1, tak żeby można było automatycznie obliczyć i użyć poziomych lub pionowych współrzędnych środka.
Parametr align (wyrównania) pozwala na ustawienie tekstu względem współrzędnych (x,y) i jest on wzorowany na układzie klawiatury numerycznej:

<lewo> 7 <góra> | <środek> 8 <góra> | <prawo> 9 <góra> | górna krawędź tekstu znajduje się w położeniu zadanym przez parametr y dla align=7,8,9
<lewo> 4 <linia bazowa> | <środek> 5 <linia bazowa> | <prawo> 6 <linia bazowa> | linia bazowa tekstu znajduje się w położeniu zadanym przez parametr y dla align=4,5,6
<lewo> 1 <dół> | <środek> 2 <dół> | <prawo> 3 <dół> | dolna krawędź tekstu znajduje się w położeniu zadanym przez parametr y dla align=1,2,3
tekst zaczyna się od parametru x dla align=1,4,7 | tekst jest wycentrowany na osi poziomej dla align=2,5,8 | tekst kończy się na wartości zadanej przez x dla align=3,6,9

UWAGA
Nie ma ustawienia wyrównania na środku osi pionowej (tzn. nie ma takiej wartości parametru align, która by to umożliwiała).
Parametr spc zezwala na modyfikację odstępów pomiędzy znakami (0=bez zmian). Wartość ta może być dodatnia lub ujemna w zależności od tego czy tekst ma być poszerzony czy zwężony. W dokumentacji Visual C++, w funkcji która wykonuje to działanie, wartość jest wyrażona w jednostkach logicznych i zaokrąglana do najbliższego piksela (trochę bez sensu - jak wartość logiczna może być zaokrąglana?). Jest to pomocne, gdy staramy się dobrać typowe czcionki komputera osobistego do czcionek używanych w napisach końcowych w filmach i telewizji, które zazwyczaj są szersze przy tej samej wysokości. Innym zastosowaniem tego parametru może być dopasowanie lub wypełnienie wolnej przestrzeni przy użyciu ustalonego odstępu dla pojedynczego znaku.
Skrócona forma filtru Subtitle może być przydatna, gdy nie zależy nam na wyglądzie napisów dopóki są one widoczne. Na przykład, gdy używany jest filtr StackVertical i wyświetla on kilka wersji tej samej klatki jednocześnie, to użycie filtru Subtitle będzie przydatne przy oznaczeniu ich tak aby pamiętać, która jest którą.
Filtr ten jest wewnętrznie używany w filtrze Version, przy wyświetlaniu komunikatów o błędach, a także przy użyciu filtru ShowFrameNumber.

### translated by Dj_AnT