composite
Exemples d'utilisation • Récapitulatif des options
Utilisez le programme composite pour superposer une image sur une autre. Consultez Traitement en ligne de commande pour des conseils sur la façon de structurer votre commande composite, ou voyez ci-dessous des exemples d'utilisation de la commande.
Exemples d'utilisation
Nous présentons ici quelques exemples de la commande composite pour illustrer son utilité et sa simplicité d'emploi. Pour commencer, superposons un visage souriant sur une rose :
magick composite -gravity center smile.gif rose: rose-over.png
Vous pouvez créer un effet tridimensionnel avec Atop :
magick -size 70x70 canvas:none -fill red -draw 'circle 35,35 10,30' red-circle.png
magick -size 70x70 canvas:none -draw "circle 35,35 35,20" -channel RGB -negate -channel A -gaussian-blur 0x8 white-highlight.png
magick composite -compose atop -geometry -13-17 white-highlight.png red-circle.png red-ball.png
Ou supposons que vous vouliez fondre un ours dans un ruisseau de façon transparente. Essayez cette commande :
magick -verbose stream.jpg bear.jpg bear_mask.png -define compose:args=400x0.0002+100 \
-compose seamless-blend -geometry +30+30 -composite bear-in-stream.png
Le masque délimite la zone autour de l'ours à fondre. Le fondu sans couture (seamless blending) est un processus itératif. Ici, nous limitons les itérations à 400 ou moins si le fondu converge (le résidu présente une RMSE inférieure à 0,0002). La valeur résiduelle (RMSE) est affichée toutes les 100 itérations. Notez que le fondu sans couture fonctionne le plus efficacement lorsque la fonctionnalité HDRI est activée.
magick -verbose stream.jpg \( bear.jpg -read-mask only_bear.png \) bear_mask.png \
-define compose:args=400x0.0002+100 -compose seamless-blend -geometry +30+30 -composite \
bear-in-stream.png
Ici, nous créons un masque de lecture (read mask) qui distingue l'objet de premier plan de son arrière-plan. Aucun fondu n'est appliqué à l'objet de premier plan, seulement à son pourtour. Le read-mask préserve les couleurs de l'ours et les empêche de s'éclaircir comme dans le premier exemple. Notez que les read-masks doivent être noirs sur fond blanc, contrairement aux masques normaux, qui sont blancs sur fond noir.
Vous trouverez d'autres exemples d'utilisation de composite dans Examples of ImageMagick Usage. Vous pouvez en apprendre davantage à leur sujet et sur les aspects mathématiques en consultant SVG Alpha Compositing.
Récapitulatif des options
La commande composite reconnaît ces options. Cliquez sur une option pour obtenir plus de détails sur son fonctionnement.
| Option | Description |
|---|---|
| -affine matrix | matrice de transformation affine |
| -alpha | on, activate, off, deactivate, set, opaque, copy, transparent, extract, background ou shape du canal alpha |
| -authenticate value | déchiffrer l'image avec ce mot de passe |
| -blend geometry | fondre les images |
| -blue-primary point | point primaire bleu de chromaticité |
| -border geometry | entourer l'image d'une bordure de couleur |
| -bordercolor color | couleur de la bordure |
| -channel type | appliquer l'option aux canaux d'image sélectionnés |
| -colors value | nombre de couleurs souhaité dans l'image |
| -colorspace type | définir l'espace colorimétrique de l'image |
| -comment string | annoter l'image avec un commentaire |
| -compose operator | définir l'opérateur de composition de l'image |
| -compress type | type de compression de l'image |
| -debug events | afficher des informations de débogage abondantes |
| -decipher filename | convertir les pixels chiffrés en clair |
| -define format:option | définir une ou plusieurs options de format d'image |
| -density geometry | densité horizontale et verticale de l'image |
| -depth value | profondeur de l'image |
| -displace geometry | décaler les pixels de l'image selon une carte de déplacement |
| -dissolve value | fondre les deux images selon un pourcentage donné |
| -dither method | appliquer une diffusion d'erreur à l'image |
| -encipher filename | convertir les pixels en clair en pixels chiffrés |
| -encoding type | type d'encodage du texte |
| -endian type | boutisme (MSB ou LSB) de l'image |
| -extract geometry | extraire une zone de l'image |
| -filter type | utiliser ce filtre lors du redimensionnement d'une image |
| -font name | rendre le texte avec cette police |
| -geometry geometry | taille ou position souhaitée de l'image |
| -gravity type | placement horizontal et vertical du texte |
| -green-primary point | point primaire vert de chromaticité |
| -help | afficher les options du programme |
| -identify | identifier le format et les caractéristiques de l'image |
| -interlace type | type de schéma d'entrelacement de l'image |
| -interpolate method | méthode d'interpolation de la couleur des pixels |
| -label string | attribuer une étiquette à une image |
| -level value | ajuster le niveau de contraste de l'image |
| -limit type value | limite de ressources du cache de pixels |
| -log format | format des informations de débogage |
| -monitor | surveiller la progression |
| -monochrome | transformer l'image en noir et blanc |
| -negate | remplacer chaque pixel par sa couleur complémentaire |
| -page geometry | taille et position d'un canevas d'image (paramètre) |
| -pointsize value | taille de la police en points |
| -profile filename | ajouter, supprimer ou appliquer un profil d'image |
| -quality value | niveau de compression JPEG/MIFF/PNG |
| -quantize colorspace | réduire les couleurs de l'image dans cet espace colorimétrique |
| -quiet | supprimer tous les messages d'avertissement |
| -red-primary point | point primaire rouge de chromaticité |
| -regard-warnings | tenir compte des messages d'avertissement |
| -respect-parentheses | les paramètres restent en vigueur jusqu'à la limite des parenthèses |
| -rotate degrees | appliquer la rotation de Paeth à l'image |
| -sampling-factor geometry | facteur d'échantillonnage horizontal et vertical |
| -scene value | numéro de scène de l'image |
| -seed value | initialiser une nouvelle séquence de nombres pseudo-aléatoires |
| -set attribute value | définir un attribut d'image |
| -sharpen geometry | accentuer la netteté de l'image |
| -shave geometry | retirer des pixels sur les bords de l'image |
| -size geometry | largeur et hauteur de l'image |
| -stegano offset | dissimuler un filigrane dans une image |
| -stereo geometry | combiner deux images pour créer un anaglyphe stéréo |
| -strip | dépouiller l'image de tous ses profils et commentaires |
| -swap indexes | échanger deux images dans la séquence d'images |
| -synchronize | synchroniser l'image avec le périphérique de stockage |
| -taint | marquer l'image comme modifiée |
| -thumbnail geometry | créer une miniature de l'image |
| -tile | répéter l'opération de composition en largeur et en hauteur de l'image |
| -transform | transformer l'image de manière affine |
| -transparent-color color | couleur transparente |
| -treedepth value | profondeur de l'arbre de couleurs |
| -type type | type de l'image |
| -units type | unités de résolution de l'image |
| -unsharp geometry | accentuer la netteté de l'image |
| -verbose | afficher des informations détaillées sur l'image |
| -version | afficher les informations de version |
| -virtual-pixel method | méthode d'accès aux pixels en dehors des limites de l'image |
| -watermark geometry | pourcentage de luminosité et de saturation d'un filigrane |
| -white-point point | point blanc de chromaticité |
| -white-threshold value | forcer en blanc tous les pixels au-dessus du seuil |
| -write filename | écrire les images dans ce fichier |