display_scene_3d — Display a 3D scene.
display_scene_3d( : : WindowHandle, Scene3D, CameraIndex : )
display_scene_3d displays the 3D scene Scene3D in the
window WindowHandle. The view of the camera CameraIndex
is used to render the scene.
Note that sometimes the aspect ratio
of WindowHandle should be similar to width and height
of the camera in order to obtain the wanted results.
See create_scene_3d for a short example.
display_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 with less requirements but lower
quality is automatically enabled.
On graphics cards with low memory the following error messages could occur
if rendering in a window with high resolution:
Low level error: 'Incomplete attachment'
Unhanded Exception: 'Required framebuffer object is unsupported'
Solutions:
Set the parameter 'quality' to 'low' using
set_scene_3d_param or use the compatibility mode to reduce the
requirements of the graphics card.
The system variable (see set_system)
'opengl_compatibility_mode_enable' can be set to 'true'
to permanently enable the visualization in compatibility mode with lower
OpenGL requirements.
This mode requires OpenGL 1.1.
In compatibility mode the parameters 'object_index_persistence',
'depth_persistence' and 'quality' are not used.
On Linux Remote Desktop 'disp_background' is not supported.
WindowHandle (input_control) window → (handle)
Window handle.
Scene3D (input_control) scene_3d → (handle)
Handle of the 3D scene.
CameraIndex (input_control) integer → (string / integer)
Index of the camera used to display the scene.
display_scene_3d returns 2 (
H_MSG_TRUE)
if all parameters are
correct. If necessary, an exception is raised.
create_scene_3d,
render_scene_3d
3D Metrology