HALCON Website / HALCON Operator-Referenz / Transformationen / Duale Quaternionen
KlassenKlassen | | Operatoren

dual_quat_trans_line_3dT_dual_quat_trans_line_3dDualQuatTransLine3dDualQuatTransLine3d (Operator)

Name

dual_quat_trans_line_3dT_dual_quat_trans_line_3dDualQuatTransLine3dDualQuatTransLine3d — Transformieren einer 3D-Linie mit einer dualen Einheitsquaternion.

Signatur

dual_quat_trans_line_3d( : : DualQuaternion, LineFormat, LineDirectionX, LineDirectionY, LineDirectionZ, LineMomentOrPointX, LineMomentOrPointY, LineMomentOrPointZ : TransLineDirectionX, TransLineDirectionY, TransLineDirectionZ, TransLineMomentOrPointX, TransLineMomentOrPointY, TransLineMomentOrPointZ)

Herror T_dual_quat_trans_line_3d(const Htuple DualQuaternion, const Htuple LineFormat, const Htuple LineDirectionX, const Htuple LineDirectionY, const Htuple LineDirectionZ, const Htuple LineMomentOrPointX, const Htuple LineMomentOrPointY, const Htuple LineMomentOrPointZ, Htuple* TransLineDirectionX, Htuple* TransLineDirectionY, Htuple* TransLineDirectionZ, Htuple* TransLineMomentOrPointX, Htuple* TransLineMomentOrPointY, Htuple* TransLineMomentOrPointZ)

void DualQuatTransLine3d(const HTuple& DualQuaternion, const HTuple& LineFormat, const HTuple& LineDirectionX, const HTuple& LineDirectionY, const HTuple& LineDirectionZ, const HTuple& LineMomentOrPointX, const HTuple& LineMomentOrPointY, const HTuple& LineMomentOrPointZ, HTuple* TransLineDirectionX, HTuple* TransLineDirectionY, HTuple* TransLineDirectionZ, HTuple* TransLineMomentOrPointX, HTuple* TransLineMomentOrPointY, HTuple* TransLineMomentOrPointZ)

void HDualQuaternion::DualQuatTransLine3d(const HString& LineFormat, const HTuple& LineDirectionX, const HTuple& LineDirectionY, const HTuple& LineDirectionZ, const HTuple& LineMomentOrPointX, const HTuple& LineMomentOrPointY, const HTuple& LineMomentOrPointZ, HTuple* TransLineDirectionX, HTuple* TransLineDirectionY, HTuple* TransLineDirectionZ, HTuple* TransLineMomentOrPointX, HTuple* TransLineMomentOrPointY, HTuple* TransLineMomentOrPointZ) const

void HDualQuaternion::DualQuatTransLine3d(const HString& LineFormat, double LineDirectionX, double LineDirectionY, double LineDirectionZ, double LineMomentOrPointX, double LineMomentOrPointY, double LineMomentOrPointZ, double* TransLineDirectionX, double* TransLineDirectionY, double* TransLineDirectionZ, double* TransLineMomentOrPointX, double* TransLineMomentOrPointY, double* TransLineMomentOrPointZ) const

void HDualQuaternion::DualQuatTransLine3d(const char* LineFormat, double LineDirectionX, double LineDirectionY, double LineDirectionZ, double LineMomentOrPointX, double LineMomentOrPointY, double LineMomentOrPointZ, double* TransLineDirectionX, double* TransLineDirectionY, double* TransLineDirectionZ, double* TransLineMomentOrPointX, double* TransLineMomentOrPointY, double* TransLineMomentOrPointZ) const

void HDualQuaternion::DualQuatTransLine3d(const wchar_t* LineFormat, double LineDirectionX, double LineDirectionY, double LineDirectionZ, double LineMomentOrPointX, double LineMomentOrPointY, double LineMomentOrPointZ, double* TransLineDirectionX, double* TransLineDirectionY, double* TransLineDirectionZ, double* TransLineMomentOrPointX, double* TransLineMomentOrPointY, double* TransLineMomentOrPointZ) const   (Nur Windows)

static void HOperatorSet.DualQuatTransLine3d(HTuple dualQuaternion, HTuple lineFormat, HTuple lineDirectionX, HTuple lineDirectionY, HTuple lineDirectionZ, HTuple lineMomentOrPointX, HTuple lineMomentOrPointY, HTuple lineMomentOrPointZ, out HTuple transLineDirectionX, out HTuple transLineDirectionY, out HTuple transLineDirectionZ, out HTuple transLineMomentOrPointX, out HTuple transLineMomentOrPointY, out HTuple transLineMomentOrPointZ)

