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 tornaani_01_test.png
test-######.png
se tornatest-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
eJACK
. -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. |