display_scene_3dT_display_scene_3dDisplayScene3dDisplayScene3ddisplay_scene_3d (算子)
名称
display_scene_3dT_display_scene_3dDisplayScene3dDisplayScene3ddisplay_scene_3d — 显示三维场景。
签名
描述
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.
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
参数
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (输入控制) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
窗口句柄。
Scene3DScene3DScene3DScene3Dscene3Dscene_3d (输入控制) scene_3d → HScene3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
3D 场景的句柄。
CameraIndexCameraIndexCameraIndexCameraIndexcameraIndexcamera_index (输入控制) integer → HTupleUnion[int, str]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Index of the camera used to display the scene.
结果
display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_scene_3d 在所有参数正确时返回 2 ( H_MSG_TRUE )。如有必要，则抛出异常。
另见
create_scene_3dcreate_scene_3dCreateScene3dCreateScene3dCreateScene3dcreate_scene_3d,
render_scene_3drender_scene_3dRenderScene3dRenderScene3dRenderScene3drender_scene_3d
模块
三维计量