Argumenty príkazového riadku

Blender 4.3
Použitie: 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).

Zvukové zariadenie je v režime na pozadí predvolene vypnuté a možno ho znovu zapnúť zadaním príkazu -setaudo Default.

-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 <vlákien> na prekreslenie a iné operácie [1-1024], 0 pre počet procesorov systému.

Možnosti prekreslenia mechanizmu Cycles

Doplnkové možnosti Cycles sa musia uvádzať za dvojitou pomlčkou.

--cycles-device <device>

Nastavenie zariadenia použitého na prekresľovanie. Platné možnosti sú: CPU CUDA OPTIX HIP ONEAPI METAL.

Pripojenie +CPU k zariadeniu GPU na prekresľovanie na CPU aj GPU.

Príklad:

blender -b file.blend -f 20 -- --cycles-device OPTIX
--cycles-print-stats

Záznam štatistík o využití pamäte a času prekresľovania.

Možnosti formátovania

-F, --render-format <format>

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

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

-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é spúšťanie skriptov Python.

-Y, --disable-autoexec

Zakáže automatické spúšťanie skriptov Python (ovládače Pythonu a spúšťače skriptov), (predvolené).

-P, --python <filepath>

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), ktoré sa majú povoliť okrem všetkých predvolených doplnkov.

Možnosti siete

--online-mode

Povolí prístup na internet, čím potlačí predvoľby.

--offline-mode

Zakáže prístup na internet, čím sa potlačí predvoľba.

Možnosti záznamu

--log <match>

Povolenie kategórií záznamu, 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 <filepath>

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 Cycles.

--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

Prepne 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-uid

Overenie platnosti identifikátorov celej relácie priradených k ID blokov údajov.

--debug-ghost

Povolí správy ladenia pre Ghost (len Linux).

--debug-wintab

Povolí správy ladenia pre Wintab.

--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-gpu-compile-shaders

Skompiluje všetky staticky definované tieňovače na otestovanie kompatibility s platformou.

--debug-gpu-scope-capture

Zachytenie príkazov GPU vydaných vnútri daného dosahu názvu.

--debug-gpu-renderdoc

Povolenie integrácie Renderdoc na zachytávanie snímok GPU a ladenie.

--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.

--debug-freestyle

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

--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ú.

-q, --quiet

Potlačiť tlač stavu (varovania a chyby sa stále tlačia).

Možnosti GPU

--gpu-backend

Vynúti použitie konkrétneho backendu GPU. Platné možnosti: vulkan``(experimentálne),  ``metal, opengl.

--gpu-compilation-subprocesses

Prepíše nastavenie maximálnej hodnoty podprocesov kompilácie (len pre OpenGL).

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

Vynechá čí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-extensions

Nastaví premennú prostredia BLENDER_SYSTEM_EXTENSIONS.

--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 Default SDL OpenAL CoreAudio JACK PulseAudio WASAPI.

-c, --command <command>

Spustí príkaz, ktorý spotrebuje všetky zostávajúce argumenty. Použitím príkazu -c help zobrazíte zoznam všetkých ostatných príkazov. Ak chcete zobraziť pomocný text príkazu, za príkazom zadajte --help.

To znamená režim --background.

-h, --help

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

/?

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

-r, --register

Zaregistruje príponu blend-súboru pre aktuálneho užívateľa a potom ho ukončí (len pre Windows a Linux).

--register-allusers

Zaregistruje príponu blend-súboru pre všetkých užívateľov a potom ich ukončí (len pre Windows a Linux).

--unregister

Zruší registráciu prípony blend-súboru pre aktuálneho užívateľa a ukončí ho (len pre Windows a Linux).

--unregister-allusers

Zruší registráciu prípony blend-súboru pre všetkých užívateľov a ukončí ho (len pre systém Windows a Linux).

-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.

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_RESOURCES:

Nahradí predvolený priečinok všetkých užívateľských súborov. Ostatné premenné BLENDER_USER_* sa po nastavení prepíšu.

BLENDER_USER_CONFIG:

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

BLENDER_USER_SCRIPTS:

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

BLENDER_USER_EXTENSIONS:

Priečinok pre užívateľské rozšírenia.

BLENDER_USER_DATAFILES:

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

BLENDER_SYSTEM_RESOURCES:

Nahradí predvolený priečinok všetkých pribalených zdrojových súborov.

BLENDER_SYSTEM_SCRIPTS:

Priečinok na pridanie ďalších pribalených skriptov.

BLENDER_SYSTEM_EXTENSIONS:

Priečinok pre úložisko rozšírení systému.

BLENDER_SYSTEM_DATAFILES:

Priečinok na nahradenie pribalených súborov údajov.

BLENDER_SYSTEM_PYTHON:

Priečinok na nahradenie pribalených knižníc Pythonu.

OCIO:

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

TEMP:

Ukladá sem dočasné súbory (MS-Windows).

TMPDIR:

Ukladá sem dočasné súbory (systémy UNIX). Cesta musí odkazovať na existujúci priečinok, inak bude ignorovaná.