FlightGear wiki - User contributions [en]

Building FlightGear - Linux

2007-02-01T21:19:58Z

Oelimoeli: Metakit is not used any more

__TOC__

This section describes how to build FlightGear on Linux system.

Compiling FlightGear is not a task for novice users. Thus, if you're a beginner (we all were once) on a platform which binaries are available for, we recommend postponing this task and just starting with the binary distribution to get you flying.

'''October 29th 2006, Flightgear CVS MAIN Branch switched to OSG support.'''
Plib support remains available in CVS using PRE_OSG_PLIB_20061029 Branch.
(cvs up -rPRE_OSG_PLIB_20061029)

== Requirements ==
Before you can compile FlightGear, you need to have the followings installed on your computer:

'''C++ compiler'''

These are: c++, cpp, gcc, g++ found under the /usr/bin directory. You will also need to have the tools '''autoconf''' and '''automake1.9''' installed.

'''CVS'''

Yes, the program is called 'CVS'. This is used for downloading the latest set of source code.

'''OpenGL support'''

More specifically, your system needs the support for hardware accelerated graphics. You can check for this by running:

glxinfo | grep direct

Note: To run the above command, you need to have the tool '''mesa-utils''' installed.

You should then see:

direct rendering: Yes

This means you are good to go as far as OpenGL support is concerned.

If you see:

direct rendering: No

Don't panic yet. This may just mean some required libraries for hardware accelerated graphic are missing. Go ahead and try installing plib1.8.4 and its dependencies first. If you still get the above message, then you will need to do some googling and troubleshoot yourself.

== Dependencies ==
FlightGear is dependent on quite a few number of libraries. You do not need to compile all of them yourself, but you will at least need to have their development version installed. For example, the development version for package plib1.8.4 is plib1.8.4'''-dev'''.

The dependency is summarized in the following tree. Please note that each library has its own dependencies, and most of these are not shown here.

