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.
Defaultwert: 0
Wertevorschläge: 0, 64, 128, 256, 512, 1024
Typischer Wertebereich: 0
≤
Row
≤
32768
(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
Defaultwert: 0
Wertevorschläge: 0, 64, 128, 256, 512, 1024
Typischer Wertebereich: 0
≤
Column
≤
32768
(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