add_scene_3d_camera — Add a camera to a 3D scene.
add_scene_3d_camera adds a new camera to the 3D scene
Scene3D and returns the index of this camera in
CameraIndex. The camera parameters of the camera must be
CameraParam. By default the new camera is located
at the origin of the world coordinate system. The pose of the camera
CameraIndex can be set with
Cameras with hypercentric lenses are not supported.
For displaying large faces (or primitives) with a non-zero distortion
CameraParam, 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.
Handle of the 3D scene.
→(real / integer / string)
Parameters of the new camera.
Index of the new camera in the 3D scene.
add_scene_3d_camera returns TRUE if all parameters are
correct. If necessary, an exception is raised.