Argumenty príkazového riadku

Blender 3.0 Použite: blender [args …] [file] [args …]

Možnosti prekreslenia

-b, --background

Spustenie na pozadí (často sa používa na prekresľovanie bez užívateľského rozhrania).

-a, --render-anim

Prekresľovanie snímok od začiatku do konca (vrátane).

-S, --scene <name>

Nastaví <name> (názov) aktívnej scény na prekresľovanie.

-f, --render-frame <frame>

Prekreslí snímku <frame> a uloží ju.

  • +<frame> počiatočná relatívna snímka, -<frame> koncová relatívna snímka.

  • Môže sa použiť aj zoznam snímok oddelených čiarkou (bez medzier).

  • Rozsah snímok možno vyjadriť oddeľovačom .. medzi prvou a poslednou snímkou (vrátane).

-s, --frame-start <frame>

Nastaví začiatok na snímku <frame>, podporuje +/- aj pre relatívne snímky.

-e, --frame-end <frame>

Nastaví koniec na snímku <frame>, podporuje +/- aj pre relatívne snímky.

-j, --frame-jump <frames>

Nastaví počet snímok, ktoré sa majú posunúť dopredu po každej prekreslenej snímke.

-o, --render-output <path>

Nastaví cestu prekresľovania a názvu súboru. Použite // na začiatku cesty na prekreslenie relatívne k blend-súboru.

Znaky # sú nahradené číslom snímky a používajú sa na definovanie nulovej výplne.

  • animation_##_test.png sa zmení na animation_01_test.png

  • test-######.png sa zmení na test-000001.png

Ak názov súboru neobsahuje #, k názvu súboru sa pridá prípona ####.

Číslo snímky sa pridá na koniec názvu súboru, napr:

blender -b animation.blend -o //render_ -F PNG -x 1 -a

//render_ sa zmení na //render_####, pričom sa snímka zapíšu ako //render_0001.png

-E, --engine <engine>

Určuje mechanizmus prekreslenia. Použite -E help na zobrazenie zoznamu dostupných mechanizmov.

-t, --threads <threads>

Použije počet <threads> (vlákien) na prekreslenie a iné operácie [1-64], 0 pre počet procesorov systému.

Možnosti formátovania

-F, --render-format <format>

Nastavenie formátu prekresľovania. Platné možnosti sú: TGA RAWTGA JPEG IRIS IRIZ AVIRAW AVIJPEG PNG BMP

Formáty, ktoré možno skompilovať do Blenderu, nie sú k dispozícii na všetkých systémoch: HDR TIFF OPEN_EXR OPEN_EXR_MULTILAYER MPEG CINEON DPX DDS JP2

-x, --use-extension <bool>

Nastaví možnosti pridania prípony súboru na koniec súboru.

Možnosti prehrávania animácií

-a <options> <file(s)>

Namiesto zobrazenia užívateľského rozhrania Blenderu sa spustí Blender ako prehrávač animácií, aby bolo možné zobraziť filmy a sekvencie obrázkov prekreslené v Blenderi (ignoruje sa, ak je nastavené -b).

Argumenty pri prehrávaní:

-p <sx> <sy>

Otvorí ľavý dolný roh na <sx>, <sy>.

-m

Čítanie z disku (bez zásobníka).

-f <fps> <fps-base>

Určuje snímkovú frekvenciu pri štarte.

-j <frame>

Nastaví krok snímky na snímke <frame>.

-s <frame>

Prehraje od snímky <frame>.

-e <frame>

Prehraje po snímku <frame>.

-c <cache_memory>

Množstvo pamäte v megabajtoch, ktoré umožňuje ukladanie obrázkov do zásobníka počas prehrávania. Nula deaktivuje (namiesto toho sa fixuje na pevný počet snímok).

Možnosti okna

-w, --window-border

Vynúti otvorenie s okrajmi.

-W, --window-fullscreen

Vynúti otvorenie v režime celej obrazovky.

-p, --window-geometry <sx> <sy> <w> <h>

Otvorí ľavý dolný roh na <sx>, <sy> a šírku ako <w> a výšku ako <h>.

-M, --window-maximized

Vynúti maximalizované otvorenie.

-con, --start-console

Spustí sa s otvoreným oknom konzoly (ignoruje sa, ak je nastavená hodnota -b), (len pre Windows).

--no-native-pixels

