GLG Truview Training Manual

TruView Training Manual
Prepared by GREAT LAKES GEOMATICSLLC
GREAT LAKES GEOMATICS
LLC
PROFESSIONAL SURVEYORS * LASER SCANNING
1274 Library
Detroit, MI 48226
(313) 964-2770
12504 Stephens
Warren, MI 48089
(586) 755-5770
Revision History
Action
Document creation
Revised title page new logo & address
Initial
GB
GB
Date
01/15/09
01/21/09
The HDS images and text of this document are

Copyright 2011 Great Lakes Geomatics, LLC. All rights reserved.
All trademarks mentioned herein belong to their respective owners.
TruView, Cyclone, and the Leica Geosystems logotype are trademarks of Leica Geosystems.
The TruView software and the look and feel of the TruView user interface
are the property of Leica Geosystems and are used under license.
The Hexagon logotype is a trademark of Hexagon Group.
Internet Explorer and Windows XP are trademarks of Microsoft Corporation.
Prepared by:
GREAT LAKES GEOMATICSLLC

Contents
Introduction: TruView and Cyclone
UNIT 1: Downloading and Installing TruView
UNIT 2: Starting TruView
UNIT 3: Working in Measure Mode
UNIT 4: Working in Mark-Up Mode
UNIT 5: Working in View Mode
UNIT 6: Mark-Ups with Links
UNIT 7: Mark-Up Data Management
UNIT 8: Collaboration Using TruView
UNIT 9: Other Miscellaneous Functions
Troubleshooting
Exercises
Appendices
4
6
8
12
15
17
18
19
21
22
23
25
30
NOTE: You may have received this manual along with a GLG data CD containing
TruView file sets for your project. In that case, the examples and illustrations (file names,
directories, etc.) shown in the manual will, of course, be different from your project data,
but the operation of TruView will be the same.
In the HDS database used in the production of this manual, scan worlds are named
ScanWorld<n> where n is a consecutive number. These scan world names are picked
up by Cyclone PUBLISHER and used as TruView subdirectory names in the TruView
file set. Thus, the subdirectory names in other file sets may be entirely different.
This manual does not attempt to describe every option of every command available in
TruView. Experience is the best teacher, and a few minutes of experimentation and
exploration with TruView will reveal much more of the programs capabilities than can
be conveniently described in print. Use the Exercises section to guide you through
examples of most common operations. For additional information refer to the help
facility by clicking the Help icon
under the About tab.
This manual assumes typical computer literacy on the part of the reader, and a basic
knowledge of the Windows operating system, directory structures, file management, etc.
The information in this document was prepared using Leica Cyclone version 6.0.2 and
TruView version 2.1.0.1.
Prepared by:

Introduction: TruView and Cyclone

Leica Cyclone consists of a suite of software modules, including
REGISTER for aligning separate point clouds to a common coordinate system

MODEL for 2D and 3D modeling for civil, architectural and other projects
SURVEY a subset of Cyclone MODEL especially for surveyors
CLOUDWORX for manipulating scan data directly within CAD applications
VIEWER allows full fly-around 3D viewing but does not include measurement or
markup tools.
PUBLISHER for creating TruView file sets
A typical point cloud viewed in Cyclone
High Density Survey (HDS) laser scan point clouds can be challenging to manipulate and
interpret without considerable Cyclone experience. Cyclone provides a sophisticated
data processing environment with many complex functions that are not required for basic
scan data viewing and measurement.
Prepared by:

TruView allows engineers and other professionals to access HDS laser scan data without
the expense and learning curve of the Cyclone software system.
TruView file sets are created from HDS laser scan data using Cyclones Publish Site
Map command. The original scan data point clouds are distilled into pixelated
images. There are a number of options available in Cyclone to control the accuracy,
resolution, color, and file size of the published TruView file sets. TruView file sets can
easily be made accessible over the internet.
Leica TruView Features and Benefits
View TruView file sets locally or via the web

Accurate coordinate and point-to-point measurements
Use high-resolution images and true-color point clouds
Text and graphic markup capabilities
Collaboration via saving and sharing of views and markups
Incorporate hyperlinks to asset information within views
Free software download: www.leica-geosystems.com/hds
Prepared by:


