From BlenderWiki

Jump to: navigation, search
Blender3D FreeTip.gif
IMPORTANT! Do not update this page!
We have moved the Blender User Manual to a new location. Please do not update this page, as it will be locked soon.

Introdução

Em algumas situações, nós queremos aumentar a velocidade de renderização, ou acessar o Blender remotamente para renderizar alguma coisa ou construir Scripts que utilizam a linha de comando do Blender.

Uma Vantagem de utilizar a linha de comando é que nós não precisamos rodar o servidor X ( no caso do Linux) e como conseqüência n´so podemos renderizar remotamente pela utilização de sessões SSH ou TELNET.

Nota
Os argumentos são executados na ordem em que são fornecidos !

Um comando mal formado como exemplificado abaixo:

blender -b file.blend -a -x 1 -o //render
...Não funcionaria, pelo fato da saída e extensão ter sido configurada após o Blender ser acionado para renderizar...


Sempre posicione os comandos -f ou -a como sendo os últimos argumentos.

Descrição

Uso: blender [-b <diretório><arquivo> [-o <diretório><arquivo>][-F <formato>][-x [0|1]][-t <tarefas>][-S <nome>][-f <quadros>][-s <quadros> -e <quadros> -a]] [[-P <nome do script> [-- <parâmetro>]]

Opções de Renderização:

-b <diretório><arquivo> Renderizar o  <arquivo> que está dentro do 
<diretório> sem carregar a Interface de Usuário (UI)
-P <especificar_arquivo>Rodar o Script Python especificado 
(Nome de arquivo ou Texto do Blender)
-S <nome> Configurar o <nome> da Cena
-f <quadro> Configura o quadro especificado em <quadro> para renderizar e
salvar (Não utilize em conjunto com a opção  -a)
-j <número> Renderize a cada X quadros/pule os quadros por este número (saltos)

Quadro Inicial e Quadro Final:

[-s <quadro>] [-e <quadro>] -a
Configure o quadro inicial (-s), e o quadro final (-e) ou ambos.
A ordem é importante e é possível utilizar somente a opção -s ou a opção -e sozinhas.

Caminho de Saída de Renderização:

-o <diretório><arquivo>    
Configure o caminho de renderização e o nome do arquivo.
Utilize  // como <diretório> para utilizar o caminho de renderização relativo ao arquivo.
Utilize # dentro do nome do arquivo para que seja substituído com o número
do quadro.
Exemplo:
blender -b foobar.blend -o //render_# -F PNG -x 1

Formatos de Saída:

-F <formato>  Configura o formato de renderização, as opções válidas são:
TGA IRIS HAMX FTYPE JPEG MOVIE IRIZ RAWTGA AVIRAW AVIJPEG PNG BMP FRAMESERVER

Alguns formatos que podem ser compilados dentro do Blender podem não estar disponíveis em todos os Sistemas Operacionais, Exemplos:

             HDR TIFF EXR MPEG AVICODEC QUICKTIME CINEON DPX

Extensão de arquivo:

-x [0|1]  Configure esta opção para adiconar a extensão de arquivo em seu  
nome final, 0 significa não adicionar e 1 significa sim, adicionar extensão.

Tarefas (Threads para múltiplos processadores):

-t <tarefas> Faz com que o Blender utilize o montante de <tarefas> 
(recomendável  caso a sua máquina possua 2 ou mais processadores) 
para a renderização.

Opções de animação: (Utilizada quando estiver pressionando o botão play (O Blender se comporta como um tocador de filmes)

-a <arquivo(s)>  Tocar <arquivo(s)> (Não utilize em conjunto com -b!)
-p <sx><sy> Abre com o canto esquerdo de baixo em <sx>,<sy> (Não funciona em Janela)
-m          Ler a partir do disco (Não fazer o buffer)

Opções de Janela :

-w            Força a abertura da Janela com bordas (padrão)
-W            Força a abertura da Janela sem as bordas (Linux/Unix Only)
-p <sx> <sy> <w> <h>  Abre com o canto esquerdo da parte de baixo em <sx>, <sy>,
e comprimento e altura especificados em <w>, <h>

Opções específicas da Máquinas de Jogos do Blender ( BGE ou Blender Game Engine ):

-g fixedtime         Roda em 50 sem descartar quadros.
-g vertexarrays      Utiliza Vertex Arrays para renderização (usualmente mais rápido)
-g noaudio           Sem Áudio na BGE 
-g nomipmap          Sem utilização de Mipmapping para as Texturas
-g linearmipmap      Utilizar Textura Linear com Mipmapping ao invés de Nearest (padrão)

Opções Diversas:

-d           Liga o modo de ‘debugging’, para verificar problemas
-noaudio     Desabilita o áudio em sistemas que suportam áudio.
-h           Imprime este Texto de ajuda
-y           Desabilita ligações de Scripts, use -Y e saiba porque foi escolhido -y
-P <nome_de_arquivo> Roda o Script Python fornecido (Nome de arquivo ou Texto do Blender)
-R            Registra a extensão do Blender em máquinas Windows
-v            Imprime a versão do Blender e sai.

Exemplos

Renderização de uma Figura

# blender -b file.blend -o //file -F JPEG -x 1 -f 1

Aonde:

  • -b file.blend  : Arquivo Blender (.blend) para renderizar
  • -o //file  : Diretório + Arquivo de Imagem Alvo
  • -F JPEG  : Formato de Imagem JPEG
  • -x 1  : Adiciona uma extensão .jpg para o nome do arquivo
  • -f 1  : Renderiza o quadro 1

Renderizar um Filme

# blender -b file.blend -x 1 -o //file -F MOVIE -s 003 -e 005 -a 
  • -b file.blend  : Aqruivo Blender (.blend) para renderizar
  • -x  : Adiciona uma extensão .avi ao arquivo de filme
  • -o //images/file : Directório + Arquivo de Imagem Alvo
  • -F MOVIE  : Isto salva um arquivo de filme .AVI com baixa compressão
  • -s 003 -e 005 -a : Configura o início dos quadros como sendo o 003 e o fim dos quadros como sendo 005. Importante: Você pode utilizar as opções -s ou -e, mas se elas não estiverem na ordem, elas não irão funcionar !