pmultval

Multiplication d'une image par des constantes stockées dans une collection.

Synopsis

pmultval [-m mask] [col_in|-] [im_in|-] [im_out|-]

Description

L'opérateur pmultval calcule l'image im_out par multiplication des valeurs de pixels de l'image im_in par les valeur stockes dans la collection col_in. La première valeur de la collection est utilisée pour multiplier tous les pixels de la première bande, la seconde à tous les pixels de la seconde bande, etc.

Il y a écrétage du résultat si la valeur résultante est supérieure à la valeur maximale du type de l'image. La formule de calcul est la suivante :

   val = pixel(im_in) * col_in;
   if (val > MAX) pixel(im_out) = MAX;
   else if (val < MIN) pixel(im_out) = MIN;
   else pixel(im_out) = val;

Entrées

col_in: une collection avec autant de valeurs réelles que de nombre de bandes pour l'image d'entrée (p. ex. 3 pour une image couleur).
im_in: une image.

Sorties

im_out: un objet du même type que im_in.

Résultat

Retourne SUCCESS ou FAILURE.

Exemples

Multiplie tangram.pan sa valeur moyenne:

   pmeanvalue tangram.pan a.pan
   pmultval a.pan tangram.pan b.pan

Autres exemples

Voir aussi

Arithmetique

Prototype C++

Errc PMultVal( const Collection &col_in, const Img2duc &im_in, Img2duc &im_out );

Auteur: Régis Clouard