get_grayval_interpolated
— Gibt Grauwerte eines Bildes an durch Zeilen- und Spaltenkoordinaten
gegebenen Positionen zurück.
get_grayval_interpolated(Image : : Row, Column, Interpolation : Grayval)
Der Operator get_grayval_interpolated
liefert die
intepolierten Grauwerte einzelner Subpixel-Positionen des Bildes
Image
. Die Koordinaten der Zeilenpositionen werden in dem
Tupel Row
, die Koordinaten der Spaltenpositionen in dem
Tupel Column
übergeben. Der Grauwerte werden in
Grayval
als ein Tupel von Gleitkommazahlen zurückgegeben.
Das Interpolationsverfahren kann mittels des Parameters
Interpolation
gewählt werden. Folgende
Interpolationsmethoden werden unterstützt:
Die Ergebnisse in
Grayval
werden mittels einer bilinearen Interpolation
berechnet, die die vier benachbarten Grauwerte der gegebenen
Koordinaten nutzt. 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. 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. 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_interpolated
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.
Image
(input_object) singlechannelimage →
object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex)
Bild, auf dessen Grauwerte zugegriffen werden soll.
Row
(input_control) point.y(-array) →
(real / integer)
Zeilenkoordinaten der Positionen.
Defaultwert: 0
Wertevorschläge: 0, 64, 128, 256, 512, 1024
Typischer Wertebereich: -0.5
≤
Row
Restriktion: -0.5 <= Row && Row < height(Image) - 0.5
Column
(input_control) point.x(-array) →
(real / integer)
Spaltenkoordinaten der Positionen.
Parameteranzahl: Column == Row
Defaultwert: 0
Wertevorschläge: 0, 64, 128, 256, 512, 1024
Typischer Wertebereich: -0.5
≤
Column
Restriktion: -0.5 <= Column && Column < width(Image) - 0.5
Interpolation
(input_control) string →
(string)
Interpolationsverfahren.
Defaultwert: 'bilinear'
Werteliste: 'bicubic' , 'bicubic_clipped' , 'bilinear'
Grayval
(output_control) grayval(-array) →
(real)
Grauwerte an den angegebenen Bildkoordinaten.
Sind die Parameterwerte korrekt, dann liefert
get_grayval_interpolated
den Wert 2 (H_MSG_TRUE). Gegebenenfalls
wird eine Fehlerbehandlung durchgeführt.
get_grayval_contour_xld
,
get_grayval
Foundation