HALCON Website / HALCON Operator-Referenz / Transformationen / 3D-Transformationen
KlassenKlassen | | Operatoren

affine_trans_point_3dT_affine_trans_point_3dAffineTransPoint3dAffineTransPoint3d (Operator)

Name

affine_trans_point_3dT_affine_trans_point_3dAffineTransPoint3dAffineTransPoint3d — Wendet eine beliebige affine 3D-Transformation auf Punkte an.

Signatur

affine_trans_point_3d( : : HomMat3D, Px, Py, Pz : Qx, Qy, Qz)

Herror T_affine_trans_point_3d(const Htuple HomMat3D, const Htuple Px, const Htuple Py, const Htuple Pz, Htuple* Qx, Htuple* Qy, Htuple* Qz)

void AffineTransPoint3d(const HTuple& HomMat3D, const HTuple& Px, const HTuple& Py, const HTuple& Pz, HTuple* Qx, HTuple* Qy, HTuple* Qz)

HTuple HHomMat3D::AffineTransPoint3d(const HTuple& Px, const HTuple& Py, const HTuple& Pz, HTuple* Qy, HTuple* Qz) const

double HHomMat3D::AffineTransPoint3d(double Px, double Py, double Pz, double* Qy, double* Qz) const

static void HOperatorSet.AffineTransPoint3d(HTuple homMat3D, HTuple px, HTuple py, HTuple pz, out HTuple qx, out HTuple qy, out HTuple qz)

HTuple HHomMat3D.AffineTransPoint3d(HTuple px, HTuple py, HTuple pz, out HTuple qy, out HTuple qz)

double HHomMat3D.AffineTransPoint3d(double px, double py, double pz, out double qy, out double qz)

Beschreibung

affine_trans_point_3daffine_trans_point_3dAffineTransPoint3dAffineTransPoint3dAffineTransPoint3d wendet eine beliebige affine 3D-Transformation (Skalierung, Drehung, Verschiebung) auf die Eingabepunkte (PxPxPxPxpx,PyPyPyPypy,PzPzPzPzpz) an und liefert die Ergebnispunkte in (QxQxQxQxqx,QyQyQyQyqy,QzQzQzQzqz) zurück. Die Transformation wird durch eine homogene Transformationsmatrix beschrieben, die in HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D übergeben wird. Dies entspricht der folgenden Gleichung (Ein- und Ausgabepunkte als homogene Vektoren dargestellt):

Die Transformationsmatrix kann mit Hilfe der Operatoren hom_mat3d_identityhom_mat3d_identityHomMat3dIdentityHomMat3dIdentityHomMat3dIdentity, hom_mat3d_scalehom_mat3d_scaleHomMat3dScaleHomMat3dScaleHomMat3dScale, hom_mat3d_rotatehom_mat3d_rotateHomMat3dRotateHomMat3dRotateHomMat3dRotate, hom_mat3d_translatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslateHomMat3dTranslate etc. aufgebaut werden oder das Resultat von pose_to_hom_mat3dpose_to_hom_mat3dPoseToHomMat3dPoseToHomMat3dPoseToHomMat3d sein.

Falls zum Beispiel HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D eine starre Transformation ist, also aus Rotation und Translation besteht, werden die Punkte folgendermaßen transformiert:

Ausführungsinformationen

Parameter

HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D (input_control)  hom_mat3d → HHomMat3D, HTupleHTupleHtuple (real) (double) (double) (double)

Eingabe-Transformationsmatrix.

PxPxPxPxpx (input_control)  point3d.x(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Eingabepunkt(e) (x-Koordinate).

Defaultwert: 64

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

PyPyPyPypy (input_control)  point3d.y(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Eingabepunkt(e) (y-Koordinate).

Defaultwert: 64

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

PzPzPzPzpz (input_control)  point3d.z(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Eingabepunkt(e) (z-Koordinate).

Defaultwert: 64

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

QxQxQxQxqx (output_control)  point3d.x(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Ausgabepunkt(e) (x-Koordinate).

QyQyQyQyqy (output_control)  point3d.y(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Ausgabepunkt(e) (y-Koordinate).

QzQzQzQzqz (output_control)  point3d.z(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Ausgabepunkt(e) (z-Koordinate).

Ergebnis

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

Vorgänger

hom_mat3d_translatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslateHomMat3dTranslate, hom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocalHomMat3dTranslateLocal, hom_mat3d_scalehom_mat3d_scaleHomMat3dScaleHomMat3dScaleHomMat3dScale, hom_mat3d_scale_localhom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocalHomMat3dScaleLocal, hom_mat3d_rotatehom_mat3d_rotateHomMat3dRotateHomMat3dRotateHomMat3dRotate, hom_mat3d_rotate_localhom_mat3d_rotate_localHomMat3dRotateLocalHomMat3dRotateLocalHomMat3dRotateLocal

Nachfolger

hom_mat3d_translatehom_mat3d_translateHomMat3dTranslateHomMat3dTranslateHomMat3dTranslate, hom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocalHomMat3dTranslateLocal, hom_mat3d_scalehom_mat3d_scaleHomMat3dScaleHomMat3dScaleHomMat3dScale, hom_mat3d_scale_localhom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocalHomMat3dScaleLocal, hom_mat3d_rotatehom_mat3d_rotateHomMat3dRotateHomMat3dRotateHomMat3dRotate, hom_mat3d_rotate_localhom_mat3d_rotate_localHomMat3dRotateLocalHomMat3dRotateLocalHomMat3dRotateLocal

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH