Argumentos de linha de comando¶
blender [args ...] [file] [args ...]
Opções de renderização¶
-b
,--background
Executa em plano de fundo (algumas vezes, utilizado para renderização sem interface de usuário).
The audio device is disabled in background-mode by default and can be re-enabled by passing in
-setaudio Default
afterwards.-a
,--render-anim
Renderiza os quadros do início ao final (de maneira inclusiva).
-S
,--scene
<nome>
Define a cena ativa pelo
<nome>
para renderização.-f
,--render-frame
<frame>
Render frame
<frame>
and save it.+<frame>
quadro relativo inicial,-<frame>
quadro relativo final.Uma lista de frames separada por vírgulas também pode ser utilizada (sem espaços).
Um espaço de frames pode ser expresso usando o separador
..
entre o primeiro e o último frame (de maneira inclusiva).
-s
,--frame-start
<frame>
Define o quadro inicial para
<quadro>
, suporta o uso de +/- adicionalmente para quadros relativos.-e
,--frame-end
<frame>
Define o quadro final para
<frame>
, suporta o uso de +/- adicionalmente para quadros relativos.-j
,--frame-jump
<frames>
Define o número de quadros a ser intercalados em salto após cada um dos quadros renderizados.
-o
,--render-output
<caminho>
Define o caminho de renderização e o nome de arquivo. Use
//
no início do caminho para renderizações relativas ao arquivo Blender.Os caracteres
#
são substituídos pelos números dos quadros, e usados para a definição de anexações de zeros.animation_##_test.png
se tornaanimation_01_test.png
test-######.png
se tornatest-000001.png
When the filename does not contain
#
, the suffix####
is added to the filename.O número do frame será adicionado ao final do nome de arquivo, por exemplo:
blender -b animation.blend -o //render_ -F PNG -x 1 -a
//render_
se torna//render_####
, escrevendo os quadros como//render_0001.png
-E
,--engine
<engine>
Specify the render engine. Use
-E help
to list available engines.-t
,--threads
<tarefas>
Use amount of
<threads>
for rendering and other operations [1-1024], 0 to use the systems processor count.
Cycles Render Options¶
Cycles add-on options must be specified following a double dash.
--cycles-device
<device>
Set the device used for rendering. Valid options are:
CPU
CUDA
OPTIX
HIP
ONEAPI
METAL
.Append +CPU to a GPU device to render on both CPU and GPU.
Example:
blender -b file.blend -f 20 -- --cycles-device OPTIX
--cycles-print-stats
Log statistics about render memory and time usage.
Opções de formato¶
-F
,--render-format
<formato>
Set the render format. Valid options are:
TGA
RAWTGA
JPEG
IRIS
AVIRAW
AVIJPEG
PNG
BMP
HDR
TIFF
.Formats that can be compiled into Blender, not available on all systems:
OPEN_EXR
OPEN_EXR_MULTILAYER
FFMPEG
CINEON
DPX
JP2
WEBP
.-x
,--use-extension
<valor booleano (0 ou 1)>
Define a opção de adicionar as extensões de arquivos no final dos mesmos.
Opções para reprodução das animações¶
-a
<opções>
<arquivo(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
-b
is set).Playback Arguments:
-p
<sx>
<sy>
Abre com a lateral inferior esquerda em
<sx>
,<sy>
.-m
Lê a partir do disco (Não utiliza buffer).
-f
<fps>
<fps_base>
Especifica uma quantidade de quadros por segundo (qps) com a qual iniciar.
-j
<frame>
Define o passo de quadros para
<quadro>
.-s
<frame>
Reproduz a partir do
<quadro>
.-e
<frame>
Reproduz até o
<frame>
.-c
<cache_memory>
Amount of memory in megabytes to allow for caching images during playback. Zero disables (clamping to a fixed number of frames instead).
Opções para a janela do aplicativo¶
-w
,--window-border
Força a abertura com bordas na janela do aplicativo.
-W
,--window-fullscreen
Force opening in full-screen mode.
-p
,--window-geometry
<sx>
<sy>
<w>
<h>
Abre com a lateral inferior esquerda em
<sx>
,<sy>
e com a largura e altura como definido em<w>
,<h>
.-M
,--window-maximized
Abertura de forçada maximizado.
-con
,--start-console
Comece com a janela do console aberta (ignored if
-b
is set), (somente Windows).--no-native-pixels
Não utiliza o tamanho de pixeis nativos, para monitores de alta resolução (Usado nos modelos MacBook com tela
Retina
).--no-window-focus
Open behind other windows and without taking focus.
Opções para a linguagem Python¶
-y
,--enable-autoexec
Enable automatic Python script execution.
-Y
,--disable-autoexec
Disable automatic Python script execution (Python-drivers & startup scripts), (default).
-P
,--python
<filepath>
Executa o arquivo de script Python fornecido.
--python-text
<nome>
Executa o bloco de texto de script Python fornecido.
--python-expr
<expressão>
Executa a expressão fornecida como um script Python.
--python-console
Executa o Blender com um console de linha de comando interativo.
--python-exit-code
<code>
Defina o código de saída em [0..255] para sair se uma exceção Python for levantada (somente para scripts executados a partir da linha de comando), zero desabilita.
--python-use-system-env
Allow Python to use system environment variables such as
PYTHONPATH
and the user site-packages directory.--addons
<addon(s)>
Comma separated list (no spaces) of add-ons to enable in addition to any default add-ons.
Network Options¶
--online-mode
Allow internet access, overriding the preference.
--offline-mode
Disallow internet access, overriding the preference.
Opções de Logging¶
--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. Sub-string can be matched using a*
prefix and suffix, so--log "*undo*"
logs every kind of undo-related message. Use «^» prefix to ignore, so--log "*,^wm.operator.*"
logs all except forwm.operators.*
Use «*» to log everything.--log-level
<level>
Defina o nível de verbosidade de registro (maior para mais detalhes) como padrão 1, use -1 para registrar todos os níveis.
--log-show-basename
Mostrar apenas o nome do arquivo na saída (não o caminho principal).
--log-show-backtrace
Mostrar um back trace para cada mensagem de log (apenas para depuração).
--log-show-timestamp
Show a timestamp for each log message in seconds since start.
--log-file
<filepath>
Set a file to output the log to.
Opções de depuração¶
-d
,--debug
Habilita a depuração.
Habilita a detecção de erros de memória
Inabilita a opção de agarrar com o mouse (para interação com um depurador em alguns casos)
Mantém a «sys.stdin» do Python ao invés de defini-la como None
--debug-value
<value>
Permite definir o valor de depuração especificado em
<valor>
durante a inicialização.--debug-events
Habilita as mensagens de depuração para o sistema de eventos.
--debug-ffmpeg
Habilita as mensagens de depuração a partir da biblioteca «FFmpeg».
--debug-handlers
Habilita as mensagens de depuração para a manipulação de eventos.
--debug-libmv
Habilita as mensagens de depuração a partir da biblioteca «libmv».
--debug-cycles
Habilita as mensagens de depuração do renderizador Cycles.
--debug-memory
Habilita a alocação de memória plenamente protegida e sua depuração.
--debug-jobs
Habilita o perfilamento de tempo para as tarefas em plano de fundo.
--debug-python
Habilita as mensagens de depuração para a linguagem Python.
--debug-depsgraph
Habilita as mensagens de depuração a partir do gráfico de dependências.
--debug-depsgraph-eval
Habilitar mensagens de debug do gráfico de dependência relacionadas à avaliação.
--debug-depsgraph-build
Habilita as mensagens de depuração a partir do gráfico de dependências.
--debug-depsgraph-tag
Habilita as mensagens de depuração a partir do gráfico de dependências.
--debug-depsgraph-no-threads
Alterna o gráfico de dependências para uma avaliação de única tarefa (mono-processada).
--debug-depsgraph-time
Habilitar mensagens de debug do gráfico de dependência relacionado ao tempo.
--debug-depsgraph-pretty
Habilitar cores para mensagens de depuração de gráficos de dependência.
--debug-depsgraph-uid
Verify validness of session-wide identifiers assigned to ID data-blocks.
--debug-ghost
Enable debug messages for Ghost (Linux only).
--debug-wintab
Enable debug messages for Wintab.
--debug-gpu
Enable GPU debug context and information for OpenGL 4.3+.
--debug-gpu-force-workarounds
Enable workarounds for typical GPU issues and disable all GPU extensions.
--debug-gpu-compile-shaders
Compile all statically defined shaders to test platform compatibility.
--debug-gpu-scope-capture
Capture the GPU commands issued inside the give scope name.
--debug-gpu-renderdoc
Enable RenderDoc integration for GPU frame grabbing and debugging.
--debug-wm
Habilita mensagens de debug para o gerenciador de janelas, mostra todos os operadores em busca, mostra erros de mapa de teclas.
--debug-xr
Enable debug messages for virtual reality contexts. Enables the OpenXR API validation layer, (OpenXR) debug messages and general information prints.
--debug-xr-time
Habilitar mensagens de debug para tempos de renderização de frames de realidade virtual.
--debug-all
Habilita todas as mensagens de depuração.
--debug-io
Enable debug messages for I/O (Collada, …).
--debug-fpe
Enable floating-point exceptions.
--debug-exit-on-error
Immediately exit when internal errors are detected.
--debug-freestyle
Habilita as mensagens de depuração para o renderizador Freestyle.
--disable-crash-handler
Desabilita o manipulador para quebras («crash handler»).
--disable-abort-handler
Desabilita o manipulador para encerramento de operações.
--verbose
<verbose>
Set the logging verbosity level for debug messages that support it.
-q
,--quiet
Suppress status printing (warnings & errors are still printed).
GPU Options¶
--gpu-backend
Force to use a specific GPU backend. Valid options:
vulkan
(experimental),metal
,opengl
.--gpu-compilation-subprocesses
Override the Max Compilation Subprocesses setting (OpenGL only).
Opções diversas¶
--open-last
Open the most recently opened blend file, instead of the default startup file.
--app-template
<template>
Set the application template (matching the directory name), use
default
for none.--factory-startup
Skip reading the
startup.blend
in the users home directory.--enable-event-simulate
Enable event simulation testing feature
bpy.types.Window.event_simulate
.--env-system-datafiles
Define a variável de ambiente
BLENDER_SYSTEM_PYTHON
.--env-system-scripts
Define a variável de ambiente
BLENDER_SYSTEM_PYTHON
.--env-system-extensions
Set the
BLENDER_SYSTEM_EXTENSIONS
environment variable.--env-system-python
Define a variável de ambiente
BLENDER_SYSTEM_PYTHON
.-noaudio
Força o sistema de áudio para nenhum (NULL).
-setaudio
Force sound system to a specific device.
None
Default
SDL
OpenAL
CoreAudio
JACK
PulseAudio
WASAPI
.-c
,--command
<command>
Run a command which consumes all remaining arguments. Use
-c help
to list all other commands. Pass--help
after the command to see its help text.This implies
--background
mode.-h
,--help
Imprime este texto de ajuda e encerra.
/?
Print this help text and exit (Windows only).
-r
,--register
Register blend-file extension for current user, then exit (Windows & Linux only).
--register-allusers
Register blend-file extension for all users, then exit (Windows & Linux only).
--unregister
Unregister blend-file extension for current user, then exit (Windows & Linux only).
--unregister-allusers
Unregister blend-file extension for all users, then exit (Windows & Linux only).
-v
,--version
Imprime a versão do Blender e encerra.
--
Encerra o processamento das opções, e os argumentos seguintes são passados inalterados. O acesso pode ser feito via Python através da lista
sys.argv
.
Other Options¶
--disable-depsgraph-on-file-load
Backround mode: Do not systematically build and evaluate ViewLayers” dependency graphs when loading a blendfile in background mode (-b or -c options).
Scripts requiring evaluated data then need to explicitly ensure that an evaluated depsgraph is available (e.g. by calling depsgraph = context.evaluated_depsgraph_get()).
NOTE: this is a temporary option, in the future depsgraph will never be automatically generated on file load in background mode.
--disable-liboverride-auto-resync
Do not perform library override automatic resync when loading a new blendfile.
NOTE: this is an alternative way to get the same effect as when setting the No Override Auto Resync User Preferences Debug option.
Passagem de argumentos¶
Argumentos devem ser separados por espaços em branco, por exemplo:
blender -ba test.blend
…will exit since -ba
is an unknown argument.
Ordem dos argumentos¶
Os argumentos são executados na ordem em que são fornecidos, por exemplo:
blender --background test.blend --render-frame 1 --render-output "/tmp"
…não irá renderizar para a pasta /tmp
pois a opção --render-frame 1
renderiza antes do caminho de saída ser definido.
blender --background --render-output /tmp test.blend --render-frame 1
…não irá renderizar para a pasta /tmp
pois o carregamento do arquivo Blender irá sobrescrever a saída de renderização que foi previamente definida.
blender --background test.blend --render-output /tmp --render-frame 1
…funciona como esperado.
Variáveis de ambiente¶
- BLENDER_USER_RESOURCES:
Replace default directory of all user files. Other
BLENDER_USER_*
variables override when set.- BLENDER_USER_CONFIG:
Diretório para arquivos de configuração do usuário.
- BLENDER_USER_SCRIPTS:
Diretório para scripts de usuário.
- BLENDER_USER_EXTENSIONS:
Directory for user extensions.
- BLENDER_USER_DATAFILES:
Diretório para arquivos de dados do usuário (ícones, traduções, etc…)
- BLENDER_SYSTEM_RESOURCES:
Replace default directory of all bundled resource files.
- BLENDER_SYSTEM_SCRIPTS:
Directories to add extra scripts.
- BLENDER_SYSTEM_EXTENSIONS:
Directory for system extensions repository.
- BLENDER_SYSTEM_DATAFILES:
Directory to replace bundled datafiles.
- BLENDER_SYSTEM_PYTHON:
Directory to replace bundled Python libraries.
- BLENDER_CUSTOM_SPLASH:
Full path to an image that replaces the splash screen.
- BLENDER_CUSTOM_SPLASH_BANNER:
Full path to an image to overlay on the splash screen.
- OCIO:
Path to override the OpenColorIO configuration file.
- TEMP:
Store temporary files here (MS-Windows).
- TMPDIR:
Store temporary files here (UNIX Systems). The path must reference an existing directory or it will be ignored.