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

hom_mat3d_scale_localT_hom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocal (Operator)

Name

hom_mat3d_scale_localT_hom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocal — Fügt eine Skalierung zu einer homogenen 3D-Transformationsmatrix hinzu.

Signatur

hom_mat3d_scale_local( : : HomMat3D, Sx, Sy, Sz : HomMat3DScale)

Herror T_hom_mat3d_scale_local(const Htuple HomMat3D, const Htuple Sx, const Htuple Sy, const Htuple Sz, Htuple* HomMat3DScale)

void HomMat3dScaleLocal(const HTuple& HomMat3D, const HTuple& Sx, const HTuple& Sy, const HTuple& Sz, HTuple* HomMat3DScale)

HHomMat3D HHomMat3D::HomMat3dScaleLocal(const HTuple& Sx, const HTuple& Sy, const HTuple& Sz) const

HHomMat3D HHomMat3D::HomMat3dScaleLocal(double Sx, double Sy, double Sz) const

static void HOperatorSet.HomMat3dScaleLocal(HTuple homMat3D, HTuple sx, HTuple sy, HTuple sz, out HTuple homMat3DScale)

HHomMat3D HHomMat3D.HomMat3dScaleLocal(HTuple sx, HTuple sy, HTuple sz)

HHomMat3D HHomMat3D.HomMat3dScaleLocal(double sx, double sy, double sz)

Beschreibung

hom_mat3d_scale_localhom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocalHomMat3dScaleLocal fügt zur homogenen 3D-Transformationsmatrix HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D eine Skalierung um die Skalierungsfaktoren SxSxSxSxsx, SySySySysy und SzSzSzSzsz hinzu und liefert die resultierende Matrix in HomMat3DScaleHomMat3DScaleHomMat3DScaleHomMat3DScalehomMat3DScale zurück. Die Skalierung wird beschrieben durch die 3×3 Skalierungsmatrix S. Im Gegensatz zu hom_mat3d_scalehom_mat3d_scaleHomMat3dScaleHomMat3dScaleHomMat3dScale wird sie relativ zum lokalen Koordinatensystem, das durch HomMat3DHomMat3DHomMat3DHomMat3DhomMat3D beschrieben ist, ausgeführt; dies entspricht der folgenden Kette von Transformationsmatrizen:

Der Fixpunkt der Skalierung ist der Ursprung des lokalen Koordinatensystems, d.h. dieser Punkt bleibt unverändert, wenn man ihn mit HomMat3DScaleHomMat3DScaleHomMat3DScaleHomMat3DScalehomMat3DScale transformiert.

Achtung

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, rc, td, re, rf, rg, th, ri, rj, rk, tl] gespeichert. Es ist aber auch möglich, volle 4×4 Matrizen, die eine projektive 3D-Transformation darstellen können, zu verarbeiten.

Ausführungsinformationen

Parameter

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

Eingabe-Transformationsmatrix.

SxSxSxSxsx (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Skalierungsfaktor in x-Richtung.

Defaultwert: 2

Wertevorschläge: 0.125, 0.25, 0.5, 1, 2, 4, 8, 112

Restriktion: Sx != 0

SySySySysy (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Skalierungsfaktor in y-Richtung.

Defaultwert: 2

Wertevorschläge: 0.125, 0.25, 0.5, 1, 2, 4, 8, 112

Restriktion: Sy != 0

SzSzSzSzsz (input_control)  number → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Skalierungsfaktor in z-Richtung.

Defaultwert: 2

Wertevorschläge: 0.125, 0.25, 0.5, 1, 2, 4, 8, 112

Restriktion: Sz != 0

HomMat3DScaleHomMat3DScaleHomMat3DScaleHomMat3DScalehomMat3DScale (output_control)  hom_mat3d → HHomMat3D, HTupleHTupleHtuple (real) (double) (double) (double)

Ausgabe-Transformationsmatrix.

Ergebnis

hom_mat3d_scale_localhom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocalHomMat3dScaleLocal liefert den Wert 2 (H_MSG_TRUE), falls alle drei Skalierungsfaktoren verschieden von 0 sind. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

hom_mat3d_identityhom_mat3d_identityHomMat3dIdentityHomMat3dIdentityHomMat3dIdentity, hom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocalHomMat3dTranslateLocal, hom_mat3d_scale_localhom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocalHomMat3dScaleLocal, hom_mat3d_rotate_localhom_mat3d_rotate_localHomMat3dRotateLocalHomMat3dRotateLocalHomMat3dRotateLocal

Nachfolger

hom_mat3d_translate_localhom_mat3d_translate_localHomMat3dTranslateLocalHomMat3dTranslateLocalHomMat3dTranslateLocal, hom_mat3d_scale_localhom_mat3d_scale_localHomMat3dScaleLocalHomMat3dScaleLocalHomMat3dScaleLocal, hom_mat3d_rotate_localhom_mat3d_rotate_localHomMat3dRotateLocalHomMat3dRotateLocalHomMat3dRotateLocal

Siehe auch

hom_mat3d_inverthom_mat3d_invertHomMat3dInvertHomMat3dInvertHomMat3dInvert, hom_mat3d_identityhom_mat3d_identityHomMat3dIdentityHomMat3dIdentityHomMat3dIdentity, hom_mat3d_scalehom_mat3d_scaleHomMat3dScaleHomMat3dScaleHomMat3dScale, pose_to_hom_mat3dpose_to_hom_mat3dPoseToHomMat3dPoseToHomMat3dPoseToHomMat3d, hom_mat3d_to_posehom_mat3d_to_poseHomMat3dToPoseHomMat3dToPoseHomMat3dToPose, hom_mat3d_composehom_mat3d_composeHomMat3dComposeHomMat3dComposeHomMat3dCompose

Modul

Foundation

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