Sound: SoundControllers – Arma 3

From Bohemia Interactive Community
Jump to navigation Jump to search
(so this stands out)
m (fix typo)
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{GameCategory|arma3|Sound}}
== Sound Controllers ==


= 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:
*[[getAllSoundControllers]] - can only be used on vehicles.
{| class="wikitable align-center-col-2"
*[[getSoundController]] - can only be used on vehicles.
! Command
*[[getSoundControllerResult]] - can only be used on vehicles.
! Usable On
*[[getAllEnvSoundControllers]] - can only be used on positions.
|-
*[[getEnvSoundController]] - can only be used on positions.
| [[getAllSoundControllers]]
| rowspan="3" | Vehicles
|-
| [[getSoundController]]
|-
| [[getSoundControllerResult]]
|-
| [[getAllEnvSoundControllers]]
| rowspan="2" | Positions
|-
| [[getEnvSoundController]]
|-
| [[getAllEnv3DSoundControllers]]
| rowspan="3" | Environmental objects
|-
| [[getEnv3DSoundController]]
|-
| [[allEnv3DSoundSources]]
|}


Also look at this {{ExternalLink|link= https://forums.bistudio.com/topic/187202-arma-3-sound-modding-101/?p=3049207|text= forum post}} for a video showcase and a great and simple to use example mission.
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" border="1"
{| class="wikitable sortable align-center"
!Sound Controller
|- class="align-center"
!Description / Notes
! Sound Controller
!type/range of value
! Description / Notes
!Usable in EnvSounds
! type/range of value
!CfgWeapons
! Usable in EnvSounds
!CfgAmmo
! CfgWeapons
!CfgVehicles (Land)
! CfgAmmo
!CfgVehicles (Helicopter)
! CfgVehicles (Land)
!CfgVehicles (Plane)
! CfgVehicles (Helicopter)
!CfgVehicles (Ship)
! CfgVehicles (Plane)
! CfgVehicles (Ship)
|-
|-
|interior
| interior
|Surface texture name below character character starts with int_, character is inside building (time based transition, 0.8s)
| Surface texture name below character character starts with int_, character is inside building (time based transition, 0.8s)
|<0;1>
| <0;1>
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|unchecked}}
|
|
|
|
Line 34: Line 52:
|
|
|-
|-
|houses
| houses
|local density of object type “building”, derived from map
| local density of object type “building”, derived from map
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|
|
Line 45: Line 63:
|
|
|-
|-
|meadow
| meadow
|derived from map - probably outdated: getAllEnvSoundControllers returns meadows (A3 1.80)
| derived from map - probably outdated: getAllEnvSoundControllers returns meadows (A3 1.80)
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|
|
|
|
Line 56: Line 74:
|
|
|-
|-
|meadows
| meadows
|derived from map
| derived from map
|<0;1>
| <0;1>
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|
|
Line 67: Line 85:
|
|
|-
|-
|forest
| forest
|local density of trees, derived from map
| local density of trees, derived from map
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|
|
Line 78: Line 96:
|
|
|-
|-
|trees
| trees
|local density of trees (different settings), derived from map
| local density of trees (different settings), derived from map
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|
|
Line 89: Line 107:
|
|
|-
|-
|sea
| sea
|derived from map
| derived from map
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|
|
Line 100: Line 118:
|
|
|-
|-
|'''windy'''
| '''windy'''
|ambient map wind intensity (soundSetEnvironment)
| ambient map wind intensity (soundSetEnvironment). See [[getAllEnvSoundControllers]]
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|No
| {{Icon|unchecked}}
|No
| {{Icon|unchecked}}
|No
| {{Icon|unchecked}}
|No
| {{Icon|unchecked}}
|No
| {{Icon|unchecked}}
|No
| {{Icon|unchecked}}
|-
|-
|'''wind'''
| '''wind'''
|wind intensity
| wind intensity. See [[getAllEnv3DSoundControllers]]
|<0;1>
| <0;1>
|No
| {{Icon|unchecked}}
|No
| {{Icon|unchecked}}
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|rain
| rain
|rain intensity
| rain intensity. This controller is zeroed for all types when snow = true in RainParticles config
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|No
| {{Icon|unchecked}}
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|fog
| fog
|fog intensity
| fog intensity
|<0;1>
| <0;1>
|?
| {{Icon|unknown}}
|?
| {{Icon|unknown}}
|
|
|?
| {{Icon|unknown}}
|?
| {{Icon|unknown}}
|?
| {{Icon|unknown}}
|
|
|-
|-
|daytime
| daytime
|relative daytime (0 = midnight, 0.5 = noon)
| relative daytime (0 = midnight, 0.5 = noon)
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|
|
|
|
Line 155: Line 173:
|
|
|-
|-
|night
| night
|night time with transitions at ~17:30-18:00 and 07:00 – 07:15
| night time with transitions at ~17:30-18:00 and 07:00 – 07:15
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|No
| {{Icon|unchecked}}
|
|
|
|
Line 166: Line 184:
|
|
|-
|-
|rainDrops
| rainDrops
|presence/density of objects above SoundSource location - not available as EnvSoundController (A3 1.80)
| 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>
| <0;1>
|Yes
| {{Icon|checked}}
|
|
|
|
Line 177: Line 195:
|
|
|-
|-
|altitudeGround
| altitudeGround
|gound altitude
| ground altitude
|m
| m
|Yes
| {{Icon|checked}}
|No
| {{Icon|unchecked}}
|
|
|
|
Line 188: Line 206:
|
|
|-
|-
|altitudeSea
| altitudeSea
|sea level altitude
| sea level altitude
|m
| m
|Yes
| {{Icon|checked}}
|
|
|
|
Line 199: Line 217:
|
|
|-
|-
|coast
| coast
|precise sea shore detection, calculation includes high above sea level (~50m)
| precise sea shore detection, calculation includes high above sea level (~50m)
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|No
| {{Icon|unchecked}}
|Yes
| {{Icon|checked}}
|
|
|
|
Line 210: Line 228:
|
|
|-
|-
|waterDepth
| waterDepth
|sea depth - not available as EnvSoundController (A3 1.80)
| sea depth - not available as EnvSoundController (A3 1.80)
|m
| m
|Yes
| {{Icon|checked}}
|No
| {{Icon|unchecked}}
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|distance
| distance
|distance to player?
| distance to player?
|m
| m
|?
| {{Icon|unknown}}
|
|
|
|
Line 232: Line 250:
|
|
|-
|-
|shooting
| shooting
|firefight detection, 1 = no firefight, value is divided by 2 with every shot
| firefight detection, 1 = no firefight, value is divided by 2 with every shot
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|
|
|
|
Line 243: Line 261:
|
|
|-
|-
|deadBody
| deadBody
|presense of dead body (~10m)
| presense of dead body (~10m)
|<0;1>
| <0;1>
|Yes
| {{Icon|checked}}
|No
| {{Icon|unchecked}}
|
|
|
|
Line 254: Line 272:
|
|
|-
|-
|rpm
| rpm
|actual rpm of the vehicle engine
| actual rpm of the vehicle engine
|rpm
| rpm
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|randomizer
| randomizer
|generates random number between 0 and 1 (once per live of instance)
| generates random number between 0 and 1 (once per live of instance)
|<0;1>
| <0;1>
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|speed
| speed
|actual speed of the vehicle
| actual speed of the vehicle
|m/s
| m/s
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|thrust
| thrust
|thrust of the vehicle engine (acceleration)
| thrust of the vehicle engine (acceleration)
|<0;1>
| <0;1>
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|camPos
| camPos
|position of camera (0 = internal, 1 = external)
| position of camera (0 = internal, 1 = external)
|<0;1>
| <0;1>
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|playerPos
| playerPos
|position of player within the vehicle (0 = front, 1 = Passenger)
| position of player within the vehicle (0 = front, 1 = Passenger)
|<0;1>
| <0;1>
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|engineOn
| engineOn
|state of vehicle engine
| state of vehicle engine
|0/1
| 0/1
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|angVelocity
| angVelocity
|speed of rotation (in all axes)
| speed of rotation (in all axes)
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|gmeterZ
| gmeterZ
|accelleration meter
| accelleration meter
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|roughness
| roughness
|roughness of surface (0 = "glass")
| roughness of surface (0 = "glass")
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|dustness
| dustness
|roughness of surface (0 = no dust)
| roughness of surface (0 = no dust)
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|damper0
| damper0
|dampers
| dampers
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|rock
| rock
|surface type
| surface type
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|sand
| sand
|surface type
| surface type
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|grass
| grass
|surface type
| surface type
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|mud
| mud
|surface type
| surface type
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|gravel
| gravel
|surface type
| surface type
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|asphalt
| asphalt
|surface type
| surface type
|
|
|
|
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|water
| water
|surface type
| surface type
|
|
|
|
Line 459: Line 477:
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|-
|-
|latSlip
| latSlip
|
|
|
|
Line 469: Line 487:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|latSlipDrive
| latSlipDrive
|
|
|
|
Line 480: Line 498:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|longSlip
| longSlip
|
|
|
|
Line 491: Line 509:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|longSlipDrive
| longSlipDrive
|
|
|
|
Line 502: Line 520:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|
|
|-
|-
|lateralMovement
| lateralMovement
|
|
|
|
Line 513: Line 531:
|
|
|
|
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|Yes
| {{Icon|checked}}
|
|
|-
|-
|machCone
| machCone
|only for Jets, makes sure sound is within machCone, if not -> sound will be silent
| only for Jets, makes sure sound is within machCone, if not -> sound will be silent
|<0;1>
| <0;1>
|
|
|
|
Line 526: Line 544:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|-
|-
|gear
| gear
|
|
|
|
Line 537: Line 555:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|-
|-
|flaps
| flaps
|
|
|
|
Line 548: Line 566:
|
|
|
|
|Yes (buggy)
| {{Icon|checked}}<br>(buggy)
|
|
|-
|-
|envelope
| envelope
|
|
|
|
Line 558: Line 576:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|-
|-
|rotorThrust
| rotorThrust
|
|
|
|
Line 569: Line 587:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|-
|-
|rotorSpeed
| rotorSpeed
|
|
|
|
Line 580: Line 598:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|-
|-
|rotorDamage
| rotorDamage
|
|
|
|
Line 591: Line 609:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|-
|-
|motorDamage
| motorDamage
|
|
|
|
Line 602: Line 620:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|-
|-
|transmissionDamage
| transmissionDamage
|
|
|
|
Line 613: Line 631:
|
|
|
|
|Yes
| {{Icon|checked}}
|
|
|
|
|-
|-
|slingLoadActive
| slingLoadActive
|
|
|
|
|
|
|
| {{Icon|checked}}
|
|
|
|
|-
| scrubLand
| object is scrubbing terrain
|
|
|
|
|
|
|Yes
|
|
|
|
| {{Icon|checked}}
| {{Icon|checked}}<br>(VTOL,UAV)
| {{Icon|checked}}
|-
|-
|scrubLand
| scrubObject
|object is scrubbing terrain
| object is scrubbing another object (vehicle ↔ vehicle)
|
|
|
|
|
|
|
|
| {{Icon|checked}}
|
|
|
|
|Yes
|Yes (VTOL,UAV)
|Yes
|-
|-
|scrubObject
| scrubTree
|object is scrubbing another object (vehicle ↔ vehicle)
| object is scrubbing object type: tree
|
|
|
|
Line 646: Line 675:
|
|
|
|
|Yes
| {{Icon|checked}}
| {{Icon|checked}}<br>(VTOL)
|
|
|-
| scrubBuilding
| object is scrubbing object type: building
|
|
|
|
|
| {{Icon|checked}}
| {{Icon|checked}}<br>(VTOL,UAV)
|
|
|-
|-
|scrubTree
| scrubArmor
|object is scrubbing object type: tree
| object is scrubbing armored vehicle (tank)
|
|
|
|
|
|
|
|
|
| {{Icon|checked}}
|
|
|Yes
|Yes (VTOL)
|
|
|-
|-
|scrubBuilding
| yearTime
|object is scrubbing object type: building
| Time of the year in 0..1 range &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;''(Since Arma 3 v2.07.148385)''
| [0,1[
| {{Icon|checked}}
|
|
|
|
Line 668: Line 710:
|
|
|
|
|Yes
|Yes (VTOL,UAV)
|
|
|-
|-
|scrubArmor
| {{GVI|arma3|2.08|size= 0.75}} ambientTemp
|object is scrubbing armored vehicle (tank)
| Ambient air temperature, see [[ambientTemperature]]
| min..max world temperature in Celsius
| {{Icon|checked}}
|
|
|
|
Line 679: Line 721:
|
|
|
|
|Yes
|
|-
| {{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> Checked Unchecked
houses local density of object type “building”, derived from map <0;1> Checked Checked Checked
meadow derived from map - probably outdated: getAllEnvSoundControllers returns meadows (A3 1.80) <0;1> Checked
meadows derived from map <0;1> Checked Checked
forest local density of trees, derived from map <0;1> Checked Checked Checked
trees local density of trees (different settings), derived from map <0;1> Checked Checked Checked
sea derived from map <0;1> Checked Checked Checked
windy ambient map wind intensity (soundSetEnvironment). See getAllEnvSoundControllers <0;1> Checked Unchecked Unchecked Unchecked Unchecked Unchecked Unchecked
wind wind intensity. See getAllEnv3DSoundControllers <0;1> Unchecked Unchecked Checked Checked Checked
rain rain intensity. This controller is zeroed for all types when snow = true in RainParticles config <0;1> Checked Unchecked Checked Checked Checked
fog fog intensity <0;1> Unknown Unknown Unknown Unknown Unknown
daytime relative daytime (0 = midnight, 0.5 = noon) <0;1> Checked
night night time with transitions at ~17:30-18:00 and 07:00 – 07:15 <0;1> Checked 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> Checked
altitudeGround ground altitude m Checked Unchecked
altitudeSea sea level altitude m Checked
coast precise sea shore detection, calculation includes high above sea level (~50m) <0;1> Checked Unchecked Checked
waterDepth sea depth - not available as EnvSoundController (A3 1.80) m Checked Unchecked Checked
distance distance to player? m Unknown
shooting firefight detection, 1 = no firefight, value is divided by 2 with every shot <0;1> Checked
deadBody presense of dead body (~10m) <0;1> Checked Unchecked
rpm actual rpm of the vehicle engine rpm Checked Checked Checked
randomizer generates random number between 0 and 1 (once per live of instance) <0;1> Checked Checked Checked
speed actual speed of the vehicle m/s Checked Checked Checked
thrust thrust of the vehicle engine (acceleration) <0;1> Checked Checked Checked
camPos position of camera (0 = internal, 1 = external) <0;1> Checked Checked Checked
playerPos position of player within the vehicle (0 = front, 1 = Passenger) <0;1> Checked Checked Checked
engineOn state of vehicle engine 0/1 Checked Checked Checked
angVelocity speed of rotation (in all axes) Checked Checked Checked
gmeterZ accelleration meter Checked Checked Checked
roughness roughness of surface (0 = "glass") Checked
dustness roughness of surface (0 = no dust) Checked
damper0 dampers Checked
rock surface type Checked
sand surface type Checked
grass surface type Checked
mud surface type Checked
gravel surface type Checked
asphalt surface type Checked
water surface type Checked Checked Checked
latSlip Checked
latSlipDrive Checked
longSlip Checked
longSlipDrive Checked
lateralMovement Checked Checked Checked
machCone only for Jets, makes sure sound is within machCone, if not -> sound will be silent <0;1> Checked
gear Checked
flaps Checked
(buggy)
envelope Checked
rotorThrust Checked
rotorSpeed Checked
rotorDamage Checked
motorDamage Checked
transmissionDamage Checked
slingLoadActive Checked
scrubLand object is scrubbing terrain Checked Checked
(VTOL,UAV)
Checked
scrubObject object is scrubbing another object (vehicle ↔ vehicle) Checked
scrubTree object is scrubbing object type: tree Checked Checked
(VTOL)
scrubBuilding object is scrubbing object type: building Checked Checked
(VTOL,UAV)
scrubArmor object is scrubbing armored vehicle (tank) Checked
yearTime Time of the year in 0..1 range      (Since Arma 3 v2.07.148385) [0,1[ Checked
Arma 3 logo black.png2.08 ambientTemp Ambient air temperature, see ambientTemperature min..max world temperature in Celsius Checked
Arma 3 logo black.png2.08 snow 1 if "RainParticle" config 'snow' = true, 0 if false. When snow is 1, 'rainDrops' is 0 1 or 0 Checked