imprimir

Manual online do FFMPEG (parte 1)

Versão desatualizada. A tradução mais atual pode ser encontrada no site do mantenedor.

dividido em duas partes: parte 1; parte 2.




Introdução


O programa FFMPEG é um conversor de arquivos de vídeo e áudio muito rápido. Ele também consegue capturar de uma fonte ao vivo de áudio/vídeo. A interface de linha de comando foi pensada para ser intuitiva, no sentido de que o FFMPEG tenta 'entender' todos os parâmetros que possam ser derivados automaticamente. Normalmente, você só precisa especificar a taxa de bits ("bitrate") desejada. O FMPEG também pode converter de qualquer taxa de amostragem ("sample rate") para qualquer outra e redimensionar o vídeo em tempo real com um filtro polifásico de alta qualidade.

Nota sobre esta versão do manual


A tradução do manual foi focada na utilização do software para fins multimídia, buscando especialmente um público de usuários-finais do sistema operacional Linux. Desta forma, informações relacionadas à sua instalação/compilação em outros sistemas operacionais não foram traduzidas, assim como as notas relacionadas a desenvolvedores, política de desenvolvimento no CVS, etc. Todos estes ítens fazem parte das seções e subseções 6 e 7 do manual original, em inglês.

Você é livre para usar, copiar e distribuir esta versão do manual desde que para fins não-comerciais.



Começo rápido (para os apressados)


Captura de áudio e vídeo


FFMPEG pode usar uma fonte de vídeo compatível com o video4linux e qualquer fonte de áudio Open Sound System:

ffmpeg /tmp/out.mpg


Note que você deve ativar a fonte de vídeo correta e o canal antes de usar o FFMPEG com qualquer visor de televisão, como o xawtv de Gerd Knorr. Você também tem que ajustar corretamente o nível de gravação do áudio com um mixer padrão.

Conversão de formatos para vídeo e áudio


O FFMPEG consegue usar qualquer protocolo e formato de arquivo suportado como entrada:

Exemplos:

  • Você pode usar arquivos YUV como entrada:
    ffmpeg -i /tmp/teste%d.Y /tmp/saída.mpg

Ele usará os arquivos:
/tmp/teste0.Y, /tmp/teste0.U, /tmp/teste0.V,
/tmp/teste1.Y, /tmp/teste1.U, /tmp/teste1.V, etc...

Arquivos Y usam uma resolução duas vezes maior do que arquivos U e V. Eles são arquivos brutos, sem chamadas ("header"). Podem ser gerados por todos os decodificadores de vídeo decentes. Você deve especificar o tamanho da imagem com a opção '-s' caso o FFMPEG não consiga 'adivinhá-la'.

  • Você pode usar como entrada ("input") um arquivo bruto YUV420P:
    ffmpeg -i /tmp/teste.yuv /tmp/saída.avi

teste.yuv é um arquivo contendo informações brutas YUV planar. Cada frame é composto de um plano Y, seguido dos planos U e V a metade das resoluções verticais e horizontais.

  • Você pode dar saída ("output to") a um arquivo bruto YUV420P:
    ffmpeg -i meudivx.avi arquivobruto.yuv

  • Você pode marcar vários arquivos de entrada e de saída:
    ffmpeg -i /tmp/a.wav -s 640x480 -i /tmp/a.yuv /tmp/a.mpg

Converter o arquivo de áudio (a.wav) e o arquivo bruto de vídeo YUV (a.yuv) para um arquivo MPEG (a.mpg).

  • Você também pode fazer conversões de áudio e vídeo ao mesmo tempo:
    ffmpeg -i /tmp/a.wav -ar 22050 /tmp/a.mp2

Converter a.wav para áudio MPEG a uma taxa de amostragem ("sample rate") de 22050Hz.

  • Você pode codificar vários formatos ao mesmo tempo e definir um mapeamento da faixa de entrada ("input stream") para as faixas de saída ("output streams"):
    ffmpeg -i /tmp/a.wav -ab 64 /tmp/a.mp2 -ab 128 /tmp/b.mp2 -map 0:0 -map 0:0

