Arguments de línia d’ordres¶

Blender 4.3

Ús: blender [args ...] [file] [args ...]

Opcions de revelat¶

-b, --background

Executa en segon pla (sovint s’utilitza per revelats sense IU).

El dispositiu d’àudio està desactivat per defecte en mode segon pla i es pot tornar a activar passant-hi ``-setaudo Default``posteriorment.

-a, --render-anim

Revelar fotogrames d’inicial a final (inclosos).

-S, --scene <name>

Definir escena activa <name> per al revelat.

-f, --render-frame <frame>

Revela el fotograma <frame> i el desa.

+<frame> fotograma d’inici relatiu, -<frame> fotograma final relatiu.
També es pot utilitzar una llista de fotogrames separats per comes (sense espais).
Un interval de fotogrames es pot expressar amb el separador .. entre el primer i l’últim fotograma (inclosos).

-s, --frame-start <frame>

Determina l’inici al fotograma``<frame>``, accepta +/- també per a fotogrames relatius.

-e, --frame-end <frame>

Determina el final al fotograma``<frame>``, accepta +/- també per a fotogrames relatius.

-j, --frame-jump <frames>

Determina el nombre de fotogrames a avançar després de cada fotograma revelat.

-o, --render-output <path>

Determina la ruta de revalat i i el nom de document. Utilitzeu ``//``al principi de la ruta per a revelat relatiu al del document blend.

Els caràcters # se substitueixen pel número de fotograma, i s’utilitzen per definir un arrastellament zero.

animation_##_test.png esdevé animation_01_test.png
test-######.png esdevé test-000001.png

Quan el nom del document no conté #, s’afegeix el sufix ``####``al nom del document.

El número de fotograma s’afegirà al final del nom de document, p. ex.:

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

//render_ esdevé //render_####, i escriu els fotogrames com a //render_0001.png

-E, --engine <engine>

Especifica el motor de revelat. Utilitzeu -E help per a llistar els motors disponibles.

-t, --threads <threads>

Empreu la quantitat de <threads> per al revelat i altres operacions [1-1024], 0 perquè s’usi el recompte de processadors del sistema.

Opcions de revelat a Cycles¶

Les opcions del complement de Cycles s’han d’especificar després d’un doble guionet.

--cycles-device <device>

Determina el dispositiu utilitzat per al revelat. Les opcions vàlides són: CPU CUDA OPTIX HIP ONEAPI METAL.

Incorporar +CPU a un dispositiu GPU per revelar tant a la CPU com a la GPU.

Exemple:

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

--cycles-print-stats

Registra estadístiques d’ús de memòria i temps de revelat.

Opcions de format¶

-F, --render-format <format>

Determina el format de revelat. Les opcions vàlides són: TGA RAWTGA JPEG IRIS AVIRAW AVIJPEG PNG BMP HDR TIFF.

Formats que es poden compilar a Blender, no disponibles a tots els sistemes: OPEN_EXR OPEN_EXR_MULTILAYER FFMPEG CINEON DPX JP2 WEBP.

-x, --use-extension <bool>

Activeu l’opció d’afegir l’extensió del document al final del document.

Opcions de reproducció d’animació¶

-a <options> <file(s)>

En lloc de mostrar la interfície d’usuària de Blender, això executa Blender com un reproductor d’animacions, per visualitzar pel·lícules i seqüències d’imatges revelades en Blender (ignorat si -b ja està definida).

Arguments de reproducció:

-p <sx> <sy>: Obre amb la cantonada inferior esquerra a <sx>, <sy>.
-m: Llegir des de disc (No dosificar).
-f <fps> <fps_base>: Especificar FPS per començar.
-j <frame>: Definir pas de fotograma a <frame>.
-s <frame>: Reproduir des de <frame>.
-e <frame>: Reproduir fins a <frame>.
-c <cache_memory>: Quantitat de memòria en megabytes per a permetre l’emmagatzematge en memòria cau de les imatges durant la reproducció. El zero inhabilita (en comptes d’això, reté a un nombre de fotogrames fix).

Opcions de finestra¶

-w, --window-border: Força l’obertura amb vores.
-W, --window-fullscreen: Força l’obertura en mode de pantalla completa.
-p, --window-geometry <sx> <sy> <w> <h>: Obrir amb el cantó de baix a l’esquerra a <sx>, <sy> i amplada i alçada com <w>, <h>.
-M, --window-maximized: Força l’obertura maximitzada.
-con, --start-console: Comença amb la finestra de consola oberta (s’ignora si s’ha posat -b), (només Windows).
--no-native-pixels: No utilitzeu la mida nativa dels píxels, per a pantalles d’alta resolució (MacBook Retina).
--no-window-focus: Obre darrere d’altres finestres i sense agafar el focus.

Opcions de Python¶

