SCENERY EDITOR OBJECT XML PROPERTIES

The <scene_filename>.xml file should be formatted as follows:

<?xml version="1.0" encoding="UTF-8"?>
<FSData version="9.0">
    <SceneryObject [attributes]>
        <!-- OBJECT PROPERTIES HERE -->
    </SceneryObject>
    <!-- FURTHER SCENERY OBJECTS HERE -->
</FSData>

 

Within the <FSData> element you would list all the different scenery objects you want to include in the package between opening and closing <SceneryObject> elements.

 

IMPORTANT! The file details given here are meant purely for reference purposes and we do not recommend that you manually create these files but instead always use The Scenery Editor.

 

 

<ProjectedMesh>

This element is used to add a ProjectedMesh Object to a scene, although it can also be used to add a projected mesh object to an airport by adding it as a sub-element of <Airport>. Each projected mesh element requires a <SceneryObject> sub-element to define the object that belongs to it. The element has the following attributes:

 

Attribute Description Type Required
priority This option sets the render priority for the projected mesh object. The default render priority is 0, which for most cases is fine. However, if you have overlapping meshes and want one to render over another one, then you will need to change this value to make it a higher or lower priority. Higher priority values will render over lower priorities, for example, a mesh with priority 1 will render over one with priority 0, which in turn will render over one with priority -1. Note that the engine cannot guarantee the render order for meshes with the same priority, so if you need something to always render over or under something else, you need to set this value. Integer No
drawOrder

This option permits you to place meshes into the render hierarchy so that they are drawn under or over different elements. To use this attribute, you must supply one of the given strings, and the projectd mesh will be rendered after the given element has been rendered but before the next element (the element strings are listed in render order). For example, if you select "MARKING", then the projected mesh will be rendered over Aprons, Taxiways and Runways, but under Markings, Runway Markings and Marking Text.

String (listed in order of rendering):

  1. "APRON"
  2. "TAXIWAY"
  3. "RUNWAY"
  4. "MARKING"
  5. "RUNWAY_MARKING"
  6. "MARKING_TEXT"
 No
surface This option permits you to select from a list of default surface types that can be applied to the projected mesh. These surfaces will be merged with the mesh texture to add further visual variety and better integrate the mesh with the terrain and surrounding elements.

String:

  1. "CONCRETE"
  2. "GRASS"
  3. "WATER"
  4. "GRASS_BUMPY"
  5. "ASPHALT"
  6. "SHORT_GRASS"
  7. "LONG_GRASS"
  8. "HARD_TURF"
  9. "SNOW"
  10. "ICE"
  11. "URBAN"
  12. "FOREST"
  13. "DIRT"
  14. "CORAL"
  15. "GRAVEL"
  16. "OIL_TREATED"
  17. "STEEL_MATS"
  18. "BITUMINUS"
  19. "BRICK"
  20. "MACADAM"
  21. "PLANKS"
  22. "SAND"
  23. "SHALE"
  24. "TARMAC"
  25. "WRIGHT_FLYER_TRACK"
 No
groundMerging Set this attribute to "TRUE" to have the projected mesh object be merged with the underlying ground, or set it to "FALSE" otherwise. You can see a visual example of this effect here: Ground Merging Boolean No

 

 

<SceneryObject>

This element is used in multiple different places to add a scenery object to the sim. This element can contain the following sub-elements:

  1. <BiasXYZ />
  2. <NoShadow />
  3. <HideOnTIN />
  4. <NoSnow />
  5. <Beacon />
  6. <Effect />
  7. <LibraryObject />
  8. <VisualEffectObject />
  9. <Trigger>
  10. <Windsock>
  11. <WorldScript />
  12. <Decal />
  13. <SimObject />
  14. <SimPropContainer />
  15. <Car Parking>
  16. <AttachedObject>

NOTE: The <AttachedObject> element should always be defined last.

 

This element is used in the following places:

  1. <Tower>
  2. <Jetway>
  3. <ProjectedMesh>
  4. Scenery Objects.

 

 

This element can have the following attributes:

 

