Howto:Add blackout and redout settings

From FlightGear wiki
Revision as of 16:39, 13 November 2016 by Johan G (talk | contribs) (→‎Related content: Adding wiki link to Necolatis' development and related forum topic)
Jump to navigation Jump to search

This is how to add blackout and redout settings to an aircraft. These settings will determine when the view will start to turn black or red and when it will be fully black or red due to g-force This is a link to a Wikipedia article.

Note  While the pilot will be temporarily blind due to g-force he will not be incapacitated and will still be able to control the aircraft.

Involved properties

Blackout and redout are controlled through these properties in /sim/rendering/redout/:

  • enabled (bool)
  • parameters/blackout-onset-g (double)
  • parameters/blackout-complete-g (double)
  • parameters/redout-onset-g (double)
  • parameters/redout-complete-g (double)

These properties can be controlled at runtime or be added to any PropertyList XML file, for example an aircraft-set.xml or your own configuration file.

In addition to these properties there is another property, /sim/rendering/headshake/enabled (bool), that will make the pilots viewpoint move up and down due to the g-force, for example due to maneuvers or turbulence.

Example

This example show how these setting can be added to a propertylist xml file:

<?xml version="1.0" encoding="UTF-8"?>
<PropertyList>
    <!-- ... -->
    <sim>
        <!-- ... -->
        <rendering>
            <redout>
                <enabled type="bool" userarchive="y">true</enabled>
                <parameters>
                    <blackout-onset-g>6</blackout-onset-g>
                    <blackout-complete-g>8</blackout-complete-g>
                    <redout-onset-g>-2</redout-onset-g>
                    <redout-complete-g>-4</redout-complete-g>
                </parameters>
            </redout>
            <headshake>
                <enabled type="bool" userarchive="y">true</enabled>
            </headshake>
        </rendering>
        <!-- ... -->
    </sim>
    <!-- ... -->
</PropertyList>

Blackout, redout and Rembrandt

As of March 2016 it seems that redout and blackout is not yet implemented in Rembrandt.

Related content

Wiki articles

Forum topics

Mailing list threads

Source code