Argumentos de linha de comando¶
Blender 2.82 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
becomesanimation_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 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 forwm.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
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
.
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.