Argumenty príkazového riadku

Blender 5.1
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 zakázané a možno ho znovu povoliť zadaním príkazu -setaudio 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.

V ceste môžete použiť funkcie šablónovania cesty, ako napríklad {blend_name}. Viac informácií nájdete v dokumentácii Blenderu o šablónach ciest.

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 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 v normálnom (nemaximalizovanom) stave.

-M, --window-maximized

Vynúti maximalizované otvorenie.

-W, --window-fullscreen

Vynúti otvorenie na celú obrazovku.

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

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

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

Zakáže všetky dekorácie okien (len Linux).

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

Výraz môže byť kompletný viacriadkový skript; obmedzený ste len maximálnou dĺžkou argumentu platformy.

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

Aktivuje kategórie protokolovania daním jediného argumentu oddeleného čiarkou.

--log "*": všetko --log "event": všetky kategórie začínajúce na event. --log "render,cycles": správy prekreslenia a Cycles. --log "*mesh*": všetky kategórie obsahujúce podreťazec mesh. --log "*,^operator": všetko okrem operátorov, s ^prefix na vylúčenie.

--log-level <level>

Nastaví úroveň podrobnosti záznamu.

fatal: Len fatálne chyby chýb: Len chyby varovania: Upozornenia info: Informácie o zariadeniach, súboroch, konfigurácii, operáciách ladenia: Podrobné správy sledovania pre vývojárov: Veľmi podrobné sledovanie vykonávania kódu

--log-show-memory

Zobrazí využitie pamäte pre každú správu záznamu.

--log-show-source

Zobrazí zdrojový súbor a názov funkcie vo výstupe.

--log-show-backtrace

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

--log-file <filepath>

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

--log-list-categories

Vypíše všetky dostupné kategórie protokolovania pre --log a skončí.

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

Povolí správy ladenia pre spracovanie udalostí.

--debug-libmv

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

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

Overí platnosť 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-shader-debug-info

Povolí generovanie informácií o ladení tieňovačov (len Vulkan).

--debug-gpu-scope-capture

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

--debug-gpu-shader-source

Uloží skompilovaný zdrojový kód GPU tieňovača pre daný názov tieňovača. Daný názov môže obsahovať úvodný alebo koncový zástupný znak „*“, aby zodpovedal viacerým tieňovačom. Súbory sa ukladajú do aktuálneho pracovného priečinka v priečinku s názvom „Shaders“.

--debug-gpu-shader-no-preprocessor

Preskočí preprocesor a namiesto toho sa spolieha na preprocesor ovládača alebo kompilátor tieňovačov. Takisto deaktivujte elimináciu mŕtveho kódu.

--debug-gpu-shader-no-dce

Preskočí fázu odstraňovania mŕtveho kódu.

--debug-gpu-no-texture-pool

Zakáže optimalizácie pamäte aliasingu v pamäti textúr GPU.

--debug-gpu-renderdoc

Povolí integráciu RenderDoc na zachytávanie snímok GPU a ladenie.

--debug-gpu-vulkan-local-read

Vynúti lokálne čítanie dynamického prekresľovania Vulkan, ak to zariadenie podporuje.

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

Povolenie ladiacich správ pre I/O.

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

--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, metal, opengl.

--gpu-vsync

Nastaví VSync (vertikálnu synchronizáciu). Platné možnosti sú: on (zap), off (vyp) a auto (automatické) pre adaptívnu synchronizáciu.

  • Predvolené nastavenia závisia od ovládača GPU.

  • Zakázanie VSync môže byť užitočné pri testovaní výkonu.

  • auto je podporované iba backendom OpenGL.

--gpu-compilation-subprocesses

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

--profile-gpu

Povolí profilovanie výkonu CPU a GPU pre ladiace skupiny GPU (Výstup súboru profile.json vo formáte Trace Event do aktuálneho priečinka)

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

--qos <level>

Nastaví režim Quality of Service (QoS) pre hybridné architektúry CPU (len Windows).

predvolene: Použije predvolené správanie operačného systému. high: Výlučne pre jadrá s vysokým výkonom eco: Naplánuje vlákna Blenderu výlučne na efektívne jadrá.

-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

--disable-depsgraph-on-file-load

Režim pozadia: Pri načítaní súboru na pozadí (voľby -b alebo -c) sa grafy závislostí Vrstiev zobrazenia systematicky nevytvárajú a nevyhodnocujú.

Skripty vyžadujúce vyhodnotené údaje potom musia explicitne zabezpečiť, aby bol k dispozícii vyhodnotený depsgraph (napr. volaním depsgraph = context.evaluated_depsgraph_get()).

POZNÁMKA: toto je dočasná možnosť, v budúcnosti sa depsgraf nikdy nebude automaticky generovať pri načítaní súboru v režime na pozadí.

--disable-liboverride-auto-resync

Pri načítaní nového blend-súboru nevykonáva automatickú opätovnú synchronizáciu prepisu knižnice.

POZNÁMKA: toto je alternatívny spôsob, ako dosiahnuť rovnaký efekt ako pri nastavení možnosti ladenia Bez automatickej opätovnej synchronizácie prepisu v používateľských predvoľbách.

--debug-ffmpeg

Povolí správa ladenia z vstupu videa a výstupu FFmpeg.

--debug-cycles

Povolí správa ladenia z Cycles.

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činky na pridanie ďalší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.

BLENDER_CUSTOM_SPLASH:

Úplná cesta k obrázku, ktorý nahradí úvodnú obrazovku.

BLENDER_CUSTOM_SPLASH_BANNER:

Úplná cesta k obrázku, ktorý sa má prekryť na úvodnej obrazovke.

BLENDER_OCIO:

Cesta na prepísanie konfiguračného súboru OpenColorIO. Ak nie je nastavená, použije sa premenná prostredia OCIO.

SPNAV_SOCKET:

Cesta k zásuvke pre pripojenie k démonickej 3D myši (len Unix).

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