Arguments de línia d’ordres¶

5.0 de Blender

Ú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à per defecte deshabilitat en mode segon pla i es pot tornar a habilitar-se passant-hi -setaudio 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>

Consigna 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 del revelat i el nom de document. Utilitzeu // al principi de la ruta de revelat relativa a la del document blend.

Podeu utilitzar funcionalitats de plantillatge com ara {blend_name} a la ruta. Vegeu la documentació de Blender sobre plantilles de rutes per més detalls.

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 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: Deshabilita 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 com a protocol de 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>

Habilita categories de registre i assumeix un argument separat per una única coma.

--log "*": tot --log "event": cada categoria que comenci per event. --log "render,cycles": tant missatges de revelat com de cycles. --log "*mesh*": cada categoria que contingui mesh subcadena. --log "*,^operator": tot excepte operadors, amb ^prefix a excloure.

--log-level <level>

Determina el nivell verbositat en registrar.

fatal: Només errors fatals: Avís només d’errors: Info d’avisos: Informació sobre dispositius, documents configuració, operacions de depuració: Missatges verbosos de pistes per a desenvolupadors: Seguiment d’execució de codi molt verbós

--log-show-memory

Mostra l’ús de la memòria per a cada missatge de registre.

--log-show-source

Mostra el nom de la funció i el document d’origen en l’egressió.

--log-show-backtrace

Mostra una traça posterior per a cada missatge de registre (només compilacions de depuració).

--log-file <filepath>

Defineix un document on egressar els registres.

--log-list-categories

Llista totes les categories de registre disponibles per a --log i surt.

Opcions de depuració¶

-d, --debug

Activa la depuració.

Activa la detecció d’errors de memòria
Deshabilita 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-handlers

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

--debug-libmv

Activa els missatges de depuració de la biblioteca libmv.

--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 deshabilita 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-shader-debug-info

Habilita la generació d’info de depuració d’aspectors (només Vulkan).

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

--debug-gpu-vulkan-local-read

Força la lectura local de revelat dinàmic de Vulkan si el dispositiu ho admet.

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

Habilita missatges de depuració per a la I/E.

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

Deshabilita el gestor de fallides.

--disable-abort-handler

Deshabilita el gestor d’avortaments.

--verbose <verbose>

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

-q, --quiet

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

Opcions de GPU¶

--gpu-backend

Força l’ús d’un basament específic de GPU. Opcions vàlides: vulkan, metal, opengl.

--gpu-vsync

Determina el VSync. Les opcions vàlides són: on, off i auto per al sincronitzat adaptatiu.

La configuració per defecte depèn del controlador de la GPU.
Deshabilitar VSync pot ser útil per a testejar el rendiment.
Només OpenGL admet el basament auto.

--gpu-compilation-subprocesses

Sobreseu el paràmetre de Subprocessos de compilació màx (només OpenGL).

--profile-gpu

Habilita els perfils de rendiment de CPU i GPU per als grups de depuració de la GPU (Egressa un docunent profile.json en Format de seguiment d’episodis al directori actual)

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

--qos <level>

Determina el mode de Qualitat de Servei (QoS) en arquitectures híbrides de CPU (només Windows).

per defecte: utilitza el comportament predeterminat del SO. Alt: sempre fa ús dels nuclis de rendiment. Eco: Programa els fils de Blender exclusivament a nuclis d’eficiència.

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

Altres opcions¶

--disable-depsgraph-on-file-load

Mode de segon pla: no bastiu ni avalueu sistemàticament les gràfiques de dependència de Capes de visionat en carregar un document blend en mode de segon pla (opcions -b o -c).

Els protocols que requereixen dades avaluades aleshores necessiten assegurar-se explícitament que hi ha disponible un gràfica de dependència avaluada (p. ex. invocant depsgraph = context.evaluated_depsgraph_get()).

NOTA: aquesta és una opció temporal. En el futur, la gràfica de dependències mai no es generarà automàticament en carregar el document en mode en segon pla.

--disable-liboverride-auto-resync

No activeu el resincronitzat automàtic de sobreseïments de biblioteca en carregar un nou document blend.

NOTA: aquesta és una manera alternativa d’obtenir el mateix efecte que quan s’activa l’opció de Depuració de Preferències d’usuària No Override Auto Resync.

--debug-ffmpeg

Habilita els missatges de depuració de la ingressió i egressió de vídeo FFmpeg.

--debug-cycles

Activa els missatges de depuració de Cycles.

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 integrats.
BLENDER_SYSTEM_SCRIPTS:: Directoris on afegir protocols suplementaris.
BLENDER_SYSTEM_EXTENSIONS:: Directori per al repositori d’extensions del sistema.
BLENDER_SYSTEM_DATAFILES:: Directori per substituir documents de dades integrats.
BLENDER_SYSTEM_PYTHON:: Directori per substituir les biblioteques Python integrades.
BLENDER_CUSTOM_SPLASH:: La ruta completa a una imatge que substitueix la careta d’inici.
BLENDER_CUSTOM_SPLASH_BANNER:: Ruta completa a una imatge per sobreimprimir a la careta d’inici.
BLENDER_OCIO:: Ruta per sobreseure la configuració de document OpenColorIO. Si no n’hi ha cap, es fa servir la variable d’entorn OCIO.
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.