render_scene_3dT_render_scene_3dRenderScene3dRenderScene3d (Operator)

Name

render_scene_3dT_render_scene_3dRenderScene3dRenderScene3d — Render an image of a 3D scene.

Signature

render_scene_3d( : Image : Scene3D, CameraIndex : )

Description

render_scene_3drender_scene_3dRenderScene3dRenderScene3dRenderScene3d renders an image of the 3D scene Scene3DScene3DScene3DScene3Dscene3D and returns the result in ImageImageImageImageimage. The view of the camera CameraIndexCameraIndexCameraIndexCameraIndexcameraIndex is used to render the image.

The set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParamSetScene3dParam 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_3dRenderScene3dRenderScene3dRenderScene3d 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.

Scene3DScene3DScene3DScene3Dscene3D (input_control) scene_3d → (handle)

Handle of the 3D scene.

CameraIndexCameraIndexCameraIndexCameraIndexcameraIndex (input_control) integer → (integer)

Index of the camera used to display the scene.

Result

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

Alternatives

display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3d

Module

3D Metrology

Operators