add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCamera (Operator)

Name

add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCamera — Hinzufügen einer Kamera zu einer 3D-Szene.

Signatur

add_scene_3d_camera( : : Scene3D, CameraParam : CameraIndex)

Beschreibung

add_scene_3d_cameraadd_scene_3d_cameraAddScene3dCameraAddScene3dCameraAddScene3dCamera fügt eine Kamera zur 3D-Szene Scene3DScene3DScene3DScene3Dscene3D hinzu und gibt den Index der Kamera in CameraIndexCameraIndexCameraIndexCameraIndexcameraIndex zurück. Die Kameraparameter der Kamera werden in CameraParamCameraParamCameraParamCameraParamcameraParam übergeben.

Zunächst befindet sich die neue Kamera am Ursprung des Weltkoordinatensystems. Ihre Pose kann mit set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPose gesetzt werden.

Achtung

Kameras mit hyperzentrischen Objektiven werden nicht unterstützt.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

Scene3DScene3DScene3DScene3Dscene3D (input_control) scene_3d → (handle)

Handle der 3D-Szene.

CameraParamCameraParamCameraParamCameraParamcameraParam (input_control) campar → (real / integer / string)

Parameter der neuen Kamera.

CameraIndexCameraIndexCameraIndexCameraIndexcameraIndex (output_control) integer → (integer)

Index der neuen Kamera in der 3D-Szene.

Ergebnis

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

Vorgänger

create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3d

Nachfolger

set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPose, display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3d

Modul

3D Metrology

Operatoren