say: Difference between revisions

Latest revision as of 16:17, 25 February 2023

1.00

Hover & click on the images for description

Description

Description:

Make unit say given sound. The sound is defined in CfgSounds. If the unit is a person, it will also perform the corresponding lipsync effect provided an appropriate .lip file has been created for this sound.

A dead or non-existent unit obviously cannot say anything.
If the camera is not within given range, title is not shown and the sound will not be heard.
See also playSound in order to play a sound wherever the camera/player is.

ⓘ

say will mimic either say2D or say3D depending on whether it is executed in a cutscene or in a game scene.

Groups:

Sounds

Syntax

Syntax:

from say sound

Parameters:

from: Object or Array of Objects

Object - the sound source
Array - format [from, to]:
- from: Object - sound source
- to: Object - target

sound: String or Array

String - class name of the sound to be played. Defined in CfgSounds including Description.ext
Array - format [sound, maxTitlesDistance, speed]:
- sound: String - class name of the sound to be played. Defined in CfgSounds including Description.ext
- maxTitlesDistance: Number (Optional, default 100) - max. distance in meters at which the sound can be heard
- speed: Number (Optional, default 1) - pitch of the sound

Return Value:

Nothing

Examples

Example 1:: (units player select 1) say ["whisper1", 5];
Example 2:: player say "scuba_breath"; // Arma 3 vanilla sound

Additional Information

See also:: say3D say2D playSound createSoundSource playSoundUI

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

@@ Line 1: / Line 1: @@
 {{RV|type=command
-| ofp
+|game1= ofp
+|version1= 1.00
-|1.00
+|game2= ofpe
+|version2= 1.00
+|game3= arma1
+|version3= 1.00
+|game4= arma2
+|version4= 1.00
+|game5= arma2oa
+|version5= 1.50
+|game6= tkoh
+|version6= 1.00
+|game7= arma3
+|version7= 0.50
 |arg= global
@@ Line 11: / Line 28: @@
 |gr1= Sounds
-| Make unit say given sound. The sound is defined in [[Description.ext#CfgSounds|CfgSounds]]. If the [[Object#Unit|unit]] is a [[Object#Person|person]], it will also perform corresponding lipsync effect provided an appropriate .lip file has been created for this sound.
+|descr= Make unit say given sound. The sound is defined in [[Description.ext#CfgSounds|CfgSounds]].
+If the [[Object#Unit|unit]] is a [[Object#Person|person]], it will also perform the corresponding lipsync effect provided an appropriate [[Lip File Format|.lip file]] has been [[WaveToLip|created]] for this sound.
 * A dead or non-existent unit obviously cannot say anything.
@@ Line 17: / Line 35: @@
 * See also [[playSound]] in order to play a sound wherever the [[cameraOn|camera/player]] is.
-{{Feature | Informative | [[say]] will mimic either [[say2D]] or [[say3D]] depending on whether it is there executed in a cutscene or in a game scene.}}
+{{Feature|informative|[[say]] will mimic either [[say2D]] or [[say3D]] depending on whether it is executed in a cutscene or in a game scene.}}
-| from [[say]] sound
-|p1= from: [[Object]] - origin of the sound
-|p2= sound: [[String]] - sound classname
-| [[Nothing]]
-|s2 = from [[say]] [sound, maxTitlesDistance, speed]
-|p21= from: [[Object]] - origin of the sound
+|s1= from [[say]] sound
-|p22= sound: [[String]] - sound classname
+|p1= from: [[Object]] or [[Array]] of [[Object]]s
+* [[Object]] - the sound source
+* [[Array]] - format [from, to]:
+** from: [[Object]] - sound source
+** to: [[Object]] - target
-|p23= maxTitlesDistance: [[Number]] - max distance at which the sound can be heard. Default: 100 m.
+|p2= sound: [[String]] or [[Array]]
+* [[String]] - class name of the sound to be played. Defined in CfgSounds including [[Description.ext]]
+* [[Array]] - format [sound, maxTitlesDistance, speed]:
+** sound: [[String]] - class name of the sound to be played. Defined in CfgSounds including [[Description.ext]]
+** maxTitlesDistance: [[Number]] (Optional, default 100) - max. distance in meters at which the sound can be heard
+** speed: [[Number]] (Optional, default 1) - pitch of the sound
-|p24= speed: [[Number]] - (Optional, default 1) pitch of the sound
+|r1= [[Nothing]]
-|r2= [[Nothing]]
+|x1= <sqf>(units player select 1) say ["whisper1", 5];</sqf>
-|s3= [from, to] [[say]] sound
+|x2= <sqf>player say "scuba_breath"; // Arma 3 vanilla sound</sqf>
-|p41= from: [[Object]] - origin of the sound
+|seealso= [[say3D]] [[say2D]] [[playSound]] [[createSoundSource]] [[playSoundUI]]
-|p42= to: [[Object]] - target
-|p43= sound: [[String]] - sound classname
-|r3= [[Nothing]]
-|s4 = [from, to] [[say]] [sound, maxTitlesDistance, speed]
-|p61= from: [[Object]] - origin of the sound
-|p62= to: [[Object]] - target
-|p63= sound: [[String]] - sound classname
-|p64= maxTitlesDistance: [[Number]] - max distance at which the sound can be heard. Default: 100 m.
-|p65= speed: [[Number]] - (Optional, default 1) pitch of the sound.
-| r4= [[Nothing]]
-|x1= <code>([[units]] [[player]] [[select]] 1) [[say]] ["whisper1", 5];</code>
-|x2= Arma 3:<code>[[player]] [[say]] "scuba_breath";</code>
-| [[say3D]], [[say2D]], [[playSound]], [[createSoundSource]]
 }}
-<dl class="command_description">
-<!-- Note Section BEGIN -->
-<dd class="notedate">Posted on 7 March 2013</dd>
-<dt class="note">[[User:Rocket|Rocket]]</dt>
-<dd class="note">
-Say will occur in 3D when the player is active, during cutscenes it will not. Use [[say3D]] to force 3D effect for cutscenes.
-<!-- Note Section END -->
-</dl>
-[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
-[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
-{{GameCategory|arma1|Scripting Commands}}
-{{GameCategory|arma2|Scripting Commands}}
-{{GameCategory|arma3|Scripting Commands}}