Property browser: Difference between revisions

Jump to navigation Jump to search
Shortening the intro text by moving parts of it to separate sections + Some cleanup
No edit summary
(Shortening the intro text by moving parts of it to separate sections + Some cleanup)
Line 1: Line 1:
[[File:Property_Browser.jpg|thumb|270px|The property browser window]]
{{PropertyTree}}
{{PropertyTree}}


[[File:Property_Browser.jpg|thumb|270px|The property browser window]]
The [[FlightGear]] '''property browser''' is a dialog used to browse, in-simulator, through all properties. Properties are internal, runtime state variables in FlightGear. The property browser cannot only be used to inspect all sorts of internal variables at runtime, but it can also be used to change the values of most properties easily.
The [[FlightGear]] '''property browser''' is a dialog used to browse, in-simulator, through all properties (internal, runtime state variables in FlightGear). The property browser cannot only be used to inspect all sorts of internal variables at runtime, but it can also be used to change most variables easily. However, some properties are so called "tied" properties which are directly mapped to internal C++ variables, so that they cannot be modified otherwise.  
 
== Opening the property browser ==
The property browser can be opened while FlightGear is running either:
* By pressing the "/" key (forward slash)
* Through the main [[menubar|menu]]: <tt>Debug > Browse Internal Properties</tt> (in older version: <tt>File > Browse Internal Properties</tt>).


In addition, even some non-tied properties cannot be modified because they are by default constantly written/modified by another subsystem (in C++/Nasal space), possibly updating properties at frame rate, this applies for example to the frame rate counter, which is constantly updated by C++ code - so trying to set it from Nasal would be kind of pointless.
Browse around to see the different data fields that are available. Just about everything interesting/useful is published in the property system. The browser allows you to inspect and even change values in the live running copy of FG.


Certain properties are only read/applied during initialization/re-initialization (startup/reset) of the sim, while others require the corresponding subsystems to be reinitialized.
== Tied properties ==
Some properties are so called ''tied'' properties which are directly mapped to internal C++ variables and they cannot be modified using the property browser.  


The property browser can be opened with / (forward slash) or through the [[menubar|menu]]: <tt>Debug > Browse Internal Properties</tt> (in older version: <tt>File > Browse Internal Properties</tt>).
In addition, even some non-tied properties cannot be modified because they are by default constantly written/modified by another subsystem (in C++/Nasal space), possibly updating properties at frame rate, this applies for example to the frame rate counter, which is constantly updated by C++ code - so trying to set it from Nasal would be kind of pointless.


Next, pop open the property browser in a live running copy of FlightGear.  Browse around to see the different data fields that are available. Just about everything interesting/useful is published in the property system. The browser allows you to inspect and even change values in the live running copy of FG.
Also certain properties are only read/applied during initialization/re-initialization (startup/reset) of the sim, while others require the corresponding subsystems to be reinitialized.


== Tips and tricks ==
== Tips and tricks ==
Line 71: Line 77:
}, 0);
}, 0);
</syntaxhighlight>
</syntaxhighlight>
== Related content ==
* [[Property Tree]]


[[Category:Menubar]]
[[Category:Menubar]]

Navigation menu