render_scene_3dT_render_scene_3dRenderScene3dRenderScene3drender_scene_3d (Operator)

Name

render_scene_3dT_render_scene_3dRenderScene3dRenderScene3drender_scene_3d — Render an image of a 3D scene.

Signature

render_scene_3d( : Image : Scene3D, CameraIndex : )

Description

render_scene_3drender_scene_3dRenderScene3dRenderScene3drender_scene_3d renders an image of the 3D scene Scene3DScene3DScene3Dscene3Dscene_3d and returns the result in ImageImageImageimageimage. The view of the camera CameraIndexCameraIndexCameraIndexcameraIndexcamera_index is used to render the image.

The set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParamset_scene_3d_param parameters 'object_index_persistence'"object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence" and 'disp_background'"disp_background""disp_background""disp_background""disp_background" are ignored. The background of ImageImageImageimageimage is black.

render_scene_3drender_scene_3dRenderScene3dRenderScene3drender_scene_3d requires OpenGL 2.1, GLSL 1.2, and the OpenGL extensions GL_EXT_framebuffer_object and GL_EXT_framebuffer_blit. Otherwise the compatibility mode is automatically enabled. The compatibility mode requires OpenGL 1.1.

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

ImageImageImageimageimage (output_object) (multichannel-)image → object (byte)

Rendered 3D scene.

Scene3DScene3DScene3Dscene3Dscene_3d (input_control) scene_3d → (handle)

Handle of the 3D scene.

CameraIndexCameraIndexCameraIndexcameraIndexcamera_index (input_control) integer → (integer)

Index of the camera used to display the scene.

Result

render_scene_3drender_scene_3dRenderScene3dRenderScene3drender_scene_3d returns 2 ( H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Alternatives

display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3ddisplay_scene_3d

Module

3D Metrology

Operators