From: John Check <j4strngs@bitless.net>
Subject: New panel doc
Date: Thu, 5 Oct 2000 19:44:02 -0500 (EST)

Hi Curt,
Here's the latest version panel doc. I'm also including the final
version joystick doc, the one in docs-mini is one behind.

I made some changes to my local sources to get a larger viewport
allowing for a shaped panel and still being able to see the runway
on takeoff. Should I send you the changes? David M is cool with it.

FWIW I've been playing with 3D renders for some textures and it's
looking pretty good. Theres a screenshot with the throttle and
mixture knobs done like that at http://rockfish.net/fg/

I'm going to post a tarball with what I have now to the above URL
but Dave is planning on making some changes to property manager over
the weekend and I figured I'd wait till I'm synched with any name changes
before making an official update.

David Megginson writes:

I have a scrollable panel working (it didn't take long in the end).  A
panel can now be much wider or higher than the available area, and the
user can scroll around using [Shift]F5, [Shift]F6, [Shift]F7, and
[Shift]F8.  The user can also scroll the panel down to get a bigger
external view.  Mouse clicks seem still to be working correctly.

To set the panel's (virtual) height and width, use the panel file's /w
and /h properties in a panel XML file; to set the initial x- and y-
offsets (untested), use the panel file's /x-offset and /y-offset
properties; to set the initial height of the external view (untested
and optional), use the panel file's /view-height property.  Note that
none of these show up in the regular FGFS property manager.

Unfortunately, these patches will not affect your initialization
problems with the property manager -- I'm having a hard time tracking
them down because I cannot reproduce them.

I have also made some patches to main.cxx and views.cxx to do two
things:

1. Expand or shrink the external view as the panel moves up and down.

2. Set the window ratio correctly, so that we don't get an oval sun
   and flat clouds when the panel is visible (the problem before was
   integer division, so I added casts).

Unfortunately, the window ratio is not set properly at start-up --
there are too many dependencies, and I haven't figured that part out
yet.  As soon as you hide and redisplay the panel or move it
vertically (i.e. force fgReshape to be called), you'll see the correct
ratio.

Properties:

- /engines/engine0/rpm changed to read-only
- /engines/engine0/egt added (read-only)
- /controls/mixture added
- /controls/propellor-pitch added (not used for C172)

BFI:

- getEGT() added
- getMixture() and setMixture() added
- getPropAdvance() and setPropAdvance() added (= pitch)
- cleaned up reinit function a bit
- force reinit only when values are actually changed; for example,
  setting the flight model to the current flight model will not cause
  a reinit

LaRCSim:

- hook up mixture and pitch to FGControls (they were hard-coded
  before)

Properties:

- /engines/engine0/rpm changed to read-only
- /engines/engine0/egt added (read-only)
- /controls/mixture added
- /controls/propellor-pitch added (not used for C172)

BFI:

- getEGT() added
- getMixture() and setMixture() added
- getPropAdvance() and setPropAdvance() added (= pitch)
- cleaned up reinit function a bit
- force reinit only when values are actually changed; for example,
  setting the flight model to the current flight model will not cause
  a reinit

LaRCSim:

- hook up mixture and pitch to FGControls (they were hard-coded
  before)

Trial support for texture sets with varying resolution.

Working on a new protocal that allows you to remotely browse, examine, and
change items in the property manager.

Die if I/O Channel config fails for any reason.
Add an I/O Shutdown function call that explicitely closes all the open channels.

Close all iochannel connections on exit.

runway textures!

Oct 2, 2000 JSBSim sync.

MSVC compatibility changes and code tweaks for minor nits caught by the
MSVC compiler.

Updates from Christian Mayer to put some of the weather data "on the bus."

Updates from David Megginson relating to the property manager.

tweaks?

Tie the engine0 rpm to the property manager.

Working on putting engine data on "the bus"

Updates to IO360 engine model:  Added a couple of guestimates for engine
and prop inertia and passed the timestep from LaRCsim in order to have
the engine rpm behaving according to the applied torque and the laws of
physics.

A bit of fg->sg namespace changing.

Renamed fg_types.hxx -> sg_types.hxx
Started work on an interactive property manager traverser/setter.

Tweaks to base making rules.

Initial revision.

Minor changes to several includes to allow out of source tree builds.

Fixed a couple "typos"

Initial revision.

Initial revision.

Updated version.

Changes from David Megginson in support of an xml based configuration file.

Sep. 22, 2000 panel updates from David Megginson to make the new config file
panel be the default (sp_panel.* RIP).

Fixes for MSVC++ issues.

Caught an old texture path reference.

Tweaks for new panel invocation.

Fixed another array overrun type bug.

Sep. 18, 2000 updates from David Megginson.  New panel configs are now
expected to be found in $fgroot.

Initial revision.

builddir -> srcdir so builds can be done outside the master source directory.

Tweaks to handle latest airport data file from Robin Peel.

Updates for version 0.7.6.

Joystick fixes from Tony.

Change A* and B* variables to lowercase to avoid conflicting defines with
Irix includes.

NEWS for 0.7.5

Grab max texture size in case we want to use it later ...

Use time_t instead of long int for mktime() return type.

Added a function to query the current size of the tile load queue.

bfi load/save fix from David.
Added an initial freeze on startup so that we can try to avoid bouncing the
plane on it's back during the very low frame rate / scenery loading startup
conditions.

Added .h flags so the they are included in the distribution.

Updated beta version letters.

Tweaks to the runfgfs.bat script.

Tweaks to ground steering sensitivity.

Incorporated previously missed updates.

MacOS changes by Darrell Walisser.

Initial revision.

MACOS -> macintosh

Explicitely add -lpthread to the link line to avoid a long standing linux
ld bug.

A couple namespace fixes to avoid problems with latest plib cvs on some
systems.

Sep 8, 2000 panel updates from David Megginson.

Ooops, shouldn't call a program "ps".

Initial revision.

Miscellaneous MSVC fixes.

Sep 1 2000 updates from the UIUC team.

Fixed whiskey compass.

Initial revision.

Tweaks ...

Tweaks relating to texture repeating effects for runways and disabling mipmaps
(experimental).

A couple tweaks from David Megginson relating to his new panel data file
support.

Default to not using new engine code ...

Added a crude check for proper simgear version.

20000905 changes from David Megginson to impliment a data file configurable
instrument panel.

Updates to trial engine model.

Updates to test the 10520 engine code.

Starting to play around with an engine model.

Add support in materials file for non-repeating textures.

Force glEnable(GL_DEPTH_TEST) for scenery rendering.

Fixed a small bug in runway closeness logic.

Setting airport position from within flightgear now also takes advantage
of the new runway positioning code.

Initial revision.

Initial revision.

Added code to put aircraft at the end of the runway closest to the desired
heading.  Only changed for initial position right now.

Updates and tweaks for Oliver's multi-player networking code.

Fixed a problem with the sound hack ... code was using a value that was never
initialized or updated ... switched to a different value that was both
initialized and updated ... :-)

Norman's changes to make the current scenery normal available.

Updates to use new SGMagVar class from simgear.

Fixes to jsbsim.

20000803 updates.

Fix to time initialization (based on position) code

Updates to JSBSim.

JSBSim updates.
Updates to put more internal JSBSim values on the "bus".

Renamed JSBsim to JSBSim ...

Sync the JSBSim code with the Jon & Tony's devel version.
Renamed JSBsim -> the official JSBSim.

Updates to move scenery initialization earlier in the initialization
sequence so that the FDM can know the current ground altitude when it is
initialized.

David Megginson's changes:

src/Cockpit/radiostack.cxx
- extended VOR ranges to make them slightly more usable (pending some
  real radio code)

src/Cockpit/sp_panel.cxx
- fixed heading bug on gyro compass (sort-of -- the AP still doesn't
  work quite as expected)
- skid ball moves the right direction
- moved whiskey compass more to the co-pilot's side, as suggested by
  Alex a while back

src/Joystick/joystick.cxx
- included Norm's Windows patches
- renamed brake properties (see bfi.cxx, below)

src/Main/bfi.cxx
src/Main/bfi.hxx
- renamed getBrake and setBrake to getBrakes and setBrakes
- added getCenterBrake and setCenterBrake
- added getAPHeading (without mag correction, needed for the panel)
- renamed property /controls/brake to /controls/brakes/all
- renamed property /controls/left-brake to /controls/brakes/left (as
  requested by Alex)
- renamed property /controls/right-brake to /controls/brakes/right (as
  requested by Alex)
- added property /controls/brakes/center
- added property /autopilot/settings/heading
- fixed bug in setAltitude so that altitude will be property restored
  from a save file
- fixed getBrakes to return the highest of the three brake settings

src/Main/save.cxx
- call FGBFI::getBrakes instead of FGBFI::getBrake

Updates for 0.7.5

Activated gyro drift ... look out!
Cleaned a bit of cruft out of gui.[ch]xx
Cleaned up win_ratio() and fov code to make more sense and be a bit more
consistant and robust and less buggy and less susceptible to screw ups.
Panel is activated now by default, HUD is off by default.

Try to set initial position in a bit more intelligent way (and earlier in
the process so time initialization can have a chance to work.)

Ready for 0.7.4

Use more common joystick mappings for default.

Merged some of Alex's code changes.
Updates for better windows support in the Joystick module.

Fix to a nagging portability problem.

Renamed the property manager stuff from fg* to sg*

Autopilot altitude increment fixes.
Screen snapshot fixes.
$FG_SCENERY fixes
FGIOChannel api tweaks.

Added support for $FG_SCENERY and --fg-scenery=path

Tweaks to build with newest gcc under Irix contributed by Erik Hofman.