Webpmux

Nom

webpmux : permet de créer des fichiers WebP animés à partir d'images WebP non animées, d'extraire des cadres à partir d'images WebP animées, et de gérer les métadonnées XMP/EXIF et le profil ICC.

Synopsis

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

Description

webpmux permet de créer ou d'extraire des fichiers WebP animés, ainsi que d'ajouter, d'extraire et de supprimer les métadonnées XMP/EXIF et le profil ICC. Si un seul nom de fichier (ne commençant pas par le caractère "-") est fourni en tant qu'argument, les arguments de ligne de commande sont en fait tokenisés à partir de ce fichier. Cela permet de créer facilement des scripts ou d'utiliser un grand nombre d'arguments.

Options

GET_OPTIONS (-get)

icc
Obtenez le profil ICC.
exif
Obtenez les métadonnées EXIF.
xmp
Obtenir les métadonnées XMP.
frame n
Obtenez n-ième image à partir d'une image animée. (n = 0 a une signification particulière: dernière image)

SET_OPTIONS (-set)

loop LOOP_COUNT
Définit le nombre de boucles dans un fichier animé. Où "LOOP_COUNT" doit être compris dans la plage [0, 65535].
bgcolor BACKGROUND_COLOR
Définissez la couleur d'arrière-plan de l'animation.
icc file.icc
Définissez le profil ICC. Où "file.icc" contient le profil ICC à définir.
exif file.exif
Définissez les métadonnées EXIF. Où: "file.exif" contient les métadonnées EXIF à définir.
xmp file.xmp
Définir les métadonnées XMP. Où: "file.xmp" contient les métadonnées XMP à définir.

STrip_OPTIONS (-strip)

icc
Supprimer le profil ICC.
exif
Supprimer les métadonnées EXIF.
xmp
Supprimer les métadonnées XMP.

DURATION_OPTIONS (-duration)

Modifiez la durée d'un intervalle d'images spécifique. Cette option n'est appliquée que sur les pages WebP animées et n'a aucun effet sur les fichiers à frame unique.

duration[,start[,end]]

Où duration est la durée de l'intervalle en millisecondes (obligatoire). Cette valeur ne doit pas être négative start est l'index de frame de départ de l'intervalle (facultatif). end est l'index de frame de fin (inclus) de l'intervalle (facultatif).

Voici les trois utilisations types de cette option:

-duration d

et définissez la durée sur "d" pour toute l'animation.

-duration d,f

et définissez la durée du frame "f" sur "d".

-duration d,start,end

définissez la durée sur "d" pour la totalité de l'intervalle [début,fin].

Notez que les images situées en dehors de l'intervalle [start, end] restent inchangées. La valeur end 0 a la signification particulière "dernière image de l'animation".

Rappel : L'indexation des frames commence à 1.

FRAME_OPTIONS (-frame)

Créez un fichier WebP animé à partir de plusieurs images WebP (non animées).

file_i +di[+xi+yi[+mi[bi]]]
Où: file_i est l'i'e image (format WebP), xi,yi spécifie le décalage de l'image pour cette image, di est la durée de mise en pause avant l'image suivante, mi est la méthode de suppression pour cette image (0 pour NONE ou 1 pour BACKGROUND) et bi est la méthode de combinaison de cette image (+b pour BLEND ou -b pour NO_BLEND). L'argument bi peut être omis. La valeur par défaut est +b (BLEND). De plus, mi peut être omis si bi est omis et est défini par défaut sur 0 (NONE). Enfin, si mi et bi sont omis, xi et yi peuvent être omis et sont définis par défaut sur +0+0.

LOOP_COUNT

Nombre de répétitions de l'animation. La plage valide est comprise entre 0 et 65 535. [Par défaut: 0 (infini)].

BACKGROUND_COLOR

Couleur d'arrière-plan du canevas. Où A, R, G et B sont des entiers compris entre 0 et 255, qui spécifient respectivement les valeurs des composants Alpha, Rouge, Vert et Bleu [Par défaut : 255,255,255,255].

INPUT

Fichier d'entrée au format WebP.

RÉSULTAT (-o)

Fichier de sortie au format WebP.

Remarque:La nature des données EXIF, XMP et ICC n'est pas vérifiée et est supposée être valide.

Bugs

Exemples

Ajouter un profil ICC:

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

Extraire le profil ICC:

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

Supprimer le profil ICC:

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

Ajoutez des métadonnées XMP.

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

Extrayez les métadonnées XMP:

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

Supprimer les métadonnées XMP:

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

Ajouter les métadonnées EXIF:

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

Extraire les métadonnées EXIF:

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

Supprimer les métadonnées EXIF:

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

Créez un fichier WebP animé à partir de trois images WebP (non animées) :

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

Récupérez la deuxième image à partir d'un fichier WebP animé:

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

Utilisation de l'option -get/-set/-strip avec un nom de fichier d'entrée commençant par "-":

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

Auteurs

webpmux fait partie de libwebp et a été écrit par l'équipe WebP. La dernière arborescence source est disponible à l'adresse https://chromium.googlesource.com/webm/libwebp/.

Cette page de manuel a été écrite par Vikas Arora vikaas.arora@gmail.com, pour le projet Debian (et peut être utilisée par d'autres personnes).