rigid_trans_object_model_3d — Anwenden einer starren 3D-Transformation auf 3D-Objektmodelle.
rigid_trans_object_model_3d( : : ObjectModel3D, Pose : ObjectModel3DRigidTrans)
rigid_trans_object_model_3d wendet starre 3D-Transformationen
auf 3D-Objektmodelle an und liefert den Handle der transformierten
3D-Objektmodelle zurück. Die Transformationen werden durch eine oder
mehrere Posen beschrieben, die in Pose übergeben werden.
Die Posen werden dabei in der Form
erwartet. Dabei steht
mcsi für das Koordinatensystem des Eingabe-3D-Objektmodells und
cst für das Koordinatensystem des transformierten Models, z.B. das
Koordinatensystem einer Szene (siehe auch Transformationen / Posen
und „Solution Guide III-C - 3D Vision“).
Posen können mit Hilfe der Operatoren create_pose,
pose_invert, etc. aufgebaut werden oder das
Resultat von get_object_model_3d_params sein.
Der Operator unterstützt ein oder mehrere 3D-Objektmodelle mit einer
Pose (N:1), ein 3D-Objektmodell mit ein oder mehreren
Posen (1:N) sowie eine Pose pro
übergebenem 3D-Objektmodell, die dann nur auf das jeweilige
3D-Objektmodell angewandt wird (N:N). Dabei kann N auch für 0 stehen, d.h.
es kann keine Pose oder kein Objektmodell übergeben werden, in welchem
Fall in ObjectModel3DRigidTrans ein leeres Tupel zurückgegeben wird.
Dies kann z.B. verwendet werden, um die Ergebnisse von
find_surface_model zu transformieren, ohne vorher zu prüfen ob
tatsächlich mindestens ein Ergebnis gefunden wurde.
rigid_trans_object_model_3d transformiert Attribute vom Typ
Punktkoordinaten, Punktnormalen und vorbereitetem 3D-Formmodell
für das formbasierte 3D-Matching, sowie 3D-Primitive. Vorberechnete
Datenstrukturen für die 3D Abstandsbestimmung werden nicht kopiert. Alle
anderen Attribute werden kopiert ohne sie zu verändern.
ObjectModel3D (input_control) object_model_3d(-array) → (handle)
Handle der 3D-Objektmodelle.
Pose (input_control) pose(-array) → (real / integer)
Posen.
ObjectModel3DRigidTrans (output_control) object_model_3d(-array) → (handle)
Handle der transformierten 3D-Objektmodelle.
rigid_trans_object_model_3d liefert den Wert 2 (
H_MSG_TRUE)
wenn alle
Parameter korrekt sind. Andernfalls wird eine Fehlerbehandlung
durchgeführt.
read_object_model_3d,
xyz_to_object_model_3d,
fit_primitives_object_model_3d
project_object_model_3d,
object_model_3d_to_xyz,
get_object_model_3d_params
affine_trans_point_3d,
affine_trans_object_model_3d
3D Metrology