3D Scene is a visualization tool in Wyn Enterprise designed for presenting three-dimensional data through the use of 3D models and their associated data. Comprising three integral sections — 3D models, lights, and data layers — further elaborated in subsequent sections of this document, the 3D Scene in Wyn Enterprise facilitates the addition of data labels to models sourced from data repositories, enhancing the informational depth of your scene.

Utilizing babylon.js for the construction, loading, and display of the 3D Scene, Wyn Enterprise supports the integration of dynamic data scripts tailored to your specific requirements within the 3D environment. These scenes can be seamlessly embedded into your dashboards, offering an enhanced visualization of your data. For more detailed guidance on leveraging 3D Scenes within your dashboard, refer to the 3D Scene help article.

To create and manage a 3D Scene in Wyn Enterprise, switch to the Resource Portal and follow the below instructions,

1. From the navigation bar click the + button and then, click the Create 3D Scene option.

   
   

2. The 3D Scene Designer page will appear on your screen. 3D Scene Designer is divided into three sections - Models, Lights, and Data Layers as explained below.

   
   

Models

The Models section of the 3D Scene Explorer lists all the items of the 3D Scene.

i) You can add new models to the 3D Scene using the + Add button. On clicking the + Add button, the Model Manager popup will appear on your screen. Add shared or external URL-based models to the 3D Scene. Simply select the model and click the OK button to add the model to the model list.

ii) Select model will be added to the scene designer. You can hide, delete, or focus on one element of the scene using the Hide, Focus, and Delete options on hover.

iii) The model information will appear on the Inspector panel where you can see the model name and source. For shared models, the name of the model appears in the Source and for the external URL-based models, the URL of the model.

iii) You can also add a 3D model to Wyn Enterprise using the Upload feature. Ensure that the 3D model file is in GLB format.

Note: For a better experience of the 3D model, when uploading keep the GLB file to less than 250MB.

Lights

The lights section of the 3D Scene Explorer lists all the available light options. A default light with an intensity of 1 is added when initializing the 3D Scene. You can add the light options using the + Add button. The available light options are Directional Light, Point Light, and Spot Light as explained below.

• Directional Light: Directional lights are used as a distant source of light that hits all the objects in a 3D Scene from the same angle regardless of the object's position.

• Point Light: Point Light sources are the light sources used to produce a uniform beam of light with the illumination scattered in all directions. Point Light sources are also known as omnidirectional lights.

• Spot Light: Spot Light sources are generally used for artificial light sources such as flashlights, headlights, and searchlights. The moving spotlight will illuminate a small area of the scene only.

• Hemispheric Light: Hemispheric Light source are generally used to stimulate the ambient environment light.

  
  

You can modify the name, intensity, and direction of the selected Light from the Inspector Panel.

Data Layers

Data Layers are used to display the data related to the model objects of the 3D Scene. Follow the below instructions to add data layers to your 3D scene,

i) From the navigation bar, navigate to the Data Layers tab and click the + Add button.

ii) From the Data Binding panel on the right side of your screen, select a dataset from the Choose Dataset dropdown.

iii) Now, drag and drop the dataset fields onto the Value and Mesh Name data containers.

• Value: Value is used to display the values of the count or sum of the data fields.

• Mesh Name: Mesh Name is used to bind the 3D object of the scene with data labels.

Note: In case, the data attribute settings conflict with the data layer style, rich text customization will have the highest priority.

iv) Data layers will now appear on your scene designer under the Models section. You can hide the data layers using the hide icon next to the data layer name. In case a data layer is disabled, the tooltip will always be hidden and the mesh will not support mouse action or auto loop.

See the Data Layer Properties section for information on the Inspector Panel properties of Data Layers.

3. On successfully adding the models, lights, and data layers you can now modify the scene settings using the Scene Settings button on the 3D Scene Designer page. The scene settings are explained in the Scene Settings section below.

   
   

4. To modify the view direction of the scene, use the Designer Status Bar at the bottom of the scene designer. The three view options are explained below,

• Side View: Used to switch the camera perspective to the side of the object.

• Top View: Used to switch the camera perspective to the top of the object.

• Primary View: Used to switch the camera perspective to the front of the object.

  
  

5. You can also use the Designer Status Bar to modify the position, rotation, and scale of the selected mesh. The selected mesh mode options are described below,

• Position: Used to adjust the x, y, and z coordinates of the selected mesh. You can fine-tune the placement of a chosen mesh in only one direction at any given time.

• Rotation: Used to rotate a selected mesh using the spherical coordinates. You can rotate a chosen mesh in only one direction at any given time.

• Scale: Used to adjust the size of the selected mesh. You can zoom a selected mesh in only one direction at any given time.

• Highlighting: Used to highlight the selected node of the scene. By default, the highlight is enabled.

  
  

  You can also use the Inspector Panel to modify the position, rotation, and scale of any mesh. Simply click the mesh and change the values under the Transformation section in the Inspector Panel.

  
  

6. Use the save button on the top left corner of the scene designer to save the 3D Scene. You can also save the camera view of the scene to start editing the scene from the same position using the Save Camera View button.

   
   

7. You can view the created 3D Scene from the Document Types tab on the Resource Portal.

   i) Navigate to the Document Types tab, click the 3D Scene option and the list of 3D scenes will appear.

   
   

   
   

   ii) You can view the 3D scene using the View 3D Scene in new window button. You can also duplicate, edit, copy URLs and categories, rename, delete, and download the 3D scene using the context menu.

   
   

8. 3D models added to Wyn Enterprise are listed in the 3D Model tab of the Document Types section.

   
   

Scene Settings

Listed below are the inspector panel properties of a 3D Scene,

SCENE

AUTO LOOP SETTINGS

CAMERA

GENERAL

DOCUMENT APPEARANCE

ANIMATION

INTERACTION

SPECIAL EFFECTS

ANTI-ALIASING

Data Layer Properties

MODEL LABEL

INTERACTION

LAYOUT

DATA VISUALIZATION