Argumentos de linha de comando

Blender 2.80 Utilização: blender [argumentos …] [arquivo] [argumentos …]

Opções de renderização

-b, --background
Executa em plano de fundo (algumas vezes, utilizado para renderização sem interface de usuário).
-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 <quadro>

Renderiza o quadro especificado em <quadro> e o salva.

  • +<quadro> quadro relativo inicial, -<quadro> quadro relativo final.
  • Uma lista de quadros separada por vírgulas também pode ser utilizada (sem espaços).
  • A range of frames can be expressed using .. separator between the first and last frames (inclusive).
-s, --frame-start <quadro>
Define o quadro inicial para <quadro>, suporta o uso de +/- adicionalmente para quadros relativos.
-e, --frame-end <quadro>
Define o quadro final para <quadro>, suporta o uso de +/- adicionalmente para quadros relativos.
-j, --frame-jump <quadros>
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 becomes animation_01_test.png
  • test-######.png se torna test-000001.png

Quando o nome de arquivo não contiver #, O sufixo #### é adicionado ao nome de arquivo.

O número do quadro 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 <motor>
Specify the render engine. Use -E help to list available engines.
-t, --threads <tarefas>
Usa quantidade de <tarefas> especificadas para renderização e outras operações. [1-64]. Use 0 (zero) para detectar o número de processadores do sistema automaticamente.

Opções de formato

-F, --render-format <formato>

Set the render format. Valid options are: TGA RAWTGA JPEG IRIS IRIZ AVIRAW AVIJPEG PNG BMP

Formats that can be compiled into Blender, not available on all systems: HDR TIFF OPEN_EXR OPEN_EXR_MULTILAYER MPEG CINEON DPX DDS JP2

-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 <quadro>
Define o passo de quadros para <quadro>.
-s <quadro>
Reproduz a partir do <quadro>.
-e <quadro>
Reproduz até o <quadro>.

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 fullscreen 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
Force opening maximized.
-con, --start-console
Start with the console window open (ignored if -b is set), (Windows only).
--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
Habilita a execução automática de scripts Python (padrão).
-Y, --disable-autoexec
Desabilita a execução automática de scripts Python (tanto os controladores python («pydrivers») quanto os scripts de inicialização).
-P, --python <nome de arquivo>
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>
Define o código de encerramento entre [0..255] para a saída do programa caso uma exceção Python ocorra (somente para Scripts executados a partir da linha de comando). Utilize 0 (zero) para desabilitar.
--addons <addon(s)>
Recebe uma lista de complementos do Blender separados por vírgula para a execução (sem espaços).

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

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 as definições para a linguagem Python usando sys.stdin ao invés de definí-lo para «Nenhum».
--debug-value <valor>
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
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
Alterna o gráfico de dependências para uma avaliação de única tarefa (mono-processada).
--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 o contexto de depuração da GPU e as informações para a versão de OpenGL 4.3 ou superiores.
--debug-gpumem
Habilita as estatísticas de memória da GPU na barra de status.
--debug-gpu-shaders
Habilita as estatísticas de memória da GPU na barra de status.
--debug-gpu-force-workarounds
Habilita as estatísticas de memória da GPU na barra de status.
--debug-wm
Enable debug messages for the window manager, shows all operators in search, shows keymap errors.
--debug-all
Habilita todas as mensagens de depuração.
--debug-io
Habilita as mensagens de depuração para I/O (entradas e saídas, tais como collada, alembic, etc…).
--debug-fpe
Habilita as exceções de ponto flutuante.
--disable-crash-handler
Desabilita o manipulador para quebras («crash handler»).
--disable-abort-handler
Desabilita o manipulador para encerramento de operações.

Opções diversas

--app-template <template>
Set the application template (matching the directory name), use default for 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
Define a variável de ambiente BLENDER_SYSTEM_PYTHON.
--env-system-scripts
Define a variável de ambiente BLENDER_SYSTEM_PYTHON.
--env-system-python
Define a variável de ambiente BLENDER_SYSTEM_PYTHON.
-noaudio
Força o sistema de áudio para nenhum (NULL).
-setaudio
Força o sistema de som para um dispositivo específico. Opções são: NULL , SDL , OPENAL e JACK.
-h, --help
Imprime este texto de ajuda e encerra.
-R
Registra a associação para a extensão de arquivos Blender (.blend), e então encerra. (Somente MS-Windows).
-r
Registra silenciosamente a associação para a extensão de arquivos Blender (.blend), e então encerra. (Somente MS-Windows).
-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.

Outras opções

/?
Imprime este texto de ajuda e encerra (somente para MS-Windows).
--debug-freestyle
Enable debug messages for Freestyle.
--verbose <modo verboso>
Define o nível de informações de relatório (log) para verboso.

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_CONFIG:
 Diretório para arquivos de configuração do usuário.
BLENDER_USER_SCRIPTS:
 Diretório para scripts de usuário
BLENDER_SYSTEM_SCRIPTS:
 Diretório para a maioria dos scripts do sistema.
BLENDER_USER_DATAFILES:
 Diretório para arquivos de dados do usuário (ícones, traduções, etc…)
BLENDER_SYSTEM_DATAFILES:
 Diretório para a maioria dos arquivos de dados do sistema.
BLENDER_SYSTEM_PYTHON:
 Diretório para as bibliotecas Python de sistema.
TEMP:Guarda os arquivos temporários aqui.
TMP:ou $TMPDIR Guarda os arquivos temporário aqui.
SDL_AUDIODRIVER:
 Definie o controlador de áudio para a biblioteca «LibSDL». Opções são: alsa, esd, dma.
PYTHONHOME:O caminho para o diretório Python, por exemplo: /usr/lib/python.