Attribute Description Type Required
instanceId GUID used to identify this instance of the element. You can find more information on GUID's here: GUIDs String Yes
lat Latitude of the center point of the object, in degrees between -90.0° and 90.0°. Float Yes
lon Longitude of the center point of the object, in degrees between -180.0° and 180.0°. Float Yes
alt Altitude of the center point of the object, in meters. You may add the "F" suffix to convert the value to feet, for example: "13.0F". Float Yes
snapToGround Whether to snap the object to the ground (TRUE) or not (FALSE). Bool No
snapToNormal Whether to snap the object to the terrain normal (TRUE) or not (FALSE). Bool No
altitudeIsAgl Indicate whether altitude is AGL (TRUE) or MSL (FALSE) Bool Yes
pitch The pitch of the object, from 0.0° to 360.0°. Float Yes
bank The bank of the object, from 0.0° to 360.0°. Float Yes
heading The facing heading of the object, from 0.0° to 360.0°. Float Yes
imageComplexity

Minimum image complexity setting in the sim for the objects to appear.

IMPORTANT! This element is DEPRECATED in Microsoft Flight Simulator 2024. It should not be set to anything other than "VERY_SPARSE" and is only listed here for legacy context.

Enum:

  1. VERY_SPARSE
  2. SPARSE
  3. NORMAL
  4. DENSE
  5. VERY_DENSE
  6. EXTREMELY_DENSE
 Yes

 

 

<NoShadow />

This element is used to indicate that the scenery object should not cast any shadows. The element is a self-closing element and requires no attributes. You can find an example of this element being used here.

 

 

<HideOnTIN />

This element is used hide the associated scenery object element unless the TIN data is unavailable, for example when the user is offline, at which point it will be visible. The element is a self-closing element and requires no attributes. You can find an example of this element being used here.

 

 

<NoSnow />

This element is used to indicate that the scenery object should not be affected by snow, ie: when snow is present, it will not be rendered on the object. The element is a self-closing element and requires no attributes. You can find an example of this element being used here.

 

 

<Beacon />

This element is used to add a beacon to the scene. Beacons can be added as stand-alone objects, but are usually added as objects attached to control towers. Note that this is a self-closing element and has the following attributes:

 

Attribute Description Type Required
type The type of beacon being used.

Enum:

  1. CANADIAN
  2. MILITARY
  3. CIVILIAN
 Yes
baseType Latitude of the center point of the object, in degrees between -90.0° and 90.0°.

Enum:

  1. AIRPORT
  2. HELIPORT
  3. SEA_BASE
 Yes

 

This element can also be used in non-airport Scenery Objects.

 

 

<Effect />

This element is used to add a scenery effect to the scene. Note that this is a self-closing element and has the following attributes:

 

Attribute Description Type Required
effectName The name of the effect (up to 80 characters).

String

 Yes
effectParams Parameters for the effect. String No

 

 

<LibraryObject />

This element is used to add a library object to the scene. Note that this is a self-closing element and has the following attributes:

 

Attribute Description Type Required
name The GUID of the object to be modeled. You can find more information on GUID's here: GUIDs

String

 Yes
scale The scale to be applied to the object (1.0 is no scaling, 0.5 would be half and 2.0 would be double). Float Yes

 

Library objects are those that are included with the base installation of Microsoft Flight Simulator 2024 and are generally those that are shown when opening the Objects window in The Scenery Editor. To get the GUID for these library objects, add the object to a scene, then check the Properties window, where the GUID will be listed.

 

 

<VisualEffectObject />

This element is used to add a visual effect to the scene. Note that this is a self-closing element and has the following attributes:

 

Attribute Description Type Required
name

The GUID for the VFX to be used. This attribute should only be used if you are not supplying the effectname attribute. This should be enclosed in {}, for example:

name="{A04B772A-6BBF-4103-B263-D479BCCE71F5}"

You can find more information on GUID's here: GUIDs

 String Yes
effectname

The name or package/name of the VFX to use. The name is the name of the effect file without the file extension, or you can supply the package name and the effect file name in case the file name alone conflicts with another file. For example:

effectName="Smoke_SOS"
effectName="Base/Smoke_SOS"

This attribute should only be used if you are not supplying the name attribute.

String

 Yes
scale The scale to be applied to the effect (1.0 is no scaling, 0.5 would be half and 2.0 would be double). Float Yes

 

VFX objects are those that are included with the base installation of Microsoft Flight Simulator 2024 or that are created as part of a VFX package. To get the GUID or the name for these VFX objects, you can check the Template/Instance Debugger window, as explained in the section on Using Effects In The World. You can find an example of using these objects in a scene here: Effects Objects.

 

 

<Trigger>

This element is used to add a trigger to the scene. Triggers are used to define regions in the world that will cause an event when the user's aircraft enters that region. Triggers can presently be used to specify refueling stations and weather areas (like thermals or ridge lifts). This element may contain <Fuel />, <Vertex /> and <TriggerWeatherData> elements, and these elements must be listed in that order.

IMPORTANT! This and the listed sub-element <TriggerWeatherData> are deprecated in Microsoft Flight Simulator 2024. They should not be used and are only listed here for legacy context.

This element can have the following attributes:

 

Attribute Description Type Required
type The type of trigger.

Enum:

  1. REFUEL_REPAIR
  2. WEATHER
 Yes
triggerHeight Height of trigger in meters (must be positive). Float Yes

 

 

<Windsock>

This element is used to add a windsock to the scene. This element may contain <PoleColor /> and <SockColor /> sub-elements, which must be defined in that order if they are entered (they are optional, the default colors are gray and orange respectively).

 

This element can have the following attributes:

Attribute Description Type Required
poleHeight Height of pole in meters.

Float

 No
sockLength Length of sock in meters. Float No
lighted Indicating whether the windsock is lit (TRUE) or not (FALSE). Bool No
containerTitle The container title of the SimObject to use (for the generic built-in windsock, use "Windsock" for the title). String Yes
containerPath The container file path. DEPRECATED (do not use) String No

 

Both <PoleColor /> and <SockColor /> have the following attributes:

 

Attribute Description Type Required
red Red component of the coloration (between 0 and 255). Integer Yes
green Green component of the coloration (between 0 and 255). Integer Yes
blue Blue component of the coloration (between 0 and 255). Integer Yes

 

<AttachedObject>

This element is used to attach another object to a scenery object. This element is allowed to contain the follow, which - if included as some are optional - must be added in the exact order given:

  1. <RandomAttach />
  2. <BiasXYZ />
  3. <Beacon />

 

Note that attached objects are subject to any rotations or displacements applied to the base object, or any animated parts. Nesting of attached objects is supported but is not encouraged (for example, a library object can be placed that has a control tower attached to it and the attached control tower has a beacon attached to it).

 

This element can have the following attributes:

Attribute Description Type Required
attachpointName Name of the attach point in the model for the object.

String

 Yes
instanceId GUID used to identify this instance of the element. You can find more information on GUID's here: GUIDs String Yes
pitch The pitch of the object, from 0.0° to 360.0°. Float Yes
bank The bank of the object, from 0.0° to 360.0°. Float Yes
heading The facing heading of the object, from 0.0° to 360.0°. Float Yes

 

<RandomAttach />

This element is used to apply some randomness to <AttachedObject> elements. Note that this is a self-closing element and has the following attributes:

 

Attribute Description Type Required
randomness When the attached object is to appear. LOCATION_RANDOM will generate a random number based on the location, and so will always be the same. PURE_RANDOM will generate a new random each time the section of scenery is created.

Enum:

  1. ALWAYS_DISPLAY
  2. LOCATION_RANDOM
  3. PURE_RANDOM
 Yes
probability The probability of the attached object appearing, calculated using a value from 0.0 (never) to 1.0 (always). Float Yes

 

<SimObject />

This element is used to add a simulated object to the scene as a sub-element of the <SceneryObject> element. Note that this is a self-closing element and has the following attributes:

 

Attribute Description Type Required
containerTitle The container title of the SimObject to use. String Yes
containerPath The container file path. String No
scale

The scale to be applied to the object (1.0 is no scaling, 0.5 would be half and 2.0 would be double).

IMPORTANT! When using this parameter to scale JetWay sim objects, the scaling is only done on the mesh and not on the bones so that, even if the object is visually bigger, in the simulation the contact points will be the same as before. Therefor, you generally want to avoid using the scale attribute for JetWays, and rather scale the object in your 3D software before exporting it.

 Float No

 

 

<SimPropContainer />

This element is used to add a SimPropContainer object to the scene as a sub-element of the <SceneryObject> element. Note that this is a self-closing element and has the following attributes:

 

Attribute Description Type Required
guid The GUID of the SimPropContainer to use. You can find more information on GUID's here: GUIDs String Yes
scale

The scale to be applied to the object (1.0 is no scaling, 0.5 would be half and 2.0 would be double).

 Float No

 

 

<Car Parking>

This element can be used to define a car park area within a scene, and is a sub-element of the <AttachedObject> element. It requires 3 or more <Vertex /> sub-elements to define the area, and has no attributes.

 

 

<LandmarkLocation />

This element is a sub-element of <SceneryObject>, has no children, and is self closing. It is used to designate a particular location as a "landmark", which will then be shown to the user both in the world map and in the world itself when flying around. This element has the following attributes:

 

Attribute Description Type Required
instanceId GUID used to identify this instance of the element. You can find more information on GUID's here: GUIDs String Yes
type

The type of landmark object marker to use. One of the following:

  1. "City": This marks a particular city. Landmark cities are only shown on the World Map.
  2. "Fauna": This marks an area of fauna. Landmark fauna areas are shown on the World Map and in the world during a flight.
  3. "Custom": This is for marking some natural phenomenon or area. Landmark natural areas are only shown on the World Map.
  4. "POI": This marks a "Point Of Interest". Landmark POI are shown on the World Map and in the world during a flight.
  5. "Star landmark": This marks a special landmark with a "Star" marker. Landmark star points are shown on the World Map and in the world during a flight.
 String
name The name of the landmark. This string can be localised. String
lat The latitude where the landmark appears. Float
lon The longitude where the landmark appears. Float
alt The altitude where the landmark appears. Float
offset This is an offset for the height of the landmark marker. Normally this is simply left at 0, but if you have multiple landmarks in a similar area, you can use this offset value to ensure that all the markers are seen without any overlap. Float

 

You can find an example of the generated XML for this object here: LandmarkLocation Objects

 

 

<Decal />

This element is a sub-element of <SceneryObject>, has no children, and is self closing. It is used to define a decal object that is being used as a decorative element within a scene. This element has the following attributes:

 

Attribute Description Type Required
materialGuid GUID used to identify the material that is used by this element. You can find more information on GUID's here: GUIDs String Yes
sizeX Sets the size of the decal bounding box along the X-axis. Float
sizeY Sets the size of the decal bounding box along the Y-axis. Float
sizeZ Sets the size of the decal bounding box along the Z-axis. Float
opacity Sets the opacity (alpha) of the decal. Note that normally you would have a value between 0 and 1 here, but you can use higher values. Values greater than 1 will raise the opacity threshold and gradually force the alpha of ALL pixels towards 1, so transparent and semi-transparent areas will become more opaque the higher the value. Float
fadeAngle This value can be used to set the fade out range of the decal based on the angle between the decal's backward direction and the vertex normal of the receiving surface. Float
fadeDepth This value is used to control how quickly the decal will fade it's opacity relative to the the center plane of the bounding box. A value of 1 will show the decal almost from the moment the bounding box intersects the opposing plane, while a value of 0 will fade the decal in/out as the bounding box moves through the opposing plane. Float
channelFlags

This value defines what the decal is being applied to.

Integer

  1. 4: Nothing (it will appear in the scene but not interact with anything)
  2. 5: Will be applied to Scenery
  3. 6: Will be applied to the Ground
  4. 7: Will be applied to both Scenery and Ground
priority With this value you can set the priority of the decal. This is important if you have multiple decal objects that are overlapping, as it permits you to set the render order based on the priority. Integer
overrideNormal When this is "true", the scenery/ground normal map will be overridden by the normal map for the decal object. Bool

 

You can find an example of the generated XML for this object here: Decal Objects

 

 

<LowResAltitude />

This self closing element is a sub-element of <SceneryObject> and has no attributes and no children. When it is included in the XML file, it will force the simulation to use a lower resolution altitude calculation when calculating the placement of the associated scenery object in relation to the camera. In general this option only needs to be checked when the object is placed on a slope and you can see it "bounce" up or down in altitude as the camera gets closer/farther from it. Enabling this option should stop this changing visual altitude.

 

 

<Polygon>

This element can be used to define a polygonal surface in a scene. It has multiple possible uses, for example:

  • flatten terrain
  • exclude auto-generated buildings
  • force or exclude vegetation
  • change vegetation type
  • specify airport zones (changes the type of auto-generated buildings)
  • apply a material to the ground
  • add or remove water

 

This element can have the following sub-elements, which are required to define the polygon shape:

  1. <Attribute />
  2. <Vertex />

 

