get_grayvalT_get_grayvalGetGrayvalGetGrayval (Operator)

Name

get_grayvalT_get_grayvalGetGrayvalGetGrayval — Zugriff auf Grauwerte eines Bildobjektes.

Signatur

get_grayval(Image : : Row, Column : Grayval)

Beschreibung

GrayvalGrayvalGrayvalGrayvalgrayval ist ein Tupel von Gleitkomma- bzw. ganzen Zahlen, das die Grauwerte ausgewählter Bildpunkte von ImageImageImageImageimage 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 RowRowRowRowrow, die Spaltenkoordinaten in ColumnColumnColumnColumncolumn.

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

Achtung

Der Typ der Werte von GrayvalGrayvalGrayvalGrayvalgrayval hängt von dem Typ der Grauwerte ab. Der Aufwand von get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayval ist relativ hoch. Normalerweise wird der Operator verwendet, um einzelne Grauwerte eines Bildes zu erhalten (z.B. durch get_mpositionget_mpositionGetMpositionGetMpositionGetMposition gefolgt von get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayval). Für die Programmierung von Bildverarbeitungsoperationen wie Filter ist er nicht geeignet. Hier ist es sinnvoller, den Operator get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1 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

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

Bild, auf dessen Grauwerte zugegriffen werden soll.

RowRowRowRowrow (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 ≤ 32768 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

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

ColumnColumnColumnColumncolumn (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 ≤ 32768 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 1

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

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

Grauwerte an den angegebenen Bildpunkten.

Ergebnis

Bei korrekter Besetzung der Parameter liefert get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayval 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.

Vorgänger

read_imageread_imageReadImageReadImageReadImage

Alternativen

get_image_pointer1get_image_pointer1GetImagePointer1GetImagePointer1GetImagePointer1, get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolatedGetGrayvalInterpolated, get_grayval_contour_xldget_grayval_contour_xldGetGrayvalContourXldGetGrayvalContourXldGetGrayvalContourXld

Siehe auch

set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayval

Modul

Foundation

Operatoren