Begin by registering at the Leica Geosystems TruView website
http://www.leica-geosystems.com/hds/en/lgs_64524.htm
After entering some minimal registration information, you will receive an email with a
link to the TruView download site. Download and execute the TruViewSetup.exe file.
TruView is installed as an Internet Explorer (IE) ActiveX add-on. It can be uninstalled
using the Add or Remove Programs function of Control Panel.
System Requirements
Microsoft Windows XP (SP1 or higher) or

Microsoft Windows 2000 (SP3 or higher with up-to-date security patches)
Microsoft Internet Explorer version 6.0 or higher
500 MHz Processor or faster
256 MB RAM or higher
OpenGL accelerated graphics card
ActiveX must be enabled in the browser (see next page)
Prepared by:


In order to allow ActiveX controls to operate
... the option shown below must be checked (it is not checked by default).
There are a number of ways to get to this dialog box. Here is one
Start
Control Panel
Internet Options
Advanced (tab)
; Allow active content to run in files on My Computer
If you skip this step, you will see the yellow ActiveX warning bar when you start
TruView (see next page).
Prepared by:


If Internet Explorer is not your default browser, then you must start IE first.
In the directory system (or IE File/Open/Browse) navigate to the published TruView
directory for your application
Open that directory, and double-click on the file SiteMap.htm
Prepared by:


The Site Map will appear as a webpage in Internet Explorer
This is the Site Map of a pumping station.

There are 6 scanner positions, each represented by a yellow triangle icon. These
correspond to the location of the scanner when the scan data was acquired.
Click an icon to bring up the scene from that scanner position
Prepared by:

10
TruView displays the HDS scanner data as a digital image:
The viewpoint cannot be changed within each scene; it is fixed at the original scanner
position, but the view can be panned and zoomed (see next page).
The user can move among the available scanner positions, or scenes, in several ways:
1) Return to the Site Map page, using either the browser Back function or by clicking
under the Controls tab. The latter will bring up the
the TruView Site Map icon
site map in either a new window or a new tab (depending on the Internet Options
setting for pop-up display). Then simply click a different scanner position icon on the
Site Map.
2) Double-click one of the scanner positions indicated by a yellow triangle icon
the current TruView scene.
in
3) Select a new scanner position from the Neighbor TruViews pull-down menu on the
left side of the TruView screen.
Prepared by:

11
TruView always operates in one of three modes:

Measure
Markup
View
The current mode is indicated by the highlighted and outlined mode icon, and can be
changed by clicking one of the others.
View mode
Markup mode
Measure mode
TruView always starts in Measure Mode. Think of it as the default mode.
Prepared by:


Panning and Zooming

Click and hold the left mouse button to pan in any direction,
or click on the Pan icon
under the Controls tab.
Use the mouse wheel to zoom in or out,

or click on the Zoom icon
Prepared by:
under the Controls tab.

12
13
Measurements
Click the coordinate icon
Click the ruler icon
to measure position coordinates.

to measure between points.
Coordinates and measurements are reported in the Measure Properties window, not in
the view window. Each measurement is named so they can be selectively reviewed.
Measure commands operate continuously until changed, or canceled with the <ESC> key.
Measurement units and color may be changed in the Measure Properties window and a
default unit and color can be set.
Part of the scene may darken if the scan data is incomplete in that area.
IMPORTANT NOTE: Measurements are not markups: Measurements are transient and
disappear with any mode change. (Measurements cannot be deleted individually.)
Prepared by:

14
Hotlinks in Measure Mode

Links to external files and documents can be created in Measure mode. Click the Hotlink
icon
then click a position in the view to place the Hotlink. A dialog box will appear
that allows entry of the link target and an optional label ...
Measure mode Hotlinks can point to any kind of file; even executable files (.exe) are
valid target files. The target file will be opened with the appropriate program (MS-Word,
MS-Office Picture Manager, Adobe Reader, etc.), not necessarily in an Internet Explorer
window or tab. (The operation of Measure mode Hotlinks is thus somewhat different
from the operation of links associated with markups--see next page.)
Measure mode Hotlink target files can be specified using relative pathname specifications
(see page 19). If the browse function of the dialog box is used, the resulting target file
pathname will be an absolute pathname.
Measure mode Hotlinks can be deleted by right-clicking on the Hotlink icon and
choosing Delete from the pop-up menu.
The setting of the option Open links from other programs in: partially controls how
Measure mode Hotlinks will be opened. This option can be set in Internet Options
Tabbed Browsing Settings.
IMPORTANT NOTE: Measure mode Hotlinks are exported along with any markups
created in Markup mode (see UNIT 7: Markup Data Management page 20).
Prepared by:

