gray_range_rectgray_range_rectGrayRangeRectGrayRangeRect (Operator)

Name

gray_range_rectgray_range_rectGrayRangeRectGrayRangeRect — Maximale Amplitude der Grauwerte in einem Rechteck.

Signatur

gray_range_rect(Image : ImageResult : MaskHeight, MaskWidth : )

Beschreibung

gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectGrayRangeRect transformiert die Grauwerte der Eingabebiler aus ImageImageImageImageimage mit Hilfe einer Filtermaske (MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight, MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth), in der die Spanne (max - min) der Grauwerte berechnet wird. Das Ergebnis wird in die Ausgabebilder ImageResultImageResultImageResultImageResultimageResult eingetragen. Die Steuerparameter MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight, MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth werden, wenn sie einen geraden Wert haben, in den nächstkleineren ungeraden Wert transformiert. 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

Unterstützt OpenCL Compute Devices.
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 / cyclic / uint2 / int2 / int4 / real)

Bilder, für deren Grauwerte die Amplitude berechnet werden sollen.

ImageResultImageResultImageResultImageResultimageResult (output_object) (multichannel-)image(-array) → object (byte / cyclic / uint2 / int2 / int4 / real)

Bilder, die das Ergebnis enthalten.

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeight (input_control) extent.y → (integer)

Höhe der Filtermaske.

Defaultwert: 11

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15

Typischer Wertebereich: 3 ≤ MaskHeight MaskHeight MaskHeight MaskHeight maskHeight ≤ 511 (lin)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

Restriktion: odd(MaskHeight)

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidth (input_control) extent.x → (integer)

Breite der Filtermaske.

Defaultwert: 11

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15

Typischer Wertebereich: 3 ≤ MaskWidth MaskWidth MaskWidth MaskWidth maskWidth ≤ 511 (lin)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

Restriktion: odd(MaskWidth)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectGrayRangeRect 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.

Alternativen

gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRect, gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRect, sub_imagesub_imageSubImageSubImageSubImage

Modul

Foundation

Operatoren