User Tools

Site Tools


en:orx:config:settings_structure:orxsound

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:orx:config:settings_structure:orxsound [2017/12/06 21:19 (6 years ago)] – external edit 127.0.0.1en:orx:config:settings_structure:orxsound [2023/09/20 00:01 (6 months ago)] (current) sausage
Line 3: Line 3:
 ==== Summary ==== ==== Summary ====
  
-<code ini>[SoundTemplate] +<code ini> 
-Sound       = path/to/SoundFile +[SoundTemplate] 
-Music       = path/to/MusicFile +Sound        = path/to/SoundFile 
-Bus         = <string> +Music        = path/to/MusicFile 
-Attenuation = <float+Bus          = <string> 
-Loop        = <bool>+Loop         = <bool
 +Pitch        = <float> 
 +Volume       = <float> 
 +Panning      = <float> 
 +Mix          = <bool> 
 +DistanceList = <float> (# <Float>
 +GainList     = <float> (# <float>
 +RollOff      = <float> 
 +FilterList   = FilterTemplate1 # ... # FilterTemplateN
 KeepInCache = <bool> KeepInCache = <bool>
-Pitch       = <float> + 
-RefDistance = <float> +</code> 
-Volume      = <float></code>+ 
 +=== BiquadFilter === 
 + 
 +<code ini> 
 +[BiquadFilter] 
 +Type           = biquad 
 +UseCustomParam = <bool> 
 +A0             = <float> 
 +A1             = <float> 
 +A2             = <float> 
 +B0             = <float> 
 +B1             = <float> 
 +B2             = <float> 
 +</code> 
 + 
 +=== LowPassFilter=== 
 + 
 +<code ini> 
 +[LowPassFilter] 
 +Type           = lowpass 
 +UseCustomParam = <bool> 
 +Frequency      = <float> 
 +Order          = <int> 
 +</code> 
 + 
 +=== HighPassFilter === 
 + 
 +<code ini> 
 +[HighPassFilter] 
 +Type           = highpass 
 +UseCustomParam = <bool> 
 +Frequency      = <float> 
 +Order          = <int> 
 +</code> 
 + 
 + 
 +=== BandPassFilter === 
 + 
 +<code ini> 
 +[BandPassFilter] 
 +Type           = bandpass 
 +UseCustomParam = <bool> 
 +Frequency      = <float> 
 +Order          = <int> 
 +</code> 
 + 
 +=== LowShelfFilter === 
 + 
 +<code ini> 
 +[LowShelfFilter] 
 +Type           = lowshelf 
 +UseCustomParam = <bool> 
 +Frequency      = <float> 
 +Q              = <float> 
 +Gain           = <float> 
 +</code> 
 + 
 +=== HighShelfFilter === 
 + 
 +<code ini> 
 +[HighShelfFilter] 
 +Type           = highshelf 
 +UseCustomParam = <bool> 
 +Frequency      = <float> 
 +Q              = <float> 
 +Gain           = <float> 
 +</code> 
 + 
 +=== NotchFilter === 
 + 
 +<code ini> 
 +[NotchFilter] 
 +Type           = notch 
 +UseCustomParam = <bool> 
 +Frequency      = <float> 
 +Q              = <float> 
 +</code> 
 + 
 +=== PeakingFilter === 
 + 
 +<code ini> 
 +[PeakingFilter] 
 +Type           = peaking 
 +UseCustomParam = <bool> 
 +Frequency      = <float> 
 +Q              = <float> 
 +Gain           = <float> 
 +</code> 
 + 
 +=== DelayFilter === 
 + 
 +<code ini> 
 +[DelayFilter] 
 +Type           = delay 
 +UseCustomParam = <bool> 
 +Delay          = <float> 
 +Decay          = <float> 
 +</code> 
  
  
Line 21: Line 127:
   * ''Music'': If no ''Sound'' is specified, this will be used as a path to a music file. Music differs from sounds mainly in the fact they're streamed from disk and buffered in memory at runtime to prevent having big files completely loaded in memory.   * ''Music'': If no ''Sound'' is specified, this will be used as a path to a music file. Music differs from sounds mainly in the fact they're streamed from disk and buffered in memory at runtime to prevent having big files completely loaded in memory.
   * ''Bus'': Assign the sound/music to a named bus. If this is not specified, the default ''Master'' bus will be used.   * ''Bus'': Assign the sound/music to a named bus. If this is not specified, the default ''Master'' bus will be used.
-  * ''Attenuation'': Specifies the attenuation value for spatialized sounds. It accepts a value between 0.0 and 1.0, default being 1.0. 
   * ''Loop'': Specifies if the sound should be played in loop. Its default value is ''false''.   * ''Loop'': Specifies if the sound should be played in loop. Its default value is ''false''.
-  * ''KeepInCache'': Specifies if the sound data (ie. the sample itself) should be kept in memory even when no sound of this type is used. This gives better performances (no disk access) but costs memory. Its default value is ''false''+  * ''Pitch'': Defines a pitch value for the playing sound (ie. a relative frequency). Its default value is 1.0 which means the sound will be played at the same frequency it was recorded. 2.0 will be a pitch twice as high0.is a pitch twice as low. 0.0 has no meaning and is ignored.
-  * ''Pitch'': Defines a pitch value for the playing sound (ie. a relative frequency). Its default value is 1.0 which means the sound will be played at the same frequency it was recorded. +
-  * ''RefDistance'': Distance below which the sound's maximum volume will be perceivedfor spatialized sounds onlyIts default value is 1.0 (in meters).+
   * ''Volume'': Specifies the relative volume to be used when playing the sound. It accepts a value between 0.0 and 1.0, default being 1.0.   * ''Volume'': Specifies the relative volume to be used when playing the sound. It accepts a value between 0.0 and 1.0, default being 1.0.
 +  * ''Panning'': Panning control. -1.0 for full left & 1.0 for full right. Defaults to 0.0 (center).
 +  * ''Mix'': Defines the Panning mode. True for mixing channels based on their position and false to act like a regular balance; Defaults to false.
 +  * ''DistanceList'': Minimum (mandatory) and maximum (optional) distances for sound spatialization, in units. If any of them is negative, sound spatialization will be disabled for this sound. Defaults to -1.0 # FLT_MAX.
 +  * ''GainList'': Minimum (mandatory) and maximum (optional) gain, used to clamp computed gain during sound spatialization, if enabled with DistanceList. Should be within [0.0f - 1.0f]. Defaults to 0.0 # 1.0.
 +  * ''RollOff'': RollOff factor used to compute sound spatialization, if enabled with DistanceList. Defaults to 1.0.
 +  * ''FilterList'': Filters will be chained in their declaration order.
 +  * ''KeepInCache'': Specifies if the sound data (ie. the sample itself) should be kept in memory even when no sound of this type is used. This gives better performances (no disk access) but costs memory. Its default value is ''false''.
 +
 +**NB: Spatialized sounds can be performed on either mono or stereo sounds. There is no longer any restriction on sample types.**
 +
 +=== BiquadFilter ===
 +
 +  * ''UseCustomParam'': When set to true, an event will be sent to override params values at runtime. Defaults to false, ie. no runtime override.
 +
 +=== LowPassFilter ===
 +
 +  * ''UseCustomParam'': When set to true, an event will be sent to override params values at runtime. Defaults to false, ie. no runtime override.
 +  * ''Frequency'': Cutoff frequency.
 +  * ''Order'': Should be between 1 and 8. Cannot be overridden at runtime with UseCustomParam. Defaults to 2.
 +
 +=== HighPassFilter ===
 +
 +  * ''UseCustomParam'': When set to true, an event will be sent to override params values at runtime. Defaults to false, ie. no runtime override.
 +  * ''Frequency'': Cutoff frequency.
 +  * ''Order'': Should be between 1 and 8. Cannot be overridden at runtime with UseCustomParam. Defaults to 2.
 +
 +=== BandPassFilter ===
 +
 +  * ''UseCustomParam'': When set to true, an event will be sent to override params values at runtime. Defaults to false, ie. no runtime override.
 +  * ''Frequency'': Cutoff frequency.
 +  * ''Order'': Should be between 2 and 8. Cannot be overridden at runtime with UseCustomParam. Defaults to 2.
 +
 +=== LowShelfFilter ===
 +
 +  * ''UseCustomParam'': When set to true, an event will be sent to override params values at runtime. Defaults to false, ie. no runtime override.
 +  * ''Frequency'': Center frequency.
 +  * ''Q'': Defines the filter's slope in ]0.0-1.0], the higher, the steeper. Defaults to ~0.707107 (1/sqrt(2.0)).
 +  * ''Gain'': In dB. Positive for amplification, negative for damping. Defaults to 0 (no change).
 +
 +=== HighShelfFilter ===
 +
 +  * ''UseCustomParam'': When set to true, an event will be sent to override params values at runtime. Defaults to false, ie. no runtime override.
 +  * ''Frequency'': Center frequency.
 +  * ''Q'': Defines the filter's slope in ]0.0-1.0], the higher, the steeper. Defaults to ~0.707107 (1/sqrt(2.0)).
 +  * ''Gain'': In dB. Positive for amplification, negative for damping. Defaults to 0 (no change).
 +
 +=== NotchFilter ===
 +
 +  * ''UseCustomParam'': When set to true, an event will be sent to override params values at runtime. Defaults to false, ie. no runtime override.
 +  * ''Frequency'': Center frequency.
 +  * ''Q'': Defines the filter's slope in ]0.0-1.0], the higher, the steeper. Defaults to ~0.707107 (1/sqrt(2.0)).
 +
 +=== PeakingFilter ===
 +
 +  * ''UseCustomParam'': When set to true, an event will be sent to override params values at runtime. Defaults to false, ie. no runtime override.
 +  * ''Frequency'': Center frequency.
 +  * ''Q'': Defines the filter's slope in ]0.0-1.0], the higher, the steeper. Defaults to ~0.707107 (1/sqrt(2.0)).
 +  * ''Gain'': In dB. Positive for amplification, negative for damping. Defaults to 0 (no change).
 +
 +=== DelayFilter ===
 +
 +  * ''UseCustomParam'': When set to true, an event will be sent to override params values at runtime. Defaults to false, ie. no runtime override.
 +  * ''Delay'': In seconds. Cannot be overridden at runtime with UseCustomParam. Should be > 0.0.
 +  * ''Decay'': Amount of the "repeat" part, in [0.0-1.0]. 0.0 to deactivate the echo entirely and only introduce delay. Defaults to 0.0.
 +
  
-**NB: If you want to use spatialized sounds, they need to be recorded with a mono channel. Stereo sounds won't be spatialized.** 
  
 ==== Latest config settings for the Development Version ==== ==== Latest config settings for the Development Version ====
 {{section>en:orx:config:developmentversion#&noheader&nofooter&noeditbutton}} {{section>en:orx:config:developmentversion#&noheader&nofooter&noeditbutton}}
  
en/orx/config/settings_structure/orxsound.1512623970.txt.gz · Last modified: 2017/12/06 21:19 (6 years ago) by 127.0.0.1