15
UNIT 4: Working in Markup Mode
A new 2D frozen view is created upon entering Markup mode following a pan or zoom.
Many different marked-up views can be created within each scene.
IMPORTANT NOTE: Always pan and zoom to the exact desired view before inserting
the first markup, because that freezes the view and it can no longer be panned or zoomed.
Views are named View#nnn where nnn is a consecutive number. These default names
can be changed to something meaningful if desired. This is done in View mode (see next
section).
In Markup mode a different view can be selected by clicking < or > under the
Markup mode tab. The banner will scroll through the existing views.
Continued ...
Prepared by:


Available markups include
Position coordinates
Linear measurement
Text box
Circle/Oval and Rectangle graphics
Call-out arrow
Measurement units, colors, and other attributes may be changed in the Markup
Properties window, and a combination of attributes can be set as the default.
Markups may be individually moved, edited, or deleted. (Only the label of a
measurement markup can be moved.)
The units of a measurement markup can be changed after the markup is positioned.
Markups may overlap, for instance text may be placed within a circle or rectangle.
Prepared by:

16
17
View mode is the normal mode for reviewing previously created markups.
Click on a view name from the list to automatically pan and zoom to that marked-up view.
Note that if a manual pan or zoom operation is executed, TruView leaves View mode and
enters Measure mode. In Measure mode the currently loaded markups are not visible.
Return to View mode by clicking the view tab or icon.
The default view names can be changed to meaningful names before the markups are
saved or exported. Type the new name in to the Name: field under View Properties and
click Update.
Prepared by:

18
UNIT 6: Markups with Links
Any type of markup may include a link. The link may point to anything IE can handle,
e.g. URLs to web pages, or absolute or relative paths to files ( .pdf , .jpg , .doc , etc. ).
The markup then becomes a clickable link in that view.
For the purpose of relative path links to files, the current directory is the specific
ScanWorld<n> directory of the current scanner position (see page 9). Relative links
allow TruView directories to be moved without disrupting links to accompanying files.
In the example illustrated above, the file ABBmotors.pdf (linked from the orange oval) is
stored in the Pump Station directory, so it is linked as ..\ABBmotors.pdf. If it were
stored in the TruViews directory, it would be linked as ..\..\ABBmotors.pdf. And if it
were stored in the ScanWorld 5 directory it would be linked as .\ABBmotors.pdf.
If the browse function is used (next to Link: in the Markup Properties menu), the
resulting link pathname will be an absolute pathname.
The setting of the option When a pop-up is encountered: partially controls how links
will be opened. This option is set in Internet Options Tabbed Browsing Settings.
Prepared by:

19
UNIT 7: Markup Data Management
To understand TruViews handling of markup data, its necessary to know what a markup
file is, and the various locations where markup files can be stored.
A markup file is simply an XML file that is understood by TruView. It contains the
views and markups associated with a particular TruView scene.
Local Markups
Whenever TruView is exited, all currently loaded markups are automatically saved in
C:\Documents and Settings\<userid>\Local Settings\Application Data\TruView\<UID>.xml
where <UID> is a unique identifier, e.g. 23G4HH45J-64DH-6JFD74-GM47-JK474.xml. Note
that these files accumulate and are never deleted by the system.
Load Local loads the last saved local markups (normally from the previous TruView
session). When the command is executed, the local markups replace any currently loaded
markups. TruView automatically keeps track of which markup files are associated with
which views. (This is not the case when markup files are exportedsee next page.) The
last saved local markups are also loaded automatically at start-up.
Prepared by:

20
Export / Import Markups

