Arma 3: Sound: SoundShader

SoundShader

SoundShader is the lowest level of sound configuration. It contains the definition of sound files and basic set of parameters.

All SoundShaders have to be defined in the base class CfgSoundShaders.

ⓘ

For single SoundShader (SoundSet respectively), use sound files with the same sampling rate.

Parameter	Unit/values	Default	Description
samples	{ ["path/sound",p], ... }	none	array containing sound file name with paths and probability values (p), wav, wss, ogg are accepted file types, 16bit/44.1KHz wav converted to wss should always work fine probability values are normalized to 1, in every case there is one sample selected no immediate repeat (engine never selects the same sample twice in a row)
volume	float (0..n) or [dBFS]	1 (= db0)	base volume value use format dbx for decibels in dBFS (e.g. db-6 for -6 dBFS) use float number to specify amplitude value directly
frequency	(0.5..2)	1	base pitch value, 1 = no change if shader is used in submix (more than one SoundShader in SoundSet), this parameter is currently ignored
range	(0..n) [m]	0	radius of sphere (with center on sound source position) where sound is playing
rangeCurve	{{d0, v0}, {d1, v1}, ... } or Class name	none	array of points & corresponding amplitude multipliers or class name defined in cfgSoundCurves if shader is not used in submix (meaning it is the only one SoundShader in SoundSet), this parameter is currently ignored
limitation	bool	false	adds SoundShader to the group of SoundShaders, where number of simultaneously playing SoundShaders will be limited (within single SoundSet)

class CfgSoundShaders
{
	class ACPC2_closeShot_SoundShader
	{
		samples[] = 
		{
			{ "A3\Sounds_F\arsenal\weapons\Pistols\Acpc2\ACPC2_closeShot_01", 1 },
			{ "A3\Sounds_F\arsenal\weapons\Pistols\Acpc2\ACPC2_closeShot_02", 1 },
			{ "A3\Sounds_F\arsenal\weapons\Pistols\Acpc2\ACPC2_closeShot_03", 2 } // example: sample has a higher chance of being picked
		};
		volume = db3; // additional gain, +3dB
		range = 50;
		rangeCurve = closeShotCurve; //classname of a curve, defined in cfgSoundCurves
};