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. 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'
Unhandled 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 visualisation 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