entropy_imageentropy_imageEntropyImageEntropyImage (Operator)

Name

entropy_imageentropy_imageEntropyImageEntropyImage — Entropie der Grauwerte in einem Rechteckfenster.

Signatur

entropy_image(Image : ImageEntropy : Width, Height : )

entropy_imageentropy_imageEntropyImageEntropyImageEntropyImage transformiert die Grauwerte der Eingabebilder aus ImageImageImageImageimage mit Hilfe einer Filtermaske (HeightHeightHeightHeightheight, WidthWidthWidthWidthwidth), in der die Entropie der Grauwerte berechnet wird. Das Ergebnis wird in ImageEntropyImageEntropyImageEntropyImageEntropyimageEntropy abgelegt. Die Entropie wird dabei mit 32 multipliziert. Die Steuerparameter HeightHeightHeightHeightheight und WidthWidthWidthWidthwidth werden, falls sie jeweils einen geraden Wert haben, zu dem nächstgrößeren ungeraden Wert gewandelt. An den Bildrändern wird eine Spiegelung der Randpunkte durchgeführt.

Achtung

Beachten Sie, dass Filteroperatoren eventuell unerwartete Resultate ausgeben, wenn ein Bild mit einer reduzierten Domäne als Input übergeben wird. Weitere Informationen können im Kapitel Filter gefunden werden.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.
Automatisch parallelisiert auf Kanalebene.
Automatisch parallelisiert auf Domainebene.

Parameter

ImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte)

Bilder, in denen die Entropie berechnet werden soll.

ImageEntropyImageEntropyImageEntropyImageEntropyimageEntropy (output_object) (multichannel-)image(-array) → object (byte)

Ergebnisbild.

WidthWidthWidthWidthwidth (input_control) extent.x → (integer)

Breite der Filtermaske.

Defaultwert: 9

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriktion: 3 <= Width && odd(Width)

HeightHeightHeightHeightheight (input_control) extent.y → (integer)

Höhe der Filtermaske.

Defaultwert: 9

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriktion: 3 <= Height && odd(Height)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
entropy_image(Image,Entropy,9,9)
dev_display(Entropy)

Beispiel (C)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
entropy_image(Image,&Entropy,9,9);
disp_image(Entropy,WindowHandle);

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
entropy_image(Image,Entropy,9,9)
dev_display(Entropy)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
entropy_image(Image,Entropy,9,9)
dev_display(Entropy)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
entropy_image(Image,Entropy,9,9)
dev_display(Entropy)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert entropy_imageentropy_imageEntropyImageEntropyImageEntropyImage den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

disp_imagedisp_imageDispImageDispImageDispImage

Alternativen

entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray

Siehe auch

energy_gaborenergy_gaborEnergyGaborEnergyGaborEnergyGabor, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray

Modul

Foundation

Operatoren