Streaming Files in Surpac 6.

0
August 2007

www.gemcomsoftware.com

Copyright 2007 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 Kiran Kumar Product Gemcom Surpac 6.0

Table of Contents
Introduction................................................................................................................................. 4
Requirements ........................................................................................................................................... 4 Objectives ................................................................................................................................................. 4 Workflow ................................................................................................................................................... 4

Creating a Streaming File .......................................................................................................... 5

Setting the Work Directory........................................................................................................................ 6 Display the Dataset in Graphics ............................................................................................................... 7 Export Streaming File ............................................................................................................................... 8

Viewing a Streaming File in HTML ............................................................................................ 9

Viewing the HTML file............................................................................................................................... 9 Installing the Driver ................................................................................................................................... 9 Viewing Data........................................................................................................................................... 10

Embedding and Viewing a Streaming File in Word ............................................................... 11

Embedding a Streaming File in Word ..................................................................................................... 11 Viewing a Streaming File in Word .......................................................................................................... 13

Embedding and Viewing a Streaming File in PowerPoint .................................................... 14

Embedding a Streaming File in PowerPoint ........................................................................................... 14 Viewing a Streaming File in PowerPoint ................................................................................................ 16

Page 3 of 16

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.0 or later installed. The dataset to be used for visualisation.

Objectives
The objective of this tutorial is to allow you to create streaming files and embed them into various other file formats.

Workflow
The process described in this tutorial is outlined below:

Page 4 of 16

Creating a Streaming File

Workflow

Creating a Streaming File

Overview

The following concepts are presented in this chapter:

1. 2. 3.

Setting the work directory. Displaying data in Surpac. Exporting to a streaming file.

Requirements

Prior to performing the exercises in this chapter, you will need:

Surpac 6.0 or later installed. A dataset, such as Surpac DTMs, string files, etc.

Page 5 of 16

Creating a Streaming File

Setting the Work Directory

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\surpac_demo

where <installation directory> is the directory in which Surpac was installed.

1. 2.

In the Surpac Navigator, right-click the surpac_demo folder. 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 6 of 16

Creating a Streaming File

Display the Dataset in Graphics

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. You can double click the icon next to the filename or drag and drop the file from the Navigator into graphics.

You should see several DTMs and string files as shown.

Project.swa

Page 7 of 16

Creating a Streaming File

Export Streaming File

Export Streaming File

1. 2. Choose File > Save to Stream Control. Enter the information as shown, and then click Apply.

Two files are created in the working directory: design.hsf and design.html

Page 8 of 16

Viewing a Streaming File in HTML

Viewing the HTML file

Viewing a Streaming File in HTML

Overview The following concepts will be presented in this chapter:

1. 2. 3.

Opening an HTML file containing a streaming file. Installing the driver. 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.0 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:

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 9 of 16

Viewing a Streaming File in HTML

Viewing Data

Viewing Data
Once the driver installation is completed, the data will display in the Internet Explorer.

1. 2.

Click and drag in the viewport to spin the data in three dimensions. 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 10 of 16

Embedding and Viewing a Streaming File in Word

Embedding a Streaming File in Word

Embedding and Viewing a Streaming File in Word

Overview

The following concepts will be presented in this chapter:

1. Embedding a streaming file in Microsoft Word 2. 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 Installed the streaming file driver Microsoft Word installed

Embedding a Streaming File in Word

1. 2. 3. 4. Open a new or existing Word document. Position the cursor where you want the file embedded. Choose Insert > Object. From the Create New tab, select Surpac Minex Stream Control Class, and then click OK.

Page 11 of 16

Embedding and Viewing a Streaming File in Word

Embedding a Streaming File in Word

A window will appear within the Word document.

5. 6.

Right-click inside the window and select Properties. On the Properties table, enter the following: Embed: enter the value 1 File name: the full path of the file needs to be inserted, for example: c:\surpacminex\surpac_60\demo_data\surpac_demo\design.hsf

7.

On the Control Toolbox, select the Exit Design Mode icon:

You will see the image embedded in Word:

Page 12 of 16

Embedding and Viewing a Streaming File in Word

Viewing a Streaming File in Word

Viewing a Streaming File in Word

1. Right click anywhere on the image, and a popup menu will be displayed:

2. 3.

Select Zoom and then click and drag in the viewport to zoom the data. Select Orbit and then click and drag in the viewport to rotate the data.

Page 13 of 16

Embedding and Viewing a Streaming File in PowerPoint

Embedding a Streaming File in PowerPoint

Embedding and Viewing a Streaming File in PowerPoint

Overview

The following concepts will be presented in this chapter:

1. Embedding a streaming file in PowerPoint 2. Viewing a streaming file in PowerPoint

Requirements

Prior to performing the exercises in this chapter, you should have:

a *.hsf file created by Surpac. installed the streaming file driver. Microsoft PowerPoint installed.

Embedding a Streaming File in PowerPoint

1. 2. 3. 4. Open a new or existing PowerPoint document. Position the cursor where you want the file embedded. Choose Insert > Object. Choose Create New, select Surpac Minex Stream Control Class, and then click OK.

A window will appear within the PowerPoint document.

Page 14 of 16

Embedding and Viewing a Streaming File in PowerPoint

Embedding a Streaming File in PowerPoint

5. 6.

Right click inside the window and select Properties. On the Properties table, enter the following: Embed: enter the value 1 File name: the full path of the file needs to be inserted, for example: c:\surpacminex\surpac_60\demo_data\surpac_demo\design.hsf

7.

Close the Properties table by clicking the red X in the upper right corner.

Page 15 of 16

Embedding and Viewing a Streaming File in PowerPoint

Viewing a Streaming File in PowerPoint

Viewing a Streaming File in PowerPoint

1. Choose View > Slideshow, and you should see the image displayed:

2.

Right click anywhere on the image, and a popup menu will be displayed:

3. 4.

Select Zoom, and then click and drag in the viewport to zoom the data. Select Orbit and then click and drag in the viewport to rotate the data.

Page 16 of 16