KlassenKlassenKlassenKlassen | | | | Operatoren

get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated (Operator)

Name

get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated — Gibt Grauwerte eines Bildes an durch Zeilen- und Spaltenkoordinaten gegebenen Positionen zurück.

Signatur

get_grayval_interpolated(Image : : Row, Column, Interpolation : Grayval)

Herror get_grayval_interpolated(const Hobject Image, double Row, double Column, const char* Interpolation, double* Grayval)

Herror T_get_grayval_interpolated(const Hobject Image, const Htuple Row, const Htuple Column, const Htuple Interpolation, Htuple* Grayval)

Herror get_grayval_interpolated(Hobject Image, const HTuple& Row, const HTuple& Column, const HTuple& Interpolation, double* Grayval)

Herror get_grayval_interpolated(Hobject Image, const HTuple& Row, const HTuple& Column, const HTuple& Interpolation, HTuple* Grayval)

HTuple HImage::GetGrayvalInterpolated(const HTuple& Row, const HTuple& Column, const HTuple& Interpolation) const

void GetGrayvalInterpolated(const HObject& Image, const HTuple& Row, const HTuple& Column, const HTuple& Interpolation, HTuple* Grayval)

HTuple HImage::GetGrayvalInterpolated(const HTuple& Row, const HTuple& Column, const HString& Interpolation) const

double HImage::GetGrayvalInterpolated(double Row, double Column, const HString& Interpolation) const

double HImage::GetGrayvalInterpolated(double Row, double Column, const char* Interpolation) const

void HOperatorSetX.GetGrayvalInterpolated(
[in] IHUntypedObjectX* Image, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Interpolation, [out] VARIANT* Grayval)

VARIANT HImageX.GetGrayvalInterpolated(
[in] VARIANT Row, [in] VARIANT Column, [in] BSTR Interpolation)

static void HOperatorSet.GetGrayvalInterpolated(HObject image, HTuple row, HTuple column, HTuple interpolation, out HTuple grayval)

HTuple HImage.GetGrayvalInterpolated(HTuple row, HTuple column, string interpolation)

double HImage.GetGrayvalInterpolated(double row, double column, string interpolation)

Beschreibung

Der Operator get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated liefert die intepolierten Grauwerte einzelner Subpixel-Positionen des Bildes ImageImageImageImageImageimage. Die Koordinaten der Zeilenpositionen werden in dem Tupel RowRowRowRowRowrow, die Koordinaten der Spaltenpositionen in dem Tupel ColumnColumnColumnColumnColumncolumn übergeben. Der Grauwerte werden in GrayvalGrayvalGrayvalGrayvalGrayvalgrayval als ein Tupel von Gleitkommazahlen zurückgegeben.

Das Interpolationsverfahren kann mittels des Parameters InterpolationInterpolationInterpolationInterpolationInterpolationinterpolation gewählt werden. Folgende Interpolationsmethoden werden unterstützt:

'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear":

Die Ergebnisse in GrayvalGrayvalGrayvalGrayvalGrayvalgrayval werden mittels einer bilinearen Interpolation berechnet, die die vier benachbarten Grauwerte der gegebenen Koordinaten nutzt. Direction- und Cyclic-Bilder werden behandelt wie Byte-Bilder.

'bicubic'"bicubic""bicubic""bicubic""bicubic""bicubic":

Die Ergebnisse in GrayvalGrayvalGrayvalGrayvalGrayvalgrayval 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.

'bicubic_clipped'"bicubic_clipped""bicubic_clipped""bicubic_clipped""bicubic_clipped""bicubic_clipped":

Die Ergebnisse in GrayvalGrayvalGrayvalGrayvalGrayvalgrayval 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_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated den Definitionsbereich des Bildes nicht berücksichtigt. D.h. wenn der Definitionsbereich z.B. mit reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain eingeschränkt wurde, werden auch für Punkte die außerhalb des Definitionsbereichs liegen Grauwerte zurück gegeben.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex)

Bild, auf dessen Grauwerte zugegriffen werden soll.

RowRowRowRowRowrow (input_control)  point.y(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Zeilenkoordinaten der Positionen.

Defaultwert: 0

Wertevorschläge: 0, 64, 128, 256, 512, 1024

Typischer Wertebereich: -0.5 ≤ Row Row Row Row Row row

Restriktion: -0.5 <= Row && Row < height(Image) - 0.5

ColumnColumnColumnColumnColumncolumn (input_control)  point.x(-array) HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Spaltenkoordinaten der Positionen.

Parameteranzahl: Column == Row

Defaultwert: 0

Wertevorschläge: 0, 64, 128, 256, 512, 1024

Typischer Wertebereich: -0.5 ≤ Column Column Column Column Column column

Restriktion: -0.5 <= Column && Column < width(Image) - 0.5

InterpolationInterpolationInterpolationInterpolationInterpolationinterpolation (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Interpolationsverfahren.

Defaultwert: 'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear"

Werteliste: 'bicubic'"bicubic""bicubic""bicubic""bicubic""bicubic", 'bicubic_clipped'"bicubic_clipped""bicubic_clipped""bicubic_clipped""bicubic_clipped""bicubic_clipped", 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear"

GrayvalGrayvalGrayvalGrayvalGrayvalgrayval (output_control)  grayval(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Grauwerte an den angegebenen Bildkoordinaten.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert get_grayval_interpolatedget_grayval_interpolatedGetGrayvalInterpolatedget_grayval_interpolatedGetGrayvalInterpolatedGetGrayvalInterpolated den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageread_imageReadImageReadImage

Alternativen

get_grayval_contour_xldget_grayval_contour_xldGetGrayvalContourXldget_grayval_contour_xldGetGrayvalContourXldGetGrayvalContourXld, get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren