Howto:Add blackout and redout settings: Difference between revisions

Jump to navigation Jump to search
Some notes about the new system.
(→‎Related content: Adding wiki link to Necolatis' development and related forum topic)
(Some notes about the new system.)
Line 1: Line 1:
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 {{wikipedia|G-force#Human tolerance of g-force|g-force}}.
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 {{wikipedia|G-force#Human tolerance of g-force|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.}}
{{note|While the pilot will be temporarily blind due to g-force he will not be incapacitated (G-LOC) and will still be able to control the aircraft.}}


== Involved properties ==
== Flightgear 2016.4.4 and earlier ==
 
=== Involved properties ===
Blackout and redout are controlled through these properties in <code>/sim/rendering/redout/</code>:
Blackout and redout are controlled through these properties in <code>/sim/rendering/redout/</code>:


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


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


Line 33: Line 35:
                     <redout-onset-g>-2</redout-onset-g>
                     <redout-onset-g>-2</redout-onset-g>
                     <redout-complete-g>-4</redout-complete-g>
                     <redout-complete-g>-4</redout-complete-g>
                </parameters>
            </redout>
            <headshake>
                <enabled type="bool" userarchive="y">true</enabled>
            </headshake>
        </rendering>
        <!-- ... -->
    </sim>
    <!-- ... -->
</PropertyList>
</syntaxhighlight>
== Post Flightgear 2017.1.1 ==
The blackout/redout system in Flightgear 20171.1.1 and later work a bit different. The system is now time based, so for example the longer time you spend at a high G the darker the screen gets.
It also features G priming, so that if you for example pull some high Gs for a while and then go negative the redout will take longer to come into effect, and vice versa, as the blood flows to or from the pilots brain.
As in the previous system, you can customize some parameters according to the quality of the G-suit the pilot is wearing and training at anti-G breathing.
Notice that the new system is backwards compatible with the old system. It is also compatible with the [[Custom blackout system]] v1.05+ as that system will switch itself off, if FG 2017.1.1 or newer is used.
=== Involved properties ===
Blackout and redout are controlled through these properties in <code>/sim/rendering/redout/</code>:
* <code>enabled</code> (bool)
If the system is on or off.
* <code>parameters/blackout-onset-g</code> (double) [Default = 2.5]
* <code>parameters/onset-blackout-sec</code> (double) [Default = 300]
Onset-g must be positive and above 1. This is the G-force when the blackout effect will start to come into effect. This is also the G-force that the pilot will have to get below to clear the blackout of the screen. The time property is to set how many seconds it takes to get complete blackout at this G value.
* <code>parameters/blackout-complete-g</code> (double) [Default = 4.5]
* <code>parameters/fast-blackout-sec</code> (double) [Default = 10]
Complete-g must be higher than blackout-onset-g. This should be at or near to the maximum the pilot should be expected to tolerate depending on his G-suit and anti-G breathing techniques or lack of those. The fast-blackout-sec, is how long it will take to blackout completely at this G value. This should normally be considerably shorter than onset-blackout-sec.
* <code>parameters/redout-onset-g</code> (double) [Default = -2]
* <code>parameters/redout-complete-g</code> (double) [Default = -4]
* <code>parameters/onset-redout-sec</code> (double) [Default = 45]
* <code>parameters/fast-redout-sec</code> (double) [Default = 7.5]
These four works like the first four, just for negative Gs. Onset-g must be below 1 and complete-g must be below onset.
* <code>parameters/recover-fast-sec</code> (double) [Default = 7]
* <code>parameters/recover-slow-sec</code> (double) [Default = 15]
The recover-slow is how long it takes to recover from complete redout/blackout just below the onset, and recover-fast is how long it takes to clear at 1 G.
The default values, is estimated to be for a pilot without G-suit and untrained in anti-G breathing techniques.
These properties can be controlled at runtime or be added to any [[PropertyList XML files|PropertyList XML file]], for example an [[aircraft-set.xml]] or your own [[FlightGear configuration via XML|configuration file]].
In addition to these properties there is another property, <code>/sim/rendering/headshake/enabled</code> (bool), that will make the pilots viewpoint move up and down due to the g-force, for example due to maneuvers or turbulence.
=== Example (F-16) ===
This example show how these setting can be added to a propertylist xml file:
These blackout settings is the values used in a 1979 Langley simulator for F-16.
Notice that the redout is also the default values, that is because G-suits mainly protects against high G, not much against negative Gs.
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<PropertyList>
    <!-- ... -->
    <sim>
        <!-- ... -->
        <rendering>
            <redout>
                <enabled type="bool" userarchive="y">true</enabled>
                <parameters>
                    <blackout-onset-g type="double">5</blackout-onset-g>
                    <blackout-complete-g type="double">9</blackout-complete-g>
                    <onset-blackout-sec type="double">300</onset-blackout-sec>
                    <fast-blackout-sec type="double">10</fast-blackout-sec>
                    <redout-onset-g type="double">-2</redout-onset-g>
                    <redout-complete-g type="double">-4</redout-complete-g>
                    <onset-redout-sec type="double">45</onset-redout-sec>
                    <fast-redout-sec type="double">7.5</fast-redout-sec>
                    <recover-fast-sec type="double">7</recover-fast-sec>
                    <recover-slow-sec type="double">15</recover-slow-sec>
                 </parameters>
                 </parameters>
             </redout>
             </redout>
574

edits

Navigation menu