Tutorial #

We made a complete tutorial for anyone to use this application easily.

Load Model #

Upon opening the application, users will see all available specimens in the database. To search the database, use the search bar and enter the specimen’s name or the date when the scan was performed.

You can click on an image to view useful data about the specimen displayed in the inspector to the right. To download a specimen, click the “Load Model” button in the inspector or the icon next to the image. After waiting a few seconds, the model will load, and a sphere of images will surround it.

Manipulation of the 3D Model #

You can hide any panel by clicking on the arrows next to it. To navigate around the objects, use the following controls:

• Hold down the right mouse button and move your mouse to rotate around the specimen.
• Left click to select a preview Image, to have a full resolution
• Hold control and press left click to add a current 3D point to a path.
• Zoom in and out using the scroll wheel.

Preview Images #

You can click on a preview image to display a high-resolution version. Use the following controls to navigate within the image:

• Hold down the right mouse button and move your mouse to pan the image.
• Zoom in and out using the scroll wheel.
• Press the scroll wheel to move the image around.
• Press the space bar to hide the image and view the model in the same orientation.
• Left-click to exit the image high-resolution
• Right-click to place a point on the image (Before that, go to the left and click on the + to add a point)
• Press “Delete” on the keyboard to remove current point on image.

Help #

All these controls are in the help window.

Points #

You can create a point by clicking the “+” icon on the left panel. A point consists of multiple 2D points in different images, forming the final precise point. To add a 2D point, click on a preview image and right-click on the image. Your point will be added to the selected point in the treeview. When a point is placed on a preview image, the selected preview turns green, indicating that a point has been made using this image. If at least two points are placed in different preview, a precise 3D point is created through triangulation. Additional points can be added by clicking the plus icon in the left interface. You can click on a point in the tree to select it, and any new points added in the preview will be used for triangulation. You can rename a point by double-clicking on its name. Next to the point’s name, there are three icons: an eye to show or hide the point, a square to change the point’s color, and a trashcan to remove the point. At the bottom, similar icons are available to show or hide all points and to remove all points.

Path #

On the top left panel we can see tabs, you can switch on the “Path” tab. The “Path” tab is dedicated to drawing multiple lines. To add a new path, click the “+” icon. By holding the control key and right-clicking on a 3D point, you can add it to the currently selected path. Information about the path, such as the distance of each segment and the ratio of the selected path, is displayed in the inspector on the right. To change the position of the path, click on the arrows to adjust the route taken by the path. Similarly to points, you can perform the same actions for paths using the same icons. You can rename a path by double-clicking on its name. Next to the path’s name, there are icons for showing or hiding the path, changing its color, and removing it. At the bottom, you have options to show or hide all paths and to remove all paths.

Camera #

We also have a “Camera” tab on the left dedicated to saving specific camera positions, aiding museums in repositioning the camera later. lick the “+” icon to add a camera on the position you are currently facing.

Inspector #

On the right we have a panel with Inspector in it, the main purpose of this tab is to have a detailed information on certain elements.

Settings #

On the right, we have a “Settings” tab where multiple parameters can be modified:

• Point Size: Adjusts the scale of the points, maintaining the same size regardless of zoom level.
• Mouse Speed: Controls the speed of mouse movement when navigating around the object.
• Sphere Radius: Sets the radius of the image sphere, corresponding to the size of the model.
• Toggle Wireframe: Switches the model to a wireframe view, displaying only the edges without detailed material.

  

Menu Top Bar #

We have a top menu bar with two main tabs: “Help” and “File.”

Help #

If you click on the “Help” button, a window will open displaying controls.

File #

If you click on “File,” it will open three subfolders:

• Save As: Save all points, paths, and camera positions to a .collnet file.
• Load Points: Load a previously saved .collnet file.
• Metrics: Load multiple files containing the same points and paths to compare them, calculate the average, standard deviation, and variance, it is used to obtain a highly precise distance for the paths.