AR/getSoundVolume: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(getSoundVolume)
 
No edit summary
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Client function}}
{{Client function}}
This function is used to return the volume level of the specified [[sound]] element.
.[[sound]] تستخدم هذه الدالة لأحضار حجم الصوت للعنصر
{{New_feature|3.0139|1.3.2|
{{New_feature|3.0139|1.3.2|
If the element is a player, this function will use the players voice.
اذا كان العنصر لآعب, ستستخدم هذه الدالة للتحكم في حجم صوت اللآعب.
}}
}}
==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">float getSoundVolume ( element theSound )</syntaxhighlight>  
<syntaxhighlight lang="lua">float getSoundVolume ( element theSound )</syntaxhighlight>  


===Required Arguments===  
===العناصر المطلوبة===  
*'''theSound:''' The [[sound]] element which volume you want to return.
*'''theSound:''' .[[sound]] العنصر المطلوب احضار مستوى صوته


===Returns===
===Returns===
Returns a [[float]] representing the volume level of the [[sound]] element, ''false'' if invalid arguments were passed.
*'''Returns''' a [[float]] .[[sound]] الرجوع لمستوى الصوت للعنصر, ''false'' .[[sound]] اذا لم ينجح احضار حجم العنصر.


==Example==
==مثال==
This example creates a sound then outputs the volume for it.
هاذه المثال يقوم بأنشاء صوت واضهار حجمه في الشات.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart)  
function wasted (killer, weapon, bodypart) -- وضيفة
local sound = playSound("sounds/wasted.mp3") --Play wasted.mp3 from the sounds folder
local sound = playSound("sounds/wasted.mp3") -- تشغيل مقطع صوتي
outputChatBox("Wasted Sound volume: "..getSoundVolume(sound)) --outputs to the client the volume of the sound
outputChatBox("Wasted Sound volume: "..getSoundVolume(sound)) -- اخراج حجم الصوت في الشات
end
end -- اغلآض الوضيفة
addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) --add the event handler
addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- اضافة حدث للوضيفة
</syntaxhighlight>
</syntaxhighlight>


==Changelog==
==Changelog==
{{ChangelogHeader}}
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element to use a players voice}}
{{ChangelogItem|1.3.2|اضافة خاصية التحكم بحجم صوت الآعب}}


==أنظر أيضاً==
==أنظر أيضاً==
{{AR/Audio_functions}}
{{AR/Audio_functions}}

Revision as of 13:13, 10 May 2013

.sound تستخدم هذه الدالة لأحضار حجم الصوت للعنصر اذا كان العنصر لآعب, ستستخدم هذه الدالة للتحكم في حجم صوت اللآعب.

Syntax

float getSoundVolume ( element theSound )

العناصر المطلوبة

  • theSound: .sound العنصر المطلوب احضار مستوى صوته

Returns

  • Returns a float .sound الرجوع لمستوى الصوت للعنصر, false .sound اذا لم ينجح احضار حجم العنصر.

مثال

هاذه المثال يقوم بأنشاء صوت واضهار حجمه في الشات.

function wasted (killer, weapon, bodypart) -- وضيفة
	local sound = playSound("sounds/wasted.mp3") -- تشغيل مقطع صوتي
	outputChatBox("Wasted Sound volume: "..getSoundVolume(sound)) -- اخراج حجم الصوت في الشات
end -- اغلآض الوضيفة
addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- اضافة حدث للوضيفة

Changelog

Version Description
1.3.2 اضافة خاصية التحكم بحجم صوت الآعب

أنظر أيضاً