Export saves the markups and views associated with the current scene as an XML file
with any desired file name and directory location.
Import loads markups from an exported XML file stored at any location. When the
command is executed, the imported markups are added to any currently loaded markups.
(For the unwary, this often leads to duplicated views, which must then be deleted.)
When exporting and importing markups the user is responsible for keeping track of
which markup files correspond to which TruView scenes. It is good practice to include
the scene name in the markup file name.
Server Based Markups

Each TruView scene can include an associated markup file that is accessed but not
changed by the user. These are called Server Based markups.
For example, Server Based markups for the TruView scene illustrated in this syllabus are
stored in ...
C:\GLG TruView Training\TruViews\Pump Station\ScanWorld5\markup.xml
Load from Server loads these server-based markups. When the command is
executed, the server based markups replace any currently loaded markups.
This provides a mechanism for centrally managed markups, which can be easily made
available to web-based users, but which cannot be changed by the user.
Prepared by:

21

There are at least three possible methods of collaboration using TruView
Server Based Markups

In situations where TruView file sets will be shared among a number of users, either via
the web, through a centralized storage server, or by some other means, Server Based
markups can be managed centrally and viewed by all TruView users. Simply create the
markups in the usual manner, then export them to a file named markup.xml stored in the
corresponding ScanWorld<n> subdirectory. This file thus becomes part of the TruView
file set, which is then distributed or published.
Markups stored in this specific location with the proper filename can be loaded by the
users with the Load From Server button.
Normally the users would not make changes to these centrally managed markup files. In
the case of most web-based access arrangements, they would be unable to change them.
In the case of a shared storage server or other means of distribution, they may or may not
have update access, but would be expected to refrain from changing them by convention.
Exported Markup Files

When less than general access is required, markup files can be created and exported as
XML files with any desired name, then simply emailed to other users. The recipients
must have access to the corresponding TruView file set in order to use the markup file.
Because TruView is unable to manage the association between TruView scenes and
exported markup files, it is the responsibility of the user to load the markup files into the
correct TruView scene. It is good practice when exporting to use filenames that convey
some indication of the TruView file set and scene to which the markups apply.
TruView Screen Shots

As a last resort, if a collaborator does not have access to TruView, they can still benefit
from TruView markups. A screen shot of TruView can be created in the usual way
(ALTPrint Screen) and emailed to the recipient. Screen shots can be converted into .jpg
files, for example by pasting them from the clipboard into Microsoft Paint and then using
the Save as function to create a .jpg file.
Alternatively, the TruView Print command can be used with the output directed to an
Adobe PDF file. TruView Print captures only the TruView image itself, without the
browser window. The PDF file can then be emailed.
Prepared by:


Metadata
Clicking the grey
icon provides information about the scan world being viewed.
Help
icon opens a help facility with index and search capability.
Clicking the blue

About
Clicking the yellow
icon provides the usual system version information.
Print
Clicking the Print icon
printer.
opens a print dialog box to send the view image to your
Right-Click brings up a menu of modes or a context sensitive list of commands.

Prepared by:

22
23
Troubleshooting
If TruView fails to run properly, check the following:
First, verify that the Internet Options setting described on page 8 In order to allow
ActiveX controls to operate was successfully accomplished.
Next, check the installed directory in Program Files; it should look more-or-less like this:
Continued ...
Prepared by:

24
Also, the IE add-ons manager should show that the TruView add-on has been installed.
Click Tools/Manage Add-ons/Enable or Disable Add-ons:
Some TruView failures result from installing TruView while Internet Explorer is running.
Use Add or Remove Programs in the Control Panel to uninstall TruView, then repeat
the installation, making sure no programs (especially IE) are running.
Finally, if TruView still fails to run, check with your companys computer systems
administrator. The most common problem is security settings that prevent downloaded
programs from installing or prevent ActiveX controls from running. Especially if your
computing environment implements Microsoft Group Policy security, there may be limits
on the programs your computer can execute. TruView runs in the My Computer IE
security zone, which normally cannot be accessed by the user through Control Panel /
Internet Options.
Prepared by:

25
Exercises
For best results, it is recommended that you study the entire training manual before
beginning these exercises.

1) Starting at the web site www.leica-geosystems.com navigate to the TruView
download page by clicking Products/HDS Systems, then Software, then HDS
Software, then Leica TruView & Cyclone PUBLISHER.
2) Click on Get Leica TruView.
3) Complete and submit the request form.
4) Check your email for the message from Leica Geosystems.
5) Download and install TruView.
6) Find the TruView add-on in Internet Explorer under Tools/Manage Add-ons.
7) Enable ActiveX controls on your computer.

