# Working with Views **Views** are one of the core tools in VoxelSpace, allowing users to interact with spatial datasets in an immersive 3D environment. Whether you're exploring raw data, comparing models, or creating polished visualizations for reporting, Views make it easy to visualize and share spatial insights. Views can be customized, saved, and shared with your team for consistent and collaborative access across a project. # Introduction **Views** in VoxelSpace are pre-configured visual compositions of multiple spatial datasets. They provide a fast, effective way for teams to explore, analyze, and share complex geospatial information. A View can function as a **carefully curated scene**, set up by one team member for others to review and interact with. Alternatively, Views can be used as **temporary workspaces**—perfect for quick experimentation by combining different datasets on the fly.
---
**Accessing Views in a Project** Each project contains a list of Views that are accessible via the **“Views”** tab in the Project Page. [![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/8n5image.png)](https://help.mystart.com/uploads/images/gallery/2025-03/8n5image.png) From this section, users can: - Click on a **View card** to open an existing View - Click the **“Add View”** button to create a new one *(See the Creating a View section for detailed instructions.)* When a View is opened, it loads in VoxelSpace’s native **OpenGL viewer**, allowing full 3D interaction with the visualized data. [![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/hlnimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/hlnimage.png) **Viewer Controls** Use the following mouse controls to interact with the 3D scene:
**Control** **Action**
**Left Mouse Button** Rotate the camera around the focus point
**Right Mouse Button** Pan the camera across the horizontal plane
**Mouse Wheel** Zoom in and out
# Creating a View The WebUI provides two different ways to start the creation of a View: 1. Create a View from the "Add Object" button in the Catalog section [![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/pzbimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/pzbimage.png) 1. Create a View from the View Section by clicking on "Create View": [![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/gAZimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/gAZimage.png) It will show this dialog to add the view information (name, description, project) [![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/hJfimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/hJfimage.png) Both approaches have the same results, the only difference is in the first case the user is aware from the start of which Folder will contain the View object, as the object is explicitly added to a Folder. When using the second approach, it is also possible to define which Folder will contain the View entity from the View definition UI. Using on any of the approaches above will show the View creation UI: [![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/pPeimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/pPeimage.png) At this point the View is created, but not saved into the Project. Other team members will not see it until you press the "Save" button. At the top-right corner of the UI, a button with a gear icon displays the View configuration options. Typically, you will add one or more visual layers to the View before saving it. The [Adding Layers to a View](https://help.mystart.com/books/using-the-webui/page/adding-layers-to-a-view "Adding Layers to a View") section covers how to add layers of data to a View. Once the view displays some content, you can provide a meaningful name to it and capture its thumbnail from the "General" section found in the View configuration panel: It is possible to save your changes to the view by clicking any of the "Save" buttons in the View configuration panel. One is found in the "General" section and the second is in the "Layers" section. # Adding Layers to a View In VoxelSpace, a **View** can contain one or more **visual layers**, each representing a different dataset or spatial element. Layers are essential for building rich, multi-dimensional visualizations that combine terrain, point clouds, block models, and more.
---
**How to Add a Layer** 1. While in the **View interface**, click the **Layer icon** [![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/oQKimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/oQKimage.png) to open the **View Configuration Panel**. 2\. In the panel, select the **“Layers”** tab. 3. Click the **“Add Layer…”** button to begin adding data to the View. [![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/mNJimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/mNJimage.png) **What Happens Next?** After clicking **“Add Layer…”**, you’ll be prompted to: - **Select a dataset** from the project’s catalog - **Configure how it’s rendered**, including visibility, transparency, color maps, or display filters—depending on the dataset type Each dataset you add enhances the View, allowing for layered analysis and deeper spatial understanding. # Working with Cross-sections The **View interface** in VoxelSpace allows users to perform real-time cross-section operations across spatial datasets. This tool is ideal for analyzing subsurface structures, internal geometries, or layered data distributions.
---
**Accessing Cross-Section Tools** 1. While viewing a dataset, open the **Viewer Tools panel**. 2. Click on the **“Cross-section”** option to activate the cross-section controls. [![image.png](https://help.mystart.com/uploads/images/gallery/2025-03/scaled-1680-/JDLimage.png)](https://help.mystart.com/uploads/images/gallery/2025-03/JDLimage.png) **Selecting Cross-Section Types** Once the tool is enabled, you can choose from various **cross-section types** to define how the cut will interact with the 3D scene. These options typically include: - **Single plane** – Cuts through the model along one axis - **Box clip** – Isolates a defined volume within a bounding box - **Axis-aligned slices** – Slices perpendicular to X, Y, or Z for sectional analysis - *(Insert specific options from UI if applicable)*
---
Cross-sections can be adjusted in real time—move, rotate, or scale the clipping planes to refine your view and focus on specific features of interest.
# Working with Regions A region is a spatial object that defines a volume of space. Regions are useful to provide a scope to reports, export operations and processing of spatial data in general. The platform currently supports one type of region, which is an extruded convex N-gon. It is possible to store multiple regions in a Project. The View configuration panel provides access to the regions in the Project. To access them, select the "Region" tab: ![](https://demo.voxelfarm.com/help/lib/NewItem31.png) The UI exposes a set of actions that can be performed over the multiple regions in the Project:
New Region Starts a new region and displays it in the viewer
Load Region Loads a previously saved region and displays it in the viewer
Save Region Saves the current region
Hide Region Hides the current region in the viewer
Show Last Region Shows the last active region in the viewer
Rename Region Renames a region
Delete Region Deletes a region
Region Properties Shows a modal dialog that contains information about the region
# Creating URL links to Views It is possible to create a deep link to a View in the platform. To do so, select the "General" tab in the View configuration panel. Click on the "Create Link to View..." button: ![](https://demo.voxelfarm.com/help/lib/NewItem97.png) This will open a modal dialog containing the link. This link will bring the browser to the same View and camera position as when the link was captured. User security will be applied to links, please make sure the recipient of the link has access to the Project.