get_grayvalT_get_grayvalGetGrayvalGetGrayvalget_grayval (Operator)

Name

get_grayvalT_get_grayvalGetGrayvalGetGrayvalget_grayval — Zugriff auf Grauwerte eines Bildobjektes.

Signatur

get_grayval(Image : : Row, Column : Grayval)

Beschreibung

GrayvalGrayvalGrayvalGrayvalgrayvalgrayval ist ein Tupel von Gleitkomma- bzw. ganzen Zahlen, das die Grauwerte ausgewählter Bildpunkte von ImageImageImageImageimageimage liefert. Bei einem mehrkanaligen Bild wird pro Bildpunkt eine Gruppe von Elementen, d.h. ein Grauwert pro Kanal (oder zwei Grauwerte für komplexe oder Vektorfeld-Bilder), zurückgegeben. Die Zeilenkoordinaten der Bildpunkte stehen im Tupel RowRowRowRowrowrow, die Spaltenkoordinaten in ColumnColumnColumnColumncolumncolumn.

Es ist zu beachten, dass get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayvalget_grayval den Definitionsbereich des Bildes nicht berücksichtigt. D.h. wenn der Definitionsbereich z.B. mit reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain eingeschränkt wurde, werden auch für Punkte die außerhalb des Definitionsbereichs liegen Grauwerte zurück gegeben.

Achtung

Der Typ der Werte von GrayvalGrayvalGrayvalGrayvalgrayvalgrayval hängt von dem Typ der Grauwerte ab. Der Aufwand von get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayvalget_grayval ist relativ hoch. Normalerweise wird der Operator verwendet, um einzelne Grauwerte eines Bildes zu erhalten (z.B. durch get_mpositionget_mpositionGetMpositionGetMpositionGetMpositionget_mposition gefolgt von get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayvalget_grayval). Für die Programmierung von Bildverarbeitungsoperationen wie Filter ist er nicht geeignet. Hier ist es sinnvoller, den Operator get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1get_image_pointer1 und direkt die C- oder C++-Schnittstelle zum Einbinden von eigenen Prozeduren zu verwenden.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

ImageImageImageImageimageimage (input_object) (multichannel-)image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Bild, auf dessen Grauwerte zugegriffen werden soll.

RowRowRowRowrowrow (input_control) point.y(-array) → (integer)

Zeilennummern der zu betrachtenden Bildpunkte.

Defaultwert: 0

Wertevorschläge: 0, 64, 128, 256, 512, 1024

Typischer Wertebereich: 0 ≤ Row Row Row Row row row ≤ 32768 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: 0 <= Row && Row < height(Image)

ColumnColumnColumnColumncolumncolumn (input_control) point.x(-array) → (integer)

Spaltennummern der zu betrachtenden Bildpunkte.

Parameteranzahl: Column == Row

Defaultwert: 0

Wertevorschläge: 0, 64, 128, 256, 512, 1024

Typischer Wertebereich: 0 ≤ Column Column Column Column column column ≤ 32768 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

Restriktion: 0 <= Column && Column < width(Image)

GrayvalGrayvalGrayvalGrayvalgrayvalgrayval (output_control) grayval-array → (real / integer)

Grauwerte an den angegebenen Bildpunkten.

Ergebnis

Bei korrekter Besetzung der Parameter liefert get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayvalget_grayval den Wert 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.

Vorgänger

read_imageread_imageReadImageReadImageReadImageread_image

Alternativen

get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1get_image_pointer1, get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolatedGetGrayvalInterpolatedget_grayval_interpolated, get_grayval_contour_xldget_grayval_contour_xldGetGrayvalContourXldGetGrayvalContourXldGetGrayvalContourXldget_grayval_contour_xld

Siehe auch

set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval

Modul

Foundation

Operatoren