get_grayval — Zugriff auf Grauwerte eines Bildobjektes.
Grayval ist ein Tupel von Gleitkomma- bzw. ganzen Zahlen,
das die Grauwerte ausgewählter Bildpunkte von Image
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 Row, die
Spaltenkoordinaten in Column.
Es ist zu beachten, dass get_grayval den Definitionsbereich
des Bildes nicht berücksichtigt. D.h. wenn der Definitionsbereich z.B.
mit reduce_domain eingeschränkt wurde, werden auch für Punkte
die außerhalb des Definitionsbereichs liegen Grauwerte zurück gegeben.
Der Typ der Werte von Grayval hängt von dem Typ der
Grauwerte ab. Der Aufwand von get_grayval ist relativ hoch.
Normalerweise wird der Operator verwendet, um einzelne Grauwerte
eines Bildes zu erhalten (z.B. durch get_mposition gefolgt
von get_grayval). Für die Programmierung von
Bildverarbeitungsoperationen wie Filter ist er nicht geeignet. Hier
ist es sinnvoller, den Operator get_image_pointer1 und
direkt die C- oder C++-Schnittstelle zum Einbinden von eigenen
Prozeduren zu verwenden.
Image (input_object) (multichannel-)image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)
Bild, auf dessen Grauwerte zugegriffen werden soll.
Row (input_control) point.y(-array) → (integer)
Zeilennummern der zu betrachtenden Bildpunkte.
Default: 0
Wertevorschläge: 0, 64, 128, 256, 512, 1024
Wertebereich:
0
≤
Row
≤
32767 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Restriktion:
0 <= Row && Row < height(Image)
Column (input_control) point.x(-array) → (integer)
Spaltennummern der zu betrachtenden Bildpunkte.
Parameteranzahl: Column == Row
Default: 0
Wertevorschläge: 0, 64, 128, 256, 512, 1024
Wertebereich:
0
≤
Column
≤
32767 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
Restriktion:
0 <= Column && Column < width(Image)
Grayval (output_control) grayval-array → (real / integer)
Grauwerte an den angegebenen Bildpunkten.
Bei korrekter Besetzung der Parameter liefert get_grayval
den Wert 2 (
H_MSG_TRUE)
.
Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt
sich mittels set_system('no_object_result',<Result>)
festlegen.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
get_image_pointer1,
get_grayval_interpolated,
get_grayval_contour_xld
Foundation