Revision History 1/19/06 Initial Draft.
X-Plane Scenery is divided into individual one-by-one degree tiles, represented in DSF format. DSF files come in two flavors:
Overlay DSFs make it possible to add or refine details in scenery. Because more than one overlay can be used for a tile, multiple airports or cities can be refined by independent authors.
X-Plane loads DSF overlays in the order of the prioritization or scenery packages; all overlays must be higher priority than the full DSF they will cover. Once X-Plane finds a full DSF it stops searching for additional files.
The DSF property
sim/overlay indicates whether a DSF is an overlay. A value of 1
indicates an overlay; a value of 0, or the absence of this property indicates a full DSF.
Overlays must have all of the regular DSF atoms (even if they are empty); limits are enforced by not using primitives and definitions. Therefore there must be no terrain or network definitions in an overlay DSF.
Warning: X-Plane does not under normal operation attempt to detect violations of DSF overlay limits. An improperly built overlay may cause the sim to crash or induce an internal error.
The following restrictions apply to overlays, but not full DSFs:
Overlays may contain objects and any form of polygon.
The 3-d objects and other 3-d stuff in an overlay are drawn on top of the underlying terrain. Since the underlying base terrain may already include objects that would conflict with the overlay, overlays may need to include exclusion zones, or areas that will delete underlying scenery.
DSF overlay exclusion zones are always specified as rectangles, bounded by latitude and longitude lines. They can be as small as you want, and you can use as many of them as you want. However exclusion zones do slow down scenery load time, so using fewer larger zones is more efficient.
Exclusion zones act on the underlying base terrain and any overlays below the overlay being loaded. For example, if one overlay replaced the entire Manhattan island with skyscrapers, and another overlay (with higher priority) replaced only the empire state-building, then with appropriate exclusion zones the 3-d objects would be merged into one city.
Exclusion zones are catagorized by the type of scenery they delete. If you want to remove all types of scenery for one area, use multiple zones with the same bounds.
Exclusion zones are specified via properties in your DSF. They are only legal in overlays. The keys for overlyas are:
sim/exclude_objto exclude objects.
sim/exclude_facto exclude facade polygons.
sim/exclude_forto exclude forest poylgons.
sim/exclude_bchto exclude beach polygons.
sim/exclude_netto exclude road network segments.
The value for each sim property is a box, of the form
west/south/east/north. For example,
-72.31/42.32/-72.05/42.66. To make multiple zones, simply repeat the keys. The order of the
keys is not important.