Howto:Understand console output: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
No edit summary
(45 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{See also|Howto:Showing the FlightGear console on Windows}}
{{Troubleshooting}}
This document lists '''[[FlightGear]] errors''', how to get rid of them and other '''console output'''. If FlightGear quits but does not give you any error, try increasing the [[FlightGear Launch Control#Debugging|Log Level]].
This document lists '''[[FlightGear]] errors''', how to get rid of them and other '''console output'''. If FlightGear quits but does not give you any error, try increasing the [[FlightGear Launch Control#Debugging|Log Level]].


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 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==
== Errors with known solutions ==
===Airports/.... ... Done===
=== Aircraft uses deprecated node egt_degf. Please upgrade to egt-degf ===
This is not an error. The message lets us know that [[TerraSync]] is updating the <tt>[[$FG_SCENERY]]/Airports</tt> directory.
The aircraft should be updated to make use of the renamed egt-degf property but it will still work as expected. You could contact the aircraft's author but he/she is probably already aware of this.
 
=== Airports/.... ... Done ===
This is not an error. The message lets us know that [[TerraSync]] is updating the <tt>[[$FG SCENERY]]/Airports</tt> directory.
 
=== bad/missing argument to <function()>: ===
This error indicates that an argument the function is either the wrong type or does not exist.  It is accompanied by a line showing the location.  For instance, executing the below snippet in the [[Nasal Console]] will throw the error blow the snippet.
<syntaxhighlight lang="nasal">
var hash = {
element: "value"
};
append(hash, "string", 12, 5.67); # you can only append() to a vector
</syntaxhighlight>
 
<syntaxhighlight>
bad/missing argument to append():
at <nasal-console/#1>, line 4
</syntaxhighlight>


===Base package check failed ... Found version [none] at: ...<br>Please upgrade to version:===
=== Bad operation output detected in configuration file ===
* FlightGear was unable to find the [[$FG_ROOT]] directory. Set it using the <tt>--fg-root=</tt> commandline option.
[[JSBSim]] reports that a <output> tag is incorrectly placed in the aircraft's FDM. When used in a <fcs_function>, it should be outside the innter <function> tags, so like:
* 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.
<syntaxhighlight>
<fcs_function name="Flap Cmd Deg">
<function>
<product>
  <property>fcs/flap-cmd-norm</property>
  <value>30</value>
</product>
</function>
<output>fcs/flap-cmd-deg1</output>
</fcs_function>
</syntaxhighlight>


===condition: comparison without property[1] or value===
=== Base package check failed ... Found version ... at: ...<br />Please upgrade to version: ===
When using [[Git]], the data must match the binary or compilation. You cannot use data from a different date than the binary's release date.
 
=== Base package check failed ... Found version [none] at: ...<br />Please upgrade to version: ===
FlightGear was unable to find the [[$FG ROOT]] directory. Set it using the <tt>--fg-root=</tt> commandline option.
 
=== Cannot find specified aircraft ===
Shows up when you use an incorrect aircraft name in the --aircraft=... command. Check the correct name by running --show-aircraft, or by looking at the aircraft's -set.xml file (eg. <tt>--aircraft=737-300</tt> for <tt>737-300-set.xml</tt>).
 
=== condition: comparison without property[1] or value ===
A condition (like <tt><less-than></tt> or <tt><equals></tt>) exists, without either:
A condition (like <tt><less-than></tt> or <tt><equals></tt>) exists, without either:
* a property to check
* a property to check
* a value to check the property against
* a value to check the property against


===Could not find at least one of the following objects for animation:===
=== 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.
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. Also in the .xml file make sure that there are not spaces at the beginning or end of the object name. If you are not the aircraft's author you can safely ignore such warnings.


===creating 3D noise texture... DONE===
=== creating 3D noise texture... DONE ===
Tells you that a new noise texture is created. It is not an error and can be ignored.
Tells you that a new noise texture is created. It is not an error and can be ignored.


Line 25: Line 64:
Try changing the [[FlightGear Launch Control#Page Four - Options and Run|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.
Try changing the [[FlightGear Launch Control#Page Four - Options and Run|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()===
=== Error: bind() failed in make_server_socket() ===
When using [[Howto: Multiplayer|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.
When using [[Howto: Multiplayer|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===
=== 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.
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()<br>SG_IO_OUT socket creation failed===
=== Error: connect() failed in make_client_socket()<br />SG_IO_OUT socket creation failed ===
Your computer is not connected with the internet.
Your computer is not connected with the internet, while a certain enabled feature (eg. multiplayer) does require an internet connection.


===Error: RenderTexture requires the following unsupported OpenGL extensions...===
=== 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]].
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===
=== 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).
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 locate aircraft carrier = ...===
===Failed to locate aircraft carrier = ...===
FlightGear is unable to find a [[Aircraft carrier|carrier]] under the set name. Check your commandline (<tt>--carrier=...</tt>) or the [[FlightGear Launch Control#Page Three - Airport Selection|airport page]] of the launcher.
FlightGear is unable to find a [[Aircraft carrier|carrier]] under the set name. Check your commandline (<tt>--carrier=...</tt>) or the [[FlightGear Launch Control#Page Three - Airport Selection|airport page]] of the launcher. Note that you might need to enable a scenario in combination with a --carrier= command.


===Failed to open file ...===
'''Hint''' Make sure your park position and carrier name is correct. See the [[Howto: Carrier|wiki's carrier page]] for details.
Check if the file exists on your system. If the missing file is a scenery object; be sure you have the latest [http://scenemodels.flightgear.org/download/SharedModels.tgz Shared Models] from the [[FlightGear Scenery Database]].


===Fatal error: mismatched tag ...===
=== Failed to open file ... ===
Check if the file exists on your system. If the missing file is a scenery object; be sure you have the latest [https://sourceforge.net/projects/flightgear/files/scenery/SharedModels.tgz/download Shared Models] from the [[FlightGear Scenery Database]].
 
=== Fatal error: illegal character after . or .. ===
Some .xml file contains a fault. Possible solutions:
* To refer to a top-level property in the tree, <tt>../</tt> should be used instead of <tt>.../</tt>
 
=== Fatal error: mismatched tag ... ===
In some .xml file, an opening tag (like <tt><sim></tt>) does not match its closing tag (like <tt></sim></tt>). This error is hard to track down, best method is to comment (place code between <nowiki><!-- and --></nowiki>) most of the aircraft. Then uncomment code one by one, until the error appears again.
In some .xml file, an opening tag (like <tt><sim></tt>) does not match its closing tag (like <tt></sim></tt>). This error is hard to track down, best method is to comment (place code between <nowiki><!-- and --></nowiki>) most of the aircraft. Then uncomment code one by one, until the error appears again.


===Fatal error: name must begin with alpha or '_'===
'''Hint for Developers:''' Pre-test all your .xml files in Windows by opening them with Internet Explorer (usually by double clicking). IE can tell you if a tag is mis-matched and which tag is mis-matched. You'll probably know there's a problem if IE displays an error message.
 
=== 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.
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===
=== Failed to tie property fcs/ to object methods ===
This [[JSBSim]] error comes up when there are unnamed components (eg. switches) in the FDM of an aircraft. Components must have unique names, from which properties will be created. As long as you are not overwriting an existing property, the <tt>name="..."</tt> can be used to output the components result to a property.
 
=== Fatal error: unclosed token ===
A token (<nowiki><!-- --></nowiki>) has been started, but not closes. Add <nowiki>--></nowiki> at the correct line.
A token (<nowiki><!-- --></nowiki>) has been started, but not closes. Add <nowiki>--></nowiki> at the correct line.


===FGMultiplayMgr::MP_ProcessData: No such file or directory===
'''Hint for Developers:''' Pre-test all your .xml files in Windows by opening them with Internet Explorer (usually by double clicking). IE can tell you if a comment/token is not closed.
 
=== 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:
--multiplay=in,10,,5001
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.
 
=== 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.
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===
=== FGMultiplayMgr - No receiver port, Multiplayermode disabled ===
FlightGear [[Howto: Multiplayer|multiplayer]] has not been set.
FlightGear [[Howto: Multiplayer|multiplayer]] has not been set.


===FGPropertyManager::GetNode() No node found for ...<br> In component: ... unknown property ... referenced. Aborting===
=== FGPropertyManager::GetNode() No node found for ...<br /> In component: ... unknown property ... referenced. Aborting ===
FlightGear found a reference in the [[FDM]] to a non-existing property.
FlightGear found a reference in the [[FDM]] to a non-existing property.


===FGPropertyManager::GetNode() No node found for ...<br> The property ... is undefined.===
=== FGPropertyManager::GetNode() No node found for ...<br /> 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.
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<br>Fatal error: Timezone reading failed===
=== Fgtzfile_read(): : Invalid argument<br />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 [http://gitorious.org/fg/fgdata/blobs/raw/master/Timezone/zone.tab Gitorious] (Right mouseclick > Save target as) and overwrite the file in <tt>[[$FG_ROOT]]/Timezone/time.tab</tt> with it.
This one is caused by wrong line ending in a timezone file. Solution might be to download the Timezone/time.tab file manually from {{fgdata source|path=Timezone/zone.tab}} (Right mouseclick > Save target as) and overwrite the file in <tt>[[$FG ROOT]]/Timezone/time.tab</tt> with it.


===Found unexpected subsystem: system exiting. JSBSim failed to load aircraft and/or engine model===
=== 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.
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'<br>This may hurt performance===
=== freeglut (fgfs): Unable to create direct context rendering for window 'FlightGear'<br />This may hurt performance ===
This reports that you do not have proper hardware accelerated 3D (direct rendering) configured.
This reports that you do not have proper hardware accelerated 3D (direct rendering) configured.


===Gate ... doesn't seem to have routes associated with it===
=== Gate ... doesn't seem to have routes associated with it ===
A startup location in the [[Interactive Traffic#Ground networks|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.
A startup location in the [[Interactive Traffic#Ground networks|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===
=== glLinkProgram "" Failed ===
Update your drivers; they have to support atleast OpenGL 2.0 for FlightGear 2.0 and later.
Update your drivers; they have to support atleast OpenGL 2.0 for FlightGear 2.0 and later.


===loading scenario '...'===
=== loading scenario '...' ===
This is not an error. It shows that an [[AI Systems#AI Models|AI scenario]] is loaded.
This is not an error. It shows that an [[AI Systems#AI Models|AI scenario]] is loaded.


===Model not found: ...===
=== 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.  
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.  


Line 92: Line 152:
# 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.
# 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===
=== Multiplayer packet truncated ===
2016.1.2: messages that start with "Multiplayer packet truncated" need to be fixed by the model developer, usually by reducing the sie of transmitted strings. Remember that strings take 4bytes per character and therefore should be used sparingly to reduce packet size.<ref>{{cite web
  |url    =  https://sourceforge.net/p/flightgear/mailman/message/35082283/
  |title  =  <nowiki> Re: [Flightgear-devel] dual-control-tools and the limit on packet
size </nowiki>
  |author =  <nowiki> Richard Harrison </nowiki>
  |date  =  May 12th, 2016
  |added  =  May 12th, 2016
  |script_version = 0.40
  }}</ref>
 
=== 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 Tree|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 <tt>-set.xml</tt> file or by adding a [[Nasal scripting language#Listeners and Signals|listener]] to the script.  
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 Tree|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 <tt>-set.xml</tt> file or by adding a [[Nasal scripting language#Listeners and Signals|listener]] to the script.  


[[Howto: Contact the developers|Contact the developers]] if this error is shown for a <tt>[[$FG_ROOT]]/Nasal/</tt> script.
[[Howto: Contact the developers|Contact the developers]] if this error is shown for a <tt>[[$FG ROOT]]/Nasal/</tt> script.


===Near camera not rendering===
=== NavCache: init failed:Sqlite error:Sqlite API abuse (attempt 0) ===
[[Image:Near_camera_off.png|500px]]
If you are using non-English characters, your [[$FG_HOME]] path may need to be temporally changed:
# Create a new empty folder such as C:\temp. Don't include non-English strings in the path.
# At the last page of the Flightgear launcher (FGRun), click the [Advanced...] button, select Environment, click [New] button, enter <code>FG_HOME=c:\temp</code> in the field and click [OK].
 
=== Near camera not rendering ===
[[File:Near_camera_off.png|500px]]


If you screen looks like the image above; make sure you have at least [[OSG]] version 2.7.6.
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===
=== No render bin name specified in render bin section ===
Update [[SimGear]] (or binary) and your data directory.
Update [[SimGear]] (or binary) and your data directory.


===No render bin number specified in render bin section===
=== No render bin number specified in render bin section ===
Update [[SimGear]] (or binary) and your data directory.
Update [[SimGear]] (or binary) and your data directory.


===... not a valid win32 application===
=== ... 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.
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 `.'===
=== OBJECT_SIGN: unexpected } in sign contents ===
One of the OBJECT_SIGN lines in the .stg file (of the tile that was loaded when this error showed up) contains a fault. Note that <tt>}</tt> must be preceded by a <tt>{</tt> character.
 
=== OBJECT_SIGN: unsupported glyph `.' ===
Check the OBJECT_SIGN lines in the .stg file of the tile that was loaded when this error showed up.
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><br>Failed to generate audio source.===
=== OpenAL error <AL_INVALID_VALUE>: bind source <alGenSources><br />Failed to generate audio source. ===
This error is probably displayed because of some misdirected audio settings in the [[aircraft]]s 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 [[FlightGear CVS|CVS]] version or solve the problem yourself and let someone commit the patch.
This error is probably displayed because of some misdirected audio settings in the [[aircraft]]s 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 [[Git]] version or solve the problem yourself and let someone commit the patch.


===OpenAL error (AL_INVALID_VALUE): constructor (alBufferData)<br>Fatal error: Failed to buffer data.===
=== OpenAL error (AL_INVALID_VALUE): constructor (alBufferData)<br />Fatal error: Failed to buffer data. ===
Disabling sound is a temporarily solution for this problem.
Disabling sound is a temporarily solution for this problem.


===osgDB ac3d reader: could not find texture...===
=== osgDB ac3d reader: could not find texture... ===
See [[#Failed to open file ...|Failed to open file ...]]
See [[#Failed to open file ...|Failed to open file ...]]


===osgDB ac3d reader: detected surface with less than 3 vertices!===
=== 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.
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...===
=== Program's vertex attrib binding ..., usrAttr... ===
Tells you that an effect binded certain attributes to a [[Shaders|shader]].
Tells you that an effect binded certain attributes to a [[Shaders|shader]].


===QNAN===
=== QNAN ===
(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:
(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:
* Using a "flap start" value of 0 in the [[YASim]] [[FDM]]. Use some small value like 0.001 instead.
* Using a "flap start" value of 0 in the [[YASim]] [[FDM]]. Use some small value like 0.001 instead.


===Scaling image...===
=== Scaling image... ===
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.
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===
=== 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.
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===
=== The system cannot find the file specified ===
If you are running Windows Vista; start by looking in <tt>C:\Users\Owner\AppData\Local\VirtualStore</tt> and seeing if you have a folder called FlightGear in there. If you do, cut-and-paste (merge) that one with <tt>C:\Program Files\Flightgear</tt> and try to launch FlightGear again.
* If you are running Windows Vista; start by looking in <tt>C:\Users\Owner\AppData\Local\VirtualStore</tt> and seeing if you have a folder called FlightGear in there. If you do, cut-and-paste (merge) that one with <tt>C:\Program Files\Flightgear</tt> and try to launch FlightGear again.<br /><br />'''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.
* Make sure you did set the right executable (<tt>fgfs.exe</tt>) on the first page of the [[FlightGear Launch Control]].


'''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 ===
 
===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
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===
=== Traffic manager could not find airport ===
There is either an airport missing from apt.dat, or there is a wrong ICAO code in a [[Interactive Traffic#Building Traffic Files|traffic file]]. An airport missing from apt.dat could be due to a recent opening.
There is either an airport missing from apt.dat, or there is a wrong ICAO code in a [[Interactive Traffic#Building Traffic Files|traffic file]]. An airport missing from apt.dat could be due to a recent opening.


===Unable to choose requested pixel format===
=== Unable to choose requested pixel format ===
Error should be solved as of version 1.9. If not, try changing your [[FlightGear Launch Control#Page Four - Options and Run|BPP]] and/or resolution.
Error should be solved as of version 1.9. If not, try changing your [[FlightGear Launch Control#Page Four - Options and Run|BPP]] and/or resolution.


===Unable to find airport details for .... in FGTower::Init()===
=== Unable to find airport details for .... in FGTower::Init() ===
This error can be surpressed by disabling [[Interactive Traffic|AI Traffic]], via the AI/ATC [[menu]].
This error can be surpressed by disabling [[Interactive Traffic|AI Traffic]], via the AI/ATC [[menu]].


The error appears when an airport in <tt>[[$FG_ROOT]]/Airports/apt.dat.gz</tt> cannot be found in <tt>[[$FG_ROOT]]/ATC/default.tower</tt> and <tt>[[$FG_ROOT]]/ATC/default.atis</tt>. Renaming the airports in the apt.dat.gz file ór in both default ATC files will fix the problem.
The error appears when an airport in <tt>[[$FG ROOT]]/Airports/apt.dat.gz</tt> cannot be found in <tt>[[$FG ROOT]]/ATC/default.tower</tt> and <tt>[[$FG ROOT]]/ATC/default.atis</tt>. Renaming the airports in the apt.dat.gz file ór in both default ATC files will fix the problem.


===Unable to open aircraft directory===
=== 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!
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===
=== 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.
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.


Line 170: Line 248:
FlightGear is unable to load the forced [[FDM]] (set through <tt>--fdm=...</tt> or via <tt>Advanced > Flight Model</tt> 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 <tt>jsb</tt>; that is the "auto setting".
FlightGear is unable to load the forced [[FDM]] (set through <tt>--fdm=...</tt> or via <tt>Advanced > Flight Model</tt> 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 <tt>jsb</tt>; that is the "auto setting".


===Unknown exception to the main loop. Aborting... <br>Possible cause: No such file or directory===
=== Unknown exception to the main loop. Aborting... <br />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 [[FlightGear_Launch_Control#Debugging|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.
This error could have a variety of sources, among them missing files but also other things. Increasing the [[FlightGear Launch Control#Debugging|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 [[FlightGear Launch Control#Page Four - Options and Run|BPP]] to a lower value might work.
* Setting your [[FlightGear Launch Control#Page Four - Options and Run|BPP]] to a lower value might work.
* Changing the resolution to a smaller one might work as well.
* Changing the resolution to a smaller one might work as well.


===WARNING: Couldn't convert texture...===
=== Unknown exception in main loop. Aborting...<br/>Possible cause: Not enough space ===
* When running 64 bits Windows, make sure to uncheck the "force 32-bits" option on installation.
* Most notebooks that run Windows 7 have the so called Optimus Technology (NVidia) or Hybrid Graphics technology (ATI) onboard. This is meant to increase battery life, by automatically switching of the powerfull graphics card when it's not needed. However, FlightGear needs it all the time, even if Optimus says it doesn't! See [[Troubleshooting performance issues#Operating system and driver setup|here]] for instructions on how to disable this behaviour.
 
When the above mentioned points do not apply or did not work, you are likely to be unable to run FlightGear at the current graphics settings. See [[Troubleshooting performance issues]] for instructions on how to switch off demanding eye candy.
 
Apart from the above mentioned stuff, it may be useful to install the latest drivers for your graphics card:
* If you have a Nvidia GPU, then visit [[Troubleshooting performance issues]].
* For ATI line of video cards, look at this site: http://www.amd.com/us/products/technologies/amd-catalyst/pages/catalyst.aspx .You should find a file named "Catalyst control center", which allow you to modify the behaviour of your GPU with flightgear. I mean the Antialiasing control, the triple buffering, etc.
 
=== 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.
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: Could not find plugin to read objects from file ...===
=== Warning: Could not find plugin to read objects from file ... ===
A library is missing from your computer. Therefore, certain fileformats cannot be read. Try to reinstall/update [[OSG]], as the libraries used by FlightGear should be part of the standard package.
A library is missing from your computer. Therefore, certain fileformats cannot be read. Try to reinstall/update [[OSG]], as the libraries used by FlightGear should be part of the standard package.


===Warning: Picked up TriangleIntersect===
=== Warning: Picked up TriangleIntersect ===
Reduce your [[FlightGear Launch Control#Debugging|Log Level]] to alert. Or [[Showstoppers|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.
Reduce your [[FlightGear Launch Control#Debugging|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===
=== 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.
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: Solution failed to converge after 10000 iterations ===
Some control in the [[YASim]] [[FDM]] is too weak, according to YASim, to control the aircraft. An effectiveness tag will be required in the FDM to solve this error.
Some control in the [[YASim]] [[FDM]] is too weak, according to YASim, to control the aircraft. An effectiveness tag will be required in the FDM to solve this error.


===YASim SOLUTION FAILURE:<br>Zero length fuselage===
=== YASim SOLUTION FAILURE:<br />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.
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===
=== YOU HAVE AN INCOMPATIBLE CFG FILE FOR THIS AIRCRAFT. RESULTS WILL BE UNPREDICTABLE !! ===
Make sure the [[JSBSim]] [[FDM]] of the aircraft has a <code><fdm_config version="2.0"</code> tag.


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.
== Errors without known solutions ==
Common reasons are:
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!
* 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:
--multiplay=in,10,,5001
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==
=== Aircraft propulsion element has problems in file ... ===
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 (fx): Invalid Value at pitch and gain ===
The sound effect's pitch (high or low) and gain (volume multiplication factor) values are not valid.


===AL Error (sound manager): Invalid Operation at update===
=== AL Error (sound manager): Invalid Operation at update ===


===AL Error (sound manager): Invalid Value at buffer add data<br>No such buffer!===
=== AL Error (sound manager): Invalid Value at buffer add data<br />No such buffer! ===


===Failed to execute command nasal===
=== Failed to execute command nasal ===
Has something to do with the [[Nasal]] scripting language used by FlightGear.


===Failed to tie property ... to object methods===
=== Failed to tie (or untie while closing) property ... to object methods ===
A JSBSim error.
A JSBSim error.


===FGMultiplayMgr::MP_ProcessData - message from ... has invalid length!===
=== FGMultiplayMgr::MP_ProcessData - message from ... has invalid length! ===


===FGMultiplayMgr::MP_ProcessData: Result too large===
=== FGMultiplayMgr::MP_ProcessData: Result too large ===


===GPS: malformed route, index=1===
===GPS: malformed route, index=1===


===Mesa 7.3 implementation error: bad texture level in r300UploadSubImage===
=== Mesa 7.3 implementation error: bad texture level in r300UploadSubImage ===
http://www.flightgear.org/forums/viewtopic.php?f=2&t=6706&start=0&st=0&sk=t&sd=a
http://www.flightgear.org/forums/viewtopic.php?f=2&t=6706&start=0&st=0&sk=t&sd=a


===Nasal runtime error: stack overflow===
=== Nasal runtime error: stack overflow ===


===No image file for texture, using white===
=== No image file for texture, using white ===
A [[Shaders|shader]] error
A [[Shaders|shader]] error, possibly you (or the developer) have/has not specified a texture for a surface while modeling the aircraft model in AC3D, Blender, Wings...
 
===No path in /sim/sound/path===


=== No path in /sim/sound/path ===
You (or the developer) have/has not specified a proper sound file in the aircraft's -set.xml file.
You (or the developer) have/has not specified a proper sound file in the aircraft's -set.xml file.


===OBJECT_SIGN: unexpected } in sign contents===
=== OpenAL error (AL_ILLEGAL_COMMAND): set_source_pos ===
 
===OpenAL error (AL_ILLEGAL_COMMAND): set_source_pos===


Has something to do with OpenAL not understanding where the sound comes from.
Has something to do with OpenAL not understanding where the sound comes from.


===OpenAL error (AL_ILLEGAL_COMMAND): set_volume===
=== OpenAL error (AL_ILLEGAL_COMMAND): set_volume ===


Has something to do with OpenAL not understanding the sound volume.
Has something to do with OpenAL not understanding the sound volume.


===PT_vs_hpt: ran out of layers===
=== 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?
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(,)===
=== Tried to initialize a non-existent engine! ===
The developer of the aircraft did not code the engine properly.
 
'''Developers:''' Check that the engine.xml file, FDM.xml, and -set.xml is coded properly.
 
=== Unknown Chunk: ***UNKNOWN*** (0xA08A) ===
I use Autodesk 3ds Max (.3ds) occurs when the 3D data model.
 
Solution converts the file format AC3D.
 
=== Warning: detected OpenGL error 'invalid value' after RenderBin::draw(,) ===
This warning is generated from OSG. Set your environment variable
This warning is generated from OSG. Set your environment variable
  OSG_NOTIFY_LEVEL=FATAL
  OSG_NOTIFY_LEVEL=FATAL


===Warning: GraphicsWindowWin32::grabFocus() - Failed grabbing the focus===
=== Warning: GraphicsWindowWin32::grabFocus() - Failed grabbing the focus ===
 
It seems that this happens when you have another window open and you are "focusing" (the window is active) on it. FlightGear will try to grab itself infront of the other window.
It seems that this happens when you have another window open and you are "focusing" (the window is active) on it. FlightGear will try to grab itself infront of the other window.


===WARNING: PUI: Too many live puInterfaces open at once!===
=== WARNING: PUI: Too many live puInterfaces open at once! ===
Appears when printing large outputs (very) frequently on the screen.
Appears when printing large outputs (very) frequently on the screen.


===Warning: State::drawQuads(0, 154400) too large handle in remapping to ushort glDrawElements===
=== Warning: State::drawQuads(0, 154400) too large handle in remapping to ushort glDrawElements ===
</br>
----


[[Category:Howto|Get rid of common errors]]
[[de:Howto:Konsolenausgaben verstehen]]
[[fr:Howto: Débarrassez-vous des erreurs les plus fréquentes]]
[[es:Comprendiendo la salida de la consola]]


[[fr:Howto: Débarrassez-vous des erreurs les plus fréquentes]]
[[Category:Howto|Console output]]
[[Category:Troubleshooting|Console output]]

Revision as of 07:30, 4 September 2016

This document lists FlightGear errors, how to get rid of them and other console output. If FlightGear quits but does not give you any error, try increasing the Log Level.

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

Aircraft uses deprecated node egt_degf. Please upgrade to egt-degf

The aircraft should be updated to make use of the renamed egt-degf property but it will still work as expected. You could contact the aircraft's author but he/she is probably already aware of this.

Airports/.... ... Done

This is not an error. The message lets us know that TerraSync is updating the $FG SCENERY/Airports directory.

bad/missing argument to <function()>:

This error indicates that an argument the function is either the wrong type or does not exist. It is accompanied by a line showing the location. For instance, executing the below snippet in the Nasal Console will throw the error blow the snippet.

var hash = {
 element: "value"
};
append(hash, "string", 12, 5.67); # you can only append() to a vector
bad/missing argument to append():
 at <nasal-console/#1>, line 4

Bad operation output detected in configuration file

JSBSim reports that a <output> tag is incorrectly placed in the aircraft's FDM. When used in a <fcs_function>, it should be outside the innter <function> tags, so like:

	<fcs_function name="Flap Cmd Deg">
		<function>
			<product>
				   <property>fcs/flap-cmd-norm</property>
				   <value>30</value>
			</product>
		</function>
		<output>fcs/flap-cmd-deg1</output>
	</fcs_function>

Base package check failed ... Found version ... at: ...
Please upgrade to version:

When using Git, the data must match the binary or compilation. You cannot use data from a different date than the binary's release date.

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.

Cannot find specified aircraft

Shows up when you use an incorrect aircraft name in the --aircraft=... command. Check the correct name by running --show-aircraft, or by looking at the aircraft's -set.xml file (eg. --aircraft=737-300 for 737-300-set.xml).

condition: comparison without property[1] 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. Also in the .xml file make sure that there are not spaces at the beginning or end of the object name. 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, while a certain enabled feature (eg. multiplayer) does require an internet connection.

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 locate aircraft carrier = ...

FlightGear is unable to find a carrier under the set name. Check your commandline (--carrier=...) or the airport page of the launcher. Note that you might need to enable a scenario in combination with a --carrier= command.

Hint Make sure your park position and carrier name is correct. See the wiki's carrier page for details.

Failed to open file ...

Check if the file exists on your system. If the missing file is a scenery object; be sure you have the latest Shared Models from the FlightGear Scenery Database.

Fatal error: illegal character after . or ..

Some .xml file contains a fault. Possible solutions:

  • To refer to a top-level property in the tree, ../ should be used instead of .../

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.

Hint for Developers: Pre-test all your .xml files in Windows by opening them with Internet Explorer (usually by double clicking). IE can tell you if a tag is mis-matched and which tag is mis-matched. You'll probably know there's a problem if IE displays an error message.

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.

Failed to tie property fcs/ to object methods

This JSBSim error comes up when there are unnamed components (eg. switches) in the FDM of an aircraft. Components must have unique names, from which properties will be created. As long as you are not overwriting an existing property, the name="..." can be used to output the components result to a property.

Fatal error: unclosed token

A token (<!-- -->) has been started, but not closes. Add --> at the correct line.

Hint for Developers: Pre-test all your .xml files in Windows by opening them with Internet Explorer (usually by double clicking). IE can tell you if a comment/token is not closed.

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:
--multiplay=in,10,,5001

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.

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 flightgear/fgdata/next/Timezone/zone.tab (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.

  1. Check if the file really does not exist at your computer.
  2. 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.
  3. 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.

Multiplayer packet truncated

2016.1.2: messages that start with "Multiplayer packet truncated" need to be fixed by the model developer, usually by reducing the sie of transmitted strings. Remember that strings take 4bytes per character and therefore should be used sparingly to reduce packet size.[1]

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.

Contact the developers if this error is shown for a $FG ROOT/Nasal/ script.

NavCache: init failed:Sqlite error:Sqlite API abuse (attempt 0)

If you are using non-English characters, your $FG_HOME path may need to be temporally changed:

  1. Create a new empty folder such as C:\temp. Don't include non-English strings in the path.
  2. At the last page of the Flightgear launcher (FGRun), click the [Advanced...] button, select Environment, click [New] button, enter FG_HOME=c:\temp in the field and click [OK].

Near camera not rendering

Near camera off.png

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: unexpected } in sign contents

One of the OBJECT_SIGN lines in the .stg file (of the tile that was loaded when this error showed up) contains a fault. Note that } must be preceded by a { character.

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 Git 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...

See Failed to open file ...

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.

QNAN

(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:

  • Using a "flap start" value of 0 in the YASim FDM. Use some small value like 0.001 instead.

Scaling image...

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.
  • Make sure you did set the right executable (fgfs.exe) on the first page of the FlightGear Launch Control.

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()

This error can be surpressed by disabling AI Traffic, via the AI/ATC menu.

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.

Also, make sure you didn't force a FDM to be loaded.

  • Commandline: --fdm=... should be left out.
  • FGRun: Advanced > Flight Model should be set to jsb (which will leave the whole command out of the commandline, so you can use this setting with any FDM).

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.

Unknown exception in main loop. Aborting...
Possible cause: Not enough space

  • When running 64 bits Windows, make sure to uncheck the "force 32-bits" option on installation.
  • Most notebooks that run Windows 7 have the so called Optimus Technology (NVidia) or Hybrid Graphics technology (ATI) onboard. This is meant to increase battery life, by automatically switching of the powerfull graphics card when it's not needed. However, FlightGear needs it all the time, even if Optimus says it doesn't! See here for instructions on how to disable this behaviour.

When the above mentioned points do not apply or did not work, you are likely to be unable to run FlightGear at the current graphics settings. See Troubleshooting performance issues for instructions on how to switch off demanding eye candy.

Apart from the above mentioned stuff, it may be useful to install the latest drivers for your graphics card:

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: Could not find plugin to read objects from file ...

A library is missing from your computer. Therefore, certain fileformats cannot be read. Try to reinstall/update OSG, as the libraries used by FlightGear should be part of the standard package.

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

Some control in the YASim FDM is too weak, according to YASim, to control the aircraft. An effectiveness tag will be required in the FDM to solve this error.

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.

YOU HAVE AN INCOMPATIBLE CFG FILE FOR THIS AIRCRAFT. RESULTS WILL BE UNPREDICTABLE !!

Make sure the JSBSim FDM of the aircraft has a <fdm_config version="2.0" tag.

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!

Aircraft propulsion element has problems in file ...

AL Error (fx): Invalid Value at pitch and gain

The sound effect's pitch (high or low) and gain (volume multiplication factor) values are not valid.

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

Has something to do with the Nasal scripting language used by FlightGear.

Failed to tie (or untie while closing) 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

http://www.flightgear.org/forums/viewtopic.php?f=2&t=6706&start=0&st=0&sk=t&sd=a

Nasal runtime error: stack overflow

No image file for texture, using white

A shader error, possibly you (or the developer) have/has not specified a texture for a surface while modeling the aircraft model in AC3D, Blender, Wings...

No path in /sim/sound/path

You (or the developer) have/has not specified a proper sound file in the aircraft's -set.xml file.

OpenAL error (AL_ILLEGAL_COMMAND): set_source_pos

Has something to do with OpenAL not understanding where the sound comes from.

OpenAL error (AL_ILLEGAL_COMMAND): set_volume

Has something to do with OpenAL not understanding the sound 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?

Tried to initialize a non-existent engine!

The developer of the aircraft did not code the engine properly.

Developers: Check that the engine.xml file, FDM.xml, and -set.xml is coded properly.

Unknown Chunk: ***UNKNOWN*** (0xA08A)

I use Autodesk 3ds Max (.3ds) occurs when the 3D data model.

Solution converts the file format AC3D.

Warning: detected OpenGL error 'invalid value' after RenderBin::draw(,)

This warning is generated from OSG. Set your environment variable

OSG_NOTIFY_LEVEL=FATAL

Warning: GraphicsWindowWin32::grabFocus() - Failed grabbing the focus

It seems that this happens when you have another window open and you are "focusing" (the window is active) on it. FlightGear will try to grab itself infront of the other window.

WARNING: PUI: Too many live puInterfaces open at once!

Appears when printing large outputs (very) frequently on the screen.

Warning: State::drawQuads(0, 154400) too large handle in remapping to ushort glDrawElements