Skip to main content
Image Viewer
Updated over a month ago

What is Image Viewer

Image Viewer is a versatile tool that allows you to view photos 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:

  1. Managing Image and Panorama Groups in the Layer Tree

  2. Three Viewing Modes for Every Need

  3. Switching Between Viewing Modes

  4. Cameras in 3D Scene

  5. Color-Coded Image Groups

  6. Mini Gap Between Cameras

  7. Contextual Sorting for Finding Relevant Images

  8. Navigating between Panoramas with Mini Map

  9. Customise Panorama Disc Size and Camera Height

Managing Image and Panorama Groups in the Layer Tree

You can find image and panorama groups in the Layer Tree alongside your models and annotations. They are marked with distinct icons for easy identification. Control their visibility just like any other layers to manage what’s displayed in your project.

Three Viewing Modes for Every Need

Image viewer has three different modes each designed for specific scenarios:

3D Overlay Mode

3D Overlay Mode renders images or panoramas directly onto your 3D model, creating an immersive experience that blends spatial context with image details. Annotations drawn on images or panoramas automatically project onto the 3D model.

To enter 3D Overlay Mode:

  1. Search for an image/panorama in the Layer Tree and click on it.

  2. Or click the image camera widget, then select Open in 3D Overlay, or click on a panorama disc to load it automatically.

  3. Or click an image/panorama in the right-side ribbon (visible only when already in a viewing mode).

Pop-out Mode

Pop-out Mode enables you to open images/panoramas in separate, resizable windows, allowing side-by-side comparisons or simultaneous viewing alongside your 3D model.

To open an image/panorama in Pop-out Mode:

  1. Search for an image/panorama in the Layer Tree, click ..., and select Open in pop-out.

  2. Or click the image camera widget, then select Open in pop-out.

  3. Or click the pop-out icon in the right-side ribbon.

2D Fullscreen Mode

Note: Panorama does not have a fullscreen mode.

2D Fullscreen Mode is ideal for focusing entirely on image details, especially when working with images that lack 3D positioning.

To enter Fullscreen Mode:

  1. Click the image camera widget, then select Open in 2D Fullscreen.

  2. Click the fullscreen icon on an image in the right-side ribbon.

Switching Between Viewing Modes

Quickly switch between Panorama Overlay, Image Overlay, and 3D Mode using the switcher in the top-right corner of the viewer. Switching back to 3D Mode will automatically exit 2D Fullscreen and 3D Overlay Modes.

Note: Make sure you have enabled at least one image or panorama group in the layer tree.

Cameras in 3D Scene

Image Viewer displays camera positions from your image and panorama groups 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.

  • Open Image Viewer Settings next to 3D Viewer Settings.

  • Adjust the number of images to show

  • or tick the All checkbox to show all cameras.

  • Click Apply to confirm changes.

Color-Coded Image Groups

Working with multiple image groups and want a quick way to tell them apart? You can customize the color of camera widgets in the 3D viewer for different image groups. This is useful for distinguishing images from different dates, locations, or project phases.

To update the color of an image group:

  1. Click "..." on the image group.

  2. Select "Change Color."

  3. Pick a color that helps you organize your images visually.

Note: These color settings are saved locally on your device, giving you the freedom to set up your project just the way you like it. Just keep in mind that if you share your project with others, they'll need to set their own color preferences.

Mini Gap Between Cameras

In the Image Viewer Settings, 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 the change.

Contextual Sorting for Finding Relevant Images

Image Viewer employs smart sorting to find the most relevant images when you click in the 3D scene or move your camera. This enhances your ability to quickly locate and inspect the images that matter most to you. To further customise sorting, open Image Viewer Settings, where you can select different sorting modes and adjust the weight sliders to fine-tune the sorting criteria.

If you want to lock the current image order:

  • Select "Lock"

  • Or use the keyboard shortcut "Z"

  • Click Apply to confirm

Navigating between Panoramas with Mini Map

When exploring panoramas in a large area, 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

Panorama Disc Size

In the Image 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 Image Viewer Settings to suit your needs.

Regenerate Image Pose & Improve Loading Speed

Noticed that your image isn't aligning perfectly with the 3D model in 3D Overlay mode? Sometimes, the initial pose or scaling needs a quick adjustment. Here's how you can fix it:

Regenerate Image Pose

  1. Click "..." on the image group.

  2. Select "Regenerate Pose" to recalculate the image’s position and scale (this may take some time).

  3. If alignment is still off, please reach out to our support team for assistance.

Improve Image Loading Speed

  • If images load slowly, look for the "Generate Image Tiles" button.

  • Clicking it will optimize loading times.

  • If you don’t see the button, your image group was already created with image tiles automatically.

Did this answer your question?