3D Scene is a visualization tool in Wyn Enterprise designed to represent three-dimensional data using 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. See the 3D Scene help article, for detailed information on embedding 3D Scenes within your dashboard.

In this article you will find information on the following:

• 3D Scene Designer

• Prepare 3D Model

• Create 3D Model

• Scene Explorer

  • Manage Models

  • Manage Lights

  • Manage Data Layers

• View and Manage 3D Scenes

• Example Scenario

3D Scene Designer

The image below displays the elements of the 3D Scene Designer page, followed by a detailed explanation of these elements.

1. Scene Explorer: Displays the hierarchical tree of all the elements of the 3D Scene listed below. You can hide, delete, or focus each scene element from the Scene Explorer.

   • Models: Lists all the 3D models of the scene in a hierarchical model tree structure. 3D models are divided into two parts as described below.

     • Transform Node: Acts as a container to group multiple meshes together. Transform Node allows collective transformations such as moving, rotating, or scaling.

     • Mesh: Individual objects of 3D models that make up the scene. Each mesh can be transformed individually,

   • Lights: Includes options to add or remove lights. By default, light with intensity 1 is added to the 3D scene upon initialization. The available light options are 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 sources are used to stimulate ambient environment light.

   • Data Layer: Data Layers display the data related to the model objects of the 3D Scene. You can also bind data to the data layers which include the following data roles,

     • Value: Represents the sum or count value associated with the data fields.

     • Mesh Name: Represents the name of the 3D object within the application.

     • Tooltip: Provides additional information on a data point, usually on mouse hover.

       See the Manage Data Layers article for more information.

2. Command Bar: Provides quick access to essential functions like Undo, Redo, Save, Preview, and Exit.

3. Settings: Includes the Inspector Panel to manage the properties of scene objects and the Data Binding Panel to bind data to the scene.

4. Status Bar: Included options to change the view directions (Side View, Top View, and Primary View), mesh selection modes (Scaling, Position, and Rotation), and highlighting.

5. Canvas: The main area to render and interact with the 3D scene. It provides a visual representation of the scene and lets you engage with the 3D objects. The following two options are available on the Canvas area,

   • Scene Settings: Allows you to configure an entire scene. Click to access and modify specific settings in the Inspector Panel.

   • Save Camera View: Save the current camera perspective using this button. The most recently saved perspective will be used on the preview.

This article provides information on creating 3D Scenes in Wyn Enterprise.

Prepare 3D Model

When creating a 3D Scene, 3D models are required to display the entire scene and the associated data. Upload a model file in .GLB format using the Upload feature on the Resource Portal. See the Upload article for more information on uploading files in Wyn Enterprise.

Uploaded 3D Models are listed on the 3D Models document list on the Resource Portal under the Document Types section.

Create 3D Scene

To create a 3D Scene from the Resource Portal. Follow these steps,

1. Click the + (create) button.

2. Click Create 3D Scene to open the 3D Scene Designer.

   
   

3. To add a 3D Model to the scene, click the + Add button in the Models section of the Scene Explorer. This will open the Model Manager.

   
   

4. Select a 3D model prepared earlier, from the Shared tab of the Model Manager. Use the search bar to search for a model from the list. Click Ok to add the model to the 3D Scene.

   
   

5. To use a 3D model available on an external URL, navigate to the External URL tab and enter the URL in the Model URL input box. Click Ok to add the model to the 3D Scene.

   
   

6. You can now use the Scene Explorer to add or manage Models, Lights, and Data Layers.

   
   

7. Use the Inspector Panel on the right side to manage the Scene Settings.

   
   

8. Use the Status bar to perform the following:

   
   

   1. Change View Direction: Select an option to change the view direction to side, top, or primary view. All three views of the 3D model of a car are shown in the below image.

      
      

   2. Modify Mesh: Select an option to adjust the scale, position, and rotation of the selected mesh. The image below shows all three modification options applied to a 3D model of a car.

      
      

   3. Highlight: Click the highlight button to highlight the selected node on the canvas area. To remove the highlight, click the highlight button again.

      
      

9. Click the save button on the command bar, enter a name for the scene, select a Category (optional), and add a comment (optional) in the Save Scene popup. Click Ok to finish.

   
   

Scene Explorer

Add or manage the Models, Lights, and Data Layers of the 3D Scenes from the Scene Explorer. Click the scene menu button to expand the scene explorer and select one of the following:

• Models

• Lights

• Data Layers

Manage Models

• Add 3D models to the scene using the + Add button.

  
  

• To hide, focus, or delete a transform node or mesh hover over it and click the corresponding buttons.

  
  

Select a transform node or mesh and manage the following properties using the Inspector Panel:

General

Transformation

Auto Loop Camera Settings

Manage Lights

• To add lights to the scene, click the + Add button and select an option from the following: Directional Light, Point Light, Spot Light, or Hemispheric Light.

  
  

• To hide or delete a light, hover over it and click the corresponding option.

  
  

• Select a light and manage the following settings using the Inspector Panel:

  Property	Description
  Name	Displays the name of the selected light.
  Intensity	Displays the intensity of the light falling on the 3D object. The default value is 1.
  Position	Displays the position of the light source with X, Y, and Z coordinates each separated by a space. This option is available for Point and Spot lights only.
  Direction	Displays the vector direction of the light with X, Y, and Z coordinates each separated by a space. This option is available for Directional, Spot, and Hemispheric lights only.

Manage Data Layers

• To add a data layer to the scene, click the + Add button. A data layer (modelDataAnnotation) will be added to the list.

  
  

• To disable or delete the data layer, hover over it and click the corresponding option. You can also add filters to the data layers using the filter icon on hover. See the Filter Data help article for more information.

  
  

• See the Manage Data Layers help article for information on binding data to layers and managing the data layer settings including conditional formatting.

View and Manage 3D Scenes

1. Navigate to Document Types >> 3D Scene.

   
   

2. A list of all the available 3D scenes will appear on your screen.

3. Use sorting on column headers, the preview button to render the scene in the same window, and the View 3D Scene in New Window button to open the scene in a new window.

4. Use the context menu to perform the following: Edit 3D Scene, Duplicate, Copy URL, Categorize, Rename, Delete, and Download.

5. Use the search bar and action menu on the top right corner to search, edit category, delete, edit, duplicate, show checkbox, and enable tile view. Use the Info icon to view the document information and history.

   
   

Example Scenario

In this example, we will create a 3D Scene of a Village with model houses, lights, and data layers from the Resource Portal.

1. Prepare a 3D model using the Upload feature and click the Create 3D Scene option to open the 3D Scene Designer.

   
   

2. Click the + Add button under the Models section to open the Model Manager.

   
   

3. Select the Village model and click Ok to apply.

   
   

4. A village scene will be added to the Canvas area. From Scene Explorer, navigate to the Data Layers section and use the + Add button to add a data layer to the scene.

   
   

5. Select the Village dataset to bind data to the scene. Drag and drop the Model Content 1 data fields onto the Value data role and Model Name data field on the Mesh Name data role.

   
   

6. Click the Preview button to render the scene. Notice the data labels above houses 1, 4, and 7, these appear by binding the Village dataset fields to the scene.

   
   

7. Click Save and enter a name for the scene. Click Ok to finish.

Scene Settings

SCENE

AUTO LOOP SETTINGS

CAMERA

GENERAL

DOCUMENT APPEARANCE

ANIMATION

INTERACTION

SPECIAL EFFECTS

ANTI-ALIASING