ClassesClasses | | Operators

display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3d (Operator)

Name

display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3d — Display a 3D scene.

Signature

display_scene_3d( : : WindowHandle, Scene3D, CameraIndex : )

Herror display_scene_3d(const Hlong WindowHandle, const Hlong Scene3D, const char* CameraIndex)

Herror T_display_scene_3d(const Htuple WindowHandle, const Htuple Scene3D, const Htuple CameraIndex)

void DisplayScene3d(const HTuple& WindowHandle, const HTuple& Scene3D, const HTuple& CameraIndex)

void HScene3D::DisplayScene3d(const HWindow& WindowHandle, const HTuple& CameraIndex) const

void HScene3D::DisplayScene3d(const HWindow& WindowHandle, const HString& CameraIndex) const

void HScene3D::DisplayScene3d(const HWindow& WindowHandle, const char* CameraIndex) const

static void HOperatorSet.DisplayScene3d(HTuple windowHandle, HTuple scene3D, HTuple cameraIndex)

void HScene3D.DisplayScene3d(HWindow windowHandle, HTuple cameraIndex)

void HScene3D.DisplayScene3d(HWindow windowHandle, string cameraIndex)

Description

display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3d displays the 3D scene Scene3DScene3DScene3DScene3Dscene3D in the window WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle. The view of the camera CameraIndexCameraIndexCameraIndexCameraIndexcameraIndex is used to render the scene. See create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3d for a short example.

display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3d 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'"quality""quality""quality""quality" to 'low'"low""low""low""low" using set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParamSetScene3dParam or use the compatibility mode to reduce the requirements of the graphics card.

The system variable (see set_systemset_systemSetSystemSetSystemSetSystem) '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" 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'"object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence", 'depth_persistence'"depth_persistence""depth_persistence""depth_persistence""depth_persistence" and 'quality'"quality""quality""quality""quality" are not used.

On Linux Remote Desktop 'disp_background'"disp_background""disp_background""disp_background""disp_background" is not supported.

Execution Information

Parameters

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Window handle.

Scene3DScene3DScene3DScene3Dscene3D (input_control)  scene_3d HScene3D, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Handle of the 3D scene.

CameraIndexCameraIndexCameraIndexCameraIndexcameraIndex (input_control)  integer HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Index of the camera used to display the scene.

Result

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

See also

create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3d, render_scene_3drender_scene_3dRenderScene3dRenderScene3dRenderScene3d

Module

3D Metrology


ClassesClasses | | Operators