add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCamera (Operator)
Name
add_scene_3d_cameraT_add_scene_3d_cameraAddScene3dCameraAddScene3dCamera
— Add a camera to a 3D scene.
Signature
Description
add_scene_3d_cameraadd_scene_3d_cameraAddScene3dCameraAddScene3dCameraAddScene3dCamera
adds a new camera to the 3D scene
Scene3DScene3DScene3DScene3Dscene3D
and returns the index of this camera in
CameraIndexCameraIndexCameraIndexCameraIndexcameraIndex
. The camera parameters of the camera must be
given in CameraParamCameraParamCameraParamCameraParamcameraParam
. By default the new camera is located
at the origin of the world coordinate system. The pose of the camera
CameraIndexCameraIndexCameraIndexCameraIndexcameraIndex
can be set with set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPose
.
Attention
Cameras with hypercentric lenses are not supported.
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
Scene3DScene3DScene3DScene3Dscene3D
(input_control) scene_3d →
HScene3D, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the 3D scene.
CameraParamCameraParamCameraParamCameraParamcameraParam
(input_control) campar →
HCamPar, HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Parameters of the new camera.
CameraIndexCameraIndexCameraIndexCameraIndexcameraIndex
(output_control) integer →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Index of the new camera in the 3D scene.
Result
add_scene_3d_cameraadd_scene_3d_cameraAddScene3dCameraAddScene3dCameraAddScene3dCamera
returns 2 (H_MSG_TRUE) if all parameters are
correct. If necessary, an exception is raised.
Possible Predecessors
create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3d
Possible Successors
set_scene_3d_camera_poseset_scene_3d_camera_poseSetScene3dCameraPoseSetScene3dCameraPoseSetScene3dCameraPose
,
display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3d
Module
3D Metrology