HALCON Website / HALCON Operator-Referenz / Graphik / 3D-Szene
KlassenKlassenKlassenKlassen | | | | Operatoren

add_scene_3d_instanceT_add_scene_3d_instanceAddScene3dInstanceadd_scene_3d_instanceAddScene3dInstanceAddScene3dInstance (Operator)

Name

add_scene_3d_instanceT_add_scene_3d_instanceAddScene3dInstanceadd_scene_3d_instanceAddScene3dInstanceAddScene3dInstance — Hinzufügen einer Instanz eines 3D-Objektmodells zu einer 3D-Szene.

Signatur

add_scene_3d_instance( : : Scene3D, ObjectModel3D, Pose : InstanceIndex)

Herror T_add_scene_3d_instance(const Htuple Scene3D, const Htuple ObjectModel3D, const Htuple Pose, Htuple* InstanceIndex)

Herror add_scene_3d_instance(const HTuple& Scene3D, const HTuple& ObjectModel3D, const HTuple& Pose, Hlong* InstanceIndex)

Hlong HScene3D::AddScene3dInstance(const HTuple& ObjectModel3D, const HTuple& Pose) const

void AddScene3dInstance(const HTuple& Scene3D, const HTuple& ObjectModel3D, const HTuple& Pose, HTuple* InstanceIndex)

Hlong HScene3D::AddScene3dInstance(const HObjectModel3DArray& ObjectModel3D, const HPoseArray& Pose) const

Hlong HScene3D::AddScene3dInstance(const HObjectModel3D& ObjectModel3D, const HPose& Pose) const

void HOperatorSetX.AddScene3dInstance(
[in] VARIANT Scene3D, [in] VARIANT ObjectModel3D, [in] VARIANT Pose, [out] VARIANT* InstanceIndex)

Hlong HScene3DX.AddScene3dInstance(
[in] IHObjectModel3DX* ObjectModel3D, [in] VARIANT Pose)

static void HOperatorSet.AddScene3dInstance(HTuple scene3D, HTuple objectModel3D, HTuple pose, out HTuple instanceIndex)

int HScene3D.AddScene3dInstance(HObjectModel3D[] objectModel3D, HPose[] pose)

int HScene3D.AddScene3dInstance(HObjectModel3D objectModel3D, HPose pose)

Beschreibung

add_scene_3d_instanceadd_scene_3d_instanceAddScene3dInstanceadd_scene_3d_instanceAddScene3dInstanceAddScene3dInstance fügt eine Instanz des 3D-Objektmodells ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D zur 3D-Szene Scene3DScene3DScene3DScene3DScene3Dscene3D hinzu und gibt den Index der Instanz in InstanceIndexInstanceIndexInstanceIndexInstanceIndexInstanceIndexinstanceIndex zurück. Werden mehrere Instanzen auf einmal hinzugefügt, kann entweder eine Pose für alle Instanzen oder für jede Instanz eine Pose übergeben werden.

Die Pose der Instanz im Koordinatensystem der Szene wird in PosePosePosePosePosepose übergeben. Mit dem Operator set_scene_3d_instance_poseset_scene_3d_instance_poseSetScene3dInstancePoseset_scene_3d_instance_poseSetScene3dInstancePoseSetScene3dInstancePose wird diese Pose geändert. Solange keine Pose für die Szene mit set_scene_3d_to_world_poseset_scene_3d_to_world_poseSetScene3dToWorldPoseset_scene_3d_to_world_poseSetScene3dToWorldPoseSetScene3dToWorldPose gesetzt wurde, bezieht sich diese Pose auf das Weltkoordinatensystem.

Mit set_scene_3d_instance_paramset_scene_3d_instance_paramSetScene3dInstanceParamset_scene_3d_instance_paramSetScene3dInstanceParamSetScene3dInstanceParam können Parameter (z.B. Farbe) der Instanz verändert werden.

Parallelisierung

Parameter

Scene3DScene3DScene3DScene3DScene3Dscene3D (input_control)  scene_3d → HScene3D, HTupleHTupleHScene3D, HTupleHScene3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle der 3D-Szene.

ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (input_control)  object_model_3d(-array) → HObjectModel3D, HTupleHTupleHObjectModel3D, HTupleHObjectModel3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des 3D-Objektmodells.

PosePosePosePosePosepose (input_control)  pose(-array) → HPose, HTupleHTupleHTupleHPoseX, VARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Pose des 3D-Objektmodells.

Parameteranzahl: 7

InstanceIndexInstanceIndexInstanceIndexInstanceIndexInstanceIndexinstanceIndex (output_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Index der neuen Instanz in der 3D-Szene.

Ergebnis

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

Vorgänger

create_scene_3dcreate_scene_3dCreateScene3dcreate_scene_3dCreateScene3dCreateScene3d

Nachfolger

set_scene_3d_instance_paramset_scene_3d_instance_paramSetScene3dInstanceParamset_scene_3d_instance_paramSetScene3dInstanceParamSetScene3dInstanceParam, set_scene_3d_instance_poseset_scene_3d_instance_poseSetScene3dInstancePoseset_scene_3d_instance_poseSetScene3dInstancePoseSetScene3dInstancePose

Siehe auch

remove_scene_3d_instanceremove_scene_3d_instanceRemoveScene3dInstanceremove_scene_3d_instanceRemoveScene3dInstanceRemoveScene3dInstance

Modul

3D Metrology

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