hom_mat2d_slantT_hom_mat2d_slantHomMat2dSlantHomMat2dSlant (Operator)

Name

hom_mat2d_slantT_hom_mat2d_slantHomMat2dSlantHomMat2dSlant — Fügt eine Scherung zu einer homogenen 2D-Transformationsmatrix hinzu.

Signatur

hom_mat2d_slant( : : HomMat2D, Theta, Axis, Px, Py : HomMat2DSlant)

Herror T_hom_mat2d_slant(const Htuple HomMat2D, const Htuple Theta, const Htuple Axis, const Htuple Px, const Htuple Py, Htuple* HomMat2DSlant)

void HomMat2dSlant(const HTuple& HomMat2D, const HTuple& Theta, const HTuple& Axis, const HTuple& Px, const HTuple& Py, HTuple* HomMat2DSlant)

HHomMat2D HHomMat2D::HomMat2dSlant(const HTuple& Theta, const HString& Axis, const HTuple& Px, const HTuple& Py) const

HHomMat2D HHomMat2D::HomMat2dSlant(double Theta, const HString& Axis, double Px, double Py) const

HHomMat2D HHomMat2D::HomMat2dSlant(double Theta, const char* Axis, double Px, double Py) const

HHomMat2D HHomMat2D::HomMat2dSlant(double Theta, const wchar_t* Axis, double Px, double Py) const   (Nur Windows)

static void HOperatorSet.HomMat2dSlant(HTuple homMat2D, HTuple theta, HTuple axis, HTuple px, HTuple py, out HTuple homMat2DSlant)

HHomMat2D HHomMat2D.HomMat2dSlant(HTuple theta, string axis, HTuple px, HTuple py)

HHomMat2D HHomMat2D.HomMat2dSlant(double theta, string axis, double px, double py)

Beschreibung

hom_mat2d_slanthom_mat2d_slantHomMat2dSlantHomMat2dSlantHomMat2dSlant fügt zur homogenen 2D-Transformationsmatrix HomMat2DHomMat2DHomMat2DHomMat2DhomMat2D eine Scherung um den Winkel ThetaThetaThetaThetatheta hinzu und liefert die resultierende Matrix in HomMat2DSlantHomMat2DSlantHomMat2DSlantHomMat2DSlanthomMat2DSlant zurück. Eine Scherung ist eine affine Transformation, bei der eine Koordinatenachse festgehalten wird, während die andere Koordinatenachse um den Winkel ThetaThetaThetaThetatheta im Gegenuhrzeigersinn gedreht wird. Der Parameter AxisAxisAxisAxisaxis bestimmt, für welche Koordinatenachse die Scherung ausgeführt werden soll. Für AxisAxisAxisAxisaxis = 'x'"x""x""x""x" wird die x-Achse geschert und die y-Achse festgehalten, für AxisAxisAxisAxisaxis = 'y'"y""y""y""y" wird die y-Achse geschert und die x-Achse festgehalten. Die Scherung wird relativ zum globalen (d.h. feststehenden) Koordinatensystem ausgeführt; dies entspricht der folgenden Kette von Transformationsmatrizen:

Der Punkt (PxPxPxPxpx,PyPyPyPypy) ist dabei der Fixpunkt der Scherung, d.h. dieser Punkt bleibt unverändert, wenn man ihn mit HomMat2DSlantHomMat2DSlantHomMat2DSlantHomMat2DSlanthomMat2DSlant transformiert. Dieses Verhalten wird erreicht, indem zur Eingabe-Transformationsmatrix zuerst eine Translation hinzugefügt wird, die den Fixpunkt in den Ursprung des globalen Koordinatensystems verschiebt. Dann wird die Scherung hinzugefügt, und zuletzt eine Translation, die den Fixpunkt wieder zurück in seine Ausgangsposition verschiebt. Dies entspricht der folgenden Kette von Transformationsmatrizen für AxisAxisAxisAxisaxis = 'x'"x""x""x""x":

Um die Transformation im lokalen Koordinatensystem, das durch HomMat2DHomMat2DHomMat2DHomMat2DhomMat2D beschrieben ist, durchzuführen, kann hom_mat2d_slant_localhom_mat2d_slant_localHomMat2dSlantLocalHomMat2dSlantLocalHomMat2dSlantLocal verwendet werden.

Achtung

