get_grayval_contour_xld — Gibt Grauwerte eines Bildes an den Positionen einer XLD-Kontur
zurück.
get_grayval_contour_xld(Image, Contour : : Interpolation : Grayval)
Der Operator get_grayval_contour_xld liefert die
interpolierten Grauwerte einzelner Subpixel-Positionen des Bildes
Image. Die Koordinaten der Positionen werden durch eine
XLD-Kontur Contour vorgegeben. Die Grauwerte werden in
Grayval zurückgegeben.
Das Interpolationsverfahren kann mittels des Parameters
Interpolation gewählt werden:
Die Ergebnisse
in Grayval sind die Grauwerte der nächstgelegenen Pixel
der gegebenen Koordinaten. Für Bilder des Typs byte, direction,
cyclic, uint2, int1, int2, int4 und int8 ist der Parameter
Grayval ein Tupel von ganzen Zahlen. Für Bilder des Typs
real und complex ist der Parameter Grayval ein Tupel von
Gleitkommazahlen.
Die Ergebnisse in
Grayval werden mittels einer bilinearen Interpolation
berechnet, die die vier benachbarten Grauwerte der gegebenen
Koordinaten nutzt. Der Parameter Grayval mit dem Ergebnis
ist ein Tupel von Gleitkommazahlen. Die Laufzeit steigt
signifikant gegenüber 'nearest_neighbor'. Direction- und
Cyclic-Bilder werden behandelt wie Byte-Bilder.
Die Ergebnisse in
Grayval werden mittels einer bikubischen Interpolation
berechnet, die sechzehn benachbarte Grauwerte der gegebenen
Koordinaten nutzt. Der Parameter Grayval mit dem Ergebnis
ist ein Tupel von Gleitkommazahlen. Die Laufzeit steigt
signifikant gegenüber 'bilinear'. Direction- und
Cyclic-Bilder werden behandelt wie Byte-Bilder. In diesem Modus
können Grauwerte als Ergebnis auftreten, die außerhalb des
darstellbaren Zahlenbereiches des Eingabebildtyps liegen.
Die Ergebnisse in
Grayval werden mittels einer bikubischen Interpolation
berechnet, die sechzehn benachbarte Grauwerte der gegebenen
Koordinaten nutzt. Der Parameter Grayval mit dem Ergebnis
ist ein Tupel von Gleitkommazahlen. Die Laufzeit steigt
signifikant gegenüber 'bilinear'. Direction- und
Cyclic-Bilder werden behandelt wie Byte-Bilder. In diesem Modus
werden Ergebnisse, die außerhalb des darstellbaren Zahlenbereiches
des Eingabebildtyps liegen, auf den darstellbaren Bereich
beschnitten.
Es ist zu beachten, dass get_grayval_contour_xld 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.
Es ist außerdem zu beachten, dass jeder Punkt der XLD-Kontour im
Bereich -0.5 <= Zeilenkoordinate <
Höhe(Image)-0.5 und -0.5 <= Spaltenkoordinate
< Breite(Image)-0.5 liegen muss.
Image (input_object) singlechannelimage → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex)
Bild, auf dessen Grauwerte zugegriffen werden soll.
Contour (input_object) xld_cont → object
Eingabe-Kontur mit den Koordinaten der Positionen.
Interpolation (input_control) string → (string)
Interpolationsverfahren.
Defaultwert: 'nearest_neighbor'
Werteliste: 'bicubic', 'bicubic_clipped', 'bilinear', 'nearest_neighbor'
Grayval (output_control) grayval(-array) → (real / integer)
Grauwerte an den angegebenen Bildkoordinaten.
Sind die Parameterwerte korrekt, dann liefert
get_grayval_contour_xld den Wert 2 (H_MSG_TRUE). Gegebenenfalls
wird eine Fehlerbehandlung durchgeführt.
read_image,
draw_xld,
gen_contour_polygon_xld,
edges_sub_pix
Foundation