Converter a.wav para a.mp2 a 64 kbits e para b.mp2 a 128 kbits. A função '-map file:index' especifica qual faixa de entrada ("input stream") é usada para qual faixa de saída ("output stream"), na ordem de definição das faixas de saída.

  • Você pode transcodificar VOBs desencriptados:
    ffmpeg -i afanado_1.vob -f avi -vcodec mpeg4 -b 800 -g 300 -bf 2 -acodec mp3 -ab 128 afanado.avi

Este é um exemplo típico de extração de conteúdos de DVD; o arquivo de entrada é um arquivo VOB, o de saída é um arquivo AVI com vídeo em MPEG-4 e áudio em MP3. Repare que neste comando estamos usando frames B ("B frames") para que a faixa em MPEG-4 seja compatível com DivX5, e o tamanho do Grupo de Imagens (GOP size) é 300, o que significa um frame intra ("intra frame") a cada 10 segundos para um vídeo com entrada a 29.97fps (FramesperSecond). Outra coisa: a faixa de áudio está codificada em MP3, então você precisa habilitar o suporte a LAME, dando o comando --enable-mp3lame para configurá-la. Este tipo de mapeamento é particularmente interessante para a transcodificação de DVDs para pegar o áudio na língua desejada.

OBSERVAÇÃO: Para ver os formatos de entrada suportados, use:
ffmpeg -formats



Chamada


Sintaxe


A sintaxe genérica é:

ffmpeg [[opções para arquivodeentrada]['-i' arquivodeentrada]]... {[opções para arquivodesaída] arquivodesaída}...


Se nenhum arquivo de entrada for informado, o programa faz captura de áudio/vídeo. Como regra geral, as opções são aplicadas ao arquivo seguinte especificado. Por exemplo, se você chamar a função -b 64, ela fixará a taxa de bits ("bitrate") para o próximo arquivo de vídeo. A opção de formato pode ser necessária para arquivos de entrada brutos. Como padrão, o FFMPEG tenta converter os arquivos com a menor perda de qualidade possível: ele usa os mesmos parâmetros de áudio e vídeo especificados nos arquivos de entrada como saída.


Opções principais


-L
Mostra a licença de uso.

-h
Mostra o arquivo de ajuda (em inglês).

-formats
Mostra os formatos, codecs, protocolos, etc, suportados.

-f formato
Força o uso de um formato.

-i nomedoarquivo
Nome do arquivo de entrada

-y
Sobrescreve os arquivos de saída (caso exista um arquivo de mesmo nome na pasta-destino).

-t duração
Fixa o tempo de gravação em segundos. hh:mm:ss.xxx sintaxe também é suportada.

-ss posição
Busca dada posição no tempo, em segundos. hh:mm:ss.xxx sintaxe também é suportada.

-title cadeiadecaracteres
Faz a marcação do título.

-author cadeiadecaracteres
Faz a marcação do autor.

-copyright cadeiadecaracteres
Faz a marcação dos direitos autorais ("copyright").

-comment cadeiadecaracteres
Faz a marcação de um comentário.

-target tipo
Especifica o tipo de arquivo a ser usado como saída ("vcd", "svcd", "dvd", "dv", "pal-vcd", "ntsc-svcd", ... ). Todas as opções do formato (taxa de bits ("bitrate"), codecs, tamanhos de buffer) são então fixados automaticamente. Você pode simplesmente digitar:
  • ffmpeg -i meuarquivo.avi -target vcd /tmp/vcd.mpg
Ainda assim, você pode especificar opções adicionais desde que você certifique-se de que elas não entrem em conflito com a padrão, como em:
  • ffmpeg -i meuarquivo.avi -target vcd -bf 2 /tmp/vcd.mpg

-hq
Ativa as marcações para alta qualidade.

