Argumentos de la Línea de Comandos

Uso de Blender 2.91: blender [argumentos …] [archivo] [argumentos …]

Opciones de Render

-b, --background

Ejecuta en segundo plano (a menudo usado para renderizado sin IU).

-a, --render-anim

Rendereza fotogramas de inicio a fin (inclusivo).

-S, --scene <nombre>

Establece la escena activa <nombre> para renderizar.

-f, --render-frame <fotograma>

Renderiza el fotograma <fotograma> y lo guarda.

  • +<fotograma> fotograma inicial relativo, -<fotograma> fotograma final relativo.

  • También se puede usar una lista de fotogramas separados por comas (sin espacios).

  • Se puede indicar un rango de fotogramas usando un separador .. entre el primero y el último fotograma (inclusivo).

-s, --frame-start <fotograma>

Establece el inicio al fotograma <fotograma>, también soporta +/- para fotogramas relativos.

-e, --frame-end <fotograma>

Establece el final al fotograma <fotograma>, también soporta +/- para fotogramas relativos.

-j, --frame-jump <fotogramas>

Establece la cantidad de fotogramas a omitir tras cada fotograma renderizado.

-o, --render-output <ruta>

Establece la ruta de render y el nombre de archivo. Se utiliza // en el inicio de la ruta para especificar una ruta relativa al archivo blend.

Los caracteres # se reemplazan por el número de fotograma, y se usa para definir el relleno con ceros.

  • animacion_##_test.png se transforma en animacion_01_test.png

  • test-######.png se transforma en test-000001.png

Cuando el nombre de archivo no contiene #, se agrega el sufijo #### al nombre de archivo.

El número de fotograma se añadirá al final del nombre de archivo, por ejemplo:

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

//render_ se transforma en //render_####, escribiendo fotogramas como //render_0001.png

-E, --engine <motor>

Especifica el motor de render. Con -E se obtiene una lista de los motores disponibles.

-t, --threads <hilos>

Se usará la cantidad de <hilos> para renderizar y otras operaciones [1-64], 0 para obtener el número de procesadores del sistema.

Opciones de Formato

-F, --render-format <formato>

Establece el formato de render. Opciones válidas: TGA RAWTGA JPEG IRIS IRIZ AVIRAW AVIJPEG PNG BMP

Formatos que pueden compilarse en Blender, no disponibles en todos los sistemas: HDR TIFF OPEN_EXR OPEN_EXR_MULTILAYER MPEG CINEON DPX DDS JP2

-x, --use-extension <booleano>

Opción para agregar la extensión al final del nombre de archivo.

Opciones de Reproducción de Animación

-a <opciones> <archivo(s)>

En lugar de mostrar la interfaz de usuario de Blender, esto ejecuta Blender como un reproductor de animaciones, para ver películas y secuencias de imágenes renderizadas en Blender (ignorado si se indica -b).

Argumentos de Reproducción:

-p <sx> <sy>

Abre con la esquina inferior izquierda en <sx>, <sy>.

-m

Lee de disco (Sin búfer).

-f <fps> <fps-base>

Especifica los FPS para empezar.

-j <frame>

Establece el paso de fotogramas en <frame>.

-s <frame>

Reproduce desde <frame>.

-e <frame>

Reproduce hasta <frame>.

Opciones de Ventana

-w, --window-border

Fuerza la apertura con bordes.

-W, --window-fullscreen

Fuerza la apertura en modo de pantalla completa.

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

Abre con la esquina inferior izquierda en <sx>, <sy> y el ancho y alto en <w>, <h>.

-M, --window-maximized

Fuerza la apertura con la ventana maximizada.

-con, --start-console

Inicia con la ventana de la consola abierta (solo en Windows). Se ignora si se especifica -b.

--no-native-pixels

No se usará el tamaño nativo de píxel, para pantallas de alta resolución (MacBook Retina).

--no-window-focus

Abre detrás de otras ventanas y sin obtener el foco.

Opciones de Python