1) Navigate into your TruView file set and locate the file SiteMap.htm
2) Notice how many scan worlds are included.
3) Notice whether any accompanying files (.pdfs, etc.) are present.
4) Double-click on the file SiteMap.png Notice that this is a picture of the site map, but
the scanner position icons are, of course, not active links. In the future, do not click
on this file by mistake.
5) Double-click on the file SiteMap.htm
6) Click on one of the scanner position icons in the site map.
7) Use the browsers Back button to return to the site map, and click on another
scanner position icon.
8) Use TruViews Home icon to return to the site map, and click on another scanner
position. Notice any difference in system behavior from step 7.
Prepared by:

26
9) Use the Neighbor TruViews menu to move to different scanner positions.

10) Double-click on a scanner position icon in the TruView scene to move to another
scanner position. Notice any differences in system behavior among steps 7 through
10.
11) Go to the Tabbed Browser Settings dialog box (Tools/Internet
Options/Tabs/Settings) and note the settings of When a pop-up is encountered: and
Open links from other programs:. Change these settings and repeat steps 7
through 10, noting the changes in system behavior.

1) With the mouse cursor on the TruView scene, click and hold the left mouse button.
Move the mouse to pan in any direction. Note the phenomena of reaching the top of
the scene and reaching the bottom of the scene.
2) Using the mouse wheel, zoom in to various parts of the scene. Try panning while
zoomed far in.
3) Use the pan
and zoom
icons to see which works better for you.
4) Click the ruler icon

and measure the center-to-center distance between two of
the large green pumps. (HINT: Select similar locations on each pump, even though
the measurement will go through one of them.)
5) Change the units of your measurement.
6) Change the color of your measurement and set the new color as the default.
7) Make several other measurements, noting the effect of the default. Notice whether
there are blacked-out no data areas in the scene.
8) Click the
icon and make a number of coordinate measurements. Make linear
measurements between those locations and check whether the reported dimensions
and coordinates correspond properly.
9) Add a Measure mode Hotlink to www.greatlakesgeomatics.com and test it.
10) Add a Hotlink to an MS-Word or MS-Excel file in your My Documents directory
and test the Hotlink.
Prepared by:

27
UNIT 4: Working in Markup Mode

1) In Measure mode, zoom in on one of the large orange motor housings. Click the
icon and markup a measurement across the top of the motor housing.
2) Change the color, units, and other attributes of your markup.
3) On the motor housing, create a text markup ABB Induction Motor and experiment
with the attributes and positioning of the text markup (transparency, font size, etc.).
4) Right-click and select Unlock then pan and zoom to a different motor housing and
repeat steps 1-3. Note that this creates a new view.

1) Click the View tab or the view icon
to enter View mode.
2) Click on the different views from the view list in the upper left corner of the TruView
frame. Notice the systems behavior of automatically zooming and panning to the
selected view. (If you have only one view, or none, repeat the previous units
exercises.)
3) While in View mode, execute a pan or zoom. Notice that TruView returns to
Measure mode.
4) Return to View mode. In the View Properties menu, enter a new name for one of
your views, and click Update.
UNIT 6: Markups with Links

1) Using the views you created in the previous exercises, add links to the markups and
test them. Use the same MS-Word or MS-Excel files you used previously. Note the
slightly different system behavior from the Measure mode Hotlinks.
2) Go to the Tabbed Browser Settings dialog box (Tools/Internet Options/Tabs/Settings
and change the settings of When a pop-up is encountered: and Open links from
other programs: Test your links again, noting the changes in system behavior
3) Copy one of your linked files to the ScanWorld 5 subdirectory and then build a
markup link to it using a relative pathname.
Prepared by:

28
UNIT 7: Markup Data Management