Es ist zu beachten, dass homogene Transformationsmatrizen sich auf ein allgemeines rechtshändiges mathematisches Koordinatensystem beziehen. Falls eine homogene Transformationsmatrix zur Transformation von Bildern, Regionen, XLD-Konturen oder anderen Daten, die aus Bildern extrahiert wurden, verwendet werden soll, ist zu beachten, dass die Zeilenkoordinaten in den x-Koordinaten und die Spaltenkoordinaten in den y-Koordinaten übergeben werden müssen. Die Übergabereihenfolge von Zeilen- und Spaltenkoordinaten entspricht also der üblichen Reihenfolge (RowRowRowRowrow,ColumnColumnColumnColumncolumn). Diese Konvention ist unerlässlich, um bei der Transformation von Bilddaten ein rechtshändiges Koordinatensystem zu erhalten, so dass z.B. insbesondere Rotationen in der mathematisch korrekten Drehrichtung ausgeführt werden.

Homogene Transformationsmatrizen werden zeilenweise in Form eines Tupels abgespeichert; die letzte Zeile wird im Normalfall nicht gespeichert, da sie für alle affinen Transformationsmatrizen identisch ist. Zum Beispiel wird die Matrix als das Tupel [ra, rb, tc, rd, re, tf] gespeichert. Es ist aber auch möglich, volle 3×3 Matrizen, die eine projektive 2D-Transformation darstellen können, zu verarbeiten.

Ausführungsinformationen

Parameter

HomMat2DHomMat2DHomMat2DHomMat2DhomMat2D (input_control)  hom_mat2d HHomMat2D, HTupleHTupleHtuple (real) (double) (double) (double)

Eingabe-Transformationsmatrix.

ThetaThetaThetaThetatheta (input_control)  angle.rad HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Winkel der Scherung.

Defaultwert: 0.78

Wertevorschläge: 0.1, 0.2, 0.3, 0.4, 0.78, 1.57, 3.14

Typischer Wertebereich: 0 ≤ Theta Theta Theta Theta theta ≤ 6.28318530718

AxisAxisAxisAxisaxis (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Koordinatenachse, die geschert wird.

Defaultwert: 'x' "x" "x" "x" "x"

Werteliste: 'x'"x""x""x""x", 'y'"y""y""y""y"

PxPxPxPxpx (input_control)  point.x HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Fixpunkt der Transformation (x-Koordinate).

Defaultwert: 0

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

PyPyPyPypy (input_control)  point.y HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Fixpunkt der Transformation (y-Koordinate).

Defaultwert: 0

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

HomMat2DSlantHomMat2DSlantHomMat2DSlantHomMat2DSlanthomMat2DSlant (output_control)  hom_mat2d HHomMat2D, HTupleHTupleHtuple (real) (double) (double) (double)

Ausgabe-Transformationsmatrix.

Ergebnis

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

Vorgänger

hom_mat2d_identityhom_mat2d_identityHomMat2dIdentityHomMat2dIdentityHomMat2dIdentity, hom_mat2d_translatehom_mat2d_translateHomMat2dTranslateHomMat2dTranslateHomMat2dTranslate, hom_mat2d_scalehom_mat2d_scaleHomMat2dScaleHomMat2dScaleHomMat2dScale, hom_mat2d_rotatehom_mat2d_rotateHomMat2dRotateHomMat2dRotateHomMat2dRotate, hom_mat2d_slanthom_mat2d_slantHomMat2dSlantHomMat2dSlantHomMat2dSlant, hom_mat2d_reflecthom_mat2d_reflectHomMat2dReflectHomMat2dReflectHomMat2dReflect

Nachfolger

hom_mat2d_translatehom_mat2d_translateHomMat2dTranslateHomMat2dTranslateHomMat2dTranslate, hom_mat2d_scalehom_mat2d_scaleHomMat2dScaleHomMat2dScaleHomMat2dScale, hom_mat2d_rotatehom_mat2d_rotateHomMat2dRotateHomMat2dRotateHomMat2dRotate, hom_mat2d_slanthom_mat2d_slantHomMat2dSlantHomMat2dSlantHomMat2dSlant, hom_mat2d_reflecthom_mat2d_reflectHomMat2dReflectHomMat2dReflectHomMat2dReflect

Siehe auch

hom_mat2d_slant_localhom_mat2d_slant_localHomMat2dSlantLocalHomMat2dSlantLocalHomMat2dSlantLocal

Modul

Foundation