pnmcomp - empile deux PNM (Portable aNyMap) ensemble.

pnmcomp [-xoff=X | -align={left,center,right}]
[-yoff=Y | -valign={top,middle,bottom}]
[-alpha=alpha-fichier_pnm] [-invert]
pnm_au_dessus [pnm_entrée] [pnm_sortie]

Les abréviations minimales qui ne sont pas ambiguës sont acceptées.

pnmcomp lit deux images et génère une image composée d’images empilées l’une au-dessus de l’autre. Les images n’ont pas besoin d’être de la même taille. Les fichiers en entrée et en sortie sont des PNM.

Dans son utilisation la plus simple, pnmcomp place simplement le fichier pnm_au_dessus au-dessus du fichier pnm_entrée, masquant la partie de pnm-input qui est en dessous de pnm_au_dessus.

Si vous spécifiez alpha-fichier_pnm, pnmcomp l’utilisera comme un masque alpha, c’est-à -dire la transparence de l’image du dessus. Le masque alpha doit avoir les mêmes dimensions que l’image du dessus. Dans les endroits où le masque alpha opacifie totalement l’image du dessus, l’image du dessous est totalement masquée. Dans les endroits où le masque alpha de l’image du dessus est totalement transparent, on ne verra que l’image du dessous. Enfin, entre les deux, l’image contient un mélange de l’image du dessus et du dessous, défini par la valeur du masque alpha.

Le masque alpha est un fichier PGM où les pixels blancs sont opaques et les pixels noirs sont transparents. Tout ce qui se situe entre les deux est translucide.

Le masque alpha fait partie de l’image pour certains types d’images (le PNG par exemple). Pour les PNM, la transparence est toujours définie dans un fichier « compagnon ». Les programmes de conversions PNM qui convertissent des formats comme le PNG ont des options qui vous permettent d’extraire les informations de transparence dans un fichier séparé, que vous pouvez utiliser pour pnmcomp.

L’image en sortie est toujours de la même dimension que l’image du dessous. pnmcomp utilise seulement des parties de l’image du dessus qui correspondent avec celles du dessous.

Pour indiquer comment aligner l’image du dessus sur l’image du dessous, utilisez les options -xoff, -yoff, -align, et -valign. Sans ces options, le coin en haut à gauche du fichier du dessus sera utilisé.

Les images du dessous et du dessus peuvent être dans des formats différents (par exemple un PBM au dessus d’un PPM). L’image en sortie est généralement la plus commune et la plus appropriée.

-invert

Cette option inverse le sens des valeurs du masque alpha. Cela inverse le rôle des images quand les deux se superposent.

-xoff X

-yoff Y

Ces options positionnent l’image du dessus selon l’image du dessous. X et Y sont les distances horizontales et verticales du coin en haut à gauche de l’image du dessus et du coin en haut à gauche de l’image du dessus de celle du dessous, en pixels. Une valeur positive signifie à droite ou en bas ; une valeur négative veut dire en haut ou à gauche. Il n’est pas nécessaire que l’image du dessus recouvre (complètement ou pas) celle du dessous.

pnmcomp utilise seulement les parties qui s’étendent au dessus de l’image du dessous.

-align=[left,center,right]

Cette option est une alternative à -xoff, dans le style du HTML. Elle sélectionne la position horizontale de l’image du dessus qui est alors alignée à gauche, centrée, ou alignée à droite sur l’image du dessous.

-valign=[top,middle,bottom]

Cette option est une alternative à -yoff, dans le style du HTML. Elle sélectionne la position verticale de l’image du dessus qui est alignée en haut, centrée, ou en bas de l’image du dessous.

ppmmix(1) et pnmpaste(1) sont des versions plus simples de programme.

pnm(5), pbmmask(1)

Copyright (C) 1992 by David Koblas (koblas@mips.com).

Traduit par François Wendling <frwendling@free.fr>, le 01 novembre 2005.