-y, --enable-autoexec: Activa l’execució automàtica de protocols de Python.
-Y, --disable-autoexec: Desactiva l’execució automàtica de protocols de Python (Protocols d’inici i controladors de Python), (per defecte).
-P, --python <filepath>: Executa el document de protocol Python indicat.
--python-text <name>: Executa el bloc de text indicat de protocol en Python.
--python-expr <expression>: Executa l’expressió indicada com a protocol de Python.
--python-console: Executa Blender amb una consola interactiva.
--python-exit-code <code>: Definir el codi de sortida a [0..255] per a sortir si es produeix una excepció de Python (només per als protocols executats des de la línia d’ordres), el zero inhabilita.
--python-use-system-env: Permet a Python d’utilitzar variables d’entorn del sistema com ara PYTHONPATH i el directori de paquets del lloc da la usuària.
--addons <addon(s)>: Llista separada per comes (sense espais) de complements per habilitar a més de qualsevol complement per defecte.

Opcions de xarxa¶

--online-mode: Permet l’accés a Internet, tot sobreseient la preferència.
--offline-mode: Desactiva l’accés a Internet, tot sobreseient la preferència.

Opcions de registre¶

--log <match>: Activa les categories de registre, prenent un sol argument separat per comes. Es pot assimilar a múltiples categories utilitzant un sufix .* , de manera que --log "wm.*" registri tots els tipus de missatges del gestor de finestres. Es pot assimilar la subcadena amb un prefix i sufix *, de manera que --log "*undo*"``registri tots els tipus de missatges relacionats amb desfer. Utilitzeu el prefix "^" per a ignorar, de manera que ``--log "*,^wm.operator.*" ho registri tot excepte wm.operators.* Empreu «*» per a registrar-ho tot.
--log-level <level>: Determina el nivell de detall del registre (més alt per a més detalls) per defecte a 1, useu -1 per a registrar tots els nivells.
--log-show-basename: Mostra només el nom del document en l’egressió (no el camí inicial).
--log-show-backtrace: Mostra una traça posterior per a cada missatge de registre (només compilacions de depuració).
--log-show-timestamp: Mostra una llegenda de temps en segons per a cada missatge de registre des de l’inici.
--log-file <filepath>: Defineix un document on egressar els registres.

Opcions de depuració¶

-d, --debug

Activa la depuració.

Activa la detecció d’errors de memòria
Desactiva la captura amb ratolí (per interactuar amb un depurador en alguns casos)
Manté el sys.stdin de python preferiblement a deixar el paràmetre a «no-cap»

--debug-value <value>

Determina el valor de depuració <value> en iniciar.

--debug-events

Activa els missatges de depuració per al sistema d’episodis.

--debug-ffmpeg

Activa els missatges de depuració de la biblioteca FFmpeg.

--debug-handlers

Activa els missatges de depuració per a la gestió d’episodis.

--debug-libmv

Activa els missatges de depuració de la biblioteca libmv.

--debug-cycles

Activa els missatges de depuració de Cycles.

--debug-memory

Activa l’assignació i depuració de memòria íntegrament vigilades.

--debug-jobs

Activa el perfilat de temps per a tasques en segon pla.

--debug-python

Activa els missatges de depuració per a Python.

--debug-depsgraph

Activa tots els missatges de depuració des de la gràfica de dependències.

--debug-depsgraph-eval

Activa els missatges de depuració de la gràfica de dependències relacionats amb l’avaluació.

--debug-depsgraph-build

Activa els missatges de depuració de la gràfica de dependències relacionats amb la construcció de la gràfica.

--debug-depsgraph-tag

Activa els missatges de depuració de la gràfica de dependències relacionats amb l’etiquetatge.

--debug-depsgraph-no-threads

Canvia la gràfica de dependències a una única avaluació a restos [threaded].

--debug-depsgraph-time

Activa els missatges de depuració des de la gràfica de dependències relacionats amb el temps.

--debug-depsgraph-pretty

Activa els colors per als missatges de depuració de gràfiques de dependències.

--debug-depsgraph-uid

Verifica la validesa dels identificadors de sessió sencera assignats als blocs de dades ID.

--debug-ghost

Activa els missatges de depuració per a Ghost (només Linux).

--debug-wintab

Activa els missatges de depuració per al Wintab.

--debug-gpu

Activa el context i la informació de depuració de la GPU per a l’OpenGL 4.3+.

--debug-gpu-force-workarounds

Activa les circumsolucions per als típics problemes de la GPU i desactiva totes les extensions de la GPU.

--debug-gpu-compile-shaders

Compila tots els aspectors definits estàticament per posar a prova la compatibilitat de la plataforma.

--debug-gpu-scope-capture

Captura les ordres de GPU emeses des de dins de «give scope name».

--debug-gpu-renderdoc

Activa la integració del Renderdoc per a la captura i depuració de fotogrames de la GPU.

--debug-wm

Activa els missatges de depuració per al gestor de finestres, mostra tots els operadors en la cerca, mostra els errors de teclari.

--debug-xr

Activa els missatges de depuració per a contextos de realitat virtual. Activa la capa de validació de l’API OpenXR, els missatges de depuració (OpenXR) i les impressions d’informació general.

--debug-xr-time

Activa els missatges de depuració per als temps de revelat dels fotogrames de realitat virtual.

