setSoundEffect: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *P([a-gi-z ])" to "$1 - p$2")
 
(104 intermediate revisions by 17 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|SETSOUNDEFFECT]]
{{RV|type=command
[[Category:Scripting Commands OFP Elite |SETSOUNDEFFECT]]
[[Category:Scripting Commands ArmA|SETSOUNDEFFECT]]


|game1= arma1
|version1= 1.00


<h2 style="color:#000066">'''''trigger or waypoint'' setSoundEffect ''[sound, voice, soundEnv, soundDet]'''''</h2>
|game2= arma2
|version2= 1.00


|game3= arma2oa
|version3= 1.50


'''Operand types:'''
|game4= tkoh
|version4= 1.00


'''trigger or waypoint:''' [[Object]] or [[Array]]
|game5= arma3
|version5= 0.50


'''[sound, voice, soundEnv, soundDet]:''' [[Array]]
|gr1= Sounds


'''Type of returned value:'''
|gr2= Triggers


[[Nothing]]
|gr3= Waypoints


'''Compatibility:'''
|descr= Defines the different sound effects for a trigger or a waypoint. To stop any sound, deactivate the trigger (might take up to 0.5 seconds to stop) or delete the trigger/waypoint (immediate).


Version 1.86 required.
|s1= trigger [[setSoundEffect]] [sound, voice, soundEnv, soundDet]


'''Description:'''
|p1= trigger: [[Object]]


Defines the different sound effects. Sound / voice plays a 2D / 3D sound from CfgSounds. SoundEnv plays an enviromental sound from CfgEnvSounds. SoundDet (only for triggers) creates a dynamic sound object attached to a trigger defined in CfgSFX.
|p2= sound: [[String]] - plays a 2D sound as if [[playSound]] was used from CfgSounds (mission or main config). Use {{hl|"$NONE$"}} for an empty sound


'''Example:'''
|p3= voice: [[String]] - attaches a 3D sound from CfgSounds (mission or main config) to the object that activated the trigger and plays it as if [[say3D]] was used


trigger '''setSoundEffect''' ["Alarm", "", "", ""]
|p4= soundEnv: [[String]] - plays an environmental sound from CfgEnvSounds (mission or main config)
 
|p5= soundDet: [[String]] - creates a dynamic sound object attached to a trigger defined in [[CfgSFX]] (mission or main config)
 
|r1= [[Nothing]]
 
|s2= waypoint [[setSoundEffect]] [sound, voice]
 
|p21= waypoint: [[Array]] - format [[Waypoint]]
 
|p22= sound: [[String]] - plays a 2D sound as if [[playSound]] was used from CfgSounds (mission or main config)
 
|p23= voice: [[String]] - attaches a 3D sound from CfgSounds (mission or main config) to the object that activated the trigger and plays it as if [[say3D]] was used
 
|r2= [[Nothing]]
 
|x1= <sqf>_trigger setSoundEffect ["Alarm", "", "", ""];</sqf>
 
|x2= <sqf>[_group1, 2] setSoundEffect ["Alarm", ""];</sqf>
 
|x3= <sqf>_trigger setSoundEffect ["$NONE$", "Alarm", "", ""];</sqf>
 
|x4= <sqf>_trigger setSoundEffect ["$NONE$", "", "BattlefieldExplosions3", ""];</sqf>
 
|x5= <sqf>_trigger setSoundEffect ["$NONE$", "", "", "Owl"];</sqf>
 
|seealso= [[createTrigger]] [[setMusicEffect]] [[setTitleEffect]]
}}

Latest revision as of 16:45, 8 November 2023

Hover & click on the images for description

Description

Description:
Defines the different sound effects for a trigger or a waypoint. To stop any sound, deactivate the trigger (might take up to 0.5 seconds to stop) or delete the trigger/waypoint (immediate).
Groups:
SoundsTriggersWaypoints

Syntax

Syntax:
trigger setSoundEffect [sound, voice, soundEnv, soundDet]
Parameters:
trigger: Object
sound: String - plays a 2D sound as if playSound was used from CfgSounds (mission or main config). Use "$NONE$" for an empty sound
voice: String - attaches a 3D sound from CfgSounds (mission or main config) to the object that activated the trigger and plays it as if say3D was used
soundEnv: String - plays an environmental sound from CfgEnvSounds (mission or main config)
soundDet: String - creates a dynamic sound object attached to a trigger defined in CfgSFX (mission or main config)
Return Value:
Nothing

Alternative Syntax

Syntax:
waypoint setSoundEffect [sound, voice]
Parameters:
waypoint: Array - format Waypoint
sound: String - plays a 2D sound as if playSound was used from CfgSounds (mission or main config)
voice: String - attaches a 3D sound from CfgSounds (mission or main config) to the object that activated the trigger and plays it as if say3D was used
Return Value:
Nothing

Examples

Example 1:
_trigger setSoundEffect ["Alarm", "", "", ""];
Example 2:
[_group1, 2] setSoundEffect ["Alarm", ""];
Example 3:
_trigger setSoundEffect ["$NONE$", "Alarm", "", ""];
Example 4:
_trigger setSoundEffect ["$NONE$", "", "BattlefieldExplosions3", ""];
Example 5:
_trigger setSoundEffect ["$NONE$", "", "", "Owl"];

Additional Information

See also:
createTrigger setMusicEffect setTitleEffect

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note