Argumentos de linha de comando¶

Blender 4.5

Usage: 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 torna animation_01_test.png
test-######.png se torna test-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 for wm.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-allusers

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