ppowerlawtransform

Synopsis

Description

L'opérateur ppowerlawtransform étale ou compresse les niveaux de gris selon une loi de transformation de puissance d'ordre gamma. Cette transformation est aussi connue sous le nom de correction gamma.

L'effet d'une transformation selon une loi de puissance est de plaquer une faible bande de niveaux de gris sombre de l'image initiale sur une large bande bande de niveaux de gris sombre de l'image de sortie gamma < 1, et le contraire quand gamma >1.

La transformation selon la loi de puissance d'un pixel 'p' prend la forme :

im_out[p]=(c * (im_in[p]-smin)^gamma) + min;
c=(max-min) / (smax-smin)

où smin et smax sont les valeurs minimale et maximale de l'image d'entrée et c est un facteur de normalisation pour l'étalement des valeurs de sortie entre min et max.

Pour les images couleur et multispectrales, la transformation utilise l'approche vectorielle : le min et le max sont calculés sur toutes les bandes et chaque bande est modifiée avec la même transformation.

Paramètres

• gamma est un réel positif. Il spécifie le degré de la transformation. Les valeurs < 1 compressent les niveaux de gris sombres et étalent les niveaux de gris clairs. Les valeurs >1 étalent les niveaux de gris clairs et compressent les niveaux de gris sombres. Une valeur de gamma=1 conduit à une transformation linéaire. Des valeurs typiques sont 0.04, ... , 0.4, 1, 1.5, ... 25.0.

• min et max spécifient les bornes des valeurs de pixels de l'image de sortie. Ils sont relatifs au type de l'image d'entrée.
  Note: si min < max alors min et max sont affectés rspectivement avec les valeurs minimum and maximum possibles pour le type de l'image d'entrée (ex: 0 et 255 pour des images de Uchar).

Entrées

• im_in: une image.

Sorties

• im_out: une image avec les mêmes propriétés que l'image d'entrée im_in.

Résultat

Retourne SUCCESS ou FAILURE en cas de mauvais paramétrage.

Exemples

Cette séquence applique successivement une transformation gamma puis la transformation inverse. L'image résultante b. est donc (presque) ègale à tangram.pan (à cause des arrondis de calcul):

   ppowerlawtransform 2 0 255 tangram.pan a.pan
   ppowerlawtransform 0.5 28 165 a.pan b.pan

Applique une transformation logarithmique pour créer l'image a.pan et utilise les valeurs extrémales possibles du type pour les bornes des valeurs de pixels de sortie :

   ppowerlawtransform 0.4 1 -1 tangram.pan a.pan

Voir aussi

Prototype C++