Webpmux

Nome

webpmux: cria arquivos WebP animados com base em imagens WebP não animadas, extrai frames de imagens WebP animadas e gerencia metadados XMP/EXIF e perfil ICC.

Sinopse

webpmux -get GET_OPTIONS INPUT -o OUTPUT
webpmux -set SET_OPTIONS INPUT -o OUTPUT
webpmux -strip STRIP_OPTIONS INPUT -o OUTPUT
webpmux -frame FRAME_OPTIONS [ -frame ... ] [ -loop LOOP_COUNT ]
        [ -bgcolor BACKGROUND_COLOR ] -o OUTPUT
webpmux -duration DURATION OPTIONS [ -duration ... ] INPUT -o OUTPUT
webpmux -info INPUT
webpmux [-h|-help]
webpmux -version
webpmux argument_file_name

Descrição

webpmux pode ser usado para criar/extrair de arquivos WebP animados, bem como para adicionar/extrair/retirar metadados XMP/EXIF e perfil ICC. Se um único nome de arquivo (que não comece com o caractere '-') for fornecido como argumento, os argumentos da linha de comando serão tokenizados desse arquivo. Isso facilita a criação de scripts ou o uso de um grande número de argumentos.

Opções

GET_OPTIONS (-get)

icc
Acessar perfil do ICC.
exif
Receber metadados EXIF.
xmp
Receba metadados XMP.
frame n
Receber o enésimo frame de uma imagem animada. (n = 0 tem um significado especial: último frame)

DEFINIR_OPÇÕES (-set)

loop LOOP_COUNT
Define a contagem de repetição em um arquivo animado. em que "LOOP_COUNT" precisa estar no intervalo [0, 65535].
bgcolor BACKGROUND_COLOR
Definir a cor do plano de fundo da animação.
icc file.icc
Definir perfil ICC. Em que "file.icc" contém o perfil ICC a ser definido.
exif file.exif
Define metadados EXIF. Em que "file.exif" contém os metadados EXIF a serem definidos.
xmp file.xmp
Definir metadados XMP. Em que "file.xmp" contém os metadados XMP a serem definidos.

SOVER_OPTIONS (-strip)

icc
Retire o perfil do ICC.
exif
Retire os metadados EXIF.
xmp
Retire os metadados XMP.

DURATION_OPTIONS (-duration)

Alteram a duração de um intervalo específico de frames. Essa opção só é efetiva em WebP animado e não tem efeito em um arquivo de frame único.

duration[,start[,end]]

Em que: duration é a duração do intervalo em milissegundos (obrigatório). Não podem ser negativas. start é o índice de frames inicial do intervalo (opcional). end é o índice de frames final (inclusivo) do intervalo (opcional).

Os três usos típicos dessa opção são:

-duration d

defina a duração como "d" para toda a animação.

-duration d,f

define a duração do frame "f" como "d".

-duration d,start,end

Defina a duração como "d" para todo o intervalo [start,end].

Os frames fora do intervalo [start, end] vão permanecer inalterados. O valor 0 de end tem o significado especial de "último frame da animação".

Lembrete: a indexação de frames começa em 1.

FRAME_OPTIONS (-frame)

Crie um arquivo WebP animado a partir de várias imagens WebP (não animadas).

file_i +di[+xi+yi[+mi[bi]]]
Em que: file_i é o i-ésimo frame (formato WebP), xi,yi especifica o deslocamento da imagem para esse frame, di é a duração da pausa antes do próximo frame, mi é o método de descarte para esse frame (0 para NONE ou 1 para BACKGROUND) e bi é o método de combinação para esse frame (+b para BLEND ou -b para NO_BLEND). O argumento bi pode ser omitido e será padronizado como +b (BLEND). Além disso, mi pode ser omitido se bi for omitido, e o padrão será 0 (NONE). Por fim, se mi e bi forem omitidos, xi e yi poderão ser omitidos e serão padronizados como +0+0.

LOOP_COUNT

Número de vezes que a animação será repetida. O intervalo válido é de 0 a 65535 [Padrão: 0 (infinito)].

BACKGROUND_COLOR

Cor do plano de fundo da tela. Em que: A, R, G e B são números inteiros no intervalo de 0 a 255 especificando os valores dos componentes Alfa, Vermelho, Verde e Azul, respectivamente. [Padrão: 255,255,255,255].

INPUT

Arquivo de entrada no formato WebP.

SAÍDA (-o)

Arquivo de saída no formato WebP.

Observação:a natureza dos dados EXIF, XMP e ICC não é verificada e é considerada válida.

Bugs

Exemplos

Adicionar perfil ICC:

webpmux -set icc image_profile.icc in.webp -o icc_container.webp

Extrair perfil ICC:

webpmux -get icc icc_container.webp -o image_profile.icc

Retirar perfil ICC:

webpmux -strip icc icc_container.webp -o without_icc.webp

Adicione metadados XMP:

webpmux -set xmp image_metadata.xmp in.webp -o xmp_container.webp

Extraia metadados XMP:

webpmux -get xmp xmp_container.webp -o image_metadata.xmp

Retirar metadados XMP:

webpmux -strip xmp xmp_container.webp -o without_xmp.webp

Adicionar metadados EXIF:

webpmux -set exif image_metadata.exif in.webp -o exif_container.webp

Extrair metadados EXIF:

webpmux -get exif exif_container.webp -o image_metadata.exif

Retirar metadados EXIF:

webpmux -strip exif exif_container.webp -o without_exif.webp

Crie um arquivo WebP animado com três imagens WebP (não animadas):

webpmux -frame 1.webp +100 -frame 2.webp +100+50+50 \
  -frame 3.webp +100+50+50+1+b -loop 10 -bgcolor 255,255,255,255 \
  -o anim_container.webp

Acesse o segundo frame de um arquivo WebP animado:

webpmux -get frame 2 anim_container.webp -o frame_2.webp

Usando -get/-set/-strip com o nome do arquivo de entrada começando com '-':

webpmux -set icc image_profile.icc -o icc_container.webp -- ---in.webp
webpmux -get icc -o image_profile.icc -- ---icc_container.webp
webpmux -strip icc -o without_icc.webp -- ---icc_container.webp

Autores

webpmux faz parte do libwebp e foi escrito pela equipe do WebP. A árvore de origem mais recente está disponível em https://chromium.googlesource.com/webm/libwebp/

Esta página de manual foi escrita por Vikas Arora vikaas.arora@gmail.com para o projeto Debian (e pode ser usada por outras pessoas).