Glg Truview Training Manual

7/25/2019 Glg Truview Training Manual

1/30

TruView Training Manual

Prepared by

GREAT L AK ES GEOM AT I CS L L C

GREATL AKES GEOM AT ICSL L CPROFESSIONAL SURVEYORS * LASER SCANNING

12504 StephensWarren, MI 48089

(586) 755-5770

1274 LibraryDetroit, MI 48226(313) 964-2770


2/30

TruViewTraining Manual 2

Prepared by:GREATL AKESGEOM AT ICSL L CPROFESSIONAL SURVEYORS * LASER SCANNING

Revision History

Action Initial Date

Document creation GB 01/15/09

Revised title page new logo & address GB 01/21/09

The HDS images and text of this document areCopyright 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 interfaceare 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.


3/30



Contents

Introduction: TruView and Cyclone 4UNIT 1: Downloading and Installing TruView 6UNIT 2: Starting TruView 8UNIT 3: Working in Measure Mode 12UNIT 4: Working in Mark-Up Mode 15UNIT 5: Working in View Mode 17UNIT 6: Mark-Ups with Links 18UNIT 7: Mark-Up Data Management 19UNIT 8: Collaboration Using TruView 21UNIT 9: Other Miscellaneous Functions 22

Troubleshooting 23Exercises 25

Appendices 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 namedScanWorld 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 andexploration 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.


4/30



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 ormarkup 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 sophisticateddata processing environment with many complex functions that are not required for basic

scan data viewing and measurement.


5/30



TruView allows engineers and other professionals to access HDS laser scan data withoutthe 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 caneasily 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


6/30



UNIT 1: Downloading and Install ing TruView

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 alink 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)


7/30



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

StartControl Panel

Internet OptionsAdvanced (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 startTruView (see next page).


8/30



UNIT 2: Starting TruView

If Internet Explorer is not your defaultbrowser, then you must start IE first.

In the directory system (or IE File/Open/Browse) navigate to the published TruViewdirectory for your application

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


9/30



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


10/30



TruView displays the HDS scanner data as a dig ital 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

the TruView Site Map icon under the Controls tab. The latter will bring up thesite 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 inthe current TruView scene.

3) Select a new scanner position from the Neighbor TruViews pull-down menu on theleft side of the TruView screen.


11/30



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 bechanged 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.


12/30



UNIT 3: Working in Measure Mode

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 under the Controls tab.


13/30



Measurements

Click the coordinate icon to measure position coordinates.

Click the ruler icon 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 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.)


14/30



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 appearthat 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 Explorerwindow 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 andchoosing 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 OptionsTabbed Browsing Settings.

IMPORTANT NOTE: Measure mode Hotlinks are exported along with any markupscreated in Markup mode (see UNIT 7: Markup Data Management page 20).


15/30



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 insertingthe 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 namescan 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 under the

Markup mode tab. The banner will scroll through the existing views.

Continued ...


16/30



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.


17/30



UNIT 5: Working in View Mode

View modeis 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 aresaved or exported. Type the new name in to the Name: field under View Properties and

click Update.


18/30



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 pathlinks to files, the current directoryis the specificScanWorld 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 fileABBmotors.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 itwere 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), theresulting 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.


19/30



UNIT 7: Markup Data Management

To understand TruViews handling of markup data, its necessary to know what a markupfile 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 inC:\Documents and Settings\\Local Settings\Application Data\TruView\.xml

where 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 Localloads 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 withwhich 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.


20/30



Export / Import Markups

Exportsaves the markups and views associated with the current scene as an XML file

with any desired file name and directory location.

Importloads markups from an exported XML file stored at any location. When thecommand 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 includethe 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 Serverloads 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.


21/30



UNIT 8: Collaboration Using TruView

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 Basedmarkups 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.xmlstored in the

corresponding ScanWorld subdirectory. This file thus becomes part of the TruViewfile 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 asXML 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 andexported 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 usingthe Save as function to create a .jpg file.

Alternatively, the TruView Print command can be used with the output directed to anAdobe PDF file. TruView Print captures only the TruView image itself, without the

