Argumentos de la Línea de Comandos¶

Uso de Blender 2.92: 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-depsgraph-uuid

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

--debug-ghost

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

--debug-gpu

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

--debug-gpu-force-workarounds

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

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

Enable floating-point exceptions.

--debug-exit-on-error

Sale inmediatamente si se detectan errores internos.

--disable-crash-handler

Deshabilita el manejador de bloqueos.

--disable-abort-handler

Deshabilita el manejador de abortos.

--verbose <verbose>

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

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.
/?: Print this help text and exit (Windows only).
-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¶

--debug-freestyle: Habilita los mensajes de depuración para FreeStyle.

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