add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera (Operator)
Name
add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera — Add a camera to a 3D scene.
Signature
Description
add_scene_3d_cameraadd_scene_3d_cameraAddScene3dCameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera adds a new camera to the 3D scene
Scene3DScene3DScene3DScene3Dscene3Dscene_3d and returns the index of this camera in
CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index. The camera parameters of the camera must be
given in CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param. By default the new camera is located
at the origin of the world coordinate system. The pose of the camera
CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index can be set with set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPoseset_scene_3d_camera_pose.
Attention
Cameras with hypercentric lenses are not supported.
For displaying large faces (or primitives) with a non-zero distortion
in CameraParamCameraParamCameraParamCameraParamcameraParamcamera_param, note that the distortion is only applied to the
points of the model. In the projection, these points are subsequently
connected by straight lines. For a good approximation of the distorted
lines, please use a triangulation with sufficiently small triangles.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
Scene3DScene3DScene3DScene3Dscene3Dscene_3d (input_control) scene_3d → HScene3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the 3D scene.
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*)
Parameters of the new camera.
CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index (output_control) integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the new camera in the 3D scene.
Result
add_scene_3d_cameraadd_scene_3d_cameraAddScene3dCameraAddScene3dCameraAddScene3dCameraadd_scene_3d_camera returns 2 (H_MSG_TRUE) if all parameters are
correct. If necessary, an exception is raised.
Possible Predecessors
create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3dcreate_scene_3d
Possible Successors
set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPoseset_scene_3d_camera_pose,
display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_scene_3d
Module
3D Metrology