Skip to content

Commit

Permalink
feat: #18 sidebar
Browse files Browse the repository at this point in the history
  • Loading branch information
aliciawr committed Nov 10, 2025
1 parent 61dcd55 commit 9e16702
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 11 deletions.
25 changes: 14 additions & 11 deletions Userguide.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ This is a user guide for all functionality found in Molloy Explorer. For general
- [Moving the viewpoint](#moving-the-viewpoint)
- [Zoom](#zoom)
- [Move](#move)
- [Menu Bar](#functionalities)
- [Sidebar](#functionalities)
- [Elevation Control](#elevation-control)
- [Accepted Filter](#accepted-filter)
- [Measurements](#measurements)
Expand Down Expand Up @@ -37,14 +37,14 @@ Drag two fingers on the touchpad towards each other or away from each other.
To move within the application, double click on a point you wish to explore further and you will automatically be moved closer to that point.
If you want to move across larger distances, for example look at a point from a different point cloud, it is recommended to zoom out first and then double click on a point closer to where you want to be positioned.

## Menu Bar
## Sidebar

In the top left corner there are two icons:
The top icon opens the menu bar and the bottom icon shows and collapses the minimap. Most of the functionalities are located in the menu bar.
The top icon opens the sidebar and the bottom icon shows and collapses the minimap. Most of the functionalities are located in the sidebar.

<img src="public/img/00_icons.png" alt="icons" width="100">

There are eight tabs in the menu bar that can be opened and collapsed by clicking on them.
There are eight tabs in the sidebar that can be opened and collapsed by clicking on them.

<img src="public/img/01_menuBarTabs.png" alt="tabs" width="400">

Expand Down Expand Up @@ -76,7 +76,7 @@ The accepted filter contains one button to change the view to show which datapoi

---

The Measurements tab allows you to measure angles, distances, heights, areas, volumes, and other properties directly within the point cloud. All tools are located in the Measurements tab in the menu bar. You can perform multiple measurements simultaneously, and all results are tracked in the "List of Measurements" section.
The Measurements tab allows you to measure angles, distances, heights, areas, volumes, and other properties directly within the point cloud. All tools are located in the Measurements tab in the sidebar. You can perform multiple measurements simultaneously, and all results are tracked in the "List of Measurements" section.

For all the measurements below, you stop by right clicking.

Expand All @@ -91,7 +91,7 @@ To measure angles between points:

To adjust a point in the triangle, click on the point you want to move, then click a new point in the point cloud.
There is no limit to the number of triangles you can display.
Measurement details appear in the "List of Measurements" below the menu bar. The default name is "Distance#1"; make sure it is selected when reviewing the data.
Measurement details appear in the "List of Measurements" below the sidebar. The default name is "Distance#1"; make sure it is selected when reviewing the data.

#### Inspect Point

Expand Down Expand Up @@ -205,7 +205,7 @@ This applies to all measurement types, including angles, distances, heights, are

#### List of Measurements

All measurements are tracked in the "List of Measurements" panel at the bottom of the menu bar. Each measurement can be selected to view detailed information or deleted individually. This list provides an easy way to manage multiple measurements in a large point cloud.
All measurements are tracked in the "List of Measurements" panel at the bottom of the sidebar. Each measurement can be selected to view detailed information or deleted individually. This list provides an easy way to manage multiple measurements in a large point cloud.

### Saved Locations

Expand Down Expand Up @@ -300,7 +300,7 @@ The Background setting controls the scene’s visual backdrop. Options include:

---

The Tools section is located in the menu bar and contains functionalities for clipping, navigation, camera control, and speed adjustment. Clicking on a tool will open the corresponding options.
The Tools section is located in the sidebar and contains functionalities for clipping, navigation, camera control, and speed adjustment. Clicking on a tool will open the corresponding options.

<img src="public/img/09_Tools.png" alt="Tools" width="400">

Expand Down Expand Up @@ -350,7 +350,7 @@ Navigation tools allow you to move around the dataset and view it from different
Similar to Fly Control, but movement mimics the behaviour of a helicopter, including tilt and banking effects.

- **Orbit Control**
Lets the camera orbit around a selected point, object, or region. Ideal for inspecting objects from multiple angles without changing the target point.
Lets the camera orbit around a selected point, object, or region. Ideal for inspecting objects from multiple angles without changing the target point. This is the default mode.

- **Full Extent**
Resets the view to show the entire dataset or point cloud. This is useful if you have zoomed in too far or moved to a specific area and want to see the whole scene.
Expand All @@ -362,7 +362,9 @@ Navigation tools allow you to move around the dataset and view it from different
Displays a compass in the top right corner of the screen. This shows the current orientation and allows you to reset the view to north-up.

- **Camera Animation**
Lets you create or play smooth camera movements, such as flying along a path or rotating around a point.
Lets you create or play smooth camera movements, such as flying along a path or rotating around a point. To utilize this tool, click on the Scene tab, then go to Objects/Other, an animation icon will show up. Click on this, adjust properties as wanted(you can move the points or adjust the duration of the animation here), and click on play.

<img src="public/img/14_Animation.jpg" alt="Scene" width="400">

- **Left View / Right View / Front View / Back View / Top View / Bottom View**
Predefined fixed perspectives that allow you to quickly switch to standard orthogonal views of your dataset.
Expand Down Expand Up @@ -431,10 +433,11 @@ General information regarding the application, licences, contributors and more w

## Minimap

The map icon below the menu bar icon in the top left corner, will show and collapse a minimap.
The map icon below the sidebar icon in the top left corner, will show and collapse a minimap.
In the minimap you can zoom using the mouse, touchpad or the icons in the top left corner.
You can move around by clicking and moving the mouse around simultaneously. The coordinates your cursor hover over will show up in the top right corner of the minimap.

## Coordinates

In the bottom right corner there is a black box that lists coordinates. These coordinates correspond to the target point, which is continuously updated to be the most recent point the user has double clicked on. Latitude and longitude are measured in degrees, while elevation is measured in metres from the sea level.
Coordinates are only shown in the "Orbit Control" Navigation mode.
Binary file added public/img/14_Animation.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 9e16702

Please sign in to comment.