Flightgear logo

How to contribute

Foreword: The instructions on this page are presented in a pretty elaborate, detailed way that might look a bit complicated at first glance. Please don't get this wrong - contributing to the repository is pretty simple, especially through the use of our web forms. We experienced that almost every individual in such a large crew of contributors has, needless to say, a different background. So we just try to give detailed recommendations in order to avoid misunderstandings.

Contributing positions

If you wish to contribute positions for the many shared models that are already available then these are best submitted:

Contributing models

If you wish to help populate the world with interesting static objects (yes, we really are aiming for total world domination here :-) then we'll need the following details:

Submission items

Mandatory submission items

  • Model placement:
    • Position (if appropriate; either lon/lat, or Ordnance Survey grid - other grids can be added on request).
    • Heading (if appropriate).
    • Ground elevation (if known to the author) - in any case, report if the model has to be sunk into the ground (what we call offset) in order to display properly !!
    • -> .... or just simply submit the respective .stg-line with your model.
  • Full name of author (yes you have to be known to us before submitting a 3D model.
  • Email address of author (if not already known, will not be published, just as a reference).
  • A notice which tells us that your submission is covered by the GNU GPL v2 (if not already known).
    • The nature of the FlightGear project does not allow us to accept submissions that don't comply with the GPL.
  • Always tell us how to name the model (like 'Tour Eiffel - Paris - France').
  • A 320x240 thumbnail containing an advantageous view on the model/object as (JPEG) image - this is preferred for a nice representation of your artwork.
  • Country in which the model is located (if known to the author).
  • Additional short comment on the author.
  • Details are available here.

Models best practice: To save you and us from avoidable and unnecessary extra work:

  • Never group different, detached buildings into a single geometry file.
  • Never put surface materials (tarmac, grass, roads, parkings, ...) or trees into Scenery Model geometries.
-> The reason is simple: Depending on the angle of view, the operating system, the graphics card and driver, the underlying terrain slope, various people might be seeing rendering artifacts. Therefore: Please don't !
  • For groupings of individual models choose a distinct, corresponding position for each of them, never mount multiple models into a single position.
  • Textures should be in PNG format - older models which used rgb textures have been updated. The textures dimensions have to be a power of two: eg 128x256.
  • Apron, taxiway, runway or other airport pavements are being maintained at XPlane Robin Peel's airport database.
  • Always choose reasonable (meaningful, descriptive) filenames for your models. At urban areas having a geometry 'tower.ac' or a texture just named 'red.png' or 'concrete.png' might prove not to be unique ;-)
  • As a rule of thumb, try to let even a detailed, single model not exceed 1/2 MByte in total size, otherwise the simulation will face hard times when approaching densely packed areas. A typical, single office building usually can be done at (far!) less than 100 kByte;
  • Avoid spaces in file- and/or directory names.
  • As a general rule, do not try to (mis)use 3D models as a substitute for unfinished airfield layout or land cover. Do not place your models at incorrect positions just because the current land cover shapes do not match.
  • Feel invited to send us an early version of your model even if it still has unfinished details. It's always possible to update the respective metadata entry with a refined model - especially when the placement of the model doesn't change any more.
-> The better your submission complies with these recommendations, the quicker we'll have it imported into the repository.

Upload facilities

  • Our dedicated webform here.

Contributing thumbnails

A noticeable amount of model submissions are missing a thumbnail. If you like to take some snapshots for us, go ahead, look at the Model Browser pages, pick those models which lack a thumbnail and create a nice view on the respective model. JPEG's of 320x240 make our overview.
Models are easily identified by their numeric id when you click on the thumbnail in the Browser view.
You can find here the models without thumbnail.

Understanding offset

Quite a lot of people are not using the offset parameter, or don't understand why it sits for. The picture below is there to give a small overview of its use, with a usual example within FG.

Understanding offset

In this example, we use a chimney. The chimney available as shared objects are quite high by default, in order to be useable in a lot of situation. Imagine if we had to create one chimney of a given height per situation.
  • The model shown has an (example) overall height of 200 meters.
  • Unfortunately, you want it to have an elevation of 150 meters Above Ground Level (AGL) to fit your situations.
  • So you have to "sink" your object in the ground of 150-200=-50 meters (the AGL elevation minus the model height).
  • This -50 meter is the offset you have to give in our webforms, while the elevation is the ground level elevation (eg 100 meters in our example).
  • Please NEVER USE "hand crafted" elevation (in that case, you could think about putting 50m as elevation, and 0 as an offset), because the elevation of each object in our database is regularly re-computed to match the best Data Elevation Model (DEM) available. At that occasion, the elevation of this object would be readjusted and replaced by 100 meters (or 102, or whatever, if the DEM or computation gets more precise). You would then see your object sitting on the ground, but with 200 meters as object AGL elevation! That's why the offset is so important.
  • Chimneys are objects where offsets are frequently used, but it's also the case if you want to put an object above another one. For instance, this Mercedes star (no ad intended here) sits on top of this building. So the star and the building have the same ground elevation (227.0 meters above MSL), but the star has an offset of 48 meters. 48 meters is the positive offset, corresponding to the height of the building on which it sits. During the next elevation computation, elevation may become another one (228 or 230), but the offset will stay the same and the star will always be sitting on its building, and the submitter has just nothing to change!
  • For those wondering, the offset is applied on export by TerraSync, which computes the (easy) operation ELEV+OFFSET (whether offset is positive or negative) and puts the result into the STG file.

Version 0a89a75 - January 13 2017 04:31 -  Version info - Volunteer? - Readme - License - History -