Nepoužíva natívnu veľkosť pixelov pre displeje s vysokým rozlíšením (MacBook Retina).

--no-window-focus

Otvorí za inými oknami a bez zamerania.

Možnosti Pythonu

-y, --enable-autoexec

Povolí automatické vykonávanie skriptov Python (predvolené).

-Y, --disable-autoexec

Zakáže automatické vykonávanie skriptov Python (pydrivers & startup scripts).

-P, --python <filename>

Spustí zadaný súbor so skriptom Python.

--python-text <name>

Spustí zadaný textový blok skriptu Python.

--python-expr <expression>

Spustí daný výraz ako skript jazyka Python.

--python-console

Spustí Blender pomocou interaktívnej konzoly.

--python-exit-code <code>

Nastaví exit-code v [0..255] na ukončenie, ak sa vyskytne výnimka Pythonu (len pre skripty spustené z príkazového riadku), nula vypne.

--python-use-system-env

Povolí Pythonu používať systémové premenné prostredia, ako napríklad PYTHONPATH a priečinok site-packages užívateľa.

--addons <addon(s)>

Zoznam doplnkov oddelených čiarkou (bez medzier).

Možnosti záznamu

--log <match>

Povolenie kategórií záznau, pričom sa použije jeden argument oddelený čiarkou. Viac kategórií možno priradiť príponou .*, takže --log "wm.*" zaznamená každý druh správy správcu okien. Podreťazce môžu byť porovnávané použitím predpony a prípony *, takže --log "*undo*" zaznamená každý druh správy týkajúcej sa zrušenia. Na ignorovanie použite prefix „^“, takže --log "*,^wm.operator.*" zaznamená všetky okrem wm.operators.* Na záznam všetkého použite „*“.

--log-level <level>

Nastaví úrovne hovorovosti záznamu (vyššia pre viac informácií) predvolene 1, pre záznam všetkých úrovní použite -1.

--log-show-basename

Vo výstupe sa zobrazí iba názov súboru (nie vedúca cesta).

--log-show-backtrace

Zobrazí spätnú trasu pre každú správu záznamu (len pri ladení).

--log-show-timestamp

Zobrazí časovú pečiatku pre každú správu záznamu v sekundách od spustenia.

--log-file <filename>

Nastaví súbor, do ktorého sa má záznam zapisovať.

Možnosti ladenia

-d, --debug

Zapnutie ladenia.

  • Povolí detekciu chýb pamäte

  • Zakáže uchopenie myšou (v niektorých prípadoch na interakciu s ladiacim programom)

  • Zachováva príkaz Pythonu sys.stdin namiesto toho, aby ho nastavil na None

--debug-value <value>

Pri spustení nastaví ladiacu hodnotu <value> .

--debug-events

Povolí správy ladenia pre systém udalostí.

--debug-ffmpeg

Povolí správy ladenia z knižnice FFmpeg.

--debug-handlers

Povolí správy ladenia pre spracovanie udalostí.

--debug-libmv

Povolí správy ladenia z knižnice libmv.

--debug-cycles

Povolí správa ladenia z Cyklov.

--debug-memory

Povolí plne strážené prideľovanie pamäte a ladenia.

--debug-jobs

Povolí časové profilovanie pre úlohy na pozadí.

--debug-python

Povolí správy ladenia pre Python.

--debug-depsgraph

Povolí všetky správy ladenia z grafu závislostí.

--debug-depsgraph-eval

Povolí správy ladenia z grafu závislostí súvisiacich s vyhodnocovaním.

--debug-depsgraph-build

Povolí správy ladenia z grafu závislostí súvisiacich s konštrukciou grafu.

--debug-depsgraph-tag

Povolí správy ladenia zrafu závislostí týkajúcich sa označovania.

--debug-depsgraph-no-threads

Prepína graf závislostí na vyhodnocovanie v jednom vlákne.

--debug-depsgraph-time

Povolí správy ladenia z grafu závislostí týkajúcich sa časovania.

--debug-depsgraph-pretty

Povolí farby pre správy ladenia grafu závislostí.

--debug-depsgraph-uuid

Povolí správy ladenia z grafu závislostí súvisiacich s konštrukciou grafu.

--debug-ghost

Povolí správy ladenia pre spracovanie udalostí.

--debug-gpu

Povolí kontext ladenia GPU a informácií pre OpenGL 4.3+.

--debug-gpu-force-workarounds

