Trimble Clarity Viewer Help

Trimble Clarity Viewer is a web-based application that enables geospatial professionals to visualize and share rich, large, and complex 3D data with their customers and other interested parties. When viewing Trimble Clarity presentations, users get a real sense of being at the project site. The collaborative environment supports easy site navigation, quick measurements,and the ability to insert annotations.

Viewing areas

The Trimble Clarity Viewer includes two viewing areas:

  • Site View(1below)
    This view allows you to pan and zoom through a realistic project site consisting of 360⁰ station-based imagery. If point cloud data is included in the presentation, you can make measurements and insert annotations as needed. The view includes icons along its top and left side for various commands, all of which are described below.
  • Mini-Map View (2below)
    This view shows an overview of the stations to assist in determining location and orientation. If the source data was georeferenced, a digital map isdisplayed as well. Stations are represented by red dots. A semi-transparent red overlay shows the direction and zoom level of the the station whose data is being viewed. You can click the Mini-Map icon located at the top of Site View to hide and show the Mini-Map View.

Navigate the viewing areas

To pan the viewing area:
Press and hold the left mouse button while moving the mouse.

To zoom the viewing area:
Use the mouse wheel.

Change stations

You can easily select to view Site View data from a different station at any time.

To display data from a different station, do any of the following:

  • Click the Station icon located on the left side of the Site View. Then select a different station in the Stations list.

Stations.png

  • In the Site View, select a golden orb representing the station you want to select.
    or
  • In the Mini-Map View, select a different red station icon.

To zoom the Mini-Map View to include all stations:
Click the Zoom Extents icon located in the upper-right corner of the Mini-Map View.

Mask non-selectable areas

You can select to show or hide a visible mask that covers those areas of the Site View that do not contain point cloud information and, therefore, do not support annotations and measurements.

To show and hide the non-selectable areas mask in the Site View:
Click the Selectable Areas icon located at the top of the Site View.

Click the Settings icon located on the left side of the Site View to change the color of the selectable area mask or the intensity.

Select the desired color using the drop down. Change the opacity of the mask using the slider.

Add annotations

You can add an annotation bubble to any location in the Site View as long as point cloud information is available at the location. Optionally, you can save your annotations in a saved view (see “Working with views” later in the help).

To add an annotation:
Click the Add Annotation icon located at the top of the Site View. Then click in an area with point cloud data on the Site View to display the Create Annotation dialog.

To edit anannotation:
Click the annotation bubble and make edits in the Edit Annotation dialog.

To delete anannotation:
Click the annotation bubble and click the Delete button in the Edit Annotation dialog.

To save the annotations that are visible in the current view:
Click the Views icon on the left side of the Site View and click the Create New View icon to display the Save View dialog. The new view is saved in the Views list. (See “Work with views” later in the help.)

Make measurements

You can make measurements between any two locations in the Site View as long as point cloud information is available at the locations. Optionally, you can save your measurements in a saved view (see “Working with views” later in the help).

To make a measurement:
Click the Add Measurement icon located at the top of the Site View. Then click to select each of the two measurement points intheSite View. Optionally, press and hold the mouse button while selecting the second point to employ a “rubber-band” effect to measure various locations.

To add an annotation to a measurement:
Click on the measurement bubble to display the Edit Measurement dialog.

To delete a measurement:
Click on the measurement bubble to display the Edit Measurement dialog and click the Delete button.

To save measurements that are visible in the current view:
Click the Views icon located on the left side of the Site View and click the Create New View icon to display the Save View dialog. The new view is saved in the Views list. (See “Work with views” later in the help.)


Show / Hide markups

You can select to show or hide all measurements and annotations displayed in the Site View.

To show markups:
Click the Show Markup icon located at the top of the Site View.

Markupshow.PNG

To hide markups:
Click the Hide Markup icon located at the top of the Site View.

MarkupHide.PNG

Work with views

A “view” allows you to capture image and point cloud data in any viewing orientation, along with all displayed measurements and annotations. You can display a list of all views that have been saved in the presentation and select any view to display it in the Site View.

