SetSoundProperties: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(3 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{Client function}}
{{Client function}}
{{New feature/item|3.0130|1.3.0|4097|
{{New feature/item|3.0130|1.3.0|4097|
This function edit's the properties of a specific [[sound]].
This function edits the properties of a specific [[sound]].
}}
}}
{{Note|Streams are not supported.}}


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">bool setSoundProperties(element sound, float fSampleRate, float fTempo, float fPitch, bool bReverse )</syntaxhighlight>  
<syntaxhighlight lang="lua">bool setSoundProperties(element sound, float fSampleRate, float fTempo, float fPitch [, bool bReverse = false ] )</syntaxhighlight>  
{{OOP||[[sound]]:setProperties||getSoundProperties}}
{{OOP||[[sound]]:setProperties||getSoundProperties}}
===Required Arguments===  
===Required Arguments===  
Line 17: Line 18:
*'''fPitch:''' a [[float]] that defines the new sound [http://en.wikipedia.org/wiki/Pitch_%28music%29 pitch]
*'''fPitch:''' a [[float]] that defines the new sound [http://en.wikipedia.org/wiki/Pitch_%28music%29 pitch]


===Optional Arguments===
{{OptionalArg}}
*'''bReverse:''' a [[boolean]] representing whether the sound will be reversed or not.
*'''bReverse:''' a [[boolean]] representing whether the sound will be reversed or not.


Line 38: Line 41:
[[hu:setSoundProperties]]
[[hu:setSoundProperties]]
[[ar:setSoundProperties]]
[[ar:setSoundProperties]]
[[ro:setSoundProperties]]

Latest revision as of 09:42, 3 March 2019

This function edits the properties of a specific sound.

[[{{{image}}}|link=|]] Note: Streams are not supported.

Syntax

bool setSoundProperties(element sound, float fSampleRate, float fTempo, float fPitch [, bool bReverse = false ] )

OOP Syntax Help! I don't understand this!

Method: sound:setProperties(...)
Counterpart: getSoundProperties


Required Arguments

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • bReverse: a boolean representing whether the sound will be reversed or not.

Returns

Returns true if the properties sucessfully set, false otherwise.

Example

Click to collapse [-]
Client
function editSongSound()
	local sound = playSound("song.wav", false) -- Play the file 'song.wav' and make it play only once
	setSoundProperties(sound, 48000.0, 128.00, 440.0, false) -- Set its samplerate to 48,000 Hz, tempo to 128.00, pitch to 440 Hz and not reversed
end
addEventHandler("onClientResourceStart", resourceRoot, editSongSound) -- Execute the function when the resource is started

See Also