-y, --enable-autoexec

Habilita la ejecución automática de scripts de Python (por defecto).

-Y, --disable-autoexec

Deshabilita la ejecución automática de scripts de Python (pydrivers y scripts de inicio).

-P, --python <nombre_de_archivo>

Ejecuta el archivo script de Python dado.

--python-text <nombre>

Ejecuta el bloque de texto de script de Python.

--python-expr <expresión>

Ejecuta la expresión dada como un script de Python.

--python-console

Ejecuta Blender con una consola interactiva.

--python-exit-code <code>

Establece el código de salida en [0..255] para salir si se encuentra alguna excepción de Python (solo para scripts que se ejecutan desde la línea de comandos). El cero deshabilita.

--python-use-system-env

Permite a Python usar variables de entorno del sistema, tales como PYTHONPATH y el directorio site-packages del usuario.

--addons <addon(s)>

Lista de complementos separados por comas (sin espacios).

Opciones de Log

--log <match>

Habilita el logging de categorías, a partir de un único argumento separado por comas. Se pueden incluir múltiples categorías usando un sufijo .*, así --log "wm.*" registra en un log toda clase de mensajes de window-manager. Se utiliza el prefijo «^» para ignorar, así --log "*,^wm.operator.*" registra todo excepto wm.operator.*. Si se indica * se registra absolutamente todo.

--log-level <level>

Establece el nivel de verbosidad del logging (más alto para más detalles), por defecto 1, y con -1 se registran todos los niveles.

--log-show-basename

Muestra solo el nombre de archivo a la salida (sin la ruta precedente).

--log-show-backtrace

Muestra un back trace para cada mensaje de log (solo compilaciones de depuración).

--log-show-timestamp

Muestra un sello de tiempo para cada mensaje de log en segundos desde el inicio.

--log-file <nombre_de_archivo>

Establece un archivo donde registrar el log.

Opciones de Depuración

-d, --debug

Habilita la depuración.

  • Habilita la detección de errores de memoria

  • Deshabilita el arrastre con el ratón (para interactuar con el depurador en algunos casos)

  • Mantiene el sys.stdin de Python, en lugar de establecerlo en None

--debug-value <valor>

Establece el valor de depuración en <valor> al inicio.

--debug-events

Habilita los mensajes de depuración para el sistema de eventos.

--debug-ffmpeg

Habilita los mensajes de depuración de la librería FFmpeg.

--debug-handlers

Habilita los mensajes de depuración para el manejo de eventos.

--debug-libmv

Habilita los mensajes de depuración de la librería libmv.

--debug-cycles

Habilita los mensajes de depuración de Cycles.

--debug-memory

Habilita depuración y asignación completas de memoria protegida.

--debug-jobs

Habilita el perfilado de tiempo para trabajos en segundo plano.

--debug-python

Habilita los mensajes de depuración de Python.

--debug-depsgraph

Habilita todos los mensajes de depuración del dependency graph.

--debug-depsgraph-eval

Habilita los mensajes de depuración del dependency graph relacionados con la evaluación.

--debug-depsgraph-build

Habilita los mensajes de depuración del dependency graph relacionados con la construcción de grafos.

--debug-depsgraph-tag

Habilita los mensajes de depuración del dependency graph relacionados con el etiquetaje.

--debug-depsgraph-no-threads

Cambia el dependency graph a una evaluación de un solo hilo.

--debug-depsgraph-time

Habilita los mensajes de depuración del dependency graph relacionados con el tiempo.

--debug-depsgraph-pretty

Habilita los colores para los mensajes de depuración del dependency graph.

--debug-gpu

Habilita el contexto de depuración de GPU e información para OpenGL 4.3+.

--debug-gpumem

Habilita las estadísticas de memoria de GPU en la barra de estado.

--debug-gpu-shaders

Habilita las estadísticas de memoria de GPU en la barra de estado.

--debug-gpu-force-workarounds

Habilita las estadísticas de memoria de GPU en la barra de estado.

