FSX KML

1st Oct 2006 - Please note: The software described in this manual has not yet been released. I will continue to update this manual over the next couple of weeks to coincide with the release of the FSX KML alpha.

Introduction

FSX KML is a freeware scenery design tool for Microsoft Flight Simulator X (FSX). It converts KML (Keyhole Markup Language) files generated by Google Earth (GE) into FSX scenery.

Using GE to draw polygons and polylines you can accurately and easily create the following types of scenery:-

• Coastlines, rivers and lakes, and islands inside these water features.
• Shorelines
• Irregular shaped landclass polygons for cities, parks, beaches, forrest, golf courses etc
• Landclass “tiles” (1.2km sq)
• Flatten polygons and airport polygons
• Roads (including roads with moving traffic) and power lines
• Place scenery objects from the FSX scenery library

Downloading FSX KML

The latest version of FSX KML can be downloaded from the following sites:-

to be completed

Installation

Unzipping and running FSX KML

FSX KML can be installed in a folder of your choice. Simply unzip the FSX KML installation zip file into the desired folder.

After unzipping the installation file you should have the following files:-

• FSX_KML.exe
• ShapeLib129.dll
• FSX_KML_Lookup.XML
• FSX_KML_Options.XML
• Tutorial.KML

Configuration options

Before you begin building FSX scenery you will need to set a few configuration options.

• Run FSX_KML.exe and click on the options tab
• Specify the location FSX using the "FSX folder option". This will usually be C:\Program Files\Microsoft Games\Flight Simulator X
• Select the "Copy to FSX Addon Scenery Folder" if you want your scenery to be automatically copied to the FSX add on scenery folder after it is built.

The Tutorial

FSX KML includes a simple tutorial. This tutorial demonstrates the creation of a coastline (with beaches), a river and islands, a town and forest, plus a road with moving traffic.

• Open Tutorial.KML in Google Earth. An easy way to do this is to double click on Tutorial.KML in windows explorer.
• Investigate the various polygons and polylines that have been "traced" over the real scenery features displayed in Google Earth. The important thing to notice is the use of the "Description" field for each polygon or polyline. The description field is used to tell FSX KML what type of scenery feature the polygon/poyline represents.
• If you open the FSX_KML_Lookup.XML file you will see how these description "tags" are translated into FSX scenery features.
• To make scenery from the Tutorial.KML file, run FSX KML, click the Project tab and open Tutorial.KML. You will see KML structure displayed in FSX KML.
• Click the Build tab and then the Build button and FSX KML will create a FSX scenery file called Tutorial.BGL. The file will be copied automatically to the FSX addon scenery directory.
• Run FSX. You can easily goto the scenery area by opening the saved flight called FSX_KML.

Building Scenery

Building your own scenery with FSX KML is easy.

Step 1 - Creating a KML file with Google Earth

The first step in creating your FSX scenery is to create a KML file by using Google Earth to "trace" scenery features.

Creating polygons and polylines

Although you can use the free version of Google Earth (GE), by far the easiest way to create polygons and polylines is by using the $20 plus version of GE.

Using GE Plus create a polygon using the "Add Poly" function or create a polyline using the "Add Path" function, and then trace the scenery feature (for example a lake or road).

"Tagging" the scenery features

To describe what scenery feature your polygon or polyline represents it needs to be "tagged". FSX_KML_Lookup.XML contains a list the tags you can use.

There are two ways to tag a polygon or polyline:-

• Place the name of the tag in the description field of the polygon or polyline
• Place the name of the tag in the description field of the parent folder that contains the polygon or polyline. All polygons and polylines in that folder will "inherit" the tag of the parent folder.

Sometimes you will need to specify multiple tags for a polygon/polyline. For example, when creating a road with moving traffic you need to specify a road tag and a traffic tag. The road tag tells FSX what type of texture to use and the traffic tag tells FSX what type of moving traffic to use.

Scenery Design Tips

Creating a road with moving traffic

To create a road with moving traffic do the following.

• Draw a polyline to represent the road. If your road is going to have "one way" traffic, then the traffic will travel from the start of the line (1st point you draw) to the end of the line (last point you draw)
• "Tag" the polyline with a road tag and a traffic tag (see FSK_KML_Lookup.XML) for a list of appropriate tags

The screenshot below (from Tutorial.KML) shows how the road was created.

add picture here

Creating a river with islands

When creating rivers (or other water features) with islands we need to associate the island polygons with the river.

The best way to do this is create a folder in your KML which will hold the river and the associated islands. Each island polygon needs to be "tagged" with "ISLAND". Thats it!

This screenshot (from the Tutorial.KML) shows how islands are created in the river:-

add screenshot here

FSX_KML_Lookup.XML

This file holds the "tags" that are used in the KML file to describe FSX scenery features. You can customise this file to add more tags or change existing ones.

This XML contains the following attributes for each "tag":-

• Feature Type - The type of FSX scenery feature that should be created for the tag. FSX KML currently supports the following scenery features

to be completed

• GUID - The FSX GUID for the scenery feature. Refer to the FSX terrain.cfg file and terrain SDK documentation for futher information

Google Earth

The free version Google Earth (GE) may be downloaded from the Google Earth home page

I strongly recommend you purchase the $20 “Plus” version of GE because it makes creating polygons and polylines very very easy.

End User Licence

Copyright © 2006 Innova Software ALL RIGHTS RESERVED

This software program is distributed without charge to other scenery designers, redistribution of the original ZIP file is allowed. You are NOT allowed to sell this software or ask money for its distribution. The use of the software is only allowed for the production of freeware sceneries, if you want to use it for commercial scenery please contact me.

The copyright and any intellectual property relating to this program remain the property of the author.

The software distributed in this way may represent work in progress, and bears no warranty, either expressed or implied.

Release History

This software has not yet been released.

Feedback

Discuss FSX KML at the fsdeveloper.com FSX KML forum post

You can email the author directly at fsx_kml@innovasoftware.com