GoogleEarth

This Viewer is requested to use Google-Earth (GE) application to be used as a 3D viewer.

Setting up

In order to use GE as a 3D viewer for vsTASKER simulation engine, an old version of GE (v7 and before) must be used because the COM+ capability has been deprecated by Google.

Also, an Apache server must run in order to command GE.

Installing Apache

Go into /runtime/geath/3rd party directory.

Run appserv-win32-2.6.0.exe file and install only Apache.

Give whatever server name and email you want.

Finish installation but do not run yet Apache server.

Once installed, go to C:/AppServ/Apache2.2/conf and edit file httpd.conf

Search for DocumentRoot.

Replace with the following:

DocumentRoot "D:/VirtualSim/LocalHost"

Create the directory D:/VirtualSim/LocalHost

Use this directory in the below window setting, for the field http://localhost

Start Apache in C:/AppServer/Apache2.2/bin/httpd.exe

Installing GoogleEarth

Go into /runtime/geath/3rd party directory.

Run GoogleEarthWin_7.exe file and install.

Close GE.

Now, you can try to run the samples provided in /Data/Db/GEarth directory.

Main File

Wrapper main file used to communicate with GE application (using COM API) as an output of the simulation engine.

/runtime/gearth/vt_gearth.cpp is the default wrapper file.

Top

LocalHost

Directory where the sim engine will drop files GE must read as a stream of command.

Correspond to the DocumentRoot value of the Apache server (configuration file, see above).

Suggested value: D:/VirtualSim/LocalHost

Top

Update Rate

Frequency at which the data file sent to GE will be produced. 1hz seems the minimum for GE.

Top

Enabled

One viewer must be at least enabled for the simulation to compile. Enabling one viewer disable all the other one.

When unchecked, all specific viewer code (and third party software API) are not generated and do not impact the makefile.

Top

Generate KML

Force some files to be generated in localhost for testing purposes. These files are normally sent to GE in a streaming link.

Top

Styles

Lists the graphical objects that will be displayed on GE as Icons for Entities and Points (feature).

Top

Source

Source code can be modified into this window or directly from Visual Studio from the solution (or any other text editor).

If code is modified, it will be automatically saved when OK button is depressed.

It is a good idea to save the modified code under another file to keep the original one unchanged. Use

button for that.

Refer to "Understanding Runtime" in the Tutorial document of vsTASKER.

Do not forget that all provided source code in vsTASKER environment is subject to change from one revision to one another. So, it is a good practice to change the name of any cpp wrapper if any change must be applied on it.

Top