-itsoffset deslocamento
Marca o tempo de deslocamento do arquivo de entrada ("input time offset") em segundos. -hh:mm:ss[.xxx] sintaxe também é suportada. Esta opção afeta todos os arquivos de entrada que o seguirem. O deslocamento ("offset") é adicionado às marcações de tempo ("timestamps") dos arquivos de entrada. Especificar um deslocamento ("offset") positivo significa que as faixas correspondentes serão atrasadas pelos segundos especificados no parâmetro 'deslocamento'.


Opções de vídeo


-b taxadebits
Fixa a taxa de bits ("bitrate") do vídeo em kbit/s (padrão = 200 kb/s).

-r fps
Fixa a taxa de frames por segundo (fps) (padrão = 25).

-s tamanho
Fixa as dimensões do frame. O formato é 'LxA', isto é, Largura x Altura ("width x high") (padrão = 160x128). As abreviaturas a seguir são reconhecidas:
  • sqcif
    128x96
  • qcif
    176x144
  • cif
    352x288
  • 4cif
    704x576

-aspect aspecto
Fixa a proporção de aspecto (4:3, 16:9 ou 1.3333, 1.7777).

-croptop tamanho
Faz a marcação do tamanho da faixa de corte (em pixels) a ser feito na parte de cima.

-cropbottom tamanho
Faz a marcação do tamanho da faixa de corte (em pixels) a ser feito na parte de baixo.

-cropleft tamanho
Faz a marcação do tamanho da faixa de corte (em pixels) a ser feito na lateral esquerda.

-cropright tamanho
Faz a marcação do tamanho da faixa de corte (em pixels) a ser feito na lateral direita.

-padtop tamanho
Faz a marcação do tamanho da faixa de 'enchimento' ("pad size") (em pixels) a ser feito na parte de cima.

-padbottom tamanho
Faz a marcação do tamanho da faixa de 'enchimento' ("pad size") (em pixels) a ser feito na parte de baixo.

-padleft tamanho
Faz a marcação do tamanho da faixa de 'enchimento' ("pad size") (em pixels) a ser feito na lateral esquerda.

-padright tamanho
Faz a marcação do tamanho da faixa de 'enchimento' ("pad size") (em pixels) a ser feito na lateral direita.

-padcolor (cor hexadecimal)
Faz a marcação de cor das faixas de preenchimento ("padded bands"). O valor da função 'padcolor' é expresso por meio de um número hexadecimal de seis dígitos, no qual os dois primeiros dígitos representam a cor vermelha, os dois dígitos intermediários representam a cor verde e os dois últimos representam a tonalidade de azul (em um sistema de cores RGB) (padrão = 000000 (preto)).

-vn
Desabilita a gravação de vídeo.

-bt tolerância
Fixa a tolerância da taxa de bits ("bitrate") (em kbit/s).

-maxrate taxadebits
Fixa a tolerância máxima da taxa de bits ("bitrate") (em kbit/s).

-minrate taxadebits
Fixa a tolerância mínima da taxa de bits ("bitrate") (em kbit/s).

-bufsize tamanho
Controla o tamanho do buffer ("buffer size") (em kbit).

-vcodec codec
Força o codec de vídeo para o especificado no parâmetro codec. Use o parâmetro especial copy para informar que a informação bruta do codec deve ser copiada como está.

-sameq
Usa a mesma qualidade do arquivo-fonte (implica VBR).

-pass n
Para codificação em 'caminhos' ("pass"). Selecione o número de 'caminhos' (1 ou 2). Á aconselhável usar o método conhecido como "two pass encoding" (valor: 2). As estatísticas do vídeo são gravadas no primeiro 'caminho' ("first pass") e o vídeo é gerado na exata faixa de bits especificada no segundo 'caminho' ("second pass").

-passlogfile arquivo
Marca o nome do arquivo de log da codificação em 'dois caminhos' ("two pass") para arquivo.


Opções avançadas de vídeo