The polygon object will need at least 3 <Vertex /> definitions to be valid, and has the following attributes:

 

Attribute Description Type Required
altitude The altitude of the polygon object, in meters Float Yes

 

<Attribute />

This element is used within the <Polygon> object - sometimes multiple times - to define the features of the polygon. The element is self-closing and has the following attributes:

Attribute Description Type Required
name The name of the attribute that is being added to the polygon object. You may include multiple <Attribute /> tags in a single polygon definition if it requires multiple attributes. See the page on Polygon Objects for more information on the attribute types. You can find an example of a polygon using multiple attributes here.

String

 Yes
GUID A GUID-formatted string to identify the attribute. You can find more information on GUID's here: GUIDs
type The type of value to be expected for the attribute.
value The value for the named attribute.

 

The table below shows the possible name attributes and their corresponding types and values:

name Description type value
Version A version number for the polygon. STRING A version number
UniqueGUID The GUID-formatted Instance ID unique to the specific instance of the polygon object placed within the simulation. You can find more information on GUID's here: GUIDs GUID GUID String, eg:
"{6A44EFFC-195D-4E43-A2B2-62B0E285062A}"
FlattenFalloff This sets the distance around the polygon which will be "feathered", smoothing the difference in altitude between the polygon terraformer and the surrounding terrain. FLOAT32 A value in meters.
FlattenMode Sets whether the polygon should flatten the terrain it is placed on or not. UINT8 Integer, either "0" (enabled) or "1" (disabled)
ExcludeDetectedBuildings Convert the polygon into an exclusion polygon which will exclude buildings created algorithmically from the aerial image data. UINT8 Integer, either "0" (false) or "1" (true)
ExcludeOSMBuildings Convert the polygon into an exclusion polygon which will exclude buildings created from the data supplied by Open Street Maps. UINT8 Integer, either "0" (false) or "1" (true)
ExcludeMSBuildings Convert the polygon into an exclusion polygon which will exclude buildings generated from open-source data for North America that comes from Microsoft. UINT8 Integer, either "0" (false) or "1" (true)
ExcludeTIN Convert the polygon into an exclusion polygon which will exclude the TIN data streamed from Bing Maps, which may include buildings as well as other things. UINT8 Integer, either "0" (false) or "1" (true)
ExclusionFlags A single value used to represent multiple possible exclusions for the polygon, summed together. UINT32

Intger, a combination of the following (summed together):

  1. 1: roads
  2. 2: street lights
  3. 4: power lines
  4. 8: feature points
BuildingOnTIN This can be used when you have excluded TIN data, but want to still have TIN generated buildings present. UINT8 Integer, either "0" (false) or "1" (true)
ForceDetectedBuilding This option can be used to force the rendering of detected buildings for an area. UINT8 Integer, either "0" (false) or "1" (true)
BiomeName This option permits you to select a different biome to be used for the vegetation within the polygon area. Note that when this attribute is included, any Material you have defined will no longer be shown. STRING

String to define the biome, one of the following:

  1. None
  2. Cactus
  3. ScrubSmall
  4. Conifer_Cold
  5. Conifer_Cold_Cities
  6. Conifer_Cold_Instead_Of_Other
  7. Conifer_Warm
  8. Date_Tree
  9. Deciduous
  10. Deciduous_Cities
  11. Deciduous_Cities_Tropical
  12. Mixed_Cold
  13. Mixed_Cold_Instead_Of_Deciduous
  14. Mixed_Warm
  15. Mixed_Warm_Instead_Of_Deciduous
  16. Palm_Tree
  17. Rain
  18. Savanna
  19. Savanna_Cities
  20. Scrub
  21. Scrub_Instead_Of_Trees
  22. Semi-Desert
  23. Semi-Tropical
VegetationScale This sets the scale of the vegetation within the polygon. UINT32 A value between 0 and 255, mapped to a scale of 0 and 1, respectively.
VegetationDensity This sets the density of vegetation within the polygon. UINT32 Value between 0 and 62, where 31 is 100%, 0 is 0% and 62 is 200%.
VegetationFalloff This sets the distance around the polygon in which the vegetation will be "feathered" between the edge and the surrounding terrain. FLOAT32 Value is in meters.
TreeBrightnessFactor This setting is for changing the brightness of the vegetation color. UINT32 Value between 0 and 255, where 127 is 100%, 0 is 0% and 255 is 200%.
MaterialGUID The GUID-formatted ID unique to the material to use with the polygon object. You can find more information on GUID's here: GUIDs GUID GUID String, eg:
"{6A44EFFC-195D-4E43-A2B2-62B0E285062A}"
MaterialTiling This sets the tiling scale for the texture used by the material. FLOAT32 Value is in meters.
MaterialFalloff This sets the distance around the polygon in which the material will be "feathered" to smooth the transition between the polygon material and the terrain. FLOAT32 Value is in meters.
MaterialRotation This sets the angle at which the material texture will be rendered. FLOAT32 Value between 0 and 6.283185 (angle expressed in radians).
MaterialOpacity This is for changing the transparency of the material. UINT8 A value between 0 and 255, mapped to a scale of 0 and 1, respectively.
MaterialColoration This permits you to add a colored "tint" to the material. Setting the RGB values to (0, 0, 0) will remove all tinting. UINT32

An unsigned integer that can be represented in hexadecimal with the format "RRGGBBAA". EG:

  1. Red = FF0000FF = 4278190335
  2. Green = 00FF00FF = 16711935
  3. Blue = 0000FFFF = 65535

Note that the alpha component is always 255.

 
Layer This option sets the render priority for the polygon. The default render priority is 0, which for most cases is fine. However, if you have overlapping polygons and want one to render over another one, then you will need to change this value. UINT32 A render priority value. Higher priority values will render over lower priorities, for example, a polygon with priority 1 will render over one with priority 0, which in turn will render over one with priority -1. Note that the engine cannot guarantee the render order for polygons with the same priority, so if you need something to always render over or under something else, you need to set this value.
IsWater Selecting this option tells the simulation that the polygon is defining an area of water. UINT8 Integer, either "0" (false) or "1" (true)
WaterType Sets the type of water that you are defining with the polygon. UINT32

Integer, where:

  1. 0: River
  2. 1: Waste Water
  3. 2: Generic Water
  4. 3: Pond
  5. 4: Lake
  6. 5: Ocean
IsWaterExclusion Selecting this option tells the simulation that the polygon is defining an area that excludes water. UINT8 Integer, either "0" (false) or "1" (true)
AirportSize This option will affect the size and type of buildings that may be auto-generated in the area as well as certain airport models like ATC Towers. UINT8

Value between 0 and 6, corresponding to:

  1. 0: Unkown
  2. 1: XS
  3. 2: S
  4. 3: M
  5. 4: L
  6. 5: XL
  7. 6: XXL
IsAirportInternational This option tells the simulation that the area is part of an airport. UINT8 Integer, either "0" (false) or "1" (true)
SubjectPhotoGUID The GUID-formatted ID used in mission files for POI photography. You can find more information on GUID's here: GUIDs STRING GUID String, eg:
"{6A44EFFC-195D-4E43-A2B2-62B0E285062A}"
PreciseTerraforming Sets whether the polygon terraforming should use the old render pipeline or the new one. By default, the modern rendering will always be used, but for legacy airports and scenery files, you may wish to set this to 0 (false). UINT8 Integer, either "0" (disabled) or "1" (enabled)

 

 

<Rectangle>

This element can be used to define a rectangular surface in a scene. It is generally used for terraforming an area and for changing the surface material within the rectangle. The rectangle is defined by supplying two sets of coordinates for latitude, longitude and altitude, which will set the positions for two sides of the rectangle, while the width value sets how wide the rectangular area will be between those points. The diagram below helps illustrate this:

Scenery Rectangle Being Defined

This element can contain the <RunwayDeformation /> as well as the <Heightmap /> sub-elements, and takes the following attributes:

 

Attribute Description Type Required
width The total width of the rectangular area, in meters. Float Yes
falloff Defines the range of terrain affected by the flattening of the rectangular area, higher value meaning an increase range. Float Yes
surface Material to apply to the rectangular surface. If not supplied, then the original terrain surface material will be used.