Povolí riešenia typických problémov s GPU a vypne všetky rozšírenia GPU.

--debug-wm

Povolí správy ladenia pre správcu okien, zobrazenie všetkých operátorov vo vyhľadávaní, zobrazenie chýb v mape klávesov.

--debug-xr

Povolí správy ladenia pre kontexty virtuálnej reality. Zapína validačnú vrstvu API OpenXR, ladiace správy (OpenXR) a výpisy všeobecných informácií.

--debug-xr-time

Povolí správy ladenia pre časy prekreslenia snímok virtuálnej reality.

--debug-all

Povolí všetky správy ladenia.

--debug-io

Povolí správy ladenia pre I/O (Collada, …).

--debug-fpe

Povolí výnimky s pohyblivou desatinnou čiarkou.

--debug-exit-on-error

Okamžite ukončí pri zistení vnútorných chýb.

--disable-crash-handler

Zakáže obsluhu zrútenia.

--disable-abort-handler

Zakáže obsluhu prerušenia.

--verbose <verbose>

Nastaví úrovne hovorovosti záznamu pre správy ladenia, ktoré to podporujú.

Rôzne možnosti

--open-last

Otvorí naposledy otvorený blend-súbor namiesto predvoleného súboru pri spustení.

--app-template <template>

Nastaví šablónu aplikácie (zodpovedajúcu názvu priečinku), použite default (pôvodnú) pre žiadnu.

--factory-startup

Preskoč načítanie súboru startup.blend v domovskom priečinku užívateľa.

--enable-event-simulate

Povolí funkcie testovania simulácie udalostí bpy.types.Window.event_simulate.

--env-system-datafiles

Nastaví premennú prostredia BLENDER_SYSTEM_DATAFILES.

--env-system-scripts

Nastaví premennú prostredia BLENDER_SYSTEM_SCRIPTS.

--env-system-python

Nastaví premennú prostredia BLENDER_SYSTEM_PYTHON.

-noaudio

Vynúti zvukový systém na Žiadny.

-setaudio

Vynúti zvukový systém na konkrétne zariadenie. None SDL OpenAL CoreAudio JACK PulseAudio WASAPI.

-h, --help

Vytlačí tento text pomocníka a ukončí ho.

/?

Vytlačí tento text pomocníka a ukončite ho (len Windows).

-R

Zaregistruje príponu blend-súboru a ukončite ho (len pre systém Windows).

-r

V tichosti zaregistrujte rozšírenie blend-súboru a ukončí ho (len pre systém Windows).

-v, --version

Vytlačí verziu Blenderu a ukončí ho.

--

Ukončí spracovanie možnosti, nasledujúce argumenty sa odovzdajú nezmenené. Prístup cez sys.argv jazyka Python.

Ďalšie možnosti

--debug-freestyle

Povolí správa ladenia správ pre Voľný štýl.

Rozbor argumentov

Argumenty musia byť oddelené bielou medzerou, napr:

blender -ba test.blend

…sa ukončí, pretože -ba je neznámy argument.

Poradie argumentov

Argumenty sa vykonávajú v poradí, v akom sú zadané, napr:

blender --background test.blend --render-frame 1 --render-output '/tmp'

…nebude prekresľovať do /tmp, pretože --render-frame 1 prekresľuje pred nastavením výstupnej cesty.

blender --background --render-output /tmp test.blend --render-frame 1

…sa nebude prekresľovať do /tmp, pretože načítanie blend-súboru prepíše nastavený výstup prekreslenia.

blender --background test.blend --render-output /tmp --render-frame 1

…funguje podľa očakávania.

Premenné prostredia

BLENDER_USER_CONFIG

Priečinok pre konfiguračné súbory užívateľa.

BLENDER_USER_SCRIPTS

Priečinok pre užívateľské skripty.

BLENDER_SYSTEM_SCRIPTS

Priečinok pre systémové skripty.

BLENDER_USER_DATAFILES

Priečinok pre súbory s údajmi užívateľa (ikony, preklady, ..).

BLENDER_SYSTEM_DATAFILES

Priečinok pre súbory údajov celého systému.

BLENDER_SYSTEM_PYTHON

Priečinok pre systémové knižnice Pythonu.

OCIO

Cesta na prepísanie konfiguračného súboru OpenColorIO.

TEMP

Ukladá sem dočasné súbory.

TMP

alebo $TMPDIR Ukladá sem dočasné súbory.