- add <delay-sec>
- fix mixed indentation
This commit is contained in:
mfranz
parent
246ce973ec
commit
95a652be17
1 changed files with 99 additions and 94 deletions
|
|
@ -63,136 +63,141 @@ Configuration description:
|
|||
-------------------------
|
||||
|
||||
<fx>
|
||||
Named FX subtree living under /sim/sound
|
||||
Named FX subtree living under /sim/sound
|
||||
|
||||
< ... >
|
||||
This is the event separator. The text inside the brackets
|
||||
can be anything. Bit it is advised to give it a meaningful name
|
||||
like: crank, engine, rumble, gear, squeal, flap, wind or stall
|
||||
This is the event separator. The text inside the brackets
|
||||
can be anything. Bit it is advised to give it a meaningful name
|
||||
like: crank, engine, rumble, gear, squeal, flap, wind or stall
|
||||
|
||||
The value can be defined multiple times, thus anything which is
|
||||
related may have the same name (grouping them together).
|
||||
The value can be defined multiple times, thus anything which is
|
||||
related may have the same name (grouping them together).
|
||||
|
||||
<name>
|
||||
This defines the name of the event. This name is used internally
|
||||
and, although it can me defined multiple times in the same file,
|
||||
should normally have an unique value.
|
||||
This defines the name of the event. This name is used internally
|
||||
and, although it can me defined multiple times in the same file,
|
||||
should normally have an unique value.
|
||||
|
||||
Multiple definitions of the same name will allow multiple sections
|
||||
to interfere in the starting and stopping of the sample.
|
||||
Multiple definitions of the same name will allow multiple sections
|
||||
to interfere in the starting and stopping of the sample.
|
||||
|
||||
This method can't be used to control the pitch or volume of the
|
||||
sample, but instead multiple volume or pitch section should be
|
||||
included inside the same event.
|
||||
This method can't be used to control the pitch or volume of the
|
||||
sample, but instead multiple volume or pitch section should be
|
||||
included inside the same event.
|
||||
|
||||
The types "raise" and "fall" will stop the playback of the sample
|
||||
regardless of any other event. This means that when the type "raise"
|
||||
is supplied, sample playback will stop when the event turns false.
|
||||
Using the type "fall" will stop playback when the event turns true.
|
||||
The types "raise" and "fall" will stop the playback of the sample
|
||||
regardless of any other event. This means that when the type "raise"
|
||||
is supplied, sample playback will stop when the event turns false.
|
||||
Using the type "fall" will stop playback when the event turns true.
|
||||
|
||||
IMPORTANT:
|
||||
If the trigger is used for anything else but stopping the sound
|
||||
at a certain event, all sections with the same name *should* have
|
||||
exactly the same sections for everything but property and type.
|
||||
IMPORTANT:
|
||||
If the trigger is used for anything else but stopping the sound
|
||||
at a certain event, all sections with the same name *should* have
|
||||
exactly the same sections for everything but property and type.
|
||||
|
||||
In the case of just stopping the sample at a certain event, the
|
||||
sections for path, volume and pitch may be omitted.
|
||||
|
||||
In the case of just stopping the sample at a certain event, the
|
||||
sections for path, volume and pitch may be omitted.
|
||||
|
||||
<path>
|
||||
This defined th path to the sound file. The path is relative to the
|
||||
FlightGear root directory but could be specified absolute.
|
||||
This defined th path to the sound file. The path is relative to the
|
||||
FlightGear root directory but could be specified absolute.
|
||||
|
||||
<condition>
|
||||
Define a condition that triggers the event.
|
||||
For a complete description of the FlightGear conditions,
|
||||
please read docs-mini/README.conditions
|
||||
Define a condition that triggers the event.
|
||||
For a complete description of the FlightGear conditions,
|
||||
please read docs-mini/README.conditions
|
||||
|
||||
An event should define either a condition or a property.
|
||||
An event should define either a condition or a property.
|
||||
|
||||
<property>
|
||||
Define which property triggers the event, and refers to a node
|
||||
in the FlightGear property tree. Action is taken when the property
|
||||
is non zero.
|
||||
Define which property triggers the event, and refers to a node
|
||||
in the FlightGear property tree. Action is taken when the property
|
||||
is non zero.
|
||||
|
||||
A more sophisticated mechanism to trigger the event is described
|
||||
in <condition>
|
||||
A more sophisticated mechanism to trigger the event is described
|
||||
in <condition>
|
||||
|
||||
<mode>
|
||||
This defines how the sample should be played:
|
||||
This defines how the sample should be played:
|
||||
|
||||
once: the sample is played once.
|
||||
this is the default.
|
||||
once: the sample is played once.
|
||||
this is the default.
|
||||
|
||||
looped: the sample plays continuesly,
|
||||
until the event turns false.
|
||||
looped: the sample plays continuously,
|
||||
until the event turns false.
|
||||
|
||||
in-transit: the sample plays continuesly,
|
||||
while the property is changing its value.
|
||||
in-transit: the sample plays continuously,
|
||||
while the property is changing its value.
|
||||
|
||||
<volume> / <pitch>
|
||||
Volume or Pitch definition. Currently there may be up to 5
|
||||
volume and up to 5 pitch definitions defined within one sound
|
||||
event. Normally all offset values are added together and the
|
||||
results after property calculations will be miltplied.
|
||||
A special condition occurs when the value of factor is negative,
|
||||
in which case the offset doesn't get added to the other offset values
|
||||
but instead will be used in the multiplication section.
|
||||
Volume or Pitch definition. Currently there may be up to 5
|
||||
volume and up to 5 pitch definitions defined within one sound
|
||||
event. Normally all offset values are added together and the
|
||||
results after property calculations will be multiplied.
|
||||
A special condition occurs when the value of factor is negative,
|
||||
in which case the offset doesn't get added to the other offset values
|
||||
but instead will be used in the multiplication section.
|
||||
|
||||
<property>
|
||||
Defines which property supplies the value for the calculation.
|
||||
Either a <property> or an <internal> should be defined.
|
||||
The value is threated as a floating point number.
|
||||
Defines which property supplies the value for the calculation.
|
||||
Either a <property> or an <internal> should be defined.
|
||||
The value is treated as a floating point number.
|
||||
|
||||
<internal>
|
||||
Defines which internal variable should be used for the calculation.
|
||||
The value is threated as a floating point number.
|
||||
The following internals are available at this time:
|
||||
Defines which internal variable should be used for the calculation.
|
||||
The value is treated as a floating point number.
|
||||
The following internals are available at this time:
|
||||
|
||||
dt_play: the number of seconds since the sound started playing.
|
||||
dt_play: the number of seconds since the sound started playing.
|
||||
|
||||
dt_stop: the number of seconds after the sound has stopped.
|
||||
dt_stop: the number of seconds after the sound has stopped.
|
||||
|
||||
<delay-sec>
|
||||
Delay after which the sound starts playing. This is useful to let
|
||||
a property start two sounds at the same time, where the second is
|
||||
delayed until the first stopped playing.
|
||||
|
||||
<type>
|
||||
Defines the function that should be used upon the property
|
||||
before it is used for calculating the net result:
|
||||
Defines the function that should be used upon the property
|
||||
before it is used for calculating the net result:
|
||||
|
||||
lin: linear handling of the property value.
|
||||
this is the default.
|
||||
lin: linear handling of the property value.
|
||||
this is the default.
|
||||
|
||||
ln: convert the property value to a natural logarithmic
|
||||
value before scaling it. Anything below 1 will return
|
||||
zero.
|
||||
ln: convert the property value to a natural logarithmic
|
||||
value before scaling it. Anything below 1 will return
|
||||
zero.
|
||||
|
||||
log: convert the property value to a true logarithmic
|
||||
value before scaling it. Anything below 1 will return
|
||||
zero.
|
||||
log: convert the property value to a true logarithmic
|
||||
value before scaling it. Anything below 1 will return
|
||||
zero.
|
||||
|
||||
inv: inverse linear handling (1/x).
|
||||
inv: inverse linear handling (1/x).
|
||||
|
||||
abs: absolute handling of the value (always positive).
|
||||
abs: absolute handling of the value (always positive).
|
||||
|
||||
sqrt: calculate the square root of the absolute value
|
||||
before scaling it.
|
||||
sqrt: calculate the square root of the absolute value
|
||||
before scaling it.
|
||||
|
||||
<factor>
|
||||
Defines the multiplication factor for the property value.
|
||||
A special condition is when scale is defined as a negative
|
||||
value. In this case the result of |<scale>| * <property) will be
|
||||
subtracted from <default>
|
||||
Defines the multiplication factor for the property value.
|
||||
A special condition is when scale is defined as a negative
|
||||
value. In this case the result of |<scale>| * <property) will be
|
||||
subtracted from <default>
|
||||
|
||||
<offset>
|
||||
The initial value for this sound. This value is also used as an
|
||||
offset value for calculating the end result.
|
||||
The initial value for this sound. This value is also used as an
|
||||
offset value for calculating the end result.
|
||||
|
||||
<min>
|
||||
Minimum allowed value.
|
||||
This is useful if sounds start to sound funny. Anything lower
|
||||
will be truncated to this value.
|
||||
Minimum allowed value.
|
||||
This is useful if sounds start to sound funny. Anything lower
|
||||
will be truncated to this value.
|
||||
|
||||
<max>
|
||||
Maximum allowed value.
|
||||
This is useful if sounds gets to loud. Anything higher will be
|
||||
truncated to this value.
|
||||
Maximum allowed value.
|
||||
This is useful if sounds gets to loud. Anything higher will be
|
||||
truncated to this value.
|
||||
|
||||
<position>
|
||||
Specify the position of the sounds source relative to the
|
||||
|
|
@ -250,19 +255,19 @@ Configuration description:
|
|||
This can be useful for limiting cockpit sounds to the cockpit.
|
||||
|
||||
|
||||
Creating a configration file:
|
||||
----------------------------
|
||||
Creating a configuration file:
|
||||
------------------------------
|
||||
|
||||
To make things easy, there is a default value for most entries to allow a
|
||||
sane configuration when a certain entry is omitted.
|
||||
|
||||
Default values are:
|
||||
|
||||
type: lin
|
||||
factor: 1.0
|
||||
offset: 0.0 for volume, 1.0 for pitch
|
||||
min: 0.0
|
||||
max: 0.0 (don't check)
|
||||
type: lin
|
||||
factor: 1.0
|
||||
offset: 0.0 for volume, 1.0 for pitch
|
||||
min: 0.0
|
||||
max: 0.0 (don't check)
|
||||
|
||||
|
||||
|
||||
|
|
@ -274,12 +279,12 @@ Calculations are made the following way (for both pitch and volume):
|
|||
for (n = 0; n < max; n++) {
|
||||
if (factor < 0)
|
||||
{
|
||||
value += offset[n] - abs(factor[n]) * function(property[n]);
|
||||
value += offset[n] - abs(factor[n]) * function(property[n]);
|
||||
}
|
||||
else
|
||||
{
|
||||
value += factor[n] * function(property[n]);
|
||||
offs += offset[n];
|
||||
value += factor[n] * function(property[n]);
|
||||
offs += offset[n];
|
||||
}
|
||||
}
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue