Argumentos de linha de comando

Blender 2.79 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).
  • Um espaço de quadros pode ser expresso usando o separador .. entre o primeiro e o último quadros (de maneira inclusiva).
-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.

  • ani_##_test.png se torna ani_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 foobar.blend -o //render_ -F PNG -x 1 -a

//render_ se torna //render_####, escrevendo os quadros como //render_0001.png

-E, --engine <motor>
Especifica o motor de renderização. Use -E help para listar os motores disponíveis.
-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>

Define o formato de renderização. As opções válidas são: TGA RAWTGA JPEG IRIS IRIZ AVIRAW AVIJPEG PNG BMP

Formatos que podem ser compilados internamente no Blender, não disponíveis em todos os sistemas, tais como: HDR TIFF EXR MULTILAYER MPEG FRAMESERVER 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)>

Reproduz o(s) <arquivo(s)>, somente opera desta maneira quando não está funcionando em plano de fundo.

-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-borderless
Força a abertura sem bordas na janela.
-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>.
-con, --start-console
Inicia com a janela de console aberta (ignorado caso -b seja definido), (Somente para MS-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).

Opções específicas para o motor de jogo

Usar -g faz com que o Blender execute com opções específicas para o motor de jogos.

fixedtime
Executa em uma taxa de 50Hz sem descarte de quadros.
vertexarrays
Usa matrizes de vértices para a renderização (usualmente mais rápido).
nomipmap
Executa sem a geração de mapeamentos «MIP» para texturas.
linearmipmap
Usa a geração «Linear» de mapas MIP para interpolação de texturas em lugar do método «Mais próximo» (padrão).

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
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
Recebe uma lista de complementos do Blender separados por vírgula para a execução (sem espaços).

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
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-gpumem
Habilita as estatísticas de memória da GPU na barra de status.
--debug-wm
Habilita as mensagens de depuração para o gerenciador de janelas, e também imprime quaisquer chamada de operadores.
--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»).

Opções diversas

--factory-startup
Salta a leitura do arquivo padrão startup.blend no diretório de perfil de usuário atual.
--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.
-nojoystick
Desabilita o suporte a joysticks.
-noglsl
Desabilita o sombreamento GLSL.
-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.

Funcionalidades experimentais

--enable-new-depsgraph
Usa o novo gráfico de dependências.
--enable-new-basic-shader-glsl
Usa o novo sombreador básico GLSL.

Outras opções

/?
Imprime este texto de ajuda e encerra (somente para MS-Windows).
--debug-freestyle
Habilita as mensagens de depuração para o renderizador Freestyle.
--debug-gpu
Habilita o contexto de depuração da GPU e as informações para a versão de OpenGL 4.3 ou superiores.
--disable-abort-handler
Desabilita o manipulador para encerramento de operações.
--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

…irá ignorar o a.

blender -b test.blend -f8

…irá ignorar o 8 devido ao fato de não haver espaços entre o argumento -f e o valor do quadro.

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.