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

add_scene_3d_camera( : : Scene3D, CameraParam : CameraIndex)

Herror T_add_scene_3d_camera(const Htuple Scene3D, const Htuple CameraParam, Htuple* CameraIndex)

void AddScene3dCamera(const HTuple& Scene3D, const HTuple& CameraParam, HTuple* CameraIndex)

Hlong HCamPar::AddScene3dCamera(const HScene3D& Scene3D) const

Hlong HScene3D::AddScene3dCamera(const HCamPar& CameraParam) const

static void HOperatorSet.AddScene3dCamera(HTuple scene3D, HTuple cameraParam, out HTuple cameraIndex)

int HCamPar.AddScene3dCamera(HScene3D scene3D)

int HScene3D.AddScene3dCamera(HCamPar cameraParam)

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

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