HALCON Website / HALCON Operator-Referenz / Transformationen / 2D-Transformationen
KlassenKlassenKlassenKlassen | | | | Operatoren

hom_mat2d_translateT_hom_mat2d_translateHomMat2dTranslatehom_mat2d_translateHomMat2dTranslateHomMat2dTranslate (Operator)

Name

hom_mat2d_translateT_hom_mat2d_translateHomMat2dTranslatehom_mat2d_translateHomMat2dTranslateHomMat2dTranslate — Fügt eine Translation zu einer homogenen 2D-Transformationsmatrix hinzu.

Signatur

hom_mat2d_translate( : : HomMat2D, Tx, Ty : HomMat2DTranslate)

Herror T_hom_mat2d_translate(const Htuple HomMat2D, const Htuple Tx, const Htuple Ty, Htuple* HomMat2DTranslate)

Herror hom_mat2d_translate(const HTuple& HomMat2D, const HTuple& Tx, const HTuple& Ty, HTuple* HomMat2DTranslate)

void HomMat2dTranslate(const HTuple& HomMat2D, const HTuple& Tx, const HTuple& Ty, HTuple* HomMat2DTranslate)

HHomMat2D HHomMat2D::HomMat2dTranslate(const HTuple& Tx, const HTuple& Ty) const

HHomMat2D HHomMat2D::HomMat2dTranslate(double Tx, double Ty) const

void HOperatorSetX.HomMat2dTranslate(
[in] VARIANT HomMat2d, [in] VARIANT Tx, [in] VARIANT Ty, [out] VARIANT* HomMat2dTranslate)

IHHomMat2DX* HHomMat2DX.HomMat2dTranslate(
[in] VARIANT Tx, [in] VARIANT Ty)

static void HOperatorSet.HomMat2dTranslate(HTuple homMat2D, HTuple tx, HTuple ty, out HTuple homMat2DTranslate)

HHomMat2D HHomMat2D.HomMat2dTranslate(HTuple tx, HTuple ty)

HHomMat2D HHomMat2D.HomMat2dTranslate(double tx, double ty)

Beschreibung

hom_mat2d_translatehom_mat2d_translateHomMat2dTranslatehom_mat2d_translateHomMat2dTranslateHomMat2dTranslate fügt zur homogenen 2D-Transformationsmatrix HomMat2DHomMat2DHomMat2DHomMat2DHomMat2DhomMat2D eine Translation um den Vektor t = (TxTxTxTxTxtx,TyTyTyTyTyty) hinzu und liefert die resultierende Matrix in HomMat2DTranslateHomMat2DTranslateHomMat2DTranslateHomMat2DTranslateHomMat2DTranslatehomMat2DTranslate zurück. Die Translation wird relativ zum globalen (d.h. feststehenden) Koordinatensystem ausgeführt; dies entspricht der folgenden Kette von Transformationsmatrizen:

Um die Transformation im lokalen Koordinatensystem, das durch HomMat2DHomMat2DHomMat2DHomMat2DHomMat2DhomMat2D beschrieben ist, durchzuführen, kann hom_mat2d_translate_localhom_mat2d_translate_localHomMat2dTranslateLocalhom_mat2d_translate_localHomMat2dTranslateLocalHomMat2dTranslateLocal 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 (RowRowRowRowRowrow,ColumnColumnColumnColumnColumncolumn). 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.

Parallelisierung

Parameter

HomMat2DHomMat2DHomMat2DHomMat2DHomMat2DhomMat2D (input_control)  hom_mat2d → HHomMat2D, HTupleHTupleHTupleHHomMat2DX, VARIANTHtuple (real) (double) (double) (double) (double) (double)

Eingabe-Transformationsmatrix.

TxTxTxTxTxtx (input_control)  point.x → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Verschiebung in x-Richtung.

Defaultwert: 64

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

TyTyTyTyTyty (input_control)  point.y → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Verschiebung in y-Richtung.

Defaultwert: 64

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

HomMat2DTranslateHomMat2DTranslateHomMat2DTranslateHomMat2DTranslateHomMat2DTranslatehomMat2DTranslate (output_control)  hom_mat2d → HHomMat2D, HTupleHTupleHTupleHHomMat2DX, VARIANTHtuple (real) (double) (double) (double) (double) (double)

Ausgabe-Transformationsmatrix.

Ergebnis

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

Vorgänger

hom_mat2d_identityhom_mat2d_identityHomMat2dIdentityhom_mat2d_identityHomMat2dIdentityHomMat2dIdentity, hom_mat2d_translatehom_mat2d_translateHomMat2dTranslatehom_mat2d_translateHomMat2dTranslateHomMat2dTranslate, hom_mat2d_scalehom_mat2d_scaleHomMat2dScalehom_mat2d_scaleHomMat2dScaleHomMat2dScale, hom_mat2d_rotatehom_mat2d_rotateHomMat2dRotatehom_mat2d_rotateHomMat2dRotateHomMat2dRotate, hom_mat2d_slanthom_mat2d_slantHomMat2dSlanthom_mat2d_slantHomMat2dSlantHomMat2dSlant, hom_mat2d_reflecthom_mat2d_reflectHomMat2dReflecthom_mat2d_reflectHomMat2dReflectHomMat2dReflect

Nachfolger

hom_mat2d_translatehom_mat2d_translateHomMat2dTranslatehom_mat2d_translateHomMat2dTranslateHomMat2dTranslate, hom_mat2d_scalehom_mat2d_scaleHomMat2dScalehom_mat2d_scaleHomMat2dScaleHomMat2dScale, hom_mat2d_rotatehom_mat2d_rotateHomMat2dRotatehom_mat2d_rotateHomMat2dRotateHomMat2dRotate, hom_mat2d_slanthom_mat2d_slantHomMat2dSlanthom_mat2d_slantHomMat2dSlantHomMat2dSlant, hom_mat2d_reflecthom_mat2d_reflectHomMat2dReflecthom_mat2d_reflectHomMat2dReflectHomMat2dReflect

Siehe auch

hom_mat2d_translate_localhom_mat2d_translate_localHomMat2dTranslateLocalhom_mat2d_translate_localHomMat2dTranslateLocalHomMat2dTranslateLocal

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH