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. If a polygon/polyline has no tag then it will inherit its tag from the parent folder.

This screenshot gives an example of how to use tags. Notice how the coastline polygon was tagged individually but the beach polygons were all tagged collectively by placing them in a sub folder and just tagging the subfolder.

add screenshot here

Scenery Design Tips

Creating a coastline with beaches

• Draw a polygon representing the coastline. "Tag" it with a coastline tag
• Draw a polygon representing the beach. "Tag" it with a beach tag

This screenshot (from the Tutorial.KML) shows how the coastline and beach was created:-

add screenshot here

Creating a road with moving traffic

• 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
• "Tag" the polyline with a traffic tag

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

add screenshot here

Creating a river with islands

• Create a folder in your KML to hold the river and its islands
• Draw a polygon representing the river. "Tag" it with a river tag
• Draw polygons for each island in the river. "Tag" each island with the special "ISLAND" tag.

This screenshot (from the Tutorial.KML) shows how the islands were 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