--debug-wm

Habilita los mensajes de depuración para el gestor de ventanas, muestra todos los operadores buscados, muestra errores de keymap.

--debug-xr

Habilita mensajes de depuración para contextos de realidad virtual. Habilita la capa de validación de la API OpenXR, mensajes de depuración (OpenXR) e impresiones de información general.

--debug-xr-time

Habilita los mensajes de depuración para tiempos de renderizado de fotogramas de realidad virtual.

--debug-all

Habilita todos los mensajes de depuración.

--debug-io

Habilita los mensajes de depuración de E/S (Collada,…).

--debug-fpe

Habilita las excepciones en punto flotante.

--disable-crash-handler

Deshabilita el manejador de bloqueos.

--disable-abort-handler

Deshabilita el manejador de abortos.

Opciones Misceláneas

--app-template <plantilla>

Establece la plantilla de la aplicación (coincidiendo con el nombre de directorio), con default para ninguna.

--factory-startup

Omite la lectura de startup.blend en el directorio «home» del usuario.

--enable-event-simulate

Habilita la característica de prueba de simulación de eventos bpy.types.Window.event_simulate.

--env-system-datafiles

Establece la variable de entorno BLENDER_SYSTEM_PYTHON.

--env-system-scripts

Establece la variable de entorno BLENDER_SYSTEM_PYTHON.

--env-system-python

Establece la variable de entorno BLENDER_SYSTEM_PYTHON.

-noaudio

Fuerza el sistema de sonido a None.

-setaudio

Fuerza el sistema de sonido a un dispositivo específico: NULL SDL OPENAL JACK.

-h, --help

Imprime este texto de ayuda y sale.

-R

Registra la extensión del archivo .blend, luego sale (solo en Windows).

-r

Registra la extensión de archivo de blender de forma silenciosa, luego se cierra (solo en Windows)

-v, --version

Imprime la versión de Blender y sale.

--

Finaliza el proceso de opciones, los siguientes argumentos pasan sin cambios. Acceso mediante sys.argv de Python.

Otras Opciones

/?

Imprime este texto de ayuda y sale (solo en Windows).

--debug-depsgraph-uuid

Habilita los mensajes de depuración del dependency graph relacionados con la construcción de grafos.

--debug-exit-on-error

Sale inmediatamente si se detectan errores internos.

--debug-freestyle

Habilita los mensajes de depuración para FreeStyle.

--debug-ghost

Habilita los mensajes de depuración para el manejo de eventos.

--verbose <verbose>

Establece el nivel de verbosidad de logging para los mensajes de depuración que lo soporten.

Análisis de Argumentos

Los argumentos deben estar separados por espacios en blanco, por ejemplo:

blender -ba test.blend

…se cerrará, pues -ba es un argumento desconocido.

Orden de los Argumentos

Los argumentos se ejecutan en el orden en el que son dados, por ejemplo:

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

…no renderizará a /tmp debido a que --render-frame 1 renderiza antes de que se establezca la ruta de salida.

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

…no renderizará a /tmp debido a que cargar el archivo blend sobreescribe la salida de render que se había establecido.

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

…funciona como se espera.

Variables de Entorno

BLENDER_USER_CONFIG

Directorio para los archivos de configuración de usuario.

BLENDER_USER_SCRIPTS

Directorio para los scripts del usuario.

BLENDER_SYSTEM_SCRIPTS

Directorio para scripts de todo el sistema.

BLENDER_USER_DATAFILES

Directorio para archivos de datos del usuario (iconos, traducciones, ..).

BLENDER_SYSTEM_DATAFILES

Directorio para los archivos de datos de todo el sistema.

BLENDER_SYSTEM_PYTHON

Directorio para las librerías de Python del sistema.

TEMP

Almacena los archivos temporales aquí.

TMP

(o $TMPDIR) Almacena archivos temporales aquí.

SDL_AUDIODRIVER

Driver de audio LibSDL - alsa, esd, dma.