Sound: SoundControllers – Arma 3
Jump to navigation
Jump to search
No edit summary |
m (fix typo) |
||
(35 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
== Sound Controllers == | |||
Sound controllers deliver data from the engine in real time which makes them perfect to control volumes and frequencies of sounds. If you want to monitor sound controllers, you can use these functions: | Sound controllers deliver data from the engine in real time which makes them perfect to control volumes and frequencies of sounds. If you want to monitor sound controllers, you can use these functions: | ||
{| class="wikitable align-center-col-2" | |||
! Command | |||
! Usable On | |||
|- | |||
| [[getAllSoundControllers]] | |||
| rowspan="3" | Vehicles | |||
|- | |||
| [[getSoundController]] | |||
|- | |||
| [[getSoundControllerResult]] | |||
|- | |||
| [[getAllEnvSoundControllers]] | |||
| rowspan="2" | Positions | |||
|- | |||
| [[getEnvSoundController]] | |||
|- | |||
| [[getAllEnv3DSoundControllers]] | |||
| rowspan="3" | Environmental objects | |||
|- | |||
| [[getEnv3DSoundController]] | |||
|- | |||
| [[allEnv3DSoundSources]] | |||
|} | |||
Also look at this | Also look at this {{Link|https://forums.bistudio.com/topic/187202-arma-3-sound-modding-101/?p{{=}}3049207|forum post}} for a video showcase and a great and simple to use example mission. | ||
{| class="wikitable sortable align-center" | |||
|- class="align-center" | |||
! Sound Controller | |||
! Description / Notes | |||
! type/range of value | |||
! Usable in EnvSounds | |||
! CfgWeapons | |||
! CfgAmmo | |||
! CfgVehicles (Land) | |||
! CfgVehicles (Helicopter) | |||
! CfgVehicles (Plane) | |||
! CfgVehicles (Ship) | |||
|- | |||
| interior | |||
| Surface texture name below character character starts with int_, character is inside building (time based transition, 0.8s) | |||
| <0;1> | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|unchecked}} | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| houses | |||
| local density of object type “building”, derived from map | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| meadow | |||
| derived from map - probably outdated: getAllEnvSoundControllers returns meadows (A3 1.80) | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| meadows | |||
| derived from map | |||
| <0;1> | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| forest | |||
| local density of trees, derived from map | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| trees | |||
| local density of trees (different settings), derived from map | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| sea | |||
| derived from map | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| '''windy''' | |||
| ambient map wind intensity (soundSetEnvironment). See [[getAllEnvSoundControllers]] | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| {{Icon|unchecked}} | |||
| {{Icon|unchecked}} | |||
| {{Icon|unchecked}} | |||
| {{Icon|unchecked}} | |||
| {{Icon|unchecked}} | |||
| {{Icon|unchecked}} | |||
|- | |||
| '''wind''' | |||
| wind intensity. See [[getAllEnv3DSoundControllers]] | |||
| <0;1> | |||
| {{Icon|unchecked}} | |||
| {{Icon|unchecked}} | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| rain | |||
| rain intensity. This controller is zeroed for all types when snow = true in RainParticles config | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| {{Icon|unchecked}} | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| fog | |||
| fog intensity | |||
| <0;1> | |||
| {{Icon|unknown}} | |||
| {{Icon|unknown}} | |||
| | |||
| {{Icon|unknown}} | |||
| {{Icon|unknown}} | |||
| {{Icon|unknown}} | |||
| | |||
|- | |||
| daytime | |||
| relative daytime (0 = midnight, 0.5 = noon) | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| night | |||
| night time with transitions at ~17:30-18:00 and 07:00 – 07:15 | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| {{Icon|unchecked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| rainDrops | |||
| Rain drop sound occlusion. How much the rain drops can be heard, 1 no occlusion 0 full occlusion. If 'snow' is set to true, rainDrops is 0 (3D Env controllers) | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| altitudeGround | |||
| ground altitude | |||
| m | |||
| {{Icon|checked}} | |||
| {{Icon|unchecked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| altitudeSea | |||
| sea level altitude | |||
| m | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| coast | |||
| precise sea shore detection, calculation includes high above sea level (~50m) | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| {{Icon|unchecked}} | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| waterDepth | |||
| sea depth - not available as EnvSoundController (A3 1.80) | |||
| m | |||
| {{Icon|checked}} | |||
| {{Icon|unchecked}} | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| distance | |||
| distance to player? | |||
| m | |||
| {{Icon|unknown}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| shooting | |||
| firefight detection, 1 = no firefight, value is divided by 2 with every shot | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| deadBody | |||
| presense of dead body (~10m) | |||
| <0;1> | |||
| {{Icon|checked}} | |||
| {{Icon|unchecked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| rpm | |||
| actual rpm of the vehicle engine | |||
| rpm | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| randomizer | |||
| generates random number between 0 and 1 (once per live of instance) | |||
| <0;1> | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| speed | |||
| actual speed of the vehicle | |||
| m/s | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| thrust | |||
| thrust of the vehicle engine (acceleration) | |||
| <0;1> | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| camPos | |||
| position of camera (0 = internal, 1 = external) | |||
| <0;1> | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| playerPos | |||
| position of player within the vehicle (0 = front, 1 = Passenger) | |||
| <0;1> | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| engineOn | |||
| state of vehicle engine | |||
| 0/1 | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| angVelocity | |||
| speed of rotation (in all axes) | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| gmeterZ | |||
| accelleration meter | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| roughness | |||
| roughness of surface (0 = "glass") | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| dustness | |||
| roughness of surface (0 = no dust) | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| damper0 | |||
| dampers | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| rock | |||
| surface type | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| sand | |||
| surface type | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| grass | |||
| surface type | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| mud | |||
| surface type | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| gravel | |||
| surface type | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| asphalt | |||
| surface type | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| water | |||
| surface type | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
|- | |||
| latSlip | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| latSlipDrive | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| longSlip | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| longSlipDrive | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
|- | |||
| lateralMovement | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| machCone | |||
| only for Jets, makes sure sound is within machCone, if not -> sound will be silent | |||
| <0;1> | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| gear | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
|- | |||
| flaps | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}}<br>(buggy) | |||
| | |||
|- | |||
| envelope | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
|- | |||
| rotorThrust | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
|- | |||
| rotorSpeed | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
|- | |||
| rotorDamage | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
|- | |||
| motorDamage | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
|- | |||
| transmissionDamage | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
|- | |||
| slingLoadActive | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
|- | |||
| scrubLand | |||
| object is scrubbing terrain | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}}<br>(VTOL,UAV) | |||
| {{Icon|checked}} | |||
|- | |||
| scrubObject | |||
| object is scrubbing another object (vehicle ↔ vehicle) | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
|- | |||
| scrubTree | |||
| object is scrubbing object type: tree | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}}<br>(VTOL) | |||
| | |||
|- | |||
| scrubBuilding | |||
| object is scrubbing object type: building | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| {{Icon|checked}}<br>(VTOL,UAV) | |||
| | |||
|- | |||
| scrubArmor | |||
| object is scrubbing armored vehicle (tank) | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| {{Icon|checked}} | |||
| | |||
| | |||
|- | |||
| yearTime | |||
| Time of the year in 0..1 range ''(Since Arma 3 v2.07.148385)'' | |||
| [0,1[ | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| {{GVI|arma3|2.08|size= 0.75}} ambientTemp | |||
| Ambient air temperature, see [[ambientTemperature]] | |||
| min..max world temperature in Celsius | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|- | |||
| {{GVI|arma3|2.08|size= 0.75}} snow | |||
| 1 if "RainParticle" config 'snow' = true, 0 if false. When snow is 1, 'rainDrops' is 0 | |||
| 1 or 0 | |||
| {{Icon|checked}} | |||
| | |||
| | |||
| | |||
| | |||
| | |||
| | |||
|} | |||
{{GameCategory|arma3|Sound}} | |||
Latest revision as of 13:48, 6 September 2023
Sound Controllers
Sound controllers deliver data from the engine in real time which makes them perfect to control volumes and frequencies of sounds. If you want to monitor sound controllers, you can use these functions:
Command | Usable On |
---|---|
getAllSoundControllers | Vehicles |
getSoundController | |
getSoundControllerResult | |
getAllEnvSoundControllers | Positions |
getEnvSoundController | |
getAllEnv3DSoundControllers | Environmental objects |
getEnv3DSoundController | |
allEnv3DSoundSources |
Also look at this forum post for a video showcase and a great and simple to use example mission.
Sound Controller | Description / Notes | type/range of value | Usable in EnvSounds | CfgWeapons | CfgAmmo | CfgVehicles (Land) | CfgVehicles (Helicopter) | CfgVehicles (Plane) | CfgVehicles (Ship) |
---|---|---|---|---|---|---|---|---|---|
interior | Surface texture name below character character starts with int_, character is inside building (time based transition, 0.8s) | <0;1> | |||||||
houses | local density of object type “building”, derived from map | <0;1> | |||||||
meadow | derived from map - probably outdated: getAllEnvSoundControllers returns meadows (A3 1.80) | <0;1> | |||||||
meadows | derived from map | <0;1> | |||||||
forest | local density of trees, derived from map | <0;1> | |||||||
trees | local density of trees (different settings), derived from map | <0;1> | |||||||
sea | derived from map | <0;1> | |||||||
windy | ambient map wind intensity (soundSetEnvironment). See getAllEnvSoundControllers | <0;1> | |||||||
wind | wind intensity. See getAllEnv3DSoundControllers | <0;1> | |||||||
rain | rain intensity. This controller is zeroed for all types when snow = true in RainParticles config | <0;1> | |||||||
fog | fog intensity | <0;1> | |||||||
daytime | relative daytime (0 = midnight, 0.5 = noon) | <0;1> | |||||||
night | night time with transitions at ~17:30-18:00 and 07:00 – 07:15 | <0;1> | |||||||
rainDrops | Rain drop sound occlusion. How much the rain drops can be heard, 1 no occlusion 0 full occlusion. If 'snow' is set to true, rainDrops is 0 (3D Env controllers) | <0;1> | |||||||
altitudeGround | ground altitude | m | |||||||
altitudeSea | sea level altitude | m | |||||||
coast | precise sea shore detection, calculation includes high above sea level (~50m) | <0;1> | |||||||
waterDepth | sea depth - not available as EnvSoundController (A3 1.80) | m | |||||||
distance | distance to player? | m | |||||||
shooting | firefight detection, 1 = no firefight, value is divided by 2 with every shot | <0;1> | |||||||
deadBody | presense of dead body (~10m) | <0;1> | |||||||
rpm | actual rpm of the vehicle engine | rpm | |||||||
randomizer | generates random number between 0 and 1 (once per live of instance) | <0;1> | |||||||
speed | actual speed of the vehicle | m/s | |||||||
thrust | thrust of the vehicle engine (acceleration) | <0;1> | |||||||
camPos | position of camera (0 = internal, 1 = external) | <0;1> | |||||||
playerPos | position of player within the vehicle (0 = front, 1 = Passenger) | <0;1> | |||||||
engineOn | state of vehicle engine | 0/1 | |||||||
angVelocity | speed of rotation (in all axes) | ||||||||
gmeterZ | accelleration meter | ||||||||
roughness | roughness of surface (0 = "glass") | ||||||||
dustness | roughness of surface (0 = no dust) | ||||||||
damper0 | dampers | ||||||||
rock | surface type | ||||||||
sand | surface type | ||||||||
grass | surface type | ||||||||
mud | surface type | ||||||||
gravel | surface type | ||||||||
asphalt | surface type | ||||||||
water | surface type | ||||||||
latSlip | |||||||||
latSlipDrive | |||||||||
longSlip | |||||||||
longSlipDrive | |||||||||
lateralMovement | |||||||||
machCone | only for Jets, makes sure sound is within machCone, if not -> sound will be silent | <0;1> | |||||||
gear | |||||||||
flaps | (buggy) |
||||||||
envelope | |||||||||
rotorThrust | |||||||||
rotorSpeed | |||||||||
rotorDamage | |||||||||
motorDamage | |||||||||
transmissionDamage | |||||||||
slingLoadActive | |||||||||
scrubLand | object is scrubbing terrain | (VTOL,UAV) |
|||||||
scrubObject | object is scrubbing another object (vehicle ↔ vehicle) | ||||||||
scrubTree | object is scrubbing object type: tree | (VTOL) |
|||||||
scrubBuilding | object is scrubbing object type: building | (VTOL,UAV) |
|||||||
scrubArmor | object is scrubbing armored vehicle (tank) | ||||||||
yearTime | Time of the year in 0..1 range (Since Arma 3 v2.07.148385) | [0,1[ | |||||||
2.08 ambientTemp | Ambient air temperature, see ambientTemperature | min..max world temperature in Celsius | |||||||
2.08 snow | 1 if "RainParticle" config 'snow' = true, 0 if false. When snow is 1, 'rainDrops' is 0 | 1 or 0 |