display_scene_3dT_display_scene_3dDisplayScene3dDisplayScene3ddisplay_scene_3d (Operator)

Name

display_scene_3dT_display_scene_3dDisplayScene3dDisplayScene3ddisplay_scene_3d — Display a 3D scene.

Signature

display_scene_3d( : : WindowHandle, Scene3D, 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

void HScene3D::DisplayScene3d(const HWindow& WindowHandle, const wchar_t* CameraIndex) const   (Windows only)

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

void HScene3D.DisplayScene3d(HWindow windowHandle, HTuple cameraIndex)

void HScene3D.DisplayScene3d(HWindow windowHandle, string cameraIndex)

def display_scene_3d(window_handle: HHandle, scene_3d: HHandle, camera_index: Union[int, str]) -> None

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. Note that sometimes the aspect ratio of WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle should be similar to width and height of the camera in order to obtain the wanted results. 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

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