diff --git a/docs-mini/model-howto.html b/docs-mini/model-howto.html deleted file mode 100644 index 8a110233f..000000000 --- a/docs-mini/model-howto.html +++ /dev/null @@ -1,200 +0,0 @@ - - - - -Flightgear External Model Mini-HowTo - - - -

FlightGear External Model Mini-HowTo

- - - -

FlightGear now supports external views with user-defined 3D models. -Eventually, FlightGear will probably support a single definition file -that specifies a package containing a flight model, engine model, -panel, external 3D model, and sounds; for now, however, users must -specify each of these separately.

- -

FlightGear uses the open-source PLIB library, which (as of -version 1.3.1) includes support for several 3D file formats:

- - - -

(Note that some of these have restrictions; see the PLIB -documentation for details.) As new formats are added to PLIB, -FlightGear will automatically be able to support them.

- -

First, you need to find a 3D model for the aircraft you want to see -during an external view. Your best bet is probably to download an -MSFS MDL file from one of the many flight-simulator Web sites, such as -www.flightsim.com. You then -need to install the main model file (with the appropriate extension) -somewhere under $FG_ROOT, and install any associated -textures in $FG_ROOT/Models/Textures.

- -
-

NOTE: if your model appears untextured and you are -using a case-sensitive filesystem, you may need to fiddle with the -case of the texture file names.

-
- -

Next, you need to set the property /sim/model/path to -the model file's name, relative to $FG_ROOT.

- -

It is possible that the model may not be aligned correctly, and -will appear to fly too high, too low, sideways, vertically, etc. If -so, you can use the additional properties described at the end of this -mini-howto to adjust to model so that it appears to fly -realistically.

- - -
-

Example

- -

You have downloaded a zip package containing a 3D Cessna model for -Microsoft Flight Simulator, and you want to use that model in -FlightGear. First, you unzip the package, where you find a series of -files, including one with the extension "mdl" and several -with extensions ending in "af"; you can safely ignore any -other files for the installation, but you should, of course, read any -files describing your usage rights.

- -

Change to the location of $FG_ROOT -(/usr/local/FlightGear on my system) and copy all of the -*af texture files to Models/Textures/. In -Unix, assuming you unzipped in /tmp/cessna

- -
-cp /tmp/cessna/*af Models/Textures
-
- -

Next, copy to *.mdl file to any location under -$FG_ROOT; it's probably a good idea to put it inside -Models/. In Unix

- -
-cp /tmp/cessna/*.mdl Models
-
- -

To use the model in FlightGear, use the --prop option -with the /sim/model/path property:

- -
-fgfs --prop:/sim/model/path=Models/C172SKH.mdl
-
- -

Press the 'v' key to switch to external view, and see how it -looks.

- -

If the model does seem to have the correct position or orientation, -you can adjust it using the properties described below. When -everything is correct, you can add the properties to your .fgfsrc file -so that you do not have to type them every time.

- - -
- - -
-

Properties

- -

These properties allow you to specify the path of the 3D model for -external views and to adjust the model's position and orientation so -that it seems to fly in the correct position. For example, if the -model is pointing backwards, you can specify

- -
---prop:/sim/model/h-rotation=180
-
- -

to turn it around the right way. If the model seems to float a -half meter above the ground, you can specify

- -
---prop:/sim/model/z-offset=0.5
-
- -

to lower it a bit.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PropertyDefaultDescription
/sim/model/pathModels/Geometry/glider.acThe pathname of a file containing a 3D model, relative to -$FG_ROOT.
/sim/model/x-offset0.0The backward/forward offset in meters. Positive is backwards, -negative is forwards.
/sim/model/y-offset0.0The left/right offset in meters. Positive is right, negative is -left.
/sim/model/z-offset0.0The up/down offset in meters. Positive is down, negative is -up.
/sim/model/h-rotation0.0The heading rotation in degrees. Positive is counter-clockwise, -negative is clockwise.
/sim/model/p-rotation0.0The bank rotation in degrees. Positive is left bank, negative is -right bank.
/sim/model/r-rotation -0.0The pitch rotation in degrees. Positive is nose up, negative is -nose down.
- - -
- -
- -
David Megginson, -david@megginson.com, -2000-11-08
- - - diff --git a/docs-mini/model.jpg b/docs-mini/model.jpg deleted file mode 100644 index 4133ae652..000000000 Binary files a/docs-mini/model.jpg and /dev/null differ diff --git a/docs-mini/properties.txt b/docs-mini/properties.txt deleted file mode 100644 index c408bee49..000000000 --- a/docs-mini/properties.txt +++ /dev/null @@ -1,192 +0,0 @@ -Current FGFS properties: - -[Properties marked '*' cannot currently be set with the --prop:* -option at startup due to a bug in the FGFS tile cache code.] - - -/sim/flight-model [*] -int -read/write - -/sim/hud/visibility [*] -bool -read/write - -/sim/panel/visibility [*] -bool -read/write - -/position/latitude [*] -double (-90.0:90.0) -read/write - -/position/longitude [*] -double (-180.0:180.0) -read/write - -/position/altitude [*] -double (feet) -read/write - -/position/altitude-agl -double (feet) -read-only - -/orientation/heading [*] -double (degrees) -read/write - -/orientation/heading-magnetic [*] -double (degrees) -read-only - -/orientation/pitch [*] -double (degrees) -read/write - -/orientation/roll [*] -double (degrees) -read/write - -/velocities/airspeed [*] -double (knots) -read-only - -/velocities/side-slip [*] -double (??) -read-only - -/velocities/vertical-speed [*] -double (??) -read-only - -/velocities/speed-north [*] -double (??) -read/write - -/velocities/speed-east [*] -double (??) -read/write - -/velocities/speed-down [*] -double (??) -read/write - -/controls/throttle -double (0.0:1.0) -read/write -(will be changing) - -/controls/flaps -double (0.0:1.0) -read/write - -/controls/aileron -double (-1.0:1.0) -read/write - -/controls/rudder -double (-1.0:1.0) -read/write - -/controls/elevator -double (-1.0:1.0) -read/write - -/controls/elevator-trim -double (-1.0:1.0) -read/write - -/controls/brake/all -double (0.0:1.0) -read/write -(will be changing) - -/autopilot/locks/altitude -bool -read/write - -/autopilot/settings/altitude -double (feet) -read/write - -/autopilot/locks/heading -bool -read/write - -/autopilot/settings/heading-magnetic -double (degrees) -read/write - -/autopilot/locks/nav1 -bool -read/write - -/radios/nav1/frequencies/selected -double -read/write - -/radios/nav1/frequencies/standby -double -read/write - -/radios/nav1/radials/actual -double (degrees) -read-only - -/radios/nav1/radials/selected -double (degrees) -read/write - -/radios/nav1/dme/distance -double (nautical miles) -read-only - -/radios/nav1/in-range -bool -read-only - -/radios/nav1/dme/in-range -bool -read-only - -/radios/nav2/frequencies/selected -double -read/write - -/radios/nav2/frequencies/standby -double -read/write - -/radios/nav2/radials/actual -double (degrees) -read-only - -/radios/nav2/radials/selected -double (degrees) -read/write - -/radios/nav2/dme/distance -double (nautical miles) -read-only - -/radios/nav2/in-range -bool -read-only - -/radios/nav2/dme/in-range -bool -read-only - -/radios/adf/frequencies/selected -double -read/write - -/radios/adf/frequencies/standby -double -read/write - -/radios/adf/rotation -double (degrees) -read/write -