Howto:Understand console output
Errors can appear in various locations, but the most common one is the console (a black window), which pops up when you run fgfs.exe.
Errors with known solutions
Airports/.... ... Done
Base package check failed ... Found version [none] at: ...
Please upgrade to version:
- FlightGear was unable to find the $FG_ROOT directory. Set it using the --fg-root= commandline option.
- When using CVS with binaries, the data must match the binary. You cannot use data from a different date than the binary's release date.
condition: comparison without property or value
A condition (like <less-than> or <equals>) exists, without either:
- a property to check
- a value to check the property against
Could not find at least one of the following objects for animation:
This means that FlightGear is unable to find an object in a .ac file. Check the .xml file (where the animation is stored) to see if the object-names match those in the .ac file. If you are not the aircraft's author you can safely ignore such warnings.
creating 3D noise texture... DONE
Tells you that a new noise texture is created. It is not an error and can be ignored.
Error: [Screen #0] GraphicsWindowWin32::setPixelFormat() - No matching pixel format found based on traits specified=
Try changing the BPP value of your FlightGear setup. If that does not work, your graphics card is probably not able to run FlightGear 1.9 and higher. Another graphics card, or an older FlightGear version will likely "fix" the problem.
Error: bind() failed in make_server_socket()
When using multiplayer or socket input, this usually means you specified an invalid ip address or the port is in use. Note: for multiplayer, you don't need to use the --multiplay=in,... option at all, FlightGear (since version 1.0) figures out the proper setting automatically. Only use when you know what you are doing.
Error Building Technique: findAttr: could not find attribute bool
Make sure that your data and source (or binary) match. They must be from the same date, to provide the best performance.
Error: connect() failed in make_client_socket()
SG_IO_OUT socket creation failed
Your computer is not connected with the internet.
Error: RenderTexture requires the following unsupported OpenGL extensions...
Your graphics card doesn't support some graphics feature that FG requires. Update your drivers, change the BPP value and/or try disabling some of the visual goodies like 3D Clouds.
Failed to find .... in apt.dat.gz
You need to edit ATC/default.tower and ATC/default.atis. You can open these files with any text editor. Either remove or fix the entries containing your airports ICAO code (like KSFO).
Failed to open file ...
Fatal error: mismatched tag ...
In some .xml file, an opening tag (like <sim>) does not match its closing tag (like </sim>). This error is hard to track down, best method is to comment (place code between <!-- and -->) most of the aircraft. Then uncomment code one by one, until the error appears again.
Fatal error: name must begin with alpha or '_'
This error comes up when a property should be formed of which the name does not start with a letter of the alphabet or _. If this error only happens with certain planes, contact their authors.
Fatal error: unclosed token
A token (<!-- -->) has been started, but not closes. Add --> at the correct line.
FGMultiplayMgr::MP_ProcessData: No such file or directory
This is telling you that there's someone online on the multiplayerserver, using a plane that you do not have installed on your own system. In order to remove the error (and see the other plane) you have to install the plane that the other pilot is using.
FGMultiplayMgr - No receiver port, Multiplayermode disabled
FlightGear multiplayer has not been set.
FGPropertyManager::GetNode() No node found for ...
In component: ... unknown property ... referenced. Aborting
FlightGear found a reference in the FDM to a non-existing property.
FGPropertyManager::GetNode() No node found for ...
The property ... is undefined.
FlightGear found a reference in the FDM to a non-existing property. Keep in mind that JSBSim reads the FDM from top to bottom. Properties should always be created before they are needed somewhere.
Fgtzfile_read(): : Invalid argument
Fatal error: Timezone reading failed
This one is caused by wrong line ending in a timezone file. Solution might be to download the Timezone/time.tab file manually from Gitorious (Right mouseclick > Save target as) and overwrite the file in $FG_ROOT/Timezone/time.tab with it.
Found unexpected subsystem: system exiting. JSBSim failed to load aircraft and/or engine model
You are probably trying to run an aircraft on a out-of-date version of FlightGear. The planes on the official download page are intended to be used with the latest version of FlightGear. Usage on any older systems may not work.
freeglut (fgfs): Unable to create direct context rendering for window 'FlightGear'
This may hurt performance
This reports that you do not have proper hardware accelerated 3D (direct rendering) configured.
Gate ... doesn't seem to have routes associated with it
A startup location in the groundnetwork is not (properly) connected to a taxi route. Contact the airport author, or import the network to TaxiDraw and run the Verify network command to find the corrupted gate.
glLinkProgram "" Failed
Update your drivers; they have to support atleast OpenGL 2.0 for FlightGear 2.0 and later.
loading scenario '...'
This is not an error. It shows that an AI scenario is loaded.
Model not found: ...
This one tells you that FlightGear was unable to find a certain file. The nice thing is that it also tells you excactly what file.
- Check if the file really does not exist at your computer.
- Try to locate the file in which the missing file is referenced. This is likely to be -set.xml in the root directory of the loaded aircraft. Between the <model> tags, the base model file is referenced. This file references to all other models that are displayed with the aircraft.
- Contact the aircraft author with a detailed bug-report, in which you state the excact location of the missing file and (if you found it) the file in which it is referenced.
Nasal runtime error: nil used in numeric context
This error is Nasal triggered by a Nasal file (the console should show what file (and line) and from where it was referenced). The Nasal script tried to do something with a property with an empty value. A solution is to fill the property before the Nasal is loaded. This can be done by setting the property in an aircraft's -set.xml file or by adding a listener to the script.
Near camera not rendering
If you screen looks like the image above; make sure you have at least OSG version 2.7.6.
No render bin name specified in render bin section
Update SimGear (or binary) and your data directory.
No render bin number specified in render bin section
Update SimGear (or binary) and your data directory.
... not a valid win32 application
This Windows error could have various reasons to pop up. Usually, the file that is causing troubles is mentioned. Re-installing this file might solve the problem.
OBJECT_SIGN: unsupported glyph `.'
Check the OBJECT_SIGN lines in the .stg file of the tile that was loaded when this error showed up.
OpenAL error <AL_INVALID_VALUE>: bind source <alGenSources>
Failed to generate audio source.
This error is probably displayed because of some misdirected audio settings in the aircrafts setup. Check the -sound.xml file of the aircraft and see if all files refered to really exist. If not, try to contact the author of the plane, so he can fix the problem in the CVS version or solve the problem yourself and let someone commit the patch.
OpenAL error (AL_INVALID_VALUE): constructor (alBufferData)
Fatal error: Failed to buffer data.
Disabling sound is a temporarily solution for this problem.
osgDB ac3d reader: could not find texture...
osgDB ac3d reader: detected surface with less than 3 vertices!
In one of the loaded models a non-existing surface is found. This can be a single line (sometimes used to simulate thin wires) or a fault in the model.
Program's vertex attrib binding ..., usrAttr...
Tells you that an effect binded certain attributes to a shader.
(Q)NAN stands for (Quiet) Not A Number, produced by 0/0 or other floating point break downs. There can be various causes for this:
This means a texture, whether in the scenery on your aircraft or anyone elses (when multiplayer is enabled), is not sized to powers of two. All textures in FlightGear have to be sized to power of two (eg. 16*16, 32*64, 32*1024). As of version 1.9 textures are resized automaticly, but it does slow your computer down, so it's better to resize the noted textures.
ssgInit called without a valid OpenGL context
In short, your GL libraries are broken. So far only Red Hat 7.x users have experienced this (see http://www.redhat.com/bugzilla/show_bug.cgi?id=18867). The only solutions are possibly complicated ones: you can either change distributions (most of us prefer Debian) or upgrade/downgrade your Mesa libs.
The system cannot find the file specified
If you are running Windows Vista; start by looking in C:\Users\Owner\AppData\Local\VirtualStore and seeing if you have a folder called FlightGear in there. If you do, cut-and-paste (merge) that one with C:\Program Files\Flightgear and try to launch FlightGear again.
Hint: you may need to go under Tools and Folder Options to specify "Show Hidden/System Files and Folders" in order for AppData to be visible.
Time zone reading failed
This is probably caused by a line-ending problem in the timezone files. Win32 users can resolve the problem by downloading a DOS to UNIX conversion utility available at http://www.nottingham.ac.uk/~eazdluf/d2u.zip. Run as `d2u *.tab` from within the timezone directory to fix your timezone files
Traffic manager could not find airport
There is either an airport missing from apt.dat, or there is a wrong ICAO code in a traffic file. An airport missing from apt.dat could be due to a recent opening.
Unable to choose requested pixel format
Error should be solved as of version 1.9. If not, try changing your BPP and/or resolution.
Unable to find airport details for .... in FGTower::Init()
The error appears when an airport in $FG_ROOT/Airports/apt.dat.gz cannot be found in $FG_ROOT/ATC/default.tower and $FG_ROOT/ATC/default.atis. Renaming the airports in the apt.dat.gz file ór in both default ATC files will fix the problem.
Unable to open aircraft directory
The aircraft that you are trying to run most likely relies on another aircraft, which you did not install (yet). The error shows what aircraft, so go download that one!
Unexpected tag '...' found in YASim aircraft description
FlightGear found a non-existing tag in the FDM of the aircraft you are trying to launch. If you have not changed the original aircraft, contact the aircraft author. Else, check the FDM througly for mistakes.
Unknown ... aircraft: ... defaulting to C172
FlightGear is unable to load the forced FDM (set through --fdm=... or via Advanced > Flight Model in FGRun) for this aircraft. FlightGear automatically picks the right FDM for each aircraft, so there is no need to set it manually, unless you know what you are doing. In the Flight Model dialog of FGRun, set the FDM to jsb; that is the "auto setting".
Unknown exception to the main loop. Aborting...
Possible cause: No such file or directory
This error could have a variety of sources, among them missing files but also other things. Increasing the log level to debug and repeating excactly what you did when the error came up, might provide some more information on what FlightGear was doing when the error occurred.
- Setting your BPP to a lower value might work.
- Changing the resolution to a smaller one might work as well.
WARNING: Couldn't convert texture...
You are trying to run an aircraft not compatible with your FlightGear version. Most of the time, this error appears when you fly an aircraft, textured with .png files on versions older than 1.9. Convert the textures manually to .rgb or upgrade your FlightGear version.
Warning: Picked up TriangleIntersect
Reduce your Log Level to alert. Or send the fgfs output to /dev/null (unix systems) or 2>nul (Windows). The errors might still be shown, but do not affect the sim anymore.
Warning: TangentSpaceGenerator: unknown primitive mode 9
This is an OSG error, showing up when an effect needs tangent vectors, but polygons are not support. The error itself can be ignored, altough some shaders may look wrong. Shader developers should try to minimise the use of polygons and use triangles and quads instead.
YASim SOLUTION FAILURE: Solution failed to converge after 10000 iterations
YASim SOLUTION FAILURE:
Zero length fuselage
There is a problem in the FDM. A fuselage section with similar ax and ay was created. Change the ax and/or ay values to match the aircraft.
FGMultiplayerMgr::Open - Failed to bind receive socket
This means FlightGear was unable to open the listening network socket required by the --multiplay=in option. Frequently this option can be omitted and FlightGear will figure out the necessary parameters automatically. Common reasons are:
- Address given in the option does not resolve to one of the IP addresses of the local machine. This parameter should only be required if you want to fine-tune the network behavior. Omitting it directs FlightGear to listen on all local interfaces automatically. Example:
Notice that you still need the comma.
- The UDP port given in the option (or the default port 5000 if no option given) is already in use. Verify nothing is using the port.
Errors without known solutions
Please take a look at the upcoming errors and see if you know a solution to get rid of them. Your additions are greatly appreciated!
AL Error (fx): Invalid Value at pitch and gain
AL Error (sound manager): Invalid Operation at update
AL Error (sound manager): Invalid Value at buffer add data
No such buffer!
Failed to execute command nasal
Failed to tie property ... to object methods
A JSBSim error.
FGMultiplayMgr::MP_ProcessData - message from ... has invalid length!
FGMultiplayMgr::MP_ProcessData: Result too large
GPS: malformed route, index=1
Mesa 7.3 implementation error: bad texture level in r300UploadSubImage
Nasal runtime error: stack overflow
No image file for texture, using white
A shader error
No path in /sim/sound/path
OBJECT_SIGN: unexpected } in sign contents
OpenAL error (AL_ILLEGAL_COMMAND): set_source_pos
OpenAL error (AL_ILLEGAL_COMMAND): set_volume
PT_vs_hpt: ran out of layers
This is issued from the atmosphere implementation in FlightGear's environment system. A comment in the code says: "should never get here". Please provide input when this happens: excessive altitudes? Negative altitudes?
Warning: detected OpenGL error 'invalid value' after RenderBin::draw(,)
This warning is generated from OSG. Set your environment variable
Warning: GraphicsWindowWin32::grabFocus() - Failed grabbing the focus
WARNING: PUI: Too many live puInterfaces open at once!
Appears when printing large outputs (very) frequently on the screen.