вебпмукс

Имя

webpmux — создавайте анимированные файлы WebP из неанимированных изображений WebP, извлекайте кадры из анимированных изображений WebP и управляйте метаданными XMP/EXIF и профилем ICC.

Краткое содержание

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

Описание

webpmux можно использовать для создания/извлечения из анимированных файлов WebP, а также для добавления/извлечения/удаления метаданных XMP/EXIF и профиля ICC. Если в качестве аргумента указано одно имя файла (не начинающееся с символа «-»), аргументы командной строки фактически маркируются из этого файла. Это позволяет легко писать сценарии или использовать большое количество аргументов.

Параметры

ПОЛУЧИТЬ_ОПЦИИ ( -get )

icc
Получите профиль ICC.
exif
Получите метаданные EXIF.
xmp
Получите метаданные XMP.
frame n
Получить n-й кадр анимированного изображения. (n = 0 имеет особое значение: последний кадр)

SET_OPTIONS ( -set )

loop LOOP_COUNT
Установите количество циклов в анимированном файле. Где: «LOOP_COUNT» должен находиться в диапазоне [0, 65535].
bgcolor BACKGROUND_COLOR
Установите цвет фона анимации.
icc file.icc
Установите профиль ICC. Где: «file.icc» содержит устанавливаемый профиль ICC.
exif file.exif
Установите метаданные EXIF. Где: «file.exif» содержит метаданные EXIF, которые необходимо установить.
xmp file.xmp
Установите метаданные XMP. Где: «file.xmp» содержит метаданные XMP, которые необходимо установить.

STRIP_OPTIONS ( -strip )

icc
Удалить профиль ICC.
exif
Удалить метаданные EXIF.
xmp
Удалить метаданные XMP.

DURATION_OPTIONS ( -duration )

Изменить продолжительность определенного интервала кадров. Этот параметр эффективен только для анимированного WebP и не влияет на однокадровый файл.

duration[,start[,end]]

Где: duration — длительность интервала в миллисекундах (обязательно). Должно быть неотрицательным. start — индекс начального кадра интервала (необязательно). end — индекс конечного кадра (включительно) интервала (необязательно).

Три типичных варианта использования этой опции:

-duration d

установите продолжительность «d» для всей анимации.

-duration d,f

установите продолжительность кадра «f» на «d».

-duration d,start,end

установите длительность «d» для всего интервала [start,end].

Обратите внимание, что кадры за пределами интервала [start, end] останутся нетронутыми. end значение 0 имеет особое значение «последний кадр анимации».

Напоминание: индексация кадров начинается с 1 .

FRAME_OPTIONS ( -frame )

Создайте анимированный файл WebP из нескольких (неанимированных) изображений WebP.

file_i +di[+xi+yi[+mi[bi]]]
Где: file_i — это i-й кадр (формат WebP), xi , yi указывает смещение изображения для этого кадра, di — продолжительность паузы перед следующим кадром, mi — метод удаления для этого кадра ( 0 для NONE или 1 для BACKGROUND ), а bi — метод смешивания для этого кадра ( +b для BLEND или -b для NO_BLEND). Аргумент bi можно опустить, и по умолчанию он будет иметь значение +b (BLEND). Кроме того, mi можно опустить, если опущен bi , и по умолчанию он равен 0 (NONE). Наконец, если mi и bi опущены, то xi и yi можно опустить, и по умолчанию они будут иметь значение +0+0 .

LOOP_COUNT

Количество повторений анимации. Допустимый диапазон: от 0 до 65535 [по умолчанию: 0 (бесконечно)].

ФОНОВЫЙ ЦВЕТ

Цвет фона холста. Где: A , R , G и B — целые числа в диапазоне 0 до 255 , определяющие значения компонентов Alpha, Red, Green и Blue соответственно [по умолчанию: 255,255,255,255 ].

ВХОД

Входной файл в формате WebP.

ВЫВОД ( -o )

Выходной файл в формате WebP.

Примечание. Характер данных EXIF, XMP и ICC не проверяется и считается действительным.

Ошибки

Примеры

Добавить профиль ICC:

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

Извлеките профиль ICC:

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

Полоса профиля ICC:

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

Добавьте метаданные XMP:

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

Извлеките метаданные XMP:

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

Удалить метаданные XMP:

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

Добавьте метаданные EXIF:

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

Извлеките метаданные EXIF:

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

Удалить метаданные EXIF:

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

Создайте анимированный файл WebP из 3 (неанимированных) изображений WebP:

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

Получите второй кадр из анимированного файла WebP:

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

Использование -get/-set/-strip с именем входного файла, начинающимся с «-»:

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

Авторы

webpmux является частью libwebp и был написан командой WebP. Последняя версия дерева исходного кода доступна по адресу https://chromium.googlesource.com/webm/libwebp/ .

Эта страница руководства была написана Викасом Аророй vikaas.arora@gmail.com для проекта Debian (и может использоваться другими).