Arma 3: Sound: SoundSet

SoundSet

SoundSet is second level of sound configuration. It contains array of SoundShaders to be mixed and parameters for advanced features and options.

All SoundSets have to be configured in the base class CfgSoundSets.

SoundSet in fact represents one single submixed sound, with the length of the longest sample used in the submix. Actual range of SoundSet is the highest range parameter value of all SoundShaders used within SoundSet and SoundSet's volumeCurve is applied (scaled) to that range. Use the same frequency wave files defined within single SoundSet (SoundShader respectively). For vehicles: soundSets must have only one soundShader for soundShader simple expressions to be updated all the time. Reatime-update does not work if there are more than 1 soundShader in soundSet.

parameter	unit/values	default	descriptions
soundShaders	{SoundShader1, ...}	none	array of SoundShader names to be submixed
soundShadersLimit	(0..n)	0 (no limit)	number of SoundShaders (with parameter limitation set to true) to be submixed in order from the highest volume. Volume here is ment to be output volume value after it is expression evaluation and applied rangeCurve SoundShaders with limitation parameter set to false will be processed always
volumeFactor	float (0..n) or dBx	1	multiplication factor for volume, both float and dBx values are possible volumeFactor = 0.5 is the same as volumeFactor = db-6
volumeCurve	{{d0, v0}, {d1, v1}, ... } or Class name	defaultVolumeCurve defined in CfgSoundGlobals	array of points or class name defined in CfgSoundCurves generally the same as rangeCurve, but applied on submix output sample and scaled to the highest range value of all SoundShaders defined within soundShaders array parameter (literally "defined", not actually playing)
volumeRandomizer	(0..6dB) [dB]	0	random multiplication factor for volume, calculated during each playback of SoundSet (volume = volume + random(-volumeRandomizer, volumeRandomizer))
volumeRandomizerMin	(0..6dB) [dB]	0	the lowest possible generated value of volumeRandomizer
frequencyFactor	(0..n)	1	multiplication factor for frequency
frequencyRandomizer	(0..12) [semitones]	0	random multiplication factor for frequency, calculated during each playback of SoundSet frequency = frequency * pow(2, frequencyRandomizer/12) 12 semitones = 1 octave = double/half speed
frequencyRandomizerMin	(0..12) [semitones]	0	the lowest possible generated value of frequencyRandomizer use it to guarantee a specific amount of pitch change on the next playback
loop	{0, 1} or boolean	0	defines looping of SoundSet play/stop of loop is handled by gameplay feature (engine)
playTrigger	simple expression	0	soundSet is triggered, once simple expression goes above 0 good for engine burst sounds (example: accelleration, use "thrust-0.1" to trigger)
shape	class name	none	name of soundShape configured in CfgSoundShapes will make sound louder/quieter depending on what side of asset is facing listener (bottom, front, back, left/right)
delay	[s]	0	time before next SoundSet is played (triggers feature of repeating playback of SoundSet) if set to nonzero value, loop parameter is automatically set to false
delayRandomizer	[s]	0	defines random time range <delay-delayRandomizer; delay+delayRandomizer> for repeating playback (normal distribution)
distanceFilter	Class name / "none"	defaultDistanceFilter defined in CfgSoundGlobals	distance frequency attenuation filter distanceFilter = "none"; removes filter from soundSet
sound3DProcessingType	Class name / "none"	defaultSound3DProcessingType defined in CfgSoundGlobals	sound processing type sound3DProcessingType = "none"; forces the engine to handle audio "the old way", stereo files are downmixed to mono and placed in the world
spatial	{0, 1} or boolean		switch for sound spatialization (positional vs ambient sound)
doppler	{0, 1} or boolean		switch for Doppler Effect filter
speedOfSound	{0, 1} or boolean		switch for simulation of delay based on distance
occlusionFactor	(0..1)		occVolumeFactor = 1-(1-GetOcclusion)*occlusionFactor; where GetOcclusion is value calculated from the scene
obstructionFactor	(0..1)		obsVolumeFactor = 1-(1-GetObstruction)*obstructionFactor; where GetObstruction is value calculated from the scene

class CfgSoundSets
{
	class Rifle_Shot_Base_SoundSet
	{
		soundShaders[] = 
		{
			MX_Closure_SoundShader,
			MX_closeShot_SoundShader,
			MX_midShot_SoundShader,
			MX_distShot_SoundShader,
			MX_tailInterior_SoundShader
		};
		volumeFactor = 1.6;
		volumeCurve = InverseSquare2Curve;
		sound3DProcessingType = WeaponMediumShot3DProcessingType;
		distanceFilter = weaponShotDistanceFreqAttenuationFilter;
		spatial = 1;
		doppler = 0;
		loop = 0;
	};
};