--debug-all

Activa tots els missatges de depuració.

--debug-io

Activa missatges de depuració per a E/S (Collada, …).

--debug-fpe

Activa les excepcions de coma flotant.

--debug-exit-on-error

Surt immediatament quan es detecten errors interns.

--debug-freestyle

Activa els missatges de depuració per al Freestyle.

--disable-crash-handler

Desactiva el gestor de fallides.

--disable-abort-handler

Desactiva el gestor d’avortaments.

--verbose <verbose>

Estableix el nivell de detall del registre per als missatges de depuració que ho suporten.

-q, --quiet

impedeix la impressió de l’estatus (els avisos i errors s’imprimeixen igualment).

Opcions de GPU¶

--gpu-backend: Força l’ús d’un basament GPU específic. Opcions vàlides:vulkan (experimental), metal, opengl.
--gpu-compilation-subprocesses: Sobreseu el paràmetre de Subprocessos de compilació màx (només OpenGL).

Opcions diverses¶

--open-last

Obre el document blend més recent en lloc del document d’inici predeterminat.

--app-template <template>

Defineix la plantilla de l’aplicació (que coincideixi amb el nom del directori), utilitzeu default per a no-cap.

--factory-startup

Omet llegir el startup.blend al directori d’inici de les usuàries.

--enable-event-simulate

Habilita la funcionalitat de prova de simulació d’episodis bpy.types.Window.event_simulate.

--env-system-datafiles

Consigna la variable d’entorn BLENDER_SYSTEM_DATAFILES.

--env-system-scripts

Consigna la variable d’entorn BLENDER_SYSTEM_SCRIPTS.

--env-system-extensions

Consigna la variable d’entorn BLENDER_SYSTEM_EXTENSIONS.

--env-system-python

Consigna la variable d’entorn BLENDER_SYSTEM_PYTHON.

-noaudio

Força el sistema de so a no-cap.

-setaudio

Força el sistema de so a un dispositiu específic. None Default SDL OpenAL CoreAudio JACK PulseAudio WASAPI.

-c, --command <command>

Executa una ordre que consumeix tots els arguments restants. Utilitzeu -c help per a llistar totes les altres ordres. Passeu --help després de l’ordre per a veure’n el text d’ajuda.

Això implica el mode ``–background`.

-h, --help

Imprimir el text d’ajuda i sortir.

/?

Imprimir el text d’ajuda i sortir (només Windows).

-r, --register

Registra l’extensió de document blend per a la usuària actual i després surt (només Windows i Linux).

--register-allusers

Registra l’extensió de document blend per a totes les usuàries i després surt (només Windows i Linux).

--unregister

Desregistra l’extensió de document blend per a la usuària actual i després surt (només Windows i Linux).

--unregister-allusers

Desregistra l’extensió de document blend per a totes les usuàries i després surt (només Windows i Linux).

-v, --version

Imprimeix versió de Blender i surt.

--

Finalitza el processament d’opcions, els arguments següents s’han passat sense canvis. Accediu-hi via sys.argv de Python.

Anàlisi d’arguments¶

Els arguments han d’estar separats per espais en blanc, p. ex.:

blender -ba test.blend

…sortirà perquè -ba és un argument desconegut.

Ordre d’arguments¶

Els arguments s’executen en l’ordre en què s’entren. p. ex.:

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

…no es revelarà a /tmp perquè``–render-frame 1``es revela abans que es defineixi la ruta d’egressió.

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

…no es revelarà a /tmp perquè en carregar el document blend se sobrescriu l’egressió de revelat que s’havia definit.

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

…funciona com s’esperava.

Variables d’entorn¶

BLENDER_USER_RESOURCES:: Substitueix el directori per defecte de tots els documents d’usuària. Altres variables BLENDER_USER_* ho sobreseuen si estan definides.
BLENDER_USER_CONFIG:: Directori per a documents de configuració d’usuària.
BLENDER_USER_SCRIPTS:: Directori per als protocols d’usuària.
BLENDER_USER_EXTENSIONS:: Directori per als protocols d’usuària.
BLENDER_USER_DATAFILES:: Directori per als documents de dades d’usuària (icones, traduccions, ..).
BLENDER_SYSTEM_RESOURCES:: Substitueix el directori predeterminat de tots els documents de recursos agregats.
BLENDER_SYSTEM_SCRIPTS:: Directori per afegir més protocols incorporats.
BLENDER_SYSTEM_EXTENSIONS:: Directori per al repositori d’extensions del sistema.
BLENDER_SYSTEM_DATAFILES:: Directori per substituir documents de dades incorporats.
BLENDER_SYSTEM_PYTHON:: Directori per substituir les biblioteques Python incorporades.
OCIO:: Ruta per sobreseure la configuració de document OpenColorIO.
TEMP:: Emmagatzemeu documents temporals aquí (MS-Windows).
TMPDIR:: Emmagatzemeu documents temporals aquí (Sistemes UNIX). La ruta ha de fer referència a un directori existent o serà ignorarada.