## Subtitle

`Subtitle` (clip, string text, int "x", int "y", int "first_frame", int "last_frame", string "font", float "size", int "text_color", int "halo_color", int "align", int "spc", int "lsp", float "font_width", float "font_angle", bool "interlaced")

`Subtitle` (clip, string text)

Filtr `Subtitle` přidá vyhlazený (anti-aliased) text do skupiny snímků. Pokud chcete více než jedny titulky, musíte filtr `Subtitle` několikrát použít (zřetězit) za sebou. Všechny parametry kromě samotného textu jsou volitelné a mohou být vynechány nebo zadány mimo pořadí použitím syntaxe name=value .

#### Parametry

text je text, kterým bude překryt klip počínaje snímkem first_frame a konče snímkem last_frame.

(x,y ) je pozice textu. Parametry x a y mohou být nastaveny na -1 pro automatický výpočet a použití horizontální nebo vertikální středové souřadnice. Jiné záporné hodnoty ''x'' a ''y'' lze použít pro umístění titulků částečně mimo obrazovku. Upozornění: Pokud váš skript používá Subtitle s Animate a zápornými hodnotami ''x'' nebo ''y'', pak hodnoty ''x'' nebo ''y'' by se mohly v daný moment stát -1, a způsobily by poruchy ve videu.

font je font textu (všechny nainstalované fonty na aktuálním počítači jsou dostupné, jsou nalezeny ve složce 'windows\fonts').

size je velikost textu v 0.125 jednotkách pixelu.

Parametry text_color a halo_color by měly být zadány v šestnáctkových $aarrggbb hodnotách, podobně jako v HTML--kromě toho že začínají na $ místo # a čtvrtý bajt udává průhlednost alfa. $00rrggbb je plně neprůhledné (opaque), $FF000000 je plně průhledné (transparent). Můžete vypnout halo výběrem této barvy. Viz zde pro více informací o uvedených barvách.

Parametr align vám umožní nastavit kde je umístěn text relativně k souřadnicím (x,y) a je založen na numerické klávesnici tímto způsobem:

<levý> 7 <horní> | <střední> 8 <horní> | <pravý> 9 <horní> | vrch textu zarovnaného podle y pro zarovnání=7,8,9
<levý> 4 <základní> | <střední> 5 <základní> | <pravý> 6 <základní> | základní umístění textu zarovnaného podle y pro zarovnání=4,5,6
<levý> 1 <spodní> | <střední> 2 <spodní> | <pravý> 3 <spodní> | spodek textu zarovnaného podle y pro zarovnání=1,2,3
začátek na x pro zarovnání=1,4,7 | střed na x pro zarovnání=2,5,8 | konec na x pro zarovnání=3,6,9 |

Poznámka: Není žádné vertikální zarovnání středu.

Parametr spc vám umožní upravit mezeru mezi znaky (0=nezměněno). Hodnota může být kladná nebo záporná pro rozšíření nebo zúžení textu. Podle dokumentace Visual C++ k funkci SetTextCharacterExtra(), která provádí tuto úlohu, je tato hodnota v logických jednotkách a zaokrouhlena na nejbližší pixel. To je užitečné pro pokusy přizpůsobení typických fontů v PC k fontům použitým ve filmu a televizi které bývají obvykle širší při stejné výšce nebo pro zaplnění daného pravoúhelníku textem s pevnou mezerou mezi znaky.

Použití víceřádkového textu pomocí "\n" je doplněno ve v2.57 a je použito pokud je nastaven parametr lsp (line spacing). Nastavuje dodatečnou mezeru mezi dvěma řádky v jednotkách 0.125 pixelu.

Parametr font_width vám umožní upravit poměr výšky a šířky (aspect ratio) znaků v 0.125 jednotkách, zapsaných podle dokumentace funkce CreateFont() ve Visual C++. Souvisí to s parametrem size , s výchozím GDI poměrem stran a přirozeným poměrem stran zvoleného fontu.

Parametr font_angle vám umožní upravit úhel natočení textu v 0.1 stupních proti směru hodinových ručiček.

Je-li zapnut parametr interlaced , snižuje se blikání (flicker) z pěkných ostrých vertikálních přenosů v prokládaných zobrazeních. Provádí to zvětšením okna pro anti-aliaser (vyhlazovač) do (včetně) 0.5 váhy pixelu z řádků nad a pod, efektivně aplikuje mírné vertikální rozmazání.

Krátká forma (se všemi výchozími parametry) je užitečná, když vám po dobu sledování skutečně nezálezí na vnějším vzhledu titulků--například, když používáte StackVertical pro zobrazení několika variant snímku, a chcete nějakým způsobem označit který je který.

Tento filtr je v AviSynthu vnitřně použit v příkazu Version a pro hlášení chybových zpráv, a také ve filtru ShowFrameNumber a podobných.

Výchozí hodnoty

clip | last
text | není výchozí, musí být zadán
x | 8 pokud je align (zarovnání) =1,4,7 nebo když není žádné align; -1 pokud je align= 2,5,8; nebo width (šířka)-8 pokud je align=3,6,9
y | height (výška)-1 pokud je align=1,2,3; size (velikost) pokud align= 4,5,6 nebo není žádné align; nebo 0 pokud je align=7,8,9
first_frame | 0
last_frame | framecount(clip)-1 (počet snímků -1)
font | "Arial"
size | 18.0
text_color | $00FFFF00 <plně neprůhledný yellow> (žlutý)
halo_color | 0 < plně neprůhledný black> (černý)
align | Běžně 4 <levý stranově a základní výškově>; pokud je x= -1, pak 5 <vodorovný střed a základní výškově>
spc | 0 <mezera fontu beze změny>
lsp | 0 <víceřádkový text není zapnut>
font_width | 0 <system default - výchozí systému>
font_angle | 0.0 stupňů
interlaced | false

Příklady

    # Nějaký text ve středu klipu:
    AviSource("D:\clip.avi")
    Subtitle("Hello world!", align=5)

    # Nějaký text v pravém horním rohu
    # klipu se zadaným fontem, velikostí a červenou barvou:
    AviSource("D:\clip.avi")
    Subtitle("Hello world!", font="georgia", size=24, \
              text_color=$ff0000, align=9)

    # Tiskne text do více řádků:
    # bez zvonění (halo) okraje textu.
    BlankClip()
    Subtitle( \
      "Nějaký text v řádku 1\\nDalší text v řádku 1\n" + \
      "Nějaký text v řádku 2", \
             lsp=10, halo_color=$ff000000)

    # To dává:
    Nějaký text v řádku 1\nDalší text v řádku 1
    Nějaký text v řádku 2

Specifické informace o verzích

v2.58 | Přidáno font_width, font_angle, smíchání prokládání a alfa barev.
v2.57 | Přidán víceřádkový text a parametr mezer řádku (lsp).
v2.07 | Přidány parametry align a spc. Nastavení y= -1počítá svislý střed (zarovnání je nedotčeno) Výchozí x a y hodnoty závisí na zarovnání align (dříve x=8, y=size)
v1.00 | Nastavení x= -1 používá vodorovné střední zarovnání (nezdokumentováno do v2.07)

`$English Date: 2008/12/21 09:23:02 $`

`Český překlad:12.20.2009`