-g tamanhodoGOP
Fixa o tamanho do Grupo de Imagens (GOP, do inglês, "group of pictures").

-intra
Usa apenas frames 'intra'.

-qscale q
Usa uma escala fixa de 'video quantiser' (VBR).

-qmin q
Valor mínimo da escala de 'video quantiser' (VBR)

-qmax q
Valor máximo da escala de 'video quantiser' (VBR)

-qdiff q
Diferença máxima entre as escalas de 'quantiser' (VBR)

-qblur obscurecência
Escala de obscurecência ("blur") do 'video quantiser' (VBR)

-qcomp compressão
Escala de compressão do 'video quantiser' (VBR)

-pix_fmt formato
Formato do pixel a ser utilizado no vídeo

-rc_init_cplx complexidade
Grau de complexidade inicial para codificação em 'caminho único' ("single pass encoding")

-b_qfactor fator
Fator qp entre frames P e B

-i_qfactor fator
Fator qp entre frames P e I

-b_qoffset deslocamento
Deslocamento qp entre frames P e B

-i_qoffset deslocamento
Deslocamento qp entre frames P e I

-rc_eq equação
Marca a equação de controle de razão (ver seção Calculadora FFMPEG) (padrão = tex^qComp).

-rc_override sobreposição
Controle de razão de sobreposição ("override") para intervalos específicos

-me método
Marca o método de estimativa de movimentação ("motion estimation method") para o valor especificado em método. Métodos disponíveis são (da qualidade mais baixa para a melhor qualidade):
  • zero
    Tenta apenas o vetor (0, 0).
  • phods
  • log
  • x1
  • epzs
    (método padrão)
  • full
    busca exaustiva (lenta e levemente melhor do que epzs)

-dct_algo algoritmo
Marca o algoritmo DCT para o valor especificado em algoritmo. Valores disponíveis são:
  • 0
    FF_DCT_AUTO (automático) (padrão)
  • 1
    FF_DCT_FASTINT (intermediário rápido?)
  • 2
    FF_DCT_INT (intermediário?)
  • 3
    FF_DCT_MMX (MMX)
  • 4
    FF_DCT_MLIB
  • 5
    FF_DCT_ALTIVEC

-idct_algo algoritmo
Marca o algoritmo IDCT para o valor especificado em algoritmo. Valores disponíveis são:
  • 0
    FF_IDCT_AUTO (automático) (padrão)
  • 1
    FF_IDCT_INT (intermediário?)
  • 2
    FF_IDCT_SIMPLE (simples)
  • 3
    FF_IDCT_SIMPLEMMX (MMX simples)
  • 4
    FF_IDCT_LIBMPEG2MMX (MMX com libmpeg2)
  • 5
    FF_IDCT_PS2 (playstation 2?)
  • 6
    FF_IDCT_MLIB
  • 7
    FF_IDCT_ARM
  • 8
    FF_IDCT_ALTIVEC
  • 9
    FF_IDCT_SH4
  • 10
    FF_IDCT_SIMPLEARM

-er n
Marca a margem de erro ("error resilience") para o valor especificado em n.
  • 1
    FF_ER_CAREFUL (cuidadoso) (padrão)
  • 2
    FF_ER_COMPLIANT (condescendente)
  • 3
    FF_ER_AGGRESSIVE (agressivo)
  • 4
    FF_ER_VERY_AGGRESSIVE (muito agressivo)

-ec máscaraembits
Marca o quanto de erro será 'escondido' ("error concealment") para o valor definido em máscaraembits. máscaraembits é uma máscara de bits nos seguintes valores:
  • 1
    FF_EC_GUESS_MVS (adivinha_MVS) (padrão = habilitado)
  • 2
    FF_EC_DEBLOCK (desbloqueia) (padrão = habilitado)

-bf frames
Usa os frames de frame B ("'frames' B-frames") (suportado para MPEG-1, MPEG-2 e MPEG-4).

