Copyright 2008 Gemcom Software International Inc. (Gemcom).
This software and documentation is proprietary to Gemcom and, except where expressly provided otherwise, does not form part of any contract. Changes may be made in products or services at any time without notice. Gemcom publishes this documentation for the sole use of Gemcom licensees. Without written permission you may not sell, reproduce, store in a retrieval system, or transmit any part of the documentation. For such permission, or to obtain extra copies please contact your local Gemcom office or visit www.gemcomsoftware.com.
While every precaution has been taken in the preparation of this manual, we assume no responsibility for errors or omissions. Neither is any liability assumed for damage resulting from the use of the information contained herein. Gemcom Software International Inc. Gemcom, the Gemcom logo, combinations thereof, and Whittle, Surpac, GEMS, Minex, Gemcom InSite and PCBC are trademarks of Gemcom Software International Inc. or its wholly‐owned subsidiaries. Contributors Rowdy Bristol Phil Jackson Gemma O’Farrell Duncan Hall Product Gemcom Surpac 6.1 Table of Contents Introduction ......................................................................................................................................... 4 Requirements .......................................................................................................................................................... 4 Workflow ................................................................................................................................................................. 4 Setting the Work Directory ...................................................................................................................................... 4 Creating a Streaming File...................................................................................................................... 6 Overview .................................................................................................................................................................. 6 Requirements .......................................................................................................................................................... 6 Display the Dataset in Graphics ............................................................................................................................... 6 Export Streaming File............................................................................................................................................... 6 Viewing a Streaming File in HTML ........................................................................................................ 8 Overview .................................................................................................................................................................. 8 Requirements .......................................................................................................................................................... 8 Viewing the HTML file.............................................................................................................................................. 8 Installing the Driver ................................................................................................................................................. 8 Viewing Data............................................................................................................................................................ 9 Embedding and Viewing a Streaming File in Word .............................................................................. 10 Overview ................................................................................................................................................................ 10 Requirements ...................................................................................................................................................... 10 Embedding a Streaming File in Word .................................................................................................................... 10 Viewing a Streaming File in Word.......................................................................................................................... 13 Embedding and Viewing a Streaming File in Powerpoint .................................................................... 15 Requirements ...................................................................................................................................................... 15 Embedding a Streaming File in Powerpoint .......................................................................................................... 15 Viewing a Streaming File in Powerpoint ................................................................................................................ 18
Page 3 of 19 Introduction Streaming files can be used to present three‐dimensional data in various Microsoft products, such as Word, PowerPoint, and Internet Explorer. Visualisations such as real‐time rotation and zooming are possible with the streaming file embedded into one of these products.
Requirements Prior to proceeding with this tutorial, you will need: • Surpac 6.1 or later installed, and • The dataset to be used for visualisation.
Workflow
Note: The Workflow shown here is not intended to be exhaustive in scope, but will show the workflow needed to achieve a result.
Setting the Work Directory
A work directory is the default directory for saving Surpac files. Files used in this tutorial are stored in the folder: <installation directory>\demo_data\tutorials\streaming_files where <installation directory> is the directory in which Surpac was installed. 1. In the Navigator, right‐click the streaming_files folder.
Page 4 of 19 Introduction Setting the Work Directory
2. On the popup menu, select Set as work directory.
The name of the work directory is displayed in the title bar at the top of the Surpac window.
Page 5 of 19 Creating a Streaming File Overview
Creating a Streaming File
Overview The following concepts are presented in this chapter: 1. Setting the work directory. 2. Displaying data in Surpac. 3. Exporting to a streaming file.
Requirements Prior to performing the exercises in this chapter, you will need: • Surpac 6.1 or later installed. • A dataset, such as Surpac DTMs, string files, etc.
Display the Dataset in Graphics
A streaming file is created from all data currently visible in graphics. In this example you will use a dataset installed with Surpac. You may use any data. 1. Open project.swa, by double‐clicking the icon next to the filename or drag and drop the file from the Navigator into graphics. Several DTMs and string files are displayed:
Export Streaming File
1. Choose File > Save to Stream Control.
Page 6 of 19 Creating a Streaming File Export Streaming File
2. Enter the information as shown, and then click Apply.
Note: Two files are created in the working directory design.hsf and design.html
Page 7 of 19 Viewing a Streaming File in HTML Overview
Viewing a Streaming File in HTML
Overview The following concepts will be presented in this chapter: 1. Opening a HTML file containing a streaming file. 2. Installing the driver. 3. Viewing the data in the streaming file.
Requirements Prior to performing the exercises in this chapter, you should have: • a *.hsf file created previously. • a *.html file which refers to the *.hsf file. • Internet Explorer v6.1 or later.
Viewing the HTML file
• From Windows Explorer, double click on the filename to open the file design.html.
Installing the Driver
If you have not previously viewed any hsf files on your computer, you will be prompted to install the driver from the form below. • Click Install.
Note: Depending on the speed of your modem, it may take a while to download and install the driver software. The file is approximately 2.2 Megabytes so on a 56Kbits/sec modem it will take approximately 2 200 000 bytes / 5600 bytes/second = 392 seconds = 6.5 minutes
Page 8 of 19 Viewing a Streaming File in HTML Viewing Data
Viewing Data When the driver installation is complete, the data will display in the Internet Explorer.
1. Click and drag in the viewport to spin the data in three dimensions. 2. Right‐click anywhere on the image, and a popup menu is displayed:
3. Select Zoom, and then click and drag in the viewport to zoom the data. Some options, such as the Shadow, are a toggle function. The Window Color option will allow you to set different background colours for the upper and lower halves of the viewport.
Page 9 of 19 Embedding and Viewing a Streaming File in Word Overview
Embedding and Viewing a Streaming File in Word
Overview The following concepts will be presented in this chapter: • Embedding a streaming file in Microsoft Word, and • Viewing a streaming file in Microsoft Word Requirements Prior to performing the exercises in this chapter, you should have: • a *.hsf file created by Surpac, and • Installed the streaming file driver , and • Microsoft Word installed.
Embedding a Streaming File in Word
1. Open a new or existing Word document. 2. Position the cursor where you want the file embedded. 3. Click the Microsoft Office button, and then click Word Options. 4. Click Trust Centre, click Trust Centre Settings, and then click ActiveX Settings. 5. Complete the form as shown, and then click OK.
6. Click OK. After you have enabled the controls in Microsoft Office, follow these steps to insert the streaming file.
1. Click the Microsoft Office button, and then click Word Options. 2. In the Word Options, click Popular.
Page 10 of 19 Embedding and Viewing a Streaming File in Word Embedding a Streaming File in Word
3. Tick the Show Developer tab in the Ribbon check box, and then click OK.
Note: In Word, you will see an additional tab called Developer, next to the View tab. 4. Click on the Developer tab. 5. In the Controls tab, click the Legacy Tools icon, and then click on the More Controls icon
6. On the form displayed, select GEMCOM Software Stream Control, and then click OK.
Note: A draw box will be displayed in your Word document.
Page 11 of 19 Embedding and Viewing a Streaming File in Word Embedding a Streaming File in Word
7. Click on the draw box in Word, resize by clicking the box, right‐click and then choose Gemcom Software Stream Control Object > Properties.
8. Browse for your *.hsf file, tick the option Embed, and then click OK.
Note: Microsoft Visual Basic will start automatically.
9. Choose Run or press F5.
10. Close Microsoft Visual Basic
Page 12 of 19 Embedding and Viewing a Streaming File in Word Viewing a Streaming File in Word
An ActiveX object is displayed:
Viewing a Streaming File in Word
1. Right click anywhere on the image, and a popup menu will be displayed:
Page 13 of 19 Embedding and Viewing a Streaming File in Word Viewing a Streaming File in Word
2. Select Zoom and then click and drag in the viewport to zoom the data. 3. Select Orbit and then click and drag in the viewport to rotate the data.
Page 14 of 19 Embedding and Viewing a Streaming File in Powerpoint Embedding a Streaming File in Powerpoint
Embedding and Viewing a Streaming File in Powerpoint
The following concepts will be presented in this section: • Embedding a streaming file in Microsoft Powerpoint, and • Viewing a streaming file in Microsoft Powerpoint Requirements Prior to performing the exercises in this chapter, you should have: • a *.hsf file created by Surpac, and • Installed the streaming file driver , and • Microsoft Powerpoint installed.
Embedding a Streaming File in Powerpoint
1. Open an existing, or create a new Powerpoint document. 2. Click the Microsoft Office button, and then click Powerpoint Options. 3. Click Trust Centre, click Trust Centre Settings, and then click ActiveX Settings. 4. Complete the form as shown, and then click OK.
5. Click OK to close the window.
After you have enabled the controls in Microsoft Office, follow these steps to insert the streaming file.
1. Click the Microsoft Office button, and then click Powerpoint Options. 2. In the Powerpoint Options, click Popular.
Page 15 of 19 Embedding and Viewing a Streaming File in Powerpoint Embedding a Streaming File in Powerpoint
3. Tick the Show Developer tab in the Ribbon check box, and then click OK.
Note: In Powerpoint, you will see an additional tab called Developer, next to the View tab. 4. Click on the Developer tab. 5. In the Controls tab, click the More Controls icon. 6. On the form displayed, select Gemcom Software Stream Control, and then click OK.
7. Left‐click the mouse and drag the pointer to draw a shape in your presentation. 8. Click on the draw box in Powerpoint, resize by clicking the box.
Page 16 of 19 Embedding and Viewing a Streaming File in Powerpoint Embedding a Streaming File in Powerpoint
9. Right‐click and then choose Gemcom Software Stream Control Object > Properties.
10. Browse for your *.hsf file, tick the option Embed,, click Apply, and then click OK.
Page 17 of 19 Embedding and Viewing a Streaming File in Powerpoint Viewing a Streaming File in Powerpoint
The ActiveX object is displayed in your presentation:
Viewing a Streaming File in Powerpoint
1. Press F5. 2. Right click anywhere on the image, and a popup menu will be displayed:
Page 18 of 19 Embedding and Viewing a Streaming File in Powerpoint Viewing a Streaming File in Powerpoint
3. Select Zoom and then click and drag in the viewport to zoom the data. 4. Select Orbit and then click and drag in the viewport to rotate the data.
