Argumenty príkazového riadku#

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

-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

When the filename does not contain #, The suffix #### is added to the filename.

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

Use amount of <threads> for rendering and other operations [1-1024], 0 for systems processor count.

Možnosti prekreslenia mechanizmu Cykly#

Doplnkové možnosti Cyklov 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 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 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

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

Možnosti GPU#

--gpu-backend: Vynúti použitie konkrétneho backendu GPU. Platné možnosti: vulkan``(experimentálne), ``metal, 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-python: Nastaví premennú prostredia BLENDER_SYSTEM_PYTHON.
-noaudio: Vynúti zvukový systém na Žiadny.
-setaudio: Force sound system to a specific device. 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, --register: Register blend-file extension for current user, then exit (Windows only).
--register-allusers: Register blend-file extension for all users, then exit (Windows only).
--unregister: Unregister blend-file extension for current user, then exit (Windows only).
--unregister-allusers: Unregister blend-file extension for all users, then exit (Windows only).
-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:: Priečinok najvyššej úrovne pre užívateľské súbory. (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_DATAFILES:: Priečinok pre súbory s údajmi užívateľa (ikony, preklady, ..).
BLENDER_SYSTEM_RESOURCES:: Priečinok najvyššej úrovne pre systémové súbory. (ostatné premenné ‚‘BLENDER_SYSTEM_*‘‘ sa prepíšu, keď sú nastavené).
BLENDER_SYSTEM_SCRIPTS:: Priečinok pre systémové skripty.
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 (MS-Windows).
TMPDIR:: Ukladá sem dočasné súbory (systémy UNIX). Cesta musí odkazovať na existujúci priečinok, inak bude ignorovaná.