display_scene_3dT_display_scene_3dDisplayScene3dDisplayScene3ddisplay_scene_3d (Operator)
Name
display_scene_3dT_display_scene_3dDisplayScene3dDisplayScene3ddisplay_scene_3d — Display a 3D scene.
Signature
Description
display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_scene_3d displays the 3D scene Scene3DScene3DScene3DScene3Dscene3Dscene_3d in the
window WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle. The view of the camera CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index
is used to render the scene. See create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3dcreate_scene_3d for a short
example.
display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_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'"quality""quality""quality""quality""quality" to 'low'"low""low""low""low""low" using
set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParamSetScene3dParamset_scene_3d_param or use the compatibility mode to reduce the
requirements of the graphics card.
The system variable (see set_systemset_systemSetSystemSetSystemSetSystemset_system)
'opengl_compatibility_mode_enable'"opengl_compatibility_mode_enable""opengl_compatibility_mode_enable""opengl_compatibility_mode_enable""opengl_compatibility_mode_enable""opengl_compatibility_mode_enable" can be set to 'true'"true""true""true""true""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'"object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence",
'depth_persistence'"depth_persistence""depth_persistence""depth_persistence""depth_persistence""depth_persistence" and 'quality'"quality""quality""quality""quality""quality" are not used.
On Linux Remote Desktop 'disp_background'"disp_background""disp_background""disp_background""disp_background""disp_background" is not supported.
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
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
Scene3DScene3DScene3DScene3Dscene3Dscene_3d (input_control) scene_3d → HScene3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the 3D scene.
CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index (input_control) integer → HTupleUnion[int, str]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Index of the camera used to display the scene.
Result
display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_scene_3d returns 2 (H_MSG_TRUE) if all parameters are
correct. If necessary, an exception is raised.
See also
create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3dcreate_scene_3d,
render_scene_3drender_scene_3dRenderScene3dRenderScene3dRenderScene3drender_scene_3d
Module
3D Metrology