* FlightGear
** [http://openal.org OpenAL and ALUT]
** SimGear
*** [http://plib.sourceforge.net/ PLIB] (until version 0.9.10 release sources, PRE_OSG_PLIB_20061029 CVS branch)
**** (Free)GLUT or SDL (We recommend the use of SDL)
*** [[ OpenSceneGraph ]] (cvs HEAD branch)
**** OpenThreads
**** Producer
**** libfreetype6-dev
**** libjpeg62-dev
**** libungif4-dev
**** libtiff4-dev
**** libpng12-dev
**** libxmu-dev
**** libxi-dev

If you attack the above dependencies in the order listed below, you should be good:

1. Glut. Most distributions include glut packages, although you may have to hunt for them. Make sure you install both the glut and glut-devel packages, otherwise FlightGear may be able to compile but won't run correctly.

2. Zlib. Most distributions install the basic zlib libraries by default, but not the development portions. If you don't have zlib.h, you probably need to install the zlib-devel package for your distribution.

3. Plib - portability libraries and scene graph.

4. [[ OpenSceneGraph ]]

5. SimGear - Simulation support libraries. If you are building FlightGear from CVS, you need the CVS version of SimGear. If you have strange build errors, one of the first things to check is that you have an up-to-date version of SimGear built and installed.

== Compiling ==
Assuming you are root, do:
cd /usr/local/src

=== Getting and compiling SimGear ===

'''Step 1:'''

Login to the cvs server and checkout the latest version of SimGear's source code with:
cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 login
CVS passwd: guest

cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 co source

'''Step 2:'''

Since all the source code will be downloaded into a directory called '''source''', you will need to rename the directory into something more meaningful.

Rename the above directory by doing:
mv source simgear

Next, go into the directory and make preparations for the compilation:
cd simgear
./autogen.sh
./configure

'''Step 3:'''

Compile and install SimGear by doing:
make; make install

=== Getting and compiling FlightGear ===

'''Step 1:'''

To login to the cvs version and checkout the latest version of Flightgear's source code, use:
cvs -d :pserver:cvsguest@cvs.flightgear.org:/var/cvs/FlightGear-0.9 login
CVS passwd: guest

cvs -d :pserver:cvsguest@cvs.flightgear.org:/var/cvs/FlightGear-0.9 co source

A directory with the name '''source''' will then be created with all of Flightgearear's source code downloaded into it.

'''Step 2:'''

To rename the above directory, use the following command:
mv source flightgear

Next, go into the folder and make preparations for the compilation:
cd flightgear
./autogen.sh
./configure

'''Step 3:'''

Now you can compile and install Flightgear by:
make; make install

== External links ==
=== Instructions ===
* [[ MSYS ]]
* [[ MinGW/cross-compiler ]]
* [[ CodeBlocks IDE ]]
* [[ OpenSUSE 10.1 ]]
* [http://www.geoffmclane.com/fg/fgmsvc7.htm MSVC7 *.Net]
* [http://www.oflebbe.de/oflebbe/FlightGear/index.html MSVC8 aka Visual 2005]
* [http://macflightgear.sourceforge.net/home/documents/ Mac OS X (0.9.10 and CVS)]

=== Tools ===
==== Free/Open Source ====
* [http://www.gnu.org/software/gcc/onlinedocs/ gcc - the GNU compiler (collection)]
* [http://www.gnu.org/software/make/manual/make.html make - GNU make]
* [http://sources.redhat.com/autobook/ autools - autoconf, automake, libtool & co]
* [http://distcc.samba.org distcc - distributed (fast!) compilations for any network]
* [http://www.gnu.org/software/binutils/manual/gprof-2.9.1/gprof.html gprof - the GNU profiler]
* [http://ccache.samba.org ccache - compiler cache, pre-compiled objects for gcc]
* [http://www.stack.nl/~dimitri/doxygen/ doxygen - source code documenting]
* [http://www.gnu.org/software/gdb/documentation/ gdb - the GNU project debugger]
* [http://www.gnu.org/manual/ddd/ddd.html DDD - Data Display Debugger]
* CVS - Concurrent Versioning System
** http://cvsbook.red-bean.com/cvsbook.html
** http://www.cs.utah.edu/dept/old/texinfo/cvs/cvs_toc.html
** http://www.wincvs.org/
* SVN
**http://www.subversion.org

==== Free/Proprietary ====
* [http://www.intel.com/vtune/ Intel VTune] [http://www.intel.com/cd/software/products/asmo-na/eng/download/download/index.htm (free Win32/Linux versions available for non-commercial use:requires an INTEL CPU!)]
* [http://developer.amd.com/downloads.aspx AMD's Developer Tools] (CodeAnalyst, available for free for [http://developer.amd.com/cawin.aspx Win32]/[http://developer.amd.com/calinux.aspx Linux] )

OpenSceneGraph

2007-01-26T21:47:42Z

Oelimoeli: /* Current issues */

__TOC__

As of October 29th 2006, FlightGear has migrated from PLIB to OpenSceneGraph.

Thanks to Mathias Fröhlich, we can use an current OpenSceneGraph CVS version

== Getting OpenSceneGraph ==
=== The patched version ===
OpenSceneGraph-CVS it now up to date with the required patches and should serve as well for running FlightGear. Please note that the "Producer" build system is currently in the works, you probably want to check out with the "-D 20061113" tag.

And the MSVC8 (Visual Sudio 2005) win32 build dependencies for OpenSceneGraph can be found at http://www.oflebbe.de/oflebbe/FlightGear. Look out for the link to http://www.oflebbe.de/oflebbe/FlightGear/3rdparty-2006-11-25.zip.

=== The latest cvs version ===
You can check out the latest version of OSG by doing the followings:
cvs -d :pserver:anon@openscenegraph.net:/cvs/osg login

Then hit enter when you are prompted for a password.

Next, checkout the source code by doing:
cvs -z 6 -d :pserver:anon@openscenegraph.net:/cvs/osg co OpenSceneGraph

OpenSceneGraph is dependent on OpenThreads and Producer. You can also do a cvs checkout of the latter two.

Note: hit enter when you are prompted for a password.

For OpenThreads:
cvs -d :pserver:cvsguest@openscenegraph.org:/cvs/openthreads login
cvs -d :pserver:cvsguest@openscenegraph.org:/cvs/openthreads co OpenThreads

For Producer:
cvs -d :pserver:anon@openscenegraph.net:/cvs/Producer login
cvs -d :pserver:anon@openscenegraph.net:/cvs/Producer co Producer

== Compiling OpenSceneGraph ==

If you get errors when compiling the patched OpenSceneGraph after having compiled (and installed) OpenThreads and Producer successfully (happens on Arch Linux), you may have to add the following to your 'make':

'''make PRODUCER_INC_DIR=/usr/local/include/Producer \'''
'''PRODUCER_LIB_DIR=/usr/local/lib \'''
'''OPENTHREADS_INC_DIR=/usr/local/include/OpenThreads \'''
'''OPENTHREADS_LIB_DIR=/usr/local/lib'''

== Compilation workaround ==

FIXME

Do not forget to run autogen.sh when updating sources.

=== Installing FlightGear and OSG with --prefix workaround ===

If you use --prefix to choose were to install FlightGear and do not want to install OSG globally on the system this can be done with the following method
(description for Linux):

1. Build OpenScenGraph. I do it directly in the OSG source directory without installing anything (when the next version comes I can just delete the old directory without any worries). Adjust as needed:
export OSG_BASE=$HOME/FlightGear/build/OpenSceneGraph/OSG_OP_OT-1.2-Flightgear
export OPENTHREADS_INC_DIR=$OSG_BASE/OpenThreads/include
export OPENTHREADS_LIB_DIR=$OSG_BASE/OpenThreads/lib/Linux32
export PRODUCER_INC_DIR=$OSG_BASE/Producer/include
export PRODUCER_LIB_DIR=$OSG_BASE/Producer/lib/Linux32
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$OPENTHREADS_LIB_DIR:$PRODUCER_LIB_DIR

cd OpenThreads; make
cd ../Producer; make
cd ../OpenScenGraph; make

2. Copy or (soft)link OpenThreads/include/OpenThreads into your $PREFIX/include/ directory.

3. Copy or (soft)link Producer/include/Producer into your $PREFIX/include/ directory.

4. Copy or (soft)link OpenSceneGraph/include/osg* into your $PREFIX/include/ directory.

5. Copy or (soft)link OpenThreads/lib/<system>/lib*.so into your $PREFIX/lib/ directory.

6. Copy or (soft)link Producer/lib/<system>/lib*.so into your $PREFIX/lib/ directory.

7. Copy or (soft)link OpenSceneGraph/lib/<system>/lib*.so into your $PREFIX/lib/ directory.

8. Add $PREFIX/lib to LD_LIBRARY_PATH.
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PREFIX/lib

9. Configure and build SimGear and FlightGear with --prefix as usual.

No need to install any quickly changing software globally.

Installing with --prefix is a very nice way to keep several distinct and independent versions of FlightGear around. To start a new $PREFIX directory you'll also need to install plib in it, but that is easy. Most other needed dependencies are usually available through the package system of most Linux distributions (e.g. FreeGLUT, SDL, ALSA, etc).

FIXME: Maybe it is enough to copy only the OpenSceneGraph/include/osg* and OpenSceneGraph/lib/<system>/lib*.so stuff into $PREFIX?

== Current issues ==

* The 2D Panels and the rendering order of instruments ... is wrong.

* transparency issues:
** runway lights shine through panel:
** runway lights shine through cloud layers in an awkward way:
** 2D-cloud layers flood into cockpit
** The prop of the C172 block the view on the waves of the carrier
** The reflector gun sight on the Seahawk causes other transparent objects (carrier wake etc.) to disappear
** A new overhead window in the C172 (inside out)

* "Near clipping problem" (nearby objects are partially clipped at left and right window boarder, ie seats in C172 inside)

* Runway lighting seems to have rendering artefacts on ATI Cards.

* Enhanced runway lighting option in the drop-down menu seems to have no effect - light always appear enhanced.

* panel hotspots are not correctly displayed in 3D panels using the 2D hotspot hack; are hidden behind 3D model geometry

* Seneca II HSI: upper instrument clipping issue for NAV/HDG flags, heading bug, pointer

[[List of 'compatible' aircrafts]] TO BE CONTINUED

== Missing features ==
Due to the migration from PLIB to OSG, some of the features seen in past versions of FlightGear are now temporarily non-functional. These are:

* 3D-billboard objects are not displayed right now (ie trees or radio masts)

* 3D clouds

* Rendering of some scenes is not perfect.

* Shadows

* Exhaust shader

* Chrome Shader

* Weather Radar

* Menu Items have no effect
** Enhanced Runway Lights
** Bump Mapped Clouds

== Miscelaneous OSG benefits ==

Mathias: "I think that we should make use in the longer term of the Producers
capabilities for multiple view installations.
But not only multipipe installs will benefit from that. The Producer will also
help to get benefit from multicore SMP machines.
For that the following article is of huge interrest:
http://www.donburns.net/OSG/Articles/OSGMP/"

== Getting the PLIB Code ==

Use the tag <tt>PRE_OSG_PLIB_20061029</tt> for checking out the branch with the plib scenegraph.

For SimGear, this works (more or less) as follows:

'''cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 login'''
'''CVS passwd: guest'''
'''cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 co source'''
'''cd source'''
'''cvs up -rPRE_OSG_PLIB_20061029'''

For FlightGear, you have to update both the "data" and "source" directories.

== External links ==
http://www.openscenegraph.org/index.php?page=CVS.CVS

OpenSceneGraph

2007-01-26T21:43:34Z

Oelimoeli: /* The patched version */

__TOC__

As of October 29th 2006, FlightGear has migrated from PLIB to OpenSceneGraph.

Thanks to Mathias Fröhlich, we can use an current OpenSceneGraph CVS version

== Getting OpenSceneGraph ==
=== The patched version ===
OpenSceneGraph-CVS it now up to date with the required patches and should serve as well for running FlightGear. Please note that the "Producer" build system is currently in the works, you probably want to check out with the "-D 20061113" tag.

And the MSVC8 (Visual Sudio 2005) win32 build dependencies for OpenSceneGraph can be found at http://www.oflebbe.de/oflebbe/FlightGear. Look out for the link to http://www.oflebbe.de/oflebbe/FlightGear/3rdparty-2006-11-25.zip.

=== The latest cvs version ===
You can check out the latest version of OSG by doing the followings:
cvs -d :pserver:anon@openscenegraph.net:/cvs/osg login

Then hit enter when you are prompted for a password.

Next, checkout the source code by doing:
cvs -z 6 -d :pserver:anon@openscenegraph.net:/cvs/osg co OpenSceneGraph

OpenSceneGraph is dependent on OpenThreads and Producer. You can also do a cvs checkout of the latter two.

Note: hit enter when you are prompted for a password.

For OpenThreads:
cvs -d :pserver:cvsguest@openscenegraph.org:/cvs/openthreads login
cvs -d :pserver:cvsguest@openscenegraph.org:/cvs/openthreads co OpenThreads

For Producer:
cvs -d :pserver:anon@openscenegraph.net:/cvs/Producer login
cvs -d :pserver:anon@openscenegraph.net:/cvs/Producer co Producer

== Compiling OpenSceneGraph ==

If you get errors when compiling the patched OpenSceneGraph after having compiled (and installed) OpenThreads and Producer successfully (happens on Arch Linux), you may have to add the following to your 'make':

'''make PRODUCER_INC_DIR=/usr/local/include/Producer \'''
'''PRODUCER_LIB_DIR=/usr/local/lib \'''
'''OPENTHREADS_INC_DIR=/usr/local/include/OpenThreads \'''
'''OPENTHREADS_LIB_DIR=/usr/local/lib'''

== Compilation workaround ==

FIXME

Do not forget to run autogen.sh when updating sources.

=== Installing FlightGear and OSG with --prefix workaround ===

If you use --prefix to choose were to install FlightGear and do not want to install OSG globally on the system this can be done with the following method
(description for Linux):

1. Build OpenScenGraph. I do it directly in the OSG source directory without installing anything (when the next version comes I can just delete the old directory without any worries). Adjust as needed:
export OSG_BASE=$HOME/FlightGear/build/OpenSceneGraph/OSG_OP_OT-1.2-Flightgear
export OPENTHREADS_INC_DIR=$OSG_BASE/OpenThreads/include
export OPENTHREADS_LIB_DIR=$OSG_BASE/OpenThreads/lib/Linux32
export PRODUCER_INC_DIR=$OSG_BASE/Producer/include
export PRODUCER_LIB_DIR=$OSG_BASE/Producer/lib/Linux32
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$OPENTHREADS_LIB_DIR:$PRODUCER_LIB_DIR

cd OpenThreads; make
cd ../Producer; make
cd ../OpenScenGraph; make

2. Copy or (soft)link OpenThreads/include/OpenThreads into your $PREFIX/include/ directory.

3. Copy or (soft)link Producer/include/Producer into your $PREFIX/include/ directory.

4. Copy or (soft)link OpenSceneGraph/include/osg* into your $PREFIX/include/ directory.

5. Copy or (soft)link OpenThreads/lib/<system>/lib*.so into your $PREFIX/lib/ directory.

6. Copy or (soft)link Producer/lib/<system>/lib*.so into your $PREFIX/lib/ directory.

7. Copy or (soft)link OpenSceneGraph/lib/<system>/lib*.so into your $PREFIX/lib/ directory.

8. Add $PREFIX/lib to LD_LIBRARY_PATH.
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PREFIX/lib

9. Configure and build SimGear and FlightGear with --prefix as usual.

No need to install any quickly changing software globally.

Installing with --prefix is a very nice way to keep several distinct and independent versions of FlightGear around. To start a new $PREFIX directory you'll also need to install plib in it, but that is easy. Most other needed dependencies are usually available through the package system of most Linux distributions (e.g. FreeGLUT, SDL, ALSA, etc).

FIXME: Maybe it is enough to copy only the OpenSceneGraph/include/osg* and OpenSceneGraph/lib/<system>/lib*.so stuff into $PREFIX?

== Current issues ==

* OSG Rendering Performance is roughly up to a factor of 2 slower for some scenes. This seems to have more dramatic on the Windows MVC8 build. Rendering ist faster now...

* some buildings are with day texture, and other with night texture. i'm landing onto Paris center and, with the external view, i rotate around the aircraft. the sun position is not fixed at the same time, left side of aircraft is on shadow, with another camera position, it's the right side. that can explain why some building are day textured, and some others night textured

* Some scenes do not work: The view is black. The default scene c172p on KSFO is working, however. It seems to be a terrain/ground problem since it disappears by using the UFO. This is fixed now by the ground-cache fix in CVS (061107)'''

* There are also missing ground tiles: For instance located between EDDF and Feldberg.

* Rendering order of instruments / ... is wrong.

* At least at the present season with "--timeofday=noon", sitting at KSFO 28R, I look straight into the moon with FlightGear/PLIB, but the moon isn't there with FG/OSG

* In the external view(s) the HUD position is shifted to the left

* transparency issues:
** runway lights shine through panel:
** runway lights shine through cloud layers in an awkward way:
** 2D-cloud layers flood into cockpit
** The prop of the C172 block the view on the waves of the carrier
** The reflector gun sight on the Seahawk causes other transparent objects (carrier wake etc.) to disappear
** A new overhead window in the C172 (inside out)

* "Near clipping problem" (nearby objects are partially clipped at left and right window boarder, ie seats in C172 inside)

* Some textures are to dark, runway for instance, c172 prop disk as well.

* Runway lighting seems to have rendering artefacts on ATI Cards.

* Enhanced runway lighting option in the drop-down menu seems to have no effect - light always appear enhanced.

* compass working incorrectly

* panel hotspots are not correctly displayed in 3D panels using the 2D hotspot hack; are hidden behind 3D model geometry

* Aircraft issues
** Hurricane/Spitfire/Seafire won't start. The starter spins continuously, but the engine won't fire.

'''Fixed: 061110'''
'''Spoke too soon - not fixed - the bug is intermittent'''

With the Spit/Seafire I get

Notice: Material::getDiffuse(FRONT_AND_BACK) called on material
with separate FRONT and BACK diffuse colors.

and a segfault;

** A4F crashes FG, without any error message that I have found so far. ('''FIXED''' a4/Models/a4-blue.ac 1.18 groups are not supposed to have vertices)
** Hunter and Seahawk have lost their exhausts (of course).
** The Engage Launch-bar command (L) is broken.
** The Mixture control (M/m) seems to be broken.

* Seneca II HSI: upper instrument clipping issue for NAV/HDG flags, heading bug, pointer

* Sky/Ephemeris
** Planets visible near the sun at noon

* Clickable Hotspots
** Not visible at night

* 3D cockpit instruments (I tried C172p's and 747's) seems to be scaled depending on the size of the window. This is most obvious when I change the FOV to its max (120) using the 'X' key. E.g. when I resize FG's window so that its width is much larger than its height (say, 1024x100), instruments all become a fat oval shape. Then if I resize the window the other way (say 100x910), instruments become narrower.<br>Screenshots: [http://pigeond.net/~pigeon/fg-osg-fat-window.png] [http://pigeond.net/~pigeon/fg-osg-thin-window.png] (20061117 pigeon)

[[List of 'compatible' aircrafts]] TO BE CONTINUED

== Missing features ==
Due to the migration from PLIB to OSG, some of the features seen in past versions of FlightGear are now temporarily non-functional. These are:

* 3D-billboard objects are not displayed right now (ie trees or radio masts)

* 3D clouds

* Rendering of some scenes is not perfect.

* Shadows

* Exhaust shader

* Chrome Shader

* Weather Radar

* Menu Items have no effect
** Enhanced Runway Lights
** Bump Mapped Clouds

== Miscelaneous OSG benefits ==

Mathias: "I think that we should make use in the longer term of the Producers
capabilities for multiple view installations.
But not only multipipe installs will benefit from that. The Producer will also
help to get benefit from multicore SMP machines.
For that the following article is of huge interrest:
http://www.donburns.net/OSG/Articles/OSGMP/"

== Getting the PLIB Code ==

Use the tag <tt>PRE_OSG_PLIB_20061029</tt> for checking out the branch with the plib scenegraph.

For SimGear, this works (more or less) as follows:

'''cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 login'''
'''CVS passwd: guest'''
'''cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 co source'''
'''cd source'''
'''cvs up -rPRE_OSG_PLIB_20061029'''

For FlightGear, you have to update both the "data" and "source" directories.

== External links ==
http://www.openscenegraph.org/index.php?page=CVS.CVS

OpenSceneGraph

2007-01-26T21:41:20Z

Oelimoeli:

__TOC__

As of October 29th 2006, FlightGear has migrated from PLIB to OpenSceneGraph.

Thanks to Mathias Fröhlich, we can use an current OpenSceneGraph CVS version

== Getting OpenSceneGraph ==
=== The patched version ===
OpenSceneGraph-CVS it now up to date with the required patches and should serve as well for running FlightGear. Please note that the "Producer" build system is currently in the works, you probably want to check out with the "-D 20061113" tag.

You can find that tarball at:
ftp://ftp.uni-duisburg.de/FlightGear/Misc_maf/OpenSceneGraph-20061114/OSG_OP_OT-1.2-Flightgear.tar.gz

Diff can be found at:
ftp://ftp.uni-duisburg.de/FlightGear/Misc_maf/OpenSceneGraph-20061114/OSG_OP_OT-1.2-Flightgear.diff

Mathias is working on getting the remaining patch upstream ...

And the MSVC8 win32 build dependencies for OpenSceneGraph can be found at http://www.oflebbe.de/oflebbe/FlightGear. Look out for the link to 3rdParty.zip.

=== The latest cvs version ===
You can check out the latest version of OSG by doing the followings:
cvs -d :pserver:anon@openscenegraph.net:/cvs/osg login

Then hit enter when you are prompted for a password.

Next, checkout the source code by doing:
cvs -z 6 -d :pserver:anon@openscenegraph.net:/cvs/osg co OpenSceneGraph

OpenSceneGraph is dependent on OpenThreads and Producer. You can also do a cvs checkout of the latter two.

Note: hit enter when you are prompted for a password.

For OpenThreads:
cvs -d :pserver:cvsguest@openscenegraph.org:/cvs/openthreads login
cvs -d :pserver:cvsguest@openscenegraph.org:/cvs/openthreads co OpenThreads

For Producer:
cvs -d :pserver:anon@openscenegraph.net:/cvs/Producer login
cvs -d :pserver:anon@openscenegraph.net:/cvs/Producer co Producer

== Compiling OpenSceneGraph ==

If you get errors when compiling the patched OpenSceneGraph after having compiled (and installed) OpenThreads and Producer successfully (happens on Arch Linux), you may have to add the following to your 'make':

'''make PRODUCER_INC_DIR=/usr/local/include/Producer \'''
'''PRODUCER_LIB_DIR=/usr/local/lib \'''
'''OPENTHREADS_INC_DIR=/usr/local/include/OpenThreads \'''
'''OPENTHREADS_LIB_DIR=/usr/local/lib'''

== Compilation workaround ==

FIXME

Do not forget to run autogen.sh when updating sources.

=== Installing FlightGear and OSG with --prefix workaround ===

If you use --prefix to choose were to install FlightGear and do not want to install OSG globally on the system this can be done with the following method
(description for Linux):

1. Build OpenScenGraph. I do it directly in the OSG source directory without installing anything (when the next version comes I can just delete the old directory without any worries). Adjust as needed:
export OSG_BASE=$HOME/FlightGear/build/OpenSceneGraph/OSG_OP_OT-1.2-Flightgear
export OPENTHREADS_INC_DIR=$OSG_BASE/OpenThreads/include
export OPENTHREADS_LIB_DIR=$OSG_BASE/OpenThreads/lib/Linux32
export PRODUCER_INC_DIR=$OSG_BASE/Producer/include
export PRODUCER_LIB_DIR=$OSG_BASE/Producer/lib/Linux32
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$OPENTHREADS_LIB_DIR:$PRODUCER_LIB_DIR

cd OpenThreads; make
cd ../Producer; make
cd ../OpenScenGraph; make

2. Copy or (soft)link OpenThreads/include/OpenThreads into your $PREFIX/include/ directory.

3. Copy or (soft)link Producer/include/Producer into your $PREFIX/include/ directory.

4. Copy or (soft)link OpenSceneGraph/include/osg* into your $PREFIX/include/ directory.

5. Copy or (soft)link OpenThreads/lib/<system>/lib*.so into your $PREFIX/lib/ directory.

6. Copy or (soft)link Producer/lib/<system>/lib*.so into your $PREFIX/lib/ directory.

7. Copy or (soft)link OpenSceneGraph/lib/<system>/lib*.so into your $PREFIX/lib/ directory.

8. Add $PREFIX/lib to LD_LIBRARY_PATH.
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PREFIX/lib

9. Configure and build SimGear and FlightGear with --prefix as usual.

No need to install any quickly changing software globally.

Installing with --prefix is a very nice way to keep several distinct and independent versions of FlightGear around. To start a new $PREFIX directory you'll also need to install plib in it, but that is easy. Most other needed dependencies are usually available through the package system of most Linux distributions (e.g. FreeGLUT, SDL, ALSA, etc).

FIXME: Maybe it is enough to copy only the OpenSceneGraph/include/osg* and OpenSceneGraph/lib/<system>/lib*.so stuff into $PREFIX?

== Current issues ==

* OSG Rendering Performance is roughly up to a factor of 2 slower for some scenes. This seems to have more dramatic on the Windows MVC8 build. Rendering ist faster now...

* some buildings are with day texture, and other with night texture. i'm landing onto Paris center and, with the external view, i rotate around the aircraft. the sun position is not fixed at the same time, left side of aircraft is on shadow, with another camera position, it's the right side. that can explain why some building are day textured, and some others night textured

* Some scenes do not work: The view is black. The default scene c172p on KSFO is working, however. It seems to be a terrain/ground problem since it disappears by using the UFO. This is fixed now by the ground-cache fix in CVS (061107)'''

* There are also missing ground tiles: For instance located between EDDF and Feldberg.

* Rendering order of instruments / ... is wrong.

* At least at the present season with "--timeofday=noon", sitting at KSFO 28R, I look straight into the moon with FlightGear/PLIB, but the moon isn't there with FG/OSG

* In the external view(s) the HUD position is shifted to the left

* transparency issues:
** runway lights shine through panel:
** runway lights shine through cloud layers in an awkward way:
** 2D-cloud layers flood into cockpit
** The prop of the C172 block the view on the waves of the carrier
** The reflector gun sight on the Seahawk causes other transparent objects (carrier wake etc.) to disappear
** A new overhead window in the C172 (inside out)

* "Near clipping problem" (nearby objects are partially clipped at left and right window boarder, ie seats in C172 inside)

* Some textures are to dark, runway for instance, c172 prop disk as well.

* Runway lighting seems to have rendering artefacts on ATI Cards.

* Enhanced runway lighting option in the drop-down menu seems to have no effect - light always appear enhanced.

* compass working incorrectly

* panel hotspots are not correctly displayed in 3D panels using the 2D hotspot hack; are hidden behind 3D model geometry

* Aircraft issues
** Hurricane/Spitfire/Seafire won't start. The starter spins continuously, but the engine won't fire.

'''Fixed: 061110'''
'''Spoke too soon - not fixed - the bug is intermittent'''

With the Spit/Seafire I get

Notice: Material::getDiffuse(FRONT_AND_BACK) called on material
with separate FRONT and BACK diffuse colors.

and a segfault;

** A4F crashes FG, without any error message that I have found so far. ('''FIXED''' a4/Models/a4-blue.ac 1.18 groups are not supposed to have vertices)
** Hunter and Seahawk have lost their exhausts (of course).
** The Engage Launch-bar command (L) is broken.
** The Mixture control (M/m) seems to be broken.

* Seneca II HSI: upper instrument clipping issue for NAV/HDG flags, heading bug, pointer

* Sky/Ephemeris
** Planets visible near the sun at noon

* Clickable Hotspots
** Not visible at night

* 3D cockpit instruments (I tried C172p's and 747's) seems to be scaled depending on the size of the window. This is most obvious when I change the FOV to its max (120) using the 'X' key. E.g. when I resize FG's window so that its width is much larger than its height (say, 1024x100), instruments all become a fat oval shape. Then if I resize the window the other way (say 100x910), instruments become narrower.<br>Screenshots: [http://pigeond.net/~pigeon/fg-osg-fat-window.png] [http://pigeond.net/~pigeon/fg-osg-thin-window.png] (20061117 pigeon)

[[List of 'compatible' aircrafts]] TO BE CONTINUED

== Missing features ==
Due to the migration from PLIB to OSG, some of the features seen in past versions of FlightGear are now temporarily non-functional. These are:

* 3D-billboard objects are not displayed right now (ie trees or radio masts)

* 3D clouds

* Rendering of some scenes is not perfect.

* Shadows

* Exhaust shader

* Chrome Shader

* Weather Radar

* Menu Items have no effect
** Enhanced Runway Lights
** Bump Mapped Clouds

== Miscelaneous OSG benefits ==

Mathias: "I think that we should make use in the longer term of the Producers
capabilities for multiple view installations.
But not only multipipe installs will benefit from that. The Producer will also
help to get benefit from multicore SMP machines.
For that the following article is of huge interrest:
http://www.donburns.net/OSG/Articles/OSGMP/"

== Getting the PLIB Code ==

Use the tag <tt>PRE_OSG_PLIB_20061029</tt> for checking out the branch with the plib scenegraph.

For SimGear, this works (more or less) as follows:

'''cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 login'''
'''CVS passwd: guest'''
'''cvs -d :pserver:cvsguest@cvs.simgear.org:/var/cvs/SimGear-0.3 co source'''
'''cd source'''
'''cvs up -rPRE_OSG_PLIB_20061029'''

For FlightGear, you have to update both the "data" and "source" directories.

== External links ==
http://www.openscenegraph.org/index.php?page=CVS.CVS

OpenSceneGraph

2006-11-10T18:19:58Z

Oelimoeli: /* Current Issues */

== Getting a patched version of OpenSceneGraph ==

Thanks to Mathias Fröhlich, we can use an updated OpenSceneGraph version that
contains 3 additional patches.
* most important an updated ac3d loader - that is our most used one ...
* a fix to the RGB Loader, which is already in OpenSceneGraph-CVS
* a small backport of OpenSceneGraph-CVS doing the right OpenGL version checks ...

You can find that tarball at:
ftp://ftp.uni-duisburg.de/FlightGear/Misc_maf/OpenSceneGraph-20061108/OSG_OP_OT-1.2-Flightgear.tar.gz

Diff can be found at:
ftp://ftp.uni-duisburg.de/FlightGear/Misc_maf/OpenSceneGraph-20061108/OSG_OP_OT-1.2-Flightgear.diff

Mathias is working on getting the remaining patch upstream ...

And the MSVC8 win32 build dependencies for OpenSceneGraph can be found at http://www.oflebbe.de/oflebbe/FlightGear. Look out for the link to 3rdParty.zip.

== Compilation workaround ==

FIXME

Do not forget to run autogen.sh when updating sources.

== Current Issues ==

* OSG Rendering Performance is roughly up to a factor of 2 slower for some scenes. This seems to have more dramatic on the Windows MVC8 build. Rendering ist faster now...

* some buidings are with day texture, and other with night
texture. i'm landing onto Paris center and, with the external view, i rotate
around the aircraft. the sun position is not fixed at the same time, left
side of aircraft is on shadow, with another camera position, it's the right
side.
that can explain why some building are day textured, and some others night
textured

* Some scenes do not work: The view is black. The default scene c172p on KSFO is working, however. It seems to be a terrain/ground problem since it disappears by using the UFO. This is fixed now by the ground-cache fix in CVS (061107)'''

* There are also missing ground tiles: For instance located between EDDF
and Feldberg.

* Rendering order of instruments / ... is wrong.

* transparency issues:

** runway lights shine through panel:

** runway lights shine through cloud layers in an awkward way:

** 2D-cloud layers flood into cockpit

** The prop of the C172 block the view on the waves of the carrier

** The reflector gun sight on the Seahawk causes other transparent objects (carrier wake etc.) to disappear

** A new overhead window in the C172 (inside out)

* "Near clipping problem" (nearby objects are partially clipped at left and right window boarder, ie seats in C172 inside)

* Some textures are to dark, runway for instance.

* Runway lighting seems to have rendering artefacts on ATI Cards.

* Enhanced runway lighting option in the drop-down menu seems to have no effect - light always appear enhanced.

* compass working incorrectly

* Aircraft issues
** Hurricane/Spitfire/Seafire won't start. The starter spins continuously, but the engine won't fire.

'''Fixed: 061110'''

With the Spit/Seafire I get

Notice: Material::getDiffuse(FRONT_AND_BACK) called on material
with separate FRONT and BACK diffuse colors.

and a segfault;

** A4F crashes FG, without any error message that I have found so far. ('''FIXED''' a4/Models/a4-blue.ac 1.18 groups are not supposed to have vertices)
** Hunter and Seahawk have lost their exhausts (of course).
** The Engage Launch-bar command (L) is broken.
** The Mixture control (M/m) seems to be broken.

* Sky/Ephemeris
** Planets visible near the sun at noon

* Clickable Hotspots
** Not visible at night

[[List of 'compatible' aircrafts]] TO BE CONTINUED

== Missing Features ==

* 3D-billboard objects are not displayed right now (ie trees or radio masts)

* 3D clouds

* Rendering of some scenes is not perfect.

* Shadows

* Exhaust shader

* Chrome Shader

* Weather Radar

== Miscelaneous OSG benefits ==

Mathias: "I think that we should make use in the longer term of the Producers
capabilities for multiple view installations.
But not only multipipe installs will benefit from that. The Producer will also
help to get benefit from multicore SMP machines.
For that the following article is of huge interrest:
http://www.donburns.net/OSG/Articles/OSGMP/"

== Getting the PLIB Code ==

Use the tag <tt>PRE_OSG_PLIB_20061029</tt> for checking out the branch with the plib scenegraph.

OpenSceneGraph

2006-11-06T22:59:02Z

Oelimoeli: /* Current Issues */

== Getting a patched version of OpenSceneGraph ==

Thanks to Mathias Fröhlich, we can use an updated OpenSceneGraph version that
contains 3 additional patches.
* most important an updated ac3d loader - that is our most used one ...
* a fix to the RGB Loader
* a small backport of OpenSceneGraph-CVS doing the right OpenGL version checks ...

You can find that tarball at ftp://ftp.uni-duisburg.de/FlightGear/Misc_maf/OpenSceneGraph-20061029/OSG_OP_OT-1.2-Flightgear.tar.gz

Diff can be found at ftp://ftp.uni-duisburg.de/FlightGear/Misc_maf/OpenSceneGraph-20061029/OSG_OP_OT-1.2-Flightgear.diff

Mathias is working on getting the two patches upstream ...

And the MSVC8 win32 build dependencies for OpenSceneGraph can be found at http://www.oflebbe.de/oflebbe/FlightGear. Look out for the link to 3rdParty.zip.

== Compilation workaround ==

FIXME

Do not forget to run autogen.sh when updating sources.

== Current Issues ==

* OSG Rendering Performance is roughly up to a factor of 2 slower for some scenes. This seems to have more dramatic on the Windows MVC8 build.

* Some scenes do not work: The view is black.
The default scene c172p on KSFO is working, however.

It seems to be a terrain/ground problem since it disappears by using the UFO.

* There are also missing ground tiles: For instance located between EDDF
and Feldberg.

* Rendering order of instruments / ... is wrong.

* transparency issues:

** runway lights shine through panel:

** runway lights shine through cloud layers in an awkward way:

** 2D-cloud layers flood into cockpit

** The prop of the C172 block the view on the waves of the carrier

** The reflector gun sight on the Seahawk

* Some textures are to dark, runway for instance.

* Runway lighting seems to have rendering artefacts on ATI Cards.

* compass working incorrectly

* Aircraft issues
** Hurricane/Spitfire/Seafire won't start. The starter spins continuously, but the engine won't fire.

With the Spit/Seafire I get

Notice: Material::getDiffuse(FRONT_AND_BACK) called on material
with separate FRONT and BACK diffuse colors.

and a segfault;

** A4F crashes FG, without any error message that I have found so far.
** Hunter and Seahawk have lost their exhausts (of course).
** The Engage Launch-bar command (L) is broken.
** The Mixture control (M/m) seems to be broken.

[[List of 'compatible' aircrafts]] FIXME

== Missing Features ==

* 3D-billboard objects are not displayed right now (ie trees)

* 3D clouds

* Rendering of some scenes is inperfect.

* Shadows

== Miscelaneous OSG benefits ==

Mathias: "I think that we should make use in the longer term of the Producers
capabilities for multiple view installations.
But not only multipipe installs will benefit from that. The Producer will also
help to get benefit from multicore SMP machines.
For that the following article is of huge interrest:
http://www.donburns.net/OSG/Articles/OSGMP/"

== Getting the PLIB Code ==

Use the tag <tt>PRE_OSG_PLIB_20061029</tt> for checking out the branch with the plib scenegraph.

OpenSceneGraph

2006-11-06T22:58:00Z

Oelimoeli: /* Current Issues */

OpenSceneGraph

2006-11-06T22:57:03Z

Oelimoeli: /* Compilation workaround */

OpenSceneGraph

2006-11-06T22:43:11Z

Oelimoeli: /* Current Issues */

OpenSceneGraph

2006-11-06T21:58:49Z

Oelimoeli: /* Current Issues */

OpenSceneGraph

2006-11-06T21:56:41Z

Oelimoeli: /* Current Issues */

OpenSceneGraph

2006-11-06T21:34:05Z

Oelimoeli: /* Missing Features */

OpenSceneGraph

2006-11-06T21:31:21Z

Oelimoeli:

OpenSceneGraph

2006-11-06T21:28:01Z

Oelimoeli:

OpenSceneGraph

2006-11-06T21:26:19Z

Oelimoeli: /* Current Issues */

OpenSceneGraph

2006-11-06T21:25:12Z

Oelimoeli: /* Current Issues */

OpenSceneGraph

2006-11-06T21:23:49Z

Oelimoeli:

Main Page

2006-11-06T21:18:49Z

Oelimoeli: New Page for OpenSceneGraph Related Topics

__NOTOC__
__NOEDITSECTION__
'''FlightGear''' Flight Simulator project is an open-source, multi-platform, cooperative flight simulator development project. Source code for the entire project is available ([http://cvs.flightgear.org/cgi-bin/viewcvs/viewcvs.cgi/?cvsroot=FlightGear-0.9#dirlist CVS repository]) and licensed under the [http://www.gnu.org/copyleft/gpl.html GNU General Public License].

The goal of the '''FlightGear''' project is to create a sophisticated flight simulator framework for use in research or academic environments, for the development and pursuit of other interesting flight simulation ideas, and as an end-user application. We are developing a sophisticated, open simulation framework that can be expanded and improved upon by anyone interested in [[Volunteer|contributing]].

There are many exciting possibilities for an open, free flight sim. We hope that this project will be interesting and useful to many people in many areas.

'''FlightGear''' comes with a set of illustrated documentation, notably
"The Manual", which is available as
[http://www.flightgear.org/Docs/getstart/getstart.pdf PDF] and
[http://www.flightgear.org/Docs/getstart/getstart.html HTML]. If you
prefer to follow the 'bleeding edge' set of FlightGear instructions,
then the following articles are likely to make you happy. You will
notice that parts of this Wiki duplicate information that's already
present in "The Manual".

{|cellspacing="10"
| width="50%"|
== User Documentation ==

=== Getting Started ===
* [[ New to FlightGear ]]
* [[ Why FlightGear ]]
* [[ Features ]]
* [[ FAQ ]]
* [[ Hardware Recommendations ]]
* [[ Recommended Software ]]
* [[ Troubleshooting Problems ]]
* [[ Volunteer ]]
* [[ Real Life Experience ]]

=== Configuring Flightgear ===
* [[ Command Line Parameters ]]
* [[ Installing Scenery ]]
* [[ Improving Framerates ]]
* [[ Multiplayer Howto ]]
* [[ Linux software audio mixing with FlightGear ]]

=== Using Flightgear ===
* [[Aircraft]]
* [[ Suggested Flights ]]
* [[ Starting in the Air ]]
* [[ Instant Replay ]]
* [[ Preset Properties ]]
* [[ Realism ]]

=== Interactive Scenarios ===
* [[ Carrier Howto ]]
* [[ Air-Air Refueling Howto ]]
* [[ AI Systems ]]
* [[ Soaring ]]

=== Flying Resources ===
* [[ Definitions Acronyms ]]
* [[ Getting IFR Charts ]]
* [[ Understanding Altitude ]]
* [[ Understanding Navigation ]]
* [[ Understanding Propeller Torque and P-Factor ]]
* [[ Understanding Aerodynamics ]]
* [[ Communications ]]
* [[ Weather ]]
* [[ Avionics and Instruments ]]
* [http://www.wingfiles.com/ Everything you need ]

| width="50%" valign="top" |
== Developer Documentation ==

=== Compiling ===
* [[ Building Flightgear ]]
* [[ Building Terragear ]]
* [[ OpenSceneGraph ]]

=== Contributing ===
* [[ Submitting Patches ]]
* [[ Code Cleanup ]]
* [[ Development Resources ]]
* [[ Extension Support ]]
* [[ Technical Reports ]]

=== Code Internals ===
* [[ Property Tree ]]
* [[ Subsystems ]]
* [[ Commands ]]
* [[ FDM API ]]
* [[ Nasal scripting language ]]
* [[ File Formats ]]

=== Modeling ===
* [[ Modeling - Getting Started ]]
* [[ Model Import and Export ]]
* [[ Modeling Resources ]]
* [[ Aircraft Information Resources ]]
* [[ Blender Ground Signs Tutorial]]
* [[ Normals and Transparency Tutorial ]]

=== Todo ===
* [[ Long Term Goals ]]
* [[ Bugs ]]
* [[ FGFS Todo ]]
* [[:Category:Aircraft TODO]]
* [[ Feature Requests / Proposals / Ideas ]]

=== Miscellaneous ===
* [[ Glass Cockpit Projects ]]
* [[ Tutorial Resources ]]
* [[ Copyright Inquiry ]]
* [http://www.cafepress.com/fgfs_gear FlightGear - Gear]
* [[Resources]]
* [[ Sign Specification Proposal ]]
* [[ Temporary discussion about a YASim patch ]]
|}