pclipvalues

Synopsis

Description

L'opérateur pclipvalues écrête les valeurs de pixel de l'image d'entrée im_in entre les valeurs spécifiées par les bornes [low..high]. Les pixels avec une valeur inférieure à low sont remplacées par low; les pixels avec une valeur supérieure à high sont remplacées par high.

Plus formellement, im_out est construite en utilisant l'algorithme suivant sur chaque pixel p:

if (im_in[p] > high) im_out[p]=high
else if (im_in[p] < low) im_out[p]=low
     else im_out[p]=im_in[p];

Pour les images couleur et multispectrale, l'opérateur est appliqué séparément sur chacune des bandes.

Paramètres

• low et high spécifie le domaine de valeur de l'image de sortie. Les valeurs sont relatives au type de l'image d'entrée (par exemple Img2duc [0..255],Img2dsl [-2147483648..+2147483648]).
  Note: si min > max alors min et max sont respectivement affecté avec le minimum et le maximum des valeurs du type (par exemple, 0 et 255 pour les images de Uchar ou +2147483648 pour Img2dsl).

Entrées

• im_in: une image.

Sorties

• im_out: une image de même type que l'image d'entrée im_in.

Résultat

Retourne SUCCESS ou FAILURE.

Exemples

Rehaussement de contraste de l'image tangram.pan en utilisant la technique du "unsharp masking". L'image réhaussée est construite en ajoutant l'image filtrée par un filtre passe-haut. L'image filtrée est construite en soustrayant l'image initiale avec une version lissée de celle-ci. A la fin, seuls les pixels entre 0 et 255 sont conservés.

   pim2sf tangram.pan i1.pan
   pgauss 0.8 i1.pan i2.pan
   psub i1.pan i2.pan i3.pan
   pmultcst 0.7 i3.pan i4.pan
   padd i1.pan i4.pan i5.pan
   pclipvalues 0 255 i5.pan mean.pan

Voir aussi

Prototype C++