Howto:Add blackout and redout settings

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 .

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>

Related content

Forum topics

• Adding redout and blackout

Mailing list threads

• [Flightgear-devel] Generic Blackout/Redout

Source code

• fgdata/Nasal/redout.nas
• flightgear/src/Scenery/redout.hxx
• flightgear/src/Scenery/redout.cxx