Default head-up display: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
m (added link to heliHUD)
m (Johan G moved page Head-up display to Default head-up display: Less ambiguous title)
 
(17 intermediate revisions by 6 users not shown)
Line 1: Line 1:
This is a short description of [[FlightGear]]'s default '''Head-up display''' ('''HUD'''), it can be (de)activated with the <tt>[h]</tt>-key. To change the brightness, press <tt>[shift]</tt>+<tt>[h]</tt>.
{{Note|The HUD system will one day be replaced by a [[Canvas HUD]] system.}}


There are also two so called 'minimal' HUDs available which are accessible with <tt>[shift]</tt>+<tt>[i]</tt>, to return to default HUD press <tt>[i]</tt>.  
[[File:HUD_default_overview.png|thumb|420px|Huds/default.xml]]
[[File:HUD_minimal_overview.png|thumb|420px|Huds/minimal.xml]]
[[File:HUD_NTPS_overview.png|thumb|420px|Huds/NTPS.xml]]


Some of the HUDs options can be altered in the menu: <tt>View > Adjust HUD Properties</tt>
The '''default head-up display''' (HUD) of FlightGear is available for any craft which does not include its own. A {{Wikipedia|head-up display}} is an important instrument in modern, mostly military, cockpits.


== Features ==
Activate the HUD with {{key press|h}}. Pressing it repeatedly moves through the configured colours and turns it off again. To change the brightness, press {{key press|Shift|H}}. Press {{key press|Shift|I}} to go through the available HUDs. Press {{key press|i}} to switch back to the first one at any time. Have in mind that some aircraft do assign one or more of those keys differently and therefore some functions may be missing from them.


=== Aileron ===
Some of the head-up options of the HUD can be altered in the menu: ''View'' &gt; ''Adjust HUD Properties''
[[File:HUD_aileron.jpg|thumb|200px|Aileron]]
Monitors the bearing of the control input on the ailerons axis.
:[[Aileron]]


=== Airspeed ===
In addition custom HUDs for aircraft such as the [[F-14B]] and [[F-16]] can relatively easily be created through an XML-based system FlightGear provides. Have a look at [[#Further Information|Further Information]] if you are planning to create a HUD.
[[File:HUD_speed.jpg|thumb|200px|Airspeed]]
Current speed relating to the ambient air in knot/knots (kt/kts) (1 kt = 1.852 km/h).


=== Altitude ===
== Features ==
[[File:HUD_altitude.jpg|thumb|200px|Altitude]]
=== Control inputs ===
Current altitude relating to sea-level in feet (ft) (1 ft = 30.48 cm).
; Aileron
 
: Displays the [[aileron]] control axis input. Attached along the upper side is the indicator for the trim input on that axis.
=== GPS ===
: Properties: <code>/controls/flight/aileron</code> and <code>/controls/flight/aileron-trim</code>
The active GPS waypoint identifier is displayed, as well as the distance and bearing to it. The GPS ground track and course-deviation are also displayed - for the course deviation,
the distance off-course is displayed in nautical miles (nm), with an arrow indicating the direction to fly to regain the GPS course.


=== Elevation ===
; Elevator
Current altitude above ground in feet. Relating to the location of the aircraft's radio altimeter, therefore it's not zero if the aircraft is on the ground.
: Displays the [[elevator]] control axis input. Attached to the left the trim on this axis.
: Properties: <code>/controls/flight/elevator</code> and <code>/controls/flight/elevator-trim</code>


=== Elevator ===
; Rudder
[[File:HUD_elevator.jpg|thumb|200px|Elevator]]
: Displays the [[rudder]] control axis input. Attached to the bottom the trim input.
Monitors the bearing of the control input on the elevators axis.
: Properties: <code>/controls/flight/rudder</code> and <code>/controls/flight/rudder-trim</code>
:[[Elevator]]


=== G-load ===
; Throttle
Displays the g-force to the pilot in g - to avoid black-/redout.
: Displays the [[throttle]] control axis input.
:The value riding on top of the [[#Airspeed|Airspeed]] indicator.
: Property: <code>/controls/engines/engine/throttle</code>


=== Heading ===
=== Instruments ===
[[File:HUD_heading.jpg|thumb|200px|Heading]]
; AMSL (Altitude above Mean Sea Level)
Direction of the aircraft relating to the geographical North pole in degree (360 degree scale).
: Current [[AMSL|altitude above mean seal level]] in feet (ft) (1 ft = 30.48 cm).
:[[Avionics and Instruments#Compass|Compass]]
: Property: <code>/position/altitude-ft</code>


=== Location ===
; g-load
[[File:HUD_location.jpg|thumb|200px|Location]]
: The {{Wikipedia|G-force}} applied to the pilot - to avoid black-/redout.
To change the coordinates-system, go to <tt>Autopilot > Set Lat/Lon-format</tt>.
: Property: <code>/accelerations/pilot/z-accel-fps_sec</code> with factor <code>-0.03108095</code>


=== Pitch ===
; Gyrocompass
Like set with <tt>[Home]</tt>/<tt>[End]</tt>.
: This is an ideal version of a [[Avionics and Instruments#DirectionalGyro|gyrocompass]] without the drawbacks of a real one. It shows heading of the aircraft relative to the geographical north pole (true north) in degree (360 degree scale).
:It's the left marker of the [[#Elevator|Elevator]] indicator.  
: Property: <code>/orientation/heading-deg</code>


=== Pitch ladder ===
; KIAS (Knots Indicated Airspeed)
Displays the aircraft's pitch relating to the grounds level/horizontal in degree. It's used as an artificial horizon.
: Current [[KIAS|speed relative to the ambient air in knots]] (kt) (1 kt = 1.151 mph = 1.852 km/h).
:The big ladder like looking indicator at the HUDs centre.
: Property: <code>/velocities/airspeed-kt</code>
:[[Avionics and Instruments#Attitude Indicator|Attitude indicator]]


=== Rudder ===
; Latitude / Longitude
[[File:HUD_rudder.jpg|thumb|200px|Rudder]]
: Current location according to the {{Wikipedia|geographic coordinate system}}.
Monitors the bearing of the control input on the rudders axis.
: To change the format of the displayed coordinates, go to ''Autopilot'' &gt; ''Set Lat/Lon-format''.
:[[Rudder]]
: Properties: <code>/position/latitude-string</code> and <code>/position/longitude-string</code>


=== Thrust ===
; Pitch ladder
[[File:HUD_thrust.jpg|thumb|200px|Thrust]]
: Displays the pitch and roll of the aircraft relative to the horizontal plane in degrees. It is used as an artificial horizon ([[Avionics and Instruments#Attitude Indicator|Attitude indicator]]).
Monitors the thrust on airplanes or the collective of helicopters.
: Properties: <code>/orientation/roll-deg</code> and <code>/orientation/pitch-deg</code>


=== Turn-bank-indicator ===
; Radio altimeter
:[[Avionics and Instruments#Turn Coordinator|Turn Coordinator]]
: Shows current altitude [[above ground level]] (AGL) in feet. Relating to the location of the radio altimeter of the aircraft, it is not zero if the aircraft is on the ground.
: Property: <code>/position/altitude-agl-ft</code>


[[File:HUD_default_autopilot.jpg|thumb|200px|HUD autopilot]]
; Turn-bank-indicator
[[File:HUD_default_overview.png|thumb|200px|HUD overview]]
: [[Avionics and Instruments#Turn Coordinator|Turn Coordinator]]
: Properties: <code>/orientation/roll-deg</code> and <code>/orientation/side-slip-deg</code>


== Further Information ==
=== Autopilot ===
The basic setup of the above described default HUD is defined at <tt>[[$FG ROOT]]/Huds/Default/default.xml</tt>. There is also a 'Runway projection' available which is, because of some issues, disabled by default.
[[File:HUD_default_autopilot.jpg|thumb|420px|HUD autopilot]]
If the [[autopilot]] is active the HUD displays its settings. For each active function (heading, altitude and speed) a box will appear below the gyrocompass containing information on its mode and, if existent, the associated value.


Documentation can be found at: <tt>[[$FG ROOT]]/Docs/README.xmlhud</tt>
; Heading control
: Whether it is active or not and on which mode it operates is determined by the content of the  <code>/autopilot/locks/heading</code> property.
: The values are taken from <code>/autopilot/settings/heading-bug-deg</code> and <code>/autopilot/settings/true-heading-deg</code>.


Since FlightGear 0.9.10 there is ''also'' a newer and more flexibly HUD-system available. An example can be found at <tt>[[$FG ROOT]]/Huds/NTPS.xml</tt> and documentation at <tt>[[$FG ROOT]]/Docs/README.hud</tt>.
; Altitude control
Also have a look at <tt>$FG_ROOT/Huds/README</tt>.
: Active mode: <code>/autopilot/locks/altitude</code>
: Their values: <code>/autopilot/settings/target-altitude-ft</code>, <code>/autopilot/settings/vertical-speed-fpm</code> and <code>/autopilot/settings/target-agl-ft</code>.


== preferences.xml ==
; Speed control
While the instruments and their behaviour are set in the Huds-directory, the basic settings and the look regarding to any HUD are set in <tt>[[$FG ROOT]]/preferences.xml</tt>. Search the file for <tt><hud></tt> and you will find a list of properties. For a short description of those have a look at [[#Property_tree|property tree]]. But I'll give some of them a closer look:
: Active mode: <code>/autopilot/locks/speed</code>
: Their values: <code>/autopilot/settings/target-speed-kt</code> and <code>/autopilot/settings/target-speed-mach</code>


=== Colour ===
=== GPS ===
The preferred thing one would like to customize is, I guess, the HUDs colour.
[[File:HUD_default_gps.jpg|thumb|420px|HUD GPS]]
The upper left hand corner shows the most important information on the current state of the [[GPS]]. Namely these are (line by line):


Discover your own settings is quite easy: Access the property tree via the Menu <tt>File > Browse Internal Properties</tt> (<tt>[/]</tt>-character) '''or''' via the [[Property Tree#Property server|Property server]] and your browser. Go to sim/hud/color, e.g. http://localhost:5500/sim/hud/color, edit a value and watch the result in FlightGears window instantly.
{| class="wikitable"
| GPS operating mode
| Active waypoint
|-
| '''D''': Distance in nautical miles (NM) to active waypoint
| '''TTW''': Calculated time to active waypoint
|-
| '''BRG''': Bearing to next waypoint
| '''XTR''': Cross track deviation, deviation from the track between the previous and active waypoint in nautical miles (NM)
|-
| '''GS''': Ground speed, the speed relative to the ground
|
|}


Once the decision is made head back to preferences.xml, copy the <color n="0">-tag and paste it on top of the colours within the <palette>-tag. Rename the existing tags in numeric order and finally put your discovered values in the new one. It should look like this, except your own values, of course:
=== Big fat arrow ===
    <current-color type="int">0</current-color>
Remains of a going to be useful instrument.
    <palette>
    <color n="0">
      <transparent type="bool">true</transparent>
      <antialiased type="bool">false</antialiased>
      <brightness type="float">1</brightness>
      <alpha type="float">0.67</alpha>
      <red type="float">0.1</red>
      <green type="float">1.0</green>
      <blue type="float">0.3</blue>
    </color>
    <color n="1"><nowiki><!-- day --></nowiki>
      ...
    </color>
    <color n="2"><nowiki><!-- night --></nowiki>
      ...
    </color>
    </palette>


=== Font ===
: To get rid of it, remove or comment <code>runway.xml</code> from <code>[[$FG_ROOT]]/Huds/{{fgdata source|path=Huds/default.xml|text=default.xml}}</code>.
 
: To make it point to the airport selected by menu item "Tower Position", apply patches as shown [http://sourceforge.net/mailarchive/message.php?msg_id=30422572 here].
    <nowiki><font></nowiki>
    <name type="string">Helvetica.txf</name>
    <size type="float">8</size>
    <nowiki></font></nowiki>
 
To change font just enter another name out of the ones in <tt>[[$FG ROOT]]/Fonts</tt> (case sensitive!). For more information about those fonts and on .txf format peruse $FG_ROOT/Fonts/README.
 
Since the size is type 'float' values like '7.449' are allowed, too.
 
=== Path ===
/!\ Just a draft and maybe not correct.
 
  <path>Huds/Default/default.xml</path>
  <path>Huds/NTPS.xml</path>          <nowiki> <!-- new HUD --></nowiki>
The first one is the default HUD mentioned above. It is for the old HUD only.
The second is the first one of the 'minimal HUD's and it is for the new HUD only. The other 'minimal' one is called by the code (I guess), its path is Huds/Minimal/default.xml.
 
For each <path> are some more HUDs available, a complete list (except aircraft specific):
 
old HUD:
Huds/Custom/default.xml
Huds/Default/default.xml
Huds/Engineering/default.xml
Huds/Minimal/default.xml
 
new HUD:
Huds/NTPS.xml
Huds/default.xml


== Further Information ==
HUDs may be replaced or added by changing or adding their paths in <code>preferences.xml</code> or by setting the paths as command line options. To change the order of the existing ones the options would be: <code>--prop:/sim/hud/path[1]=Huds/minimal.xml</code> <code>--prop:/sim/hud/path[2]=Huds/default.xml</code>


== Property tree ==
If you consider to create your own HUD have a look at [[Canvas HUD]] first.
More information about FlightGear's property tree and on how to access it can be found at its page: [[Property Tree]].


Paths starting with '[[$FG ROOT]]/' apply to the file system, the others are intra-property tree.
The basic settings regarding to any HUD are set in {{fgdata source|path=defaults.xml}}. Search the file for the <code><hud></code> tag and you will find a list of properties.
/sim/hud
  current-color  (0|1|2...)    int    One out of /sim/hud/palette
  enable3d        (false|true)  bool    hud n=0 3D off|on
  enable3d[1]    (false|true)  bool    hud n=1 3D off|on
  frame-stat-type (tris|???)            ???
  path           (Huds/...)            Path to hud n=0
  path[1]        (Huds/...)            Path to hud n=1
  visibility      (false|true)  bool    hud n=0 hidden|visible
  visibility[1]  (false|true)  bool    hud n=1 hidden|visible
/sim/hud/color/          Contains settings of current-color
    alpha        (0...1)      float  0=invisible, 1=nontransparent
    alpha-clamp  (???)                ???
    antialiased  (false|true)  bool    Antialiasing off|on
    blue          (0...1)      float
    brightness    (0...1)      float  0=dark/black
    green        (0...1)      float
    red          (0...1)      float
    transparent  (false|true)  bool    Transparency off|on
/sim/hud/font/
    name          (*.txf)      string  One out of $FG_ROOT/Fonts
    size          (8)          float  Size of font
/sim/hud/palette/
/sim/hud/palette/color/        Settings of predefined colours, nearly
/sim/hud/palette/color[n]/      the same options as in /sim/hud/color.


The setup of the default HUD is defined at {{fgdata source|path=Huds/default.xml}} and documentation can be found at {{readme file|hud}}.


== Additional HUD's ==
== Additional HUDs ==
; HeliHUD
; HeliHUD
: Designed to fly helicopters in Helicopter View it is also handy for any craft with a not yet finished cockpit. The [http://janodesbois.free.fr/D-HUND/helihud_0.2.tar.bz2 download] contains instructions and specs.
: The [http://wiki.beggabaur.rocks/ya/HeliHUD HeliHUD] is designed for fly helicopters in Helicopter View it is also handy for any craft with a not yet finished cockpit. It also contains a minimalistic HUD only showing some navigational information such as compass and GPS. The [http://beggabaur.rocks/fgfs/helihud_0.3.tar.bz2 download] contains instructions and specs.
 


[[Category:FlightGear feature]]
[[Category:FlightGear feature]]
[[Category:Menubar]]
[[Category:Menubar]]

Latest revision as of 17:48, 2 May 2020

Note  The HUD system will one day be replaced by a Canvas HUD system.
Huds/default.xml
Huds/minimal.xml
Huds/NTPS.xml

The default head-up display (HUD) of FlightGear is available for any craft which does not include its own. A head-up display This is a link to a Wikipedia article is an important instrument in modern, mostly military, cockpits.

Activate the HUD with h. Pressing it repeatedly moves through the configured colours and turns it off again. To change the brightness, press Shift+H. Press Shift+I to go through the available HUDs. Press i to switch back to the first one at any time. Have in mind that some aircraft do assign one or more of those keys differently and therefore some functions may be missing from them.

Some of the head-up options of the HUD can be altered in the menu: View > Adjust HUD Properties

In addition custom HUDs for aircraft such as the F-14B and F-16 can relatively easily be created through an XML-based system FlightGear provides. Have a look at Further Information if you are planning to create a HUD.

Features

Control inputs

Aileron
Displays the aileron control axis input. Attached along the upper side is the indicator for the trim input on that axis.
Properties: /controls/flight/aileron and /controls/flight/aileron-trim
Elevator
Displays the elevator control axis input. Attached to the left the trim on this axis.
Properties: /controls/flight/elevator and /controls/flight/elevator-trim
Rudder
Displays the rudder control axis input. Attached to the bottom the trim input.
Properties: /controls/flight/rudder and /controls/flight/rudder-trim
Throttle
Displays the throttle control axis input.
Property: /controls/engines/engine/throttle

Instruments

AMSL (Altitude above Mean Sea Level)
Current altitude above mean seal level in feet (ft) (1 ft = 30.48 cm).
Property: /position/altitude-ft
g-load
The G-force This is a link to a Wikipedia article applied to the pilot - to avoid black-/redout.
Property: /accelerations/pilot/z-accel-fps_sec with factor -0.03108095
Gyrocompass
This is an ideal version of a gyrocompass without the drawbacks of a real one. It shows heading of the aircraft relative to the geographical north pole (true north) in degree (360 degree scale).
Property: /orientation/heading-deg
KIAS (Knots Indicated Airspeed)
Current speed relative to the ambient air in knots (kt) (1 kt = 1.151 mph = 1.852 km/h).
Property: /velocities/airspeed-kt
Latitude / Longitude
Current location according to the geographic coordinate system This is a link to a Wikipedia article.
To change the format of the displayed coordinates, go to Autopilot > Set Lat/Lon-format.
Properties: /position/latitude-string and /position/longitude-string
Pitch ladder
Displays the pitch and roll of the aircraft relative to the horizontal plane in degrees. It is used as an artificial horizon (Attitude indicator).
Properties: /orientation/roll-deg and /orientation/pitch-deg
Radio altimeter
Shows current altitude above ground level (AGL) in feet. Relating to the location of the radio altimeter of the aircraft, it is not zero if the aircraft is on the ground.
Property: /position/altitude-agl-ft
Turn-bank-indicator
Turn Coordinator
Properties: /orientation/roll-deg and /orientation/side-slip-deg

Autopilot

HUD autopilot

If the autopilot is active the HUD displays its settings. For each active function (heading, altitude and speed) a box will appear below the gyrocompass containing information on its mode and, if existent, the associated value.

Heading control
Whether it is active or not and on which mode it operates is determined by the content of the /autopilot/locks/heading property.
The values are taken from /autopilot/settings/heading-bug-deg and /autopilot/settings/true-heading-deg.
Altitude control
Active mode: /autopilot/locks/altitude
Their values: /autopilot/settings/target-altitude-ft, /autopilot/settings/vertical-speed-fpm and /autopilot/settings/target-agl-ft.
Speed control
Active mode: /autopilot/locks/speed
Their values: /autopilot/settings/target-speed-kt and /autopilot/settings/target-speed-mach

GPS

HUD GPS

The upper left hand corner shows the most important information on the current state of the GPS. Namely these are (line by line):

GPS operating mode Active waypoint
D: Distance in nautical miles (NM) to active waypoint TTW: Calculated time to active waypoint
BRG: Bearing to next waypoint XTR: Cross track deviation, deviation from the track between the previous and active waypoint in nautical miles (NM)
GS: Ground speed, the speed relative to the ground

Big fat arrow

Remains of a going to be useful instrument.

To get rid of it, remove or comment runway.xml from $FG_ROOT/Huds/default.xml.
To make it point to the airport selected by menu item "Tower Position", apply patches as shown here.

Further Information

HUDs may be replaced or added by changing or adding their paths in preferences.xml or by setting the paths as command line options. To change the order of the existing ones the options would be: --prop:/sim/hud/path[1]=Huds/minimal.xml --prop:/sim/hud/path[2]=Huds/default.xml

If you consider to create your own HUD have a look at Canvas HUD first.

The basic settings regarding to any HUD are set in flightgear/fgdata/next/defaults.xml. Search the file for the <hud> tag and you will find a list of properties.

The setup of the default HUD is defined at flightgear/fgdata/next/Huds/default.xml and documentation can be found at $FG_ROOT/Docs/README.hud.

Additional HUDs

HeliHUD
The HeliHUD is designed for fly helicopters in Helicopter View it is also handy for any craft with a not yet finished cockpit. It also contains a minimalistic HUD only showing some navigational information such as compass and GPS. The download contains instructions and specs.