void HDualQuaternion.DualQuatTransLine3d(string lineFormat, HTuple lineDirectionX, HTuple lineDirectionY, HTuple lineDirectionZ, HTuple lineMomentOrPointX, HTuple lineMomentOrPointY, HTuple lineMomentOrPointZ, out HTuple transLineDirectionX, out HTuple transLineDirectionY, out HTuple transLineDirectionZ, out HTuple transLineMomentOrPointX, out HTuple transLineMomentOrPointY, out HTuple transLineMomentOrPointZ)

void HDualQuaternion.DualQuatTransLine3d(string lineFormat, double lineDirectionX, double lineDirectionY, double lineDirectionZ, double lineMomentOrPointX, double lineMomentOrPointY, double lineMomentOrPointZ, out double transLineDirectionX, out double transLineDirectionY, out double transLineDirectionZ, out double transLineMomentOrPointX, out double transLineMomentOrPointY, out double transLineMomentOrPointZ)

Beschreibung

Der Operator dual_quat_trans_line_3ddual_quat_trans_line_3dDualQuatTransLine3dDualQuatTransLine3dDualQuatTransLine3d transformiert eine in Plücker-Koordinaten dargestellte 3D-Line mit einer starren 3D-Abbildung, die durch die duale Einheitsquaternion DualQuaternionDualQuaternionDualQuaternionDualQuaterniondualQuaternion gegeben ist.

Eine kurze Einführung in duale Quaternionen, Plücker-Koordinaten und die verwendete Notation findet sich in der Dokumentation zu diesem Kapitel (Transformationen / Duale Quaternionen).

Eine Linie in Plücker-Koordinaten ist gegeben durch ihre Richtung mit und ihr Moment mit . Sie kann als duale Quaternion mit Skalarteil 0 repräsentiert werden. Die Linie kann durch die starre 3D-Abbildung, die durch eine duale Einheitsquaternion repräsentiert ist, sehr einfach transformiert werden: Die resultierende duale Quaternion hat ebenfalls einen Skalarteil von 0 und enthält direkt die Richtung und das Moment der transformierten Linie in ihren Vektorteilen.

Die Linienrichtung muss in LineDirectionXLineDirectionXLineDirectionXLineDirectionXlineDirectionX, LineDirectionYLineDirectionYLineDirectionYLineDirectionYlineDirectionY und LineDirectionZLineDirectionZLineDirectionZLineDirectionZlineDirectionZ übergeben werden. Zu beachten ist, dass die Länge des übergebenen Richtungsvektors 1 sein muss, um sinnvolle Ergebnisse zu erhalten, d.h. .

Wird für LineFormatLineFormatLineFormatLineFormatlineFormat 'moment'"moment""moment""moment""moment" gewählt, muss in LineMomentOrPointXLineMomentOrPointXLineMomentOrPointXLineMomentOrPointXlineMomentOrPointX, LineMomentOrPointYLineMomentOrPointYLineMomentOrPointYLineMomentOrPointYlineMomentOrPointY und LineMomentOrPointZLineMomentOrPointZLineMomentOrPointZLineMomentOrPointZlineMomentOrPointZ das Moment der Linie übergeben werden.

Alternativ ist es auch möglich, anstatt des Moments der Linie einen beliebigen Punkt auf der Linie zu übergeben. Dazu muss für LineFormatLineFormatLineFormatLineFormatlineFormat 'point'"point""point""point""point" gewählt werden und in LineMomentOrPointXLineMomentOrPointXLineMomentOrPointXLineMomentOrPointXlineMomentOrPointX, LineMomentOrPointYLineMomentOrPointYLineMomentOrPointYLineMomentOrPointYlineMomentOrPointY und LineMomentOrPointZLineMomentOrPointZLineMomentOrPointZLineMomentOrPointZlineMomentOrPointZ müssen die Koordinaten des Punktes übergeben werden.

Die Parameter der transformierten Linie werden in TransLineDirectionXTransLineDirectionXTransLineDirectionXTransLineDirectionXtransLineDirectionX, TransLineDirectionYTransLineDirectionYTransLineDirectionYTransLineDirectionYtransLineDirectionY, TransLineDirectionZTransLineDirectionZTransLineDirectionZTransLineDirectionZtransLineDirectionZ, TransLineMomentOrPointXTransLineMomentOrPointXTransLineMomentOrPointXTransLineMomentOrPointXtransLineMomentOrPointX, TransLineMomentOrPointYTransLineMomentOrPointYTransLineMomentOrPointYTransLineMomentOrPointYtransLineMomentOrPointY und TransLineMomentOrPointZTransLineMomentOrPointZTransLineMomentOrPointZTransLineMomentOrPointZtransLineMomentOrPointZ im Format, das in LineFormatLineFormatLineFormatLineFormatlineFormat angegeben ist, zurückgegeben. Wird für LineFormatLineFormatLineFormatLineFormatlineFormat 'point'"point""point""point""point" gewählt, wird der Punkt auf der Linie mit dem kürzesten Abstand zum Koordinatensystemursprung zurückgegeben.

Achtung

dual_quat_trans_line_3ddual_quat_trans_line_3dDualQuatTransLine3dDualQuatTransLine3dDualQuatTransLine3d liefert nur dann sinnvolle Ergebnisse, wenn in DualQuaternionDualQuaternionDualQuaternionDualQuaterniondualQuaternion eine duale Einheitsquaternion übergeben wird und die Länge des Richtungsvektors der Linie 1 ist.

Ausführungsinformationen

Parameter

DualQuaternionDualQuaternionDualQuaternionDualQuaterniondualQuaternion (input_control)  dual_quaternion → HDualQuaternion, HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Duale Einheitsquaternion, die die Transformation darstellt.

LineFormatLineFormatLineFormatLineFormatlineFormat (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Format der Linienparameter.

Defaultwert: 'moment' "moment" "moment" "moment" "moment"

Werteliste: 'moment'"moment""moment""moment""moment", 'point'"point""point""point""point"

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

X-Komponente des Richtungsvektors der Linie.

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

Y-Komponente des Richtungsvektors der Linie.

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

Z-Komponente des Richtungsvektors der Linie.

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

X-Komponente des Momentenvektors oder eines Punktes der Linie.

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

Y-Komponente des Momentenvektors oder eines Punktes der Linie.

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

Z-Komponente des Momentenvektors oder eines Punktes der Linie.

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

X-Komponente des Richtungsvektors der transformierten Linie.

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

Y-Komponente des Richtungsvektors der transformierten Linie.

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

Z-Komponente des Richtungsvektors der transformierten Linie.

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

X-Komponente des Momentenvektors der transformierten Linie oder des zum Ursprung nächstliegenden Punktes auf der transformierten Linie.

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

Y-Komponente des Momentenvektors der transformierten Linie oder des zum Ursprung nächstliegenden Punktes auf der transformierten Linie.

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

Z-Komponente des Momentenvektors der transformierten Linie oder des zum Ursprung nächstliegenden Punktes auf der transformierten Linie.

Nachfolger

dual_quat_composedual_quat_composeDualQuatComposeDualQuatComposeDualQuatCompose, dual_quat_conjugatedual_quat_conjugateDualQuatConjugateDualQuatConjugateDualQuatConjugate, pose_to_dual_quatpose_to_dual_quatPoseToDualQuatPoseToDualQuatPoseToDualQuat

Alternativen

affine_trans_point_3daffine_trans_point_3dAffineTransPoint3dAffineTransPoint3dAffineTransPoint3d

Siehe auch

dual_quat_to_hom_mat3ddual_quat_to_hom_mat3dDualQuatToHomMat3dDualQuatToHomMat3dDualQuatToHomMat3d, dual_quat_to_screwdual_quat_to_screwDualQuatToScrewDualQuatToScrewDualQuatToScrew, dual_quat_to_posedual_quat_to_poseDualQuatToPoseDualQuatToPoseDualQuatToPose, dual_quat_normalizedual_quat_normalizeDualQuatNormalizeDualQuatNormalizeDualQuatNormalize, serialize_dual_quatserialize_dual_quatSerializeDualQuatSerializeDualQuatSerializeDualQuat, deserialize_dual_quatdeserialize_dual_quatDeserializeDualQuatDeserializeDualQuatDeserializeDualQuat, quat_rotate_point_3dquat_rotate_point_3dQuatRotatePoint3dQuatRotatePoint3dQuatRotatePoint3d

Modul

Foundation

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