illuminateilluminateIlluminateIlluminate (Operator)

Name

illuminateilluminateIlluminateIlluminate — Ausleuchten von Bildern.

Signatur

Beschreibung

illuminateilluminateIlluminateIlluminateIlluminate dient der Kontrastverbesserung. Sehr dunkle Bildteile werden besser „ausgeleuchtet“, sehr helle „abgedunkelt“. Sei orig der Original Grauwert und mean der mittels mean_imagemean_imageMeanImageMeanImageMeanImage und Filtergröße MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight x MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth ermittelte zugehörige Grauwert des tiefpassgefilterten Bildes. Bei byte-Bildern ist val gleich 127, bei int2-Bildern und uint2-Bildern ist val gleich dem Mittelwert. Dann ist der Ergebnisgrauwert new:

             new = round ( (val - mean) * Factor + orig ).

   Height Width  Factor
   ---------------------
    40     40     0.55
   100    100     0.7
   150    150     0.8

Hingewiesen sei noch auf folgenden „Scheinwerfereffekt“: Befindet sich in einem Bild beispielsweise ein dunkles Objekt vor einer hellen Wand, so wird das Objekt, in unmittelbarer Nähe der Objektkontur aber auch die ohnehin schon helle Wand durch die Anwendung von illuminateilluminateIlluminateIlluminateIlluminate aufgehellt. Dies entspricht in etwa dem Effekt, der sich durch Anstrahlen des Objekts mit einem starken Scheinwerfer ergeben. Analoges gilt auch für helle Objekte vor einem dunklen Hintergrund. Der fiktive „Scheinwerfer“ verdunkelt nun allerdings Objekte.

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 interner Datenebene.

Parameter

read_image(Image,'fabrik')
dev_display (Image)
illuminate(Image,Better,40,40,0.55)
dev_display (Better)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
illuminate(Image,&Better,40,40,0.55);
disp_image(Better,WindowHandle); 

read_image(Image,'fabrik')
dev_display (Image)
illuminate(Image,Better,40,40,0.55)
dev_display (Better)

read_image(Image,'fabrik')
dev_display (Image)
illuminate(Image,Better,40,40,0.55)
dev_display (Better)

read_image(Image,'fabrik')
dev_display (Image)
illuminate(Image,Better,40,40,0.55)
dev_display (Better)

Ergebnis

illuminateilluminateIlluminateIlluminateIlluminate liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. 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

scale_image_maxscale_image_maxScaleImageMaxScaleImageMaxScaleImageMax, equ_histo_imageequ_histo_imageEquHistoImageEquHistoImageEquHistoImage, mean_imagemean_imageMeanImageMeanImageMeanImage, sub_imagesub_imageSubImageSubImageSubImage

Siehe auch

emphasizeemphasizeEmphasizeEmphasizeEmphasize, gray_histogray_histoGrayHistoGrayHistoGrayHisto

Modul

Foundation