gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectgray_range_rect (Operator)

Name

gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectgray_range_rect — Maximale Amplitude der Grauwerte in einem Rechteck.

Signatur

gray_range_rect(Image : ImageResult : MaskHeight, MaskWidth : )

Beschreibung

gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectGrayRangeRectgray_range_rect transformiert die Grauwerte der Eingabebilder aus ImageImageImageImageimageimage mit Hilfe einer Filtermaske (MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height, MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width), in der die Spanne (max - min) der Grauwerte berechnet wird. Das Ergebnis wird in die Ausgabebilder ImageResultImageResultImageResultImageResultimageResultimage_result eingetragen. Die Steuerparameter MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height, MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width 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

ImageImageImageImageimageimage (input_object) (multichannel-)image(-array) → object (byte / cyclic / uint2 / int2 / int4 / real)

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

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

Bilder, die das Ergebnis enthalten.

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height (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 mask_height ≤ 511 (lin)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

Restriktion: odd(MaskHeight) && MaskHeight < height(Image) * 2

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width (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 mask_width ≤ 511 (lin)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

Restriktion: odd(MaskWidth) && MaskWidth < width(Image) * 2

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gray_range_rectgray_range_rectGrayRangeRectGrayRangeRectGrayRangeRectgray_range_rect 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>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Alternativen

gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRectgray_dilation_rect, gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRectgray_erosion_rect, sub_imagesub_imageSubImageSubImageSubImagesub_image

Modul

Foundation

Operatoren