Skip to content

render_scene_3dRenderScene3dRenderScene3drender_scene_3dT_render_scene_3d🔗

Short description🔗

render_scene_3dRenderScene3dRenderScene3drender_scene_3dT_render_scene_3d — Render an image of a 3D scene.

Signature🔗

render_scene_3d( out image Image, scene_3d Scene3D, integer CameraIndex )void RenderScene3d( HObject* Image, const HTuple& Scene3D, const HTuple& CameraIndex )static void HOperatorSet.RenderScene3d( out HObject image, HTuple scene3D, HTuple cameraIndex )def render_scene_3d( scene_3d: HHandle, camera_index: int ) -> HObject

Herror T_render_scene_3d( Hobject* Image, const Htuple Scene3D, const Htuple CameraIndex )

HImage HScene3D::RenderScene3d( Hlong CameraIndex ) const

HImage HScene3D.RenderScene3d( int cameraIndex )

Description🔗

render_scene_3dRenderScene3d renders an image of the 3D scene Scene3Dscene3Dscene_3d and returns the result in Imageimageimage. The view of the camera CameraIndexcameraIndexcamera_index is used to render the image.

The set_scene_3d_paramSetScene3dParam parameters 'object_index_persistence'"object_index_persistence" and 'disp_background'"disp_background" are ignored. The background of Imageimageimage is black.

render_scene_3dRenderScene3d 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🔗

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🔗

Imageimageimage (output_object) (multichannel-)image → object (byte)HObject (byte)HImage (byte)HObject (byte)Hobject * (byte)

Rendered 3D scene.

Scene3Dscene3Dscene_3d (input_control) scene_3d → (handle)HTuple (HHandle)HScene3D, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the 3D scene.

CameraIndexcameraIndexcamera_index (input_control) integer → (integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Index of the camera used to display the scene.

Result🔗

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

Combinations with other operators🔗

Combinations

Alternatives

display_scene_3dDisplayScene3d

See also

create_scene_3dCreateScene3d

Module🔗

3D Metrology