add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera (Operator)
Name
add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera — Hinzufügen einer Kamera zu einer 3D-Szene.
Signatur
Beschreibung
add_scene_3d_cameraadd_scene_3d_cameraAddScene3dCameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera fügt eine Kamera zur 3D-Szene Scene3DScene3DScene3DScene3Dscene3Dscene_3d
hinzu und gibt den Index der Kamera in CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index zurück.
Die Kameraparameter der Kamera werden in CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param übergeben.
Zunächst befindet sich die neue Kamera am Ursprung des
Weltkoordinatensystems. Ihre Pose kann mit set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPoseset_scene_3d_camera_pose
gesetzt werden.
Achtung
Kameras mit hyperzentrischen Objektiven werden nicht unterstützt.
Falls CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param Verzeichnungskoeffizienten ungleich null
enthält ist bei der Projektion großer Dreiecke oder Polygone
(oder 3D-Primitive)
darauf zu achten, dass die Verzeichnung nur auf die Punkte des
Objektmodells angewandt werden. In der Projektion werden diese
wiederum mit geraden Linien verbunden. Für eine gute
Approximation der verzeichneten Linien sollte eine Triangulierung
mit ausreichend kleinen Dreiecken verwendet werden.
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
Scene3DScene3DScene3DScene3Dscene3Dscene_3d (input_control) scene_3d → HScene3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle der 3D-Szene.
CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param (input_control) campar → HCamPar, HTupleSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Parameter der neuen Kamera.
CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index (output_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index der neuen Kamera in der 3D-Szene.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert add_scene_3d_cameraadd_scene_3d_cameraAddScene3dCameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3dcreate_scene_3d
Nachfolger
set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPoseset_scene_3d_camera_pose,
display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_scene_3d
Modul
3D Metrology