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