1) Close IE. Restart IE with TruView and return to the same scene where you created
your markups. Note that your markups are automatically reloaded.
2) Create an additional simple markup.
3) Click the Load Local button. This will take TruView to View mode. Note that the
markup created in step 2 was lost. It was not exported manually, and it was not saved
automatically because there was no exit from IE.
4) Click the Export button and save your markups to a file of your choice.
5) Click the Import Button and load the markup file you just created. Notice that
there is now a duplicate set of views. Import does not overwrite the currently
loaded markups and views, it adds the imported markups.
6) Copy the markup file you created in step 4 into the ScanWorld<n> subdirectory
where you are working and rename it markup.xml.
7) Click the Load From Server button. In View mode notice that there is now only a
single set of views. Load From Server overwrites the currently loaded markups and
views, which are lost if they had not been saved.

1) Return to the TruView Site Map and select a scanner position different from the one
in which you created your markups.
2) Click the Import button and load the markup file you created in the previous
exercise.
3) In View mode, notice that the markups do not correctly correspond to the TruView
scene. When importing and Exporting markups the user is responsible for keeping
track of which markup files correspond to which TruView scenes. Hence, it is good
practice to include the scene name in the markup file name.

1) Click the blue
icon to open the Help facility. Explore the available information.
The Help facility contains considerable information not covered in this manual.
2) Click the grey
icon to review meta-data about the scan world being viewed.
Refer to the help facility for information on how to interpret this meta-data.
Prepared by:


3) Click the yellow
icon to view system version information. This manual was
prepared using TruView version 2.1.0.1.
4) Click the Print icon
to send the TruView image to your printer.
Troubleshooting
1) Use the IE Add-on Manager to disable TruView.
2) Attempt to start TruView in the normal way and notice the systems behavior.
3) Re-enable TruView and verify its operation.
Prepared by:

29
Appendices
Leica Cyclone PUBLISHER 6.0 and TruView 2.0
Leica Geosystems
Leica TruView Accuracy
Leica Geosystems
Prepared by:

30

GLG Truview Training Manual

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

GLG Truview Training Manual

Uploaded by

Copyright:

Available Formats

TruView Training Manual

Prepared by GREAT LAKES GEOMATICSLLC

GREAT LAKES GEOMATICS

PROFESSIONAL SURVEYORS * LASER SCANNING

TruView Training Manual

The HDS images and text of this document are

GREAT LAKES GEOMATICSLLC

TruView Training Manual

under the About tab.

GREAT LAKES GEOMATICSLLC

TruView Training Manual

Introduction: TruView and Cyclone

REGISTER for aligning separate point clouds to a common coordinate system

A typical point cloud viewed in Cyclone

GREAT LAKES GEOMATICSLLC

TruView Training Manual

Leica TruView Features and Benefits

View TruView file sets locally or via the web

GREAT LAKES GEOMATICSLLC

TruView Training Manual

Microsoft Windows XP (SP1 or higher) or

GREAT LAKES GEOMATICSLLC

TruView Training Manual

GREAT LAKES GEOMATICSLLC

TruView Training Manual

Open that directory, and double-click on the file SiteMap.htm

GREAT LAKES GEOMATICSLLC

TruView Training Manual

This is the Site Map of a pumping station.

GREAT LAKES GEOMATICSLLC

TruView Training Manual

TruView displays the HDS scanner data as a digital image:

GREAT LAKES GEOMATICSLLC

TruView Training Manual

TruView always operates in one of three modes:

TruView always starts in Measure Mode. Think of it as the default mode.

GREAT LAKES GEOMATICSLLC

TruView Training Manual

Panning and Zooming

under the Controls tab.

Use the mouse wheel to zoom in or out,

under the Controls tab.

GREAT LAKES GEOMATICSLLC

TruView Training Manual

to measure position coordinates.

GREAT LAKES GEOMATICSLLC

TruView Training Manual

Hotlinks in Measure Mode

GREAT LAKES GEOMATICSLLC

TruView Training Manual

UNIT 4: Working in Markup Mode

GREAT LAKES GEOMATICSLLC

TruView Training Manual

GREAT LAKES GEOMATICSLLC

TruView Training Manual

UNIT 5: Working in View Mode

GREAT LAKES GEOMATICSLLC

TruView Training Manual

UNIT 6: Markups with Links

GREAT LAKES GEOMATICSLLC

TruView Training Manual

UNIT 7: Markup Data Management

GREAT LAKES GEOMATICSLLC