Data Item: Scene#

This contains a scene of 3D geometry that is rendered-interactively in the browser using WebGL. The scene consists of a collection of parts that can be animated over time. Parts are a collection of shaded polygon and line models that support basic coloring attributes, including the ability to be colored by a variable. An example might look like this:


By default, the proxy image for the 3D scene is displayed. If EnSight is the source of the 3D scene, this will be the same Image visible when the scene is exported. Clicking on the scene will cause it to become active:


Options exist in the upper left corner of the view to display the part tree, re-center/size the scene, clip the scene and transition to/from full browser window mode.

The embedded EnVision viewer can also be used to view some types of 3D scenes. This viewer looks like the following:


There is a hamburger menu in the upper left corner that can be used to hide/show parts and change variable displays as well as controls in the lower right for element outlines, part highlighting, recentering, revert and full screen mode.

Note: various web proxy configurations may put limits on the size of the geometry files that can be uploaded. Generally, files of several hundred MB are allowed, provided that the maximum size of a REST request allows them. See Nexus Launcher configuration for details.





Enable interactive "exploded view" for all geometry formats except GLB and EnSight scenes by setting this property to '1'. The default: '0'.


height in pixels of the 3D rendering frame. The default is the height of the proxy image (if any).


width in pixels of the 3D rendering frame. The default is the width of the proxy image (if any).


An optional, three value vector representing an offset applied to the vertices of a GLB file. This can be used to place the geometry for simpler viewing. The default centers the geometry around the view origin. Example: [1.0,0.0,0.3]


An optional scaling factor applied to vertices before the translation is applied. If the value is set to 0.0 (the default), the scale is set to the length of the largest axis. If the scale is set to -1.0, no scaling will be applied.


Some geometry items can be displayed using either the webGL rendering engine or embedded EnVision. For such items, if use_remote_viewer is set to 1, Ansys Dynamic Reporting will try to use the EnVision viewer wherever possible. See 3D Viewers. for more details. The default value is 0.


Control access to the virtual reality UI interface for scenes containing GLB format geometry. See Virtual Reality.




Never enable VR support


Enable VR options if the browser claims to support VR


Always enable VR options

3D Viewers#

The following file formats can be uploaded into Ansys Dynamic Reporting as a scene item:

  • STL

  • PLY

  • EnSight Scene Geometry Source


  • DSCO

  • AVZ

  • GLB

The first three formats (STL, PLY, EnSight Scene Geometry Source) may be displayed using WebGL or using the embedded EnVision viewer. The GLB, SCDOC, DSCO and AVZ formats can only be displayed with the WebGL viewer. The use_remote_viewer property can be used to enable the use of the EnVision viewer if it is available.


To use the embedded EnVision viewer it needs to be enabled in the ADR Nexus server launcher configuration setup and the user must be logged in.

Virtual Reality Support#

ADR includes basic virtual reality support via WebXR. It is only supported when displaying scenes with GLB format geometry files and it only supports viewing. Interaction with the 3D scenes is not currently supported. When enabled, the 3D interactive scene will have an ENTER VR button overlaid.


Click on the button to enter virtual reality mode. Leaving the mode depends on the specific device being used.

To enable virtual reality in ADR one must do the following:

  1. Upload a SceneItem with a GLB file payload. It is not supported for other scene file formats.

  2. Set the vr property to enable or ifavailable for the template the item is displayed in.

  3. Enable WebXR in the browser the ADR report is being displayed in. For example, the built-in web browser in an Meta Occulus Quest display has WebXR enabled automatically. One can install the WebXR emulator from the Chrome web store to enable WebXR without a physical VR device.

  4. View the page containing the SceneItem.

  5. (Optional) Use the scene_translate and scene_scale properties to adjust the initial view of the 3D scene.