Argumentos de la Línea de Comandos¶
Blender 2.80 Uso: blender [argumentos …] [archivo] [argumentos …]
Opciones de Render¶
-b,--background- Run in background (often used for UI-less rendering).
-a,--render-anim- Render frames from start to end (inclusive).
-S,--scene<nombre>- Set the active scene
<name>for rendering. -f,--render-frame<fotograma>Fotograma de render
<fotograma>y almacenarlo.+<fotograma>fotograma inicial relativo,-<fotograma>fotograma final relativo.- También se puede usar una lista de fotogramas clave separados por coma (sin espacios).
- A range of frames can be expressed using
..separator between the first and last frames (inclusive).
-s,--frame-start<fotograma>- Establecer el inicio al fotograma
<fotograma>, también soporta +/- para fotogramas relativos. -e,--frame-end<fotograma>- Establecer el final al fotograma
<fotograma>, también soporta +/- para fotogramas relativos. -j,--frame-jump<fotogramas>- Set number of frames to step forward after each rendered frame.
-o,--render-output<ruta>Establece la ruta de render y el nombre de archivo. Use
//en el inicio de la ruta para especificar una ruta de render relativa al archivo blend.Los caracteres
#se reemplazan por el número de fotograma, y se usa para definir el relleno con ceros.animation_##_test.pngbecomesanimation_01_test.pngtest-######.pngse transforma entest-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á en el final del nombre de archivo, ej:
blender -b animation.blend -o //render_ -F PNG -x 1 -a//render_se transforma en//render_####, escribiendo los fotogramas como//render_0001.png-E,--engine<motor>- Specify the render engine.
Use
-Ehelp to list available engines. -t,--threads<hilos>- Use amount of
<threads>for rendering and other operations [1-64], 0 for systems processor count.
Opciones de Formato¶
-F,--render-format<formato>Set the render format. Valid options are:
TGARAWTGAJPEGIRISIRIZAVIRAWAVIJPEGPNGBMPFormats that can be compiled into Blender, not available on all systems:
HDRTIFFOPEN_EXROPEN_EXR_MULTILAYERMPEGCINEONDPXDDSJP2-x,--use-extension<booleano>- Set option to add the file extension to the end of the file.
Opciones de Reproducción de Animación¶
-a<opciones><archivo(s)>Instead of showing Blender’s user interface, this runs Blender as an animation player, to view movies and image sequences rendered in Blender (ignored if
-bis set).Playback Arguments:
-p<sx><sy>- Open with lower left corner at
<sx>,<sy>. -m- Read from disk (Do not buffer).
-f<fps><fps-base>- Specify FPS to start with.
-j<frame>- Set frame step to
<frame>. -s<frame>- Play from
<frame>. -e<frame>- Play until
<frame>.
Opciones de Ventana¶
-w,--window-border- Force opening with borders.
-W,--window-fullscreen- Force opening in fullscreen mode.
-p,--window-geometry<sx><sy><w><h>- Open with lower left corner at
<sx>,<sy>and width and height as<w>,<h>. -M,--window-maximized- Force opening maximized.
-con,--start-console- Start with the console window open (ignored if
-bis set), (Windows only). --no-native-pixels- Do not use native pixel size, for high resolution displays (MacBook
Retina). --no-window-focus- Open behind other windows and without taking focus.
Opciones de Python¶
-y,--enable-autoexec- Enable automatic Python script execution (default).
-Y,--disable-autoexec- Disable automatic Python script execution (pydrivers & startup scripts).
-P,--python<nombre_de_archivo>- Run the given Python script file.
--python-text<nombre>- Run the given Python script text block.
--python-expr<expresión>- Run the given expression as a Python script.
--python-console- Run Blender with an interactive console.
--python-exit-code<code>- Establecer 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.
--addons<addon(s)>- Comma separated list of add-ons (no spaces).
Logging Options¶
--log<match>- Enable logging categories, taking a single comma separated argument.
Multiple categories can be matched using a
.*suffix, so--log "wm.*"logs every kind of window-manager message. Use «^» prefix to ignore, so--log "*,^wm.operator.*"logs all except forwm.operators.*Use «*» to log everything. --log-level<level>- Set the logging verbosity level (higher for more details) defaults to 1, use -1 to log all levels.
--log-show-basename- Only show file name in output (not the leading path).
--log-show-backtrace- Show a back trace for each log message (debug builds only).
--log-show-timestamp- Show a timestamp for each log message in seconds since start.
--log-file<filename>- Set a file to output the log to.
Opciones de Depuración¶
-d,--debugTurn debugging on.
- Habilita la detección de errores de memoria
- Deshabilita el arrastre del ratón (para interactuar con el depurador en algunos casos)
- Mantiene el
sys.stdinde Python, en lugar de establecerlo en None
--debug-value<valor>- Set debug value of
<value>on startup. --debug-events- Enable debug messages for the event system.
--debug-ffmpeg- Enable debug messages from FFmpeg library.
--debug-handlers- Enable debug messages for event handling.
--debug-libmv- Enable debug messages from libmv library.
--debug-cycles- Enable debug messages from Cycles.
--debug-memory- Enable fully guarded memory allocation and debugging.
--debug-jobs- Habilita el perfilado de tiempo para trabajos en segundo plano.
--debug-python- Enable debug messages for Python.
--debug-depsgraph- Enable all debug messages from dependency graph.
--debug-depsgraph-eval- Enable debug messages from dependency graph related on evaluation.
--debug-depsgraph-build- Enable debug messages from dependency graph related on graph construction.
--debug-depsgraph-tag- Enable debug messages from dependency graph related on tagging.
--debug-depsgraph-no-threads- Switch dependency graph to a single threaded evaluation.
--debug-depsgraph-time- Enable debug messages from dependency graph related on timing.
--debug-depsgraph-pretty- Enable colors for dependency graph debug messages.
--debug-gpu- Habilita el contexto de depuración de la GPU y la información para OpenGL 4.3+.
--debug-gpumem- Enable GPU memory stats in status bar.
--debug-gpu-shaders- Enable GPU memory stats in status bar.
--debug-gpu-force-workarounds- Enable GPU memory stats in status bar.
--debug-wm- Enable debug messages for the window manager, shows all operators in search, shows keymap errors.
--debug-all- Enable all debug messages.
--debug-io- Enable debug messages for I/O (collada, …).
--debug-fpe- Enable floating point exceptions.
--disable-crash-handler- Disable the crash handler.
--disable-abort-handler- Disable the abort handler.
Opciones misceláneas¶
--app-template<template>- Set the application template (matching the directory name), use
defaultfor none. --factory-startup- Skip reading the startup.blend in the user’s home directory.
--enable-library-override- Enable Library Override features in the UI.
--enable-event-simulate- Enable event simulation testing feature
bpy.types.Window.event_simulate. --env-system-datafiles- Set the
BLENDER_SYSTEM_DATAFILESenvironment variable. --env-system-scripts- Set the
BLENDER_SYSTEM_SCRIPTSenvironment variable. --env-system-python- Set the
BLENDER_SYSTEM_PYTHONenvironment variable. -noaudio- Force sound system to None.
-setaudio- Force sound system to a specific device.
NULLSDLOPENALJACK. -h,--help- Print this help text and exit.
-R- Register blend-file extension, then exit (Windows only).
-r- Silently register blend-file extension, then exit (Windows only).
-v,--version- Print Blender version and exit.
--- End option processing, following arguments passed unchanged. Access via Python’s
sys.argv.
Otras Opciones¶
/?- Print this help text and exit (windows only).
--debug-freestyle- Enable debug messages for Freestyle.
--verbose<verbose>- Establecer el nivel de registro de eventos
Análisis de argumentos¶
Los argumentos deben ser separados con espacios en blanco, ej:
blender -ba test.blend…will exit since
-bais an unknown argument.
Orden de los Argumentos¶
Los argumentos se ejecutan en el orden en el que son dados, ej:
blender --background test.blend --render-frame 1 --render-output '/tmp'…will not render to
/tmpbecause--render-frame 1renders before the output path is set.blender --background --render-output /tmp test.blend --render-frame 1…will not render to
/tmpbecause loading the blend-file overwrites the render output that was set.blender --background test.blend --render-output /tmp --render-frame 1…funciona como es de esperar.
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 (íconos, traducciones, ..) | |
| BLENDER_SYSTEM_DATAFILES: | |
| Directorio para los archivos de datos de todo el sistema | |
| BLENDER_SYSTEM_PYTHON: | |
| Directory for system Python libraries. | |
| TEMP: | Almacenar los archivos temporales aquí. |
| TMP: | o $TMPDIR Almacenar archivos temporales aquí. |
| SDL_AUDIODRIVER: | |
| Controlador de audio LibSDL - alsa, esd, dma. | |
| PYTHONHOME: | Path to the Python directory, eg. /usr/lib/python. |