-mbd modo
Decisão de macroblocos ("macroblock")
  • 0
    FF_MB_DECISION_SIMPLE (decisão simples): Usa mb_cmp (ainda não consegue mudar no FFMPEG).
  • 1
    FF_MB_DECISION_BITS (decisão_bits): Escolhe qual precisa de menos bits.
  • 2
    FF_MB_DECISION_RD (decisão: distorção de razão): Distorção de razão ("rate distortion")

-4mv
Usa quatro vetores de movimentos por macrobloco (apenas MPEG-4).

-part
Usa particionamento de informações (apenas MPEG-4).

-bug parâmetro
Trabalha erros de codificação que não são auto-detectados.

-strict rigidez
Quão estrito/rígido o programa seguirá os padrões.

-aic
Habilita codificação 'intra' avançada (h263+).

-umv
Habilita vetor de movimentação ilimitado ("Unlimited Motion Vector") (h263+)

-deinterlace
Desentrelaça as imagens.

-interlace
Força suporte a entrelaçamento durante a codificação (MPEG-2 e MPEG-4 apenas). Use esta opção caso seu arquivo de entrada é entrelaçado e você quer deixá-lo entrelaçado para haver perdas mínimas. A alternativa é desentrelaçar o arquivo de entrada usando '-deinterlace', mas o desentrelaçamento gera perdas.

-psnr
Calcula o valor PSNR ("Peak signal-to-noise ratio", razão máxima entre sinal-e-ruído) de frames comprimidos.

-vstats
Escreve as estatísticas da codificação do vídeo no arquivo 'vstats_HHMMSS.log'.

-vhook módulo
Insere o módulo de processamento do vídeo, de acordo com o especificado na função módulo. Módulo contém o nome do módulo e seus parâmetros, separados por espaços.


Opções de áudio


-ar freqüência
Marca a freqüência da amostragem de áudio ("audio sampling frequency") (padrão = 44100 Hz).

-ab taxadebits
Marca a taxa de bits ("bitrate") de áudio em kbit/s (padrão = 64).

-ac canais
Marca o número de canais de áudio (padrão = 1).

-an
Desabilita a gravação de áudio.

-acodec codec
Força determinado codec de áudio de acordo com o especificado na função codec. Use o parâmetro especial copy para especificar que a informação bruta do codec deve ser copiada como está.


Opções de captura para áudio e vídeo


-vd dispositivo
Marca o dispositivo ("device") de captura de vídeo (exemplo: '/dev/video0').

-vc canal
Marca o canal ("channel") de captura de áudio (DV1394 apenas).

-tvstd padrão
Escolhe o padrão de televisão (NTSC, PAL (SECAM)).

-dv1394
Captura pelo dispositivo DV1394.

-ad dispositivo
Escolhe o dispositivo ("device") de áudio (exemplo: '/dev/dsp').


Opções avançadas


-map arquivo:faixa
Marca mapeamento da faixa de entrada ("input stream mapping").

-debug
Imprime informação específica de de depuração ("debug").

-benchmark
Adiciona tempos para o teste de performance ("benchmarking").

-hex
Esvazia ("dump") cada pacote de entrada.

-bitexact
Usar apenas algoritmos de bit exato (para teste de codec).

-ps tamanho
Marca o tamanho do pacote em bits.

-re
Lê arquivo de entrada com a razão de frames nativa. Usado principalmente para simular um dispositivo de captura.

-loop
Faz um 'loop' da faixa de entrada. Atualmente, funciona apenas para faixas de imagens (não de áudio). Esta opção é usada para teste automático do servidor FF ("FFserver").

-loop_output númerodevezes
Faz um 'loop' repetido do arquivo de saída para formatos que suportam 'loops', como o GIF animado (o valor 0 fará um 'loop' infinito do arquivo de saída).




Este manual está dividido em duas partes. Você está na parte 1; Ir para parte 2.



Última alteração: 30/07/2008 às 04:40, por: flavio