AGN (FSX)

From FSDeveloper Wiki

This document describes the FSX format for autogen (AGN) files.

Contents 1 Sections 1.1 VERS 1.2 GBDD 1.3 GBTE 1.4 RHTE 1.5 GBLD 1.5.1 GBLR 1.6 PREG 1.6.1 PRDE 1.7 VGRG 1.7.1 VGRE 1.8 VGRD 1.9 VGRO 1.10 ROWH 1.11 AGN2 1.11.1 A2GE 1.12 PBLD 1.12.1 PBDE

[edit] Sections

The AGN file uses the RIFF format (like MDL files), this means that the file consists of different sections. Each section starts with a four character label, followed by the length of the section in bytes (this length without the header itself).

The main RIFF section itself has one additional parameter, this is a four character string that indicates the type of RIFF AGN file. For an FSX AGN file the value should always be AGNX.

The following subsection show more details about the content of these different sections.

[edit] VERS

Contains versions information about the AGN file.

 int32 version (normally 1091777331)

[edit] GBDD

Contains information about autogen generic buildings

 int32 percentage of 1 and 2 floor buildings (normally 10)
 int32 percentage of 3 to 5 floor buildings (normally 10)
 int32 percentage of 6 to 8 floor buildings (normally 10)
 int32 percentage of 9 to 12 floor buildings (normally 10)

Valid values for percentage are from 0x00 (0%) to 0x14 (100%).

[edit] GBTE

This section contains the name of the texture to use for the generic buidlings. The texture name is stored without extension and the length seems to be a multiple of 4.

[edit] RHTE

This section contains the name of the texture to use for the row houses. The texture name is stored without extension and the length seems to be a multiple of 4.

[edit] GBLD

Contains building information. This section contains one or more GBLR sections.

[edit] GBLR

Contains information about Generic Buildings.

 GUID roof type (will use default roofs, if 0)

For each Generic Building:

 float X position of first point 
 float Y position of first point
 float X direction to the second point
 float Y direction to the second point
 float X offset of third point
 float Y offset of third point 

The x and y coordinates are given as offset from the middle of the LOD13 square (range -0.5 till 0.5).

[edit] PREG

Contains vegatation information. This section contains one or more PRDE sections.

[edit] PRDE

For vegatation polygon. Contains:

 GUID vegatation type

For each polygon:

 int number of vertices

For each vertex:

 single x
 single y

The x and y coordinates are given as offset from the top left of the LOD13 square (range 0 till 1). The first and last vertex of the polygon have to be the same (so the polygon has to be closed).

[edit] VGRG

Contains information about FSX style rectangular vegetation regions. This section contains one or more VGRE sections. The type of vegetation is defined by a GUID.

[edit] VGRE

 GUID vegetation type

For each rectangle:

 float X position of first point
 float Y position of first point
 float X offset to second point
 float Y offset to second point 

The x and y coordinates are given as offset from the middle of the LOD13 square (range -0.5 till 0.5).

[edit] VGRD

Contains information about the FS2004 vegetation definition.

 int vegetation class 1
 int vegetation class 2
 int percentage vegetation class 1 (0-100)
 int maximum density
 float minimum height class 1
 float maximum height class 1
 float minimum height class 2
 float maximum height class 2

[edit] VGRO

Contains information about FS2004 style rectangular vegetation regions. The type of vegetation is defined in the VGRD section.

For each rectangle:

 float X position of first point
 float Y position of first point
 float X offset to second point
 float Y offset to second point 

The x and y coordinates are given as offset from the middle of the LOD13 square (range -0.5 till 0.5).

[edit] ROWH

Contains information about row houses. The amount of houses is the length of the section divided by 24.

For each row house:

 float X position of first point
 float Y position of first point
 float X direction to second point
 float Y direction to second point
 float X offset to third point
 float Y offset to third point 

The x and y coordinates are given as offset from the middle of the LOD13 square (range -0.5 till 0.5).

[edit] AGN2

Contains information about library objects. Contains one or more A2GE sections.

[edit] A2GE

Contains information about library objects.

 GUID library object guid

For each library object:

 float X position of first point
 float Y position of first point
 float X direction to second point
 float Y direction to second point
 float X offset to third point
 float Y offset to third point 

The x and y coordinates are given as offset from the middle of the LOD13 square (range -0.5 till 0.5). The coordinates describe the bounding box, the actual library object is placed in the center of it.

[edit] PBLD

Contains information about polygon buildings. Contains one or more PBDE sections.

[edit] PBDE

 GUID building type

For each building:

 int32 1 (seems always to be 1)
 float extrusion width
 int32 number of footprint vertices

For each vertex:

 single x
 single y

The x and y coordinates are given as offset from the top left of the LOD13 square (range 0 till 1).