Cesty súborov

Šablóny ciest

Šablóny ciest nahrádzajú výrazy šablóny (napísané {abcd}, kde „abcd“ je meno premennej) v ceste k súboru, keď sa cesta používa.

Napríklad, ak je aktuálne otvorený blend súbor dance.blend a výstupná cesta prekreslenia je nastavená na túto hodnotu:

//my_render_dir/{blend_name}.png

Potom pri prekresľovaní Blender spracuje cestu ako:

//my_render_dir/dance.png

Pri {blend_name} sa nahradí dance z dance.blend.

Toto nahradenie sa uskutoční interne v čase použitia (napr. pri prekresľovaní), takže syntax šablóny zostane v poli cesty zachovaná.

Poznámka

V súčasnosti sú šablóny ciest podporované len pre výstupnú cestu prekreslenia vo vlastnostiach scény a výstupné cesty v uzle výstupného súboru kompozítora. Ďalšie cesty súborov budú podporovať šablóny v budúcich verziách.

Dostupné premenné

V súčasnosti sú vo výrazoch šablón k dispozícii tieto premenné.

K dispozícii vo všetkých cestách, ktoré podporujú výrazy šablón:

blend_name:

Názov aktuálne otvoreného súboru blend (bez prípony .blend).

blend_dir:

Cesta až po aktuálne otvorený blend-súbor (ale nie vrátane).

blend_name_lib:

Podobne ako blend_name, až na to, že pre vlastnosti cesty na blokoch údajov prepojených s knižnicou to bude názov knižnice blend-súboru, z ktorého blok údajov pochádza.

blend_dir_lib:

Podobne ako blend_dir, až na to, že pre vlastnosti cesty na blokoch údajov prepojených s knižnicou to bude cesta ku knižnici blend-súboru, z ktorého blok údajov pochádza.

K dispozícii len vo výstupných cestách prekreslenia (vrátane uzla Výstupný súbor kompozítora):

fps:

Počet snímok za sekundu (fps - frames per second) aktuálnej scény.

resolution_x / resolution_y:

Rozlíšenie x a y prekresľovaného obrázka. Tento faktor zohľadňuje aj mierku rozlíšenia, takže ak je rozlíšenie scény 1000x600 a mierka je 50%, potom resolution_x a resolution_y budú 500 a 300.

scene_name:

Názov aktuálnej scény.

camera_name:

Názov aktuálnej prekresľovacej kamery.

K dispozícii len vo vlastnostiach cesty na uzle:

node_name:

Názov uzla, na ktorom sa nachádza vlastnosť path.

Syntax

Základný šablónový výraz jednoducho obalí názov premennej zloženými zátvorkami:

dance_{fps}.png

Špecifikátory formátu

Výrazy šablóny môžu obsahovať aj špecifikátor formátu. Špecifikátory formátu dávajú Blenderu pokyny, ako má formátovať nahradenú hodnotu. Zapisujú sa za oddeľujúcu dvojbodku, napríklad takto:

dance_{fps:FORMAT}.png

Špecifikátory formátu možno v súčasnosti používať len s premennými, ktoré predstavujú číselné hodnoty, nie reťazcové hodnoty. Dostupné špecifikátory formátu sú:

• dance_{fps:###}.png: formát ako celé číslo s najmenej 3 číslicami.

• dance_{fps:.###}.png: formát ako číslo s pohyblivou desatinnou čiarkou s presne 3 číslicami za desatinnou bodkou.

• dance_{fps:###.##}.png: formát ako číslo s pohyblivou desatinnou čiarkou s najmenej 3 číslicami pre celočíselnú časť a presne 2 číslicami pre zlomkovú časť.

Vo všetkých prípadoch počet hašovacích symbolov (#) označuje požadovaný počet číslic.

Ak je napríklad počet snímok za sekundu 29,97, potom:

• dance_{fps:###}.png -> dance_030.png

• dance_{fps:.###}.png -> dance_29.970.png

• dance_{fps:###.##}.png -> -> dance_029.97.png

Všimnite si, že hodnoty sú správne zaokrúhlené pre daný počet číslic.

Ak nie je zadaná špecifikácia formátu, použije sa predvolené formátovanie pre pomenovanú premennú (napr. plávajúca desatinná čiarka pre snímky za sekundu, celé číslo pre rozlíšenie).

Únikové sekvencie

Keďže {` and } sa používajú pre šablónové výrazy v cestách, ktoré ich podporujú, ak je v takejto ceste požadovaný doslovný {` or }, musia byť obídené ich dvojitým zápisom:

• {{` sa prekladá vo finálnej ceste na jednu {` .

• }} sa v finálnej ceste prekladá na jednu }.

Napríklad:

• my_weird}}_{{path.png -> my_weird}_{path.png

• //my_render_{{dir}}/{blend_name}.png -> //my_render_{dir}/dance.png

• //my_render_dir/{{{blend_name}}}.png -> //my_render_dir/{dance}.png

Chyby

Cesty, ktoré podporujú šablóny, môžu mať chyby šablón, ktoré bránia spracovaniu cesty.

Napríklad v nasledujúcej ceste:

//my_render_dir/{blend_name.png

Výraz {blend_name nie je správne uzavretý, čo vedie k chybe.

Ak sa v ceste vyskytnú chyby šablóny, pole cesty sa v užívateľskom rozhraní zvýrazní červenou farbou:

Po nabehnutí na pole cesty sa zobrazí popis obsahujúci zoznam chýb šablóny, ktoré sa vyskytli v danej ceste:

Poznámka

V závislosti od cesty môžu chyby šablóny zabrániť určitým akciám. Ak sa napríklad vo výstupnej ceste prekreslenia vyskytnú chyby, prekreslenie animácie zlyhá s chybovým hlásením označujúcim chyby cesty.