From FSDeveloper Wiki
Jump to: navigation, search

Scenery Processor, or scenProc for short, is a tool to process GIS data and create scenery output from it. It can for example import vector data and create autogen AGN files from this data. The tool is driven by the configuration file, which can be edited in the GUI of the tool.

Getting scenProc



At this moment scenProc is still under development, but a beta version is already available. Please be aware that this version might have bug left. You can download the latest development release here.

The development release also contains other tools that I made, like ModelConverterX. Just unzip all of these tools to a folder of your choice. That's all the installation.

To be able to read shapefiles, you need to have the Microsoft Access Database Engine 2010 installed. Be aware to install the right version, if you are running a 64 bit OS, you need to have the 64 bit driver installed. If you get an error while installing that a 32 bit Microsoft Office is installed, you can run the installer in passive mode to still install the driver:

 AccessDatabaseEngine_X64.exe /passive

User interface

The graphical user interface of scenProc is shown below. It consists of three main components:

  • Toolbar with buttons for common actions. This offers the way to create, save and load configuration files, to start processing the configuration and to set the options.
  • Text editor where the configuration can be defined. The text editor has features like auto completion and tooltips showing help. When you put your mouse over a processing step, the tooltip will show the help text for that step. If you put it over a GUID the friendly name of the GUID will be shown as tooltip.
  • Event log that shows messages and progress.

Scenproc ui.jpg


While typing your configuration in the text editor the configuration file is automatically validated. This means that there is a mistake in the file this will be reported in the event log at the bottom of the screen. It is for example validated if the correct amount of arguments are specified for a step, if the file specified exists or if the specified GUID is valid. As long as there are errors while validating the configuration file, you can not run the configuration.


Below the options of scenProc are shown. In the options you need to specify the paths to FSX and to the FSX SDK. Without these paths the auto completion functionality is not working. Besides that some parameters of algorithms can be set in the options as well.

40px-Emblem-important.png Make sure you specify the FSX SDK root folder, not the Autogen SDK folder!

Scenproc options.jpg

Batch mode

It is also possible to run the tool like a command line tool. In that case it should be started from the command line providing the name of the configuration file and the additional argument /run. In this case the configuration file will be ran directly after opening and the tool will automatically close once finished.

Configuration file

In the configuration file (plain text file, usually with the extension .spc) you specify what data you want to process and how you want to process it. In the next section the available commands are described.

All lines starting with a hash (#) are comments and are ignored. Each lines starts with the name of the action you want to perform, followed by arguments of needed. The arguments are separated with a pipe (|) symbol.


Some processing commands take a filter as input. With this filter you can select the features that match certain attributes. Please be aware that attribute names are values are case sensitive, so be aware that you type them in the correct case. You specify the filter with the syntax:


There are four operators that can be used:

  • Equal (=)
  • Not equal (!)
  • Greater (>)
  • Smaller (<)

If you want to specify multiple conditions you separate them with semicolons (;). All features that match all of those conditions are then selected.


Besides the attributes that are present in the source data you imported, there are some special attributes that scenProc adds while importing the data. The table below indicates which attribute is added to which type of feature.

Attribute Description Polygon Line Point
FTYPE type of feature (POINT/LINE/POLYGON) X X X
FROMFILE name of the source file that the feature comes from (without path) X X X
FWIDTH width of the bounding box around the object (in meters) X
FLENGTH length of the bounding box around the object (in meters) X
FAREA area of the bounding box around hte objects (in square meters) X
FMINSIDE the length of the shortest edge of the feature X X
FNUMVERT the number of vertices in the feature X X
FNUMPERPANG the number of 90 degree angles in the feature X
FNUMNOTPAR The number of edges that do not have another edge that is parallel X
FCONVEX 1 if polygon is convex, 0 if polygon is concave X

Use can use an asterisk (*) to select all features.

Available processing steps

Below the available processing steps in scenProc are listed. For more detailed help enter the step in your configuration file and hover over the command to see the tooltip showing the help.

Imports features from an ESRI Shapefile.
Imports features from an OpenStreetMap OSM file.
Imports features from a KML file.
Imports features from a DXF file.
Splits the features into cells with a given size.
Scale features based on two reference points.
Sets the building height properties for the AGN cell.
Sets the texture to be used for autogen buildings in this cell.
Sets the texture to be used for autogen row houses in this cell.
Sets the FS2004 style vegetation settings for the cell.
Create autogen polygonal vegetation from the selected features.
Create autogen polygonal buildings from the selected features.
Create autogen rectangular vegetation from the selected features.
Create generic autogen buildings from the selected features.
Create autogen row houses from the selected features.
Create autogen library objects from the selected features.
Write the created autogen objects to AGN files. This should always be the last command when making autogen.
Add a new attribute with the given value to the selected features.
Remove the given attribute from the selected features
Replaces polygons by building rectangles fitting the original polygon.
Replaces polygons by rectangles covering the same area.
Exports the fetures to an ESRI Shapefile.


FSX autogen from OpenStreetMap shapefiles

This examples shows how FSX autogen can be created from OpenStreetMap shapefiles downloaded from GeoFabrik.

 # Schiermonnikoog autogen test

FS2004 autogen from shapefiles

This example shows how to create FS2004 autogen from a set of shapefiles that each contain a specific feature type.



If you have any problems while using the program or if you have suggestions and other feedback to improve the tool, please let me know. You can either contact me directly or visit the scenProc subforum at

User license

(c) 2011 / Arno Gerretsen

This software program is distributed without charge to other addon developers. Redistribution of the original ZIP file is allowed. You are NOT allowed to sell this software program or ask money for its distribution. Special effects created with this software program can be used in commercial scenery projects if you wish.

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.