Arguments de línia d’ordres

5.3 de Blender

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

Opcions de revelat

-b, --background

Executa en segon pla (d’ús habitual per revelar sense la IU).

El dispositiu d’àudio està per defecte deshabilitat en mode segon pla i es pot tornar a habilitar passant-hi -setaudio Default posteriorment.

-a, --render-anim

Revela fotogrames de l’inicial al final (inclosos).

-S, --scene <name>

Determina l’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>

Posa l’inici al fotograma <frame>, admet +/- també per a fotogrames relatius.

-e, --frame-end <frame>

Posa el final al fotograma <frame>, admet +/- 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.

Per a la ruta, podeu utilitzar funcionalitats de plantillatge com ara {blend_name}. 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 encasellat 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>

Empra 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 amb Cycles

Les opcions de 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>

Activa 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, executa Blender com un reproductor d’animacions per visualitzar pel·lícules i seqüències d’imatges revelades a Blender (s’ignora si -b ja està posat).

Arguments de reproducció:

-p <sx> <sy>

Obre a la cantonada inferior esquerra a <sx>, <sy>.

-m

Llegeix des del disc (sense vàlvula).

-f <fps> <fps_base>

Especifica els FPS amb què començar.

-j <frame>

Determina el pas de fotograma a <frame>.

-s <frame>

Reprodueix des de <frame>.

-e <frame>

Reprodueix 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 (i aleshores ho reté a un nombre de fotogrames fix).

Opcions de finestra

-w, --window-border

Força l’obertura amb vores en un estat normal (no maximitzat).

-M, --window-maximized

Força l’obertura maximitzada.

-W, --window-fullscreen

Força l’obertura en pantalla completa.

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

Obre a la cantonada inferior esquerra a <sx>, <sy> i amplada i alçada com <w>, <h>.

-con, --start-console

Comença amb la finestra de consola oberta (s’ignora si s’ha posat -b), (sols Windows).

--no-native-pixels

No empra la mida nativa dels píxels, per a pantalles d’alta resolució (MacBook Retina).

--no-window-frame

Deshabilita totes les decoracions de finestra (sols Línux).

--no-window-focus

Obre darrere d’altres finestres i sense assumir el focus.

Opcions de python

-y, --enable-autoexec

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

L’expressió pot ser un protocol sencer multilínea; l’únic que us pot limitar és la llargada màxima d’arguments de la plataforma.

--python-console

Executa Blender amb una consola interactiva.

--python-exit-code <code>

Defineix el codi de sortida a [0..255] per a sortir si es produeix una excepció de python (sols en 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 de la usuària.

--addons <addon(s)>

Llista separada per comes (sense espais) de complements a habilitar a més dels complements 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": tota categoria que comenci per event. --log "render,cycles": tant missatges de revelat com de Cycles. --log "*mesh*": tota categoria que contingui mesh subcadena. --log "*,^operator": tot excepte operadors, amb ^prefix a excloure.

--log-level <level>

Determina el nivell de verbositat en el registre.

fatal: Només errors fatals: Avisos sols d’errors: Info d’avisos: Informació sobre dispositius, documents, configuració, operacions de depuració: Missatges verbosos de seguiment per a desenvolupadores: 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 en l’egressió el nom de la funció i el document d’origen.

--log-show-backtrace

Mostra una traça anterior 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ó.

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

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

--debug-handlers

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

--debug-libmv

Habilita els missatges de depuració de la biblioteca libmv.

--debug-memory

Habilita l’assignació de memòria plenament protegida i la depuració.

--debug-jobs

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

--debug-python

Habilita els missatges de depuració per a python.

--debug-depsgraph

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

--debug-depsgraph-eval

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

--debug-depsgraph-build

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

--debug-depsgraph-tag

Habilita 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

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

--debug-depsgraph-pretty

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

--debug-depsgraph-uid

Verifica la validesa dels identificadors a nivell de sessió sencera assignats als blocs de dades d’ID.

--debug-ghost

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

--debug-wintab

Habilita els missatges de depuració per al Wintab.

--debug-gpu

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

--debug-gpu-force-workarounds

Habilita 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-shader-source

Desa el codi font de l’aspecció de GPU compilada per a un nom d’aspector donat. El nom donat pot contenir un comodí «*» pel cap o per la cua per recollir múltiples aspectors. Els documents es desen en el directori de treball actual dins d’un directori anomenat «Shaders».

--debug-gpu-shader-no-preprocessor

Omet la passada de preprocessament i es recolza en un preprocessador de compilació d’aspecció. També deshabilita l’eliminació de codi mort.

--debug-gpu-shader-no-dce

Omet la passada d’eliminació de codi mort.

--debug-gpu-no-texture-pool

Deshabilita les optimitzacions de memòria d’aliàsing a la reserva de textura de la GPU.

--debug-gpu-renderdoc

Habilita 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

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

--debug-xr

Habilita 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

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

--debug-all

Habilita tots els missatges de depuració.

--debug-io

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

--debug-fpe

Habilita les excepcions de coma flotant.

--debug-exit-on-error

Surt immediatament quan es detecten errors interns.

--debug-freestyle

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

-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

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

• Sols OpenGL admet el basament auto.

--gpu-compilation-subprocesses

Sobreseu el paràmetre de Subprocessos de compilació màx (sols 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>

Configura la plantilla de l’aplicació (perquè 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

Imprimeix el text d’ajuda i surt.

/?

Imprimeix el text d’ajuda i surt (sols Windows).

-r, --register

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

--register-allusers

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

--unregister

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

--unregister-allusers

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

--qos <level>

Configura el mode de Qualitat de Servei (QoS) en arquitectures híbrides de CPU (sols Windows).

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

-v, --version

Imprimeix versió de Blender i surt.

--

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

Altres opcions

--disable-depsgraph-on-file-load

Mode de segon pla: no basteix ni avalua 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 una 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 executa 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 es configura 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

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

SPNAV_SOCKET:

La ruta del born per connectar el daemon del ratolí 3D (sols Unix).

TEMP:

Emmagatzema documents temporals aquí (MS-Windows).

TMPDIR:

Emmagatzema documents temporals aquí (Sistemes UNIX). La ruta ha de fer referència a un directori existent o serà ignorarada.