browser window. The PDF file can then be emailed.


22/30



UNIT 9: Other Miscellaneous Functions

Metadata

Clicking the grey icon provides information about the scan world being viewed.

Help

Clicking the blue icon opens a help facility with index and search capability.

About

Clicking the yellow icon provides the usual system version information.

Print

Clicking the Print icon opens a print dialog box to send the view image to yourprinter.

Right-Clickbrings up a menu of modes or a context sensitive list of commands.


23/30



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 ...


24/30



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 repeatthe installation, making sure no programs (especially IE) are running.

Finally, if TruView still fails to run, check with your companys computer systemsadministrator. 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 limitson 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.


25/30



Exercises

For best results, it is recommended that you study the entire training manual before

beginning these exercises.

UNIT 1: Downloading and Installing TruView

1) Starting at the web site www.leica-geosystems.comnavigate to the TruViewdownload 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.

UNIT 2: Starting TruView

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, butthe 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 anotherscanner position icon.

8) Use TruViews Home icon to return to the site map, and click on another scannerposition. Notice any difference in system behavior from step 7.


26/30



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 anotherscanner position. Notice any differences in system behavior among steps 7 through

10.

11) Go to the Tabbed Browser Settings dialog box (Tools/InternetOptions/Tabs/Settings) and note the settings of When a pop-up is encountered: andOpen links from other programs:. Change these settings and repeat steps 7

through 10, noting the changes in system behavior.

UNIT 3: Working in Measure Mode

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 ofthe scene and reaching the bottom of the scene.

2) Using the mouse wheel, zoom in to various parts of the scene. Try panning whilezoomed 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 ofthe 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 whetherthere are blacked-out no data areas in the scene.

8) Click the icon and make a number of coordinate measurements. Make linearmeasurements between those locations and check whether the reported dimensions

and coordinates correspond properly.

9) Add a Measure mode Hotlink to www.greatlakesgeomatics.comand test it.

10) Add a Hotlink to an MS-Word or MS-Excel file in your My Documents directoryand test the Hotlink.


27/30



UNIT 4: Working in Markup Mode

1) In Measure mode, zoom in on one of the large orange motor housings. Click theicon 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 experimentwith 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 andrepeat steps 1-3. Note that this creates a new view.

UNIT 5: Working in View Mode

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 TruViewframe. 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 toMeasure mode.

4)

Return to View mode. In the View Properties menu, enter a new name for one ofyour views, and click Update.

UNIT 6: Markups with Links

1) Using the views you created in the previous exercises, add links to the markups andtest them. Use the same MS-Word or MS-Excel files you used previously. Note theslightly different system behavior from the Measure mode Hotlinks.

2) Go to the Tabbed Browser Settings dialog box (Tools/Internet Options/Tabs/Settingsand change the settings of When a pop-up is encountered: and Open links fromother 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 amarkup link to it using a relative pathname.


28/30



UNIT 7: Markup Data Management

1) Close IE. Restart IE with TruView and return to the same scene where you createdyour 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 themarkup 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 thatthere is now a duplicate set of views. Import does not overwrite the currentlyloaded markups and views, it adds the imported markups.

6) Copy the markup file you created in step 4 into the ScanWorld subdirectorywhere you are working and rename it markup.xml.

7) Click the Load From Server button. In View mode notice that there is now only asingle set of views. Load From Server overwrites the currently loaded markups and

views, which are lost if they had not been saved.

UNIT 8: Collaboration Using TruView

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 previousexercise.

3) In View mode, notice that the markups do not correctly correspond to the TruViewscene. When importing and Exporting markups the user is responsible for keepingtrack of which markup files correspond to which TruView scenes. Hence, it is good

practice to include the scene name in the markup file name.

UNIT 9: Other Miscellaneous Functions

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.


29/30



3) Click the yellow icon to view system version information. This manual wasprepared 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.


30/30


Appendices

Leica Cyclone PUBLISHER 6.0 and TruView 2.0

Leica Geosystems

Leica TruView Accuracy

Leica Geosystems