To view a list of saved views:
Click the Views icon located on the left side of the Site View.

To display a saved view:
Click the Views icon located on the left edge of the Site View and select the view you want to display in the Site View.

To create a view:

Click the Views icon located on the left side of the Site View and select the Create New View icon to display the Save View dialog.

To update a view:

Click the Views icon located on the left side of the Site View and select the view you want to update. Make changes in the the Site View as needed and click the Update Current View icon to save the changes in the view.

To delete a view:

Click the Views icon located on the left side of the Site View and select the view you want to delete. Then click the Delete View icon .

Use the Distance Cursor

Select the Distance Cursor icon in the Cursor Type drop-down list located at the top of the Site View to replace the normal cursor icon with a visual gauge icon indicating the distance ofthe selected point from the current station. The cursor gauge is largest when located on a point near the station center of the view, and it grows smaller as it moves away from the station center.

depth 1.pngdepth 2.png

This is especially useful when, fore xample, you want to measure the top of a fence (larger cursor gauge) without accidentally picking a point that corresponds to the building located farther behindit (smaller cursor gauge).

Use the Scale Cursor

Select the Scale Cursor icon in the Cursor Type drop-down list located at the top of the Site View to replace the normal cursor icon with a visual ruler icon that scales accordingly based on the distance of the selected point from the current station. The Scale Cursor is tallest when located on a point near the current station, and it grows larger or smaller as it moves away from the current station. Unlike the Distance Cursor, which indicates only a relative distance from the station, the Scale Cursor indicates the actual vertical height of the ruler when viewed at different locations. You can even use it to make quick vertical measurements.

To change the real-world height of the Scale Cursor:
Click the Settigns icon located on the left side of the Site View and make changes as necessary.

Tool Settings

The individual who publishes a project to Trimble Clarity and any ‘Members of the project’ they designate in Trimble Connect has the option of changing the tools available to some of the users they wish to share their published project with.  Click the Settings icon  located on the left side of the Site View and you will see the following in the bottom portion of the Settings pane:

When sharing a project with other users, Trimble Connect defines three categories of users: ‘Any users with the link’, ‘Signed in users with the link’, and ‘Members of the project’.  The Tool Settings allow users to affect the visibility of the Annotations and Measurements buttons to all individuals within two of these three groups.  By default – these options are selected for all projects published.  

The following table displays which users will be affected by changing the Share Users or Project Users settings.

Trimble Connect User

Trimble Clarity Tool Settings

Any users with the link

Share Users

Signed in users with the link

Project Users

Members of the project

Not applicable

If the Annotations and Measurements  options are de-selected for a user type, when a user of that type views the shared presentation they will see a toolbar without these buttons.  

Additionally, only a project’s owner or ‘Members of the project’ as defined in Trimble Connect will see the Tools Settings portion of the Settings pane in the Site View.

Troubleshooting

Supported Browsers

The rich graphical experience that users experience in Trimble Clarity Viewer is reliant on a technology provided in most current web browsers called ‘WebGL’. All browsers which support this technology can be used to view Trimble Clarity presentations. While most major browsers for the desktop currently support this technology, others have not yet implemented it. The following is a partial list of major browsers which currently support ‘WebGL’ and can be used to view published presentations:

  • Chrome
  • Edge
  • Firefox

If you are trying to use a browser that has not yet implemented support for ‘WebGL’, when you open a presentation for viewing, you will likely receive a message similar to the one below:

Recommended Hardware

Desktop and Laptop

CPU

  • x64 recommended

Memory

  • Minimum 4 GB RAM (x64)
  • 8 GB RAM recommended

Storage

  • Minimum 32 GB storage, at least 10 GB free
  • SSD recommended

Graphics card

  • Minimum integrated DX 10 compatible
  • Discrete GPU (Nvidia, AMD), minimum 1 GB memory recommended

Tablet

CPU

  • Quad-core mobile processor

Memory

  • 4 GB or more RAM

Graphics card

  • Integrated graphics with HD hardware acceleration and dynamic video memory allocation or dedicated graphics card. OpenGL support.