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
interpolierten 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.
Default: 0
Wertevorschläge: 0, 64, 128, 256, 512, 1024
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
Default: 0
Wertevorschläge: 0, 64, 128, 256, 512, 1024
Wertebereich:
-0.5
≤
Column
Restriktion:
-0.5 <= Column && Column < width(Image) - 0.5
Interpolation (input_control) string → (string)
Interpolationsverfahren.
Default: '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