Version 6 (modified by pmartz@…, 9 years ago)

FLT export regression test is now on Google Code.


The OpenFlight format is an defacto industry standard format in the visual simulation industry, developed by Multigen Paradigm Inc. (MPI)
Here is the web link:

The old OpenFlight plugin osgdb_flt is moved out of the core to the deprecated SVN directory structure.
svn co http://www.openscenegraph.ORG/svn/osg/OpenSceneGraph/deprecated deprecated
To use the old plugin set the environment variable OSG_OPEN_FLIGHT_PLUGIN=old

Option strings for OpenFlight reader

billboardCenter Set billboard rotation point to center of face.
dofAnimation Enable animation on DOF nodes.
readObjectRecordData Read object records and store as osgSim::ObjectRecordData.
clampToEdge Use texture wrap mode CLAMP_TO_EDGE where CLAMP is specified.
noTextureAlphaForTransparancyBinning Do not enable alpha blending based on image translucency.
preserveFace Preserve Face information like name and comment by translating each face record into an osg::Geode.
preserveObject Preserve Object information.
keepExternalReferences Externals will be left as ProxyNodes.
cloneExternalReferences Externals are cloned.
Units conversion:
convertToFeet Convert units to feet.
convertToInches Convert units to inches.
convertToMeters Convert units to meters.
convertToKilometers Convert units to kilometers.
convertToNauticalMiles Convert units to miles.
noUnitsConversion Disable units conversion.

Option strings for OpenFlight writer

OSG was enhanced Q1 2008 to support FLT export.

version=<ver> Specifies the version of the output FLT file. Supported values include 15.7, 15.8, and 16.1. Default is 16.1. Example: "version=15.8".
units=<units> Specifies the contents of the \c Units field of the FLT header record. Valid values include INCHES, FEET, METERS, KILOMETERS, and NATICAL_MILES. Default is METERS. Example: "units=METERS".
validate If present in the Options string, the plugin does not write a FLT file. Instead, it returns an indication of the scene graph's suitability for FLT export.
tempDir=<path> Specifies the directory to use for creation of temporary files. If not specified, the directory is taken from the file name. If the file doesn't contain a path, the current working directory is used. Applications should set this to the name of their app-specific temp directory. If the path contains spaces, use double quotes to ensure correct parsing. Examples: "tempDir=/tmp"; "tempDir=\"C:\\My Temp Dir\"".
lighting=<value> Specifies a default enable/disable state for lighting. By default, the exporter assumes lighting is enabled (GL_LIGHTING ON). Set this to either ON or OFF. Example: "lighting=OFF".
stripTextureFilePath If present in the Options string, the exporter strips the path from texture file names, and writes only the texure file name to the FLT Texture Palette. By default, the exporter doesn't strip the path, and the name written to the Texture Palette is taken directly from the osg::Image object referenced by the osg::Texture2D StateAttribute.

If you encounter any isues with the exporter, please post to osg-users and include the following info:

  • .osg file for scene graph you are exporting
  • If a crash, include a stack trace

A regression test suite is available to test FLT export in OSG. Please checkout and run it to verify your build. Contributions to the test suite are welcome, please see the top-level readme.txt for contact information.

MultiGen, OpenFlight, and Flight Format are registered trademarks of MultiGen Inc.