String:

  1. "CONCRETE"
  2. "GRASS"
  3. "WATER"
  4. "GRASS_BUMPY"
  5. "ASPHALT"
  6. "SHORT_GRASS"
  7. "LONG_GRASS"
  8. "HARD_TURF"
  9. "SNOW"
  10. "ICE"
  11. "URBAN"
  12. "FOREST"
  13. "DIRT"
  14. "CORAL"
  15. "GRAVEL"
  16. "OIL_TREATED"
  17. "STEEL_MATS"
  18. "BITUMINUS"
  19. "BRICK"
  20. "MACADAM"
  21. "PLANKS"
  22. "SAND"
  23. "SHALE"
  24. "TARMAC"
  25. "WRIGHT_FLYER_TRACK"
 No
lat Latitude of the first side of the rectangular area. Float Yes
lon Longitude of the first side of the rectangular area. Float Yes
alt Altitude of the first side of the rectangular area, in meters. Please note that the referential for this value is always ELLIPSOID. Float Yes
lat2 Latitude of the second side of the rectangular area. Float Yes
lon2 Longitude of the second side of the rectangular area. Float Yes
alt2 Altitude of the second side of the rectangular area, in meters. Please note that the referential for this value is always ELLIPSOID. Float Yes
priority This value is used to define the order in which the terraforming rectangles should be applied. Integer No

 

<Heightmap />

This sub-element can be added to a <Rectangle> to define a set of heightmap values to the area being terraformed. This element takes two attributes:

 

Attribute Description Type Required
width The width of the data grid. Integer Yes
data

A list of altitude values, where each value is separated by a space, eg:

data="49.393673 49.393929 49.394184 49.394440"

 String Yes

 

The heightmap will be applied to the entire rectangle, and the attributes are basically defining a grid of values where:

number_of_data_values = width * length

For example, say we want to apply a heightmap of 9 points to the defined rectangle. We'd use this element like this:

<Heightmap width="3" data="val1 val2 val3 val4 val5 val6 val7 val8 val9" />

This would then be applied to the rectangle like this:

Heightmap Element Example Illustration

 

 

<ExclusionRectangle />

This element can be used to define a rectangular area which can be used to exclude specific elements. The elements to be excluded are supplied as attributes to the element and are listed in the table below.

IMPORTANT! This element will not exclude anything from the current package being edited. It is only valid for removing things from a previously loaded package, and is dependent on the package load order. So, packages loaded after the package with the <ExclusionRectangle> will be rendered as normal, and packages loaded before the package with the <ExclusionRectangle> will have elements excluded.

NOTE: Exclusion rectangles will only apply to SimObjects placed via the Scenery Editor. They will not apply to BGL traffic or SimObjects spawned using SimConnect.

This element has no children and is self closing, and it uses the attributes listed below:

 

Attribute Description Type Required
latitudeMinimum The minimum latitude for one side of the rectangle. Float Yes
latitudeMaximum The maximum latitude for one side of the rectangle. Float Yes
longitudeMinimum The minimum longitude for one side of the rectangle. Float Yes
longitudeMaximum The maximum longitude for one side of the rectangle. Float Yes
excludeAllObjects Setting this will exclude all objects within the rectangular area (in which case none of the other attributes are necessary). Bool No
excludeBeaconObjects Setting this will exclude any beacons within the rectangular area.
excludeCarParking Setting this will exclude any car park objects within the rectangular area.
excludeEffectObjects Setting this will exclude any legacy effect objects within the rectangular area.
excludeLibraryObjects Setting this will exclude any library objects within the rectangular area.
excludePolygons Setting this will exclude any polygons within the rectangular area.
excludeProjectedMesh Setting this will exclude any projected meshes within the rectangular area.
excludeRectangles Setting this will exclude any rectangles within the rectangular area.
excludeSimObjects Setting this will exclude any SimObjects within the rectangular area.
excludeTaxiwaySignObjects Setting this will exclude any taxiway signs within the rectangular area.
excludeVisualObjects Setting this will exclude any Visual Effect objects within the rectangular area.
excludeWindsockObjects Setting this will exclude any windsocks within the rectangular area.
excludeWorldScripts Setting this will exclude any world script objects within the rectangular area.
excludeAirports Setting this will exclude the airport that it has been placed over. This requires that the exclusion rectangle covers the center point of the airport, and will prevent all airport objects from spawning, including towers, runways, aprons, etc... Note that this will not change any ground textures, and so - if the airport being excluded exists in the real world - there may still be airport areas visible in the TIN.


Related Topics

  1. General Environment XML Properties
  2. Scenery Editor Object Examples
  3. The Scenery Editor
  4. Scenery Objects
  5. Debug