What is Image Viewer
Image Viewer is a versatile tool that allows you to view 2D images and panoramas alongside your models and see their camera positions directly within the 3D scene. This provides a seamless integration of your images and spatial data. This guide outlines the main features and functions of the Image Viewer and how to use them efficiently:
Switching Between 2D Images and Panoramas
You can view both 2D image and panorama groups in the Image Viewer. To switch between them, simply use the dropdown menu at the top of the viewer to toggle between your imported images and panoramas.
Searching and Filtering
Use the filter button to choose specific 2D image or panorama groups to display in the list. Additionally, you can quickly find a particular image or panorama using the search bar. Just enter the filename, and the viewer will automatically filter and show the matching results.
Cameras in 3D Scene
Image Viewer displays camera positions from your 2D images and panoramas within the 3D scene. By default, it displays up to 10 cameras to optimise performance. You can adjust this setting to display a specific number of cameras or show all cameras as needed.
Adjust the number of images to show
or tick the ALL checkbox to show all cameras
Click Apply to confirm
You also have granular control over the distance between cameras, allowing you to skip unnecessary ones within a specified range for a clutter-free experience, especially in smaller spaces.
Scroll the slider, Minimum gap distance in meters, to set the distance
or Enter a specific value in the input box.
Click Apply to confirm
To toggle the visibility of cameras:
Click the gear button ⚙️ and enable or disable the Show Camera option
Or use the keyboard shortcut "X"
Click Apply to confirm
Contextual Sorting for Finding Relevant Images
The Image Viewer employs smart sorting to find the most relevant images when you click in the 3D scene. This enhances your ability to quickly locate and inspect the images that matter most to you. The images are automatically sorted based on:
Proximity: Distance from the point clicked in the 3D scene to the photo's camera.
Angle Similarity: How similar the photo’s camera view is to your current viewpoint.
To further customise sorting, click the gear button ⚙️ to open settings, where you can adjust the weight sliders to fine-tune the sorting criteria.
If you want to lock the current image order:
Click the gear button ⚙️ and select "Lock"
Or use the keyboard shortcut "Z"
Click Apply to confirm
Interacting with 2D Images
When you select an image from the list, the following actions take place:
The 3D scene moves to the camera position where the image was taken
The full-resolution image is displayed below the 3D scene
You can also adjust the size ratio between the 3D scene and the image by dragging the divider line between the two views.
Pro tip: You can also click on the camera in the 3D scene to select the image.
To disable automatic flying to the camera position:
Click the gear button ⚙️ and uncheck "Auto-orient 3D scene"
Or use the keyboard shortcut "C"
Click Apply to confirm
Interacting with Panoramas
When viewing panoramas, you can click on one from the list to overlay it onto the 3D scene. To see the 3D models behind the panorama, adjust its opacity using the slider located in the top-left corner of the 3D scene.
Pro Tip: To quickly navigate through panoramas in Panorama Mode, click on the next panorama disc to move to the subsequent one. Alternatively, click in the direction you want to explore, and the view will shift to the surrounding panorama.
To exit Panorama Mode and return to the regular 3D view, click the button located in the top-right corner of the 3D scene.
Navigating in Panorama Mode with Mini Map
When exploring large areas in Panorama Mode, it’s easy to lose your sense of direction. To help, turn on the mini map in the bottom-right corner of the 3D scene.
White points: Represent different panoramas.
Cursor: Shows your current location and rotates as you move the camera.
Click on any white point to quickly jump to that panorama.
Customise Panorama Disc Size and Camera Height
You can access the Viewer Settings by clicking the gear icon located in the top right corner of the 3D scene.
Panorama Disc Size
In the Viewer Settings, you can adjust the size of the panorama icon. Increasing the size helps when locating panoramas in large, open spaces, while reducing it can improve navigation in smaller areas.
Panorama Camera Height
By default, the panorama icon is positioned 1.5 meters below the original camera location to show where the camera was approximately placed. You can reset this position to 0 or adjust it further in the Viewer Settings to suit your needs.
Mini Gap Between Panoramas
In the Image Viewer Settings, you can control the distance between panoramas by setting a specific distance in meters. This feature allows you to automatically skip unnecessary panoramas that are too close to each other, helping you create a cleaner and more streamlined walkthrough experience.
This feature is especially useful for smaller spaces, where panoramas may be positioned too closely. By setting a customised distance, you can ensure your walkthroughs are clutter-free and easy to navigate.