AR/getSoundLevelData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(getSoundLevelData)
 
No edit summary
Line 2: Line 2:
{{Client function}}
{{Client function}}
{{New feature/item|3.0130|1.3.0|4162|
{{New feature/item|3.0130|1.3.0|4162|
This function gets the left/right level from a [[sound]] [[element]].
تحصل هذه الوظيفة على المستوى الأيسر / الأيمن من عنصر الصوت. إذا كان العنصر لاعبًا ، فستستخدم هذه الوظيفة صوت اللاعبين.
[[sound]] [[element]].
}}
}}
{{New_feature|3.0139|1.3.2|
==تركيب الوظيفة==  
If the element is a player, this function will use the players voice.
}}
==Syntax==  
<syntaxhighlight lang="lua">int, int getSoundLevelData ( element theSound )</syntaxhighlight>  
<syntaxhighlight lang="lua">int, int getSoundLevelData ( element theSound )</syntaxhighlight>  


===Required Arguments===  
===الفرغات المطلوبة===  
*'''theSound''' The [[sound]] [[element]] which level data you want to return.
*'''الصوت''' The [[sound]] [[element]] which level data you want to return.
*'''الصوت''' عنصر الصوت الذي تريد جلب منة بينات مستوي الصوت.


===Returns===
[[sound]] [[element]]
Returns a 2 values with Left, Right level data from sound, ''false'' otherwise.
===المعطيات===
تعطي عددان صحيحين في النطاق من 0 الي 32767
==مثال==


==Example==
<section name="Client" class="client" show="true">
TODO
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--TODO
soundHandler = playSound ( "sound.wav" )
 
function onSoundPlayRender ( )
    if ( soundHandler ) then
        local leftData, rightData = getSoundLevelData ( soundHandler )
if ( leftData ) then
            dxDrawRectangle ( 0, 0, 64, leftData / 32767 * 256, tocolor ( 255, 0, 0 ) )
            dxDrawRectangle ( 64, 0, 64, rightData / 32767 * 256, tocolor ( 0, 0, 255 ) )
        end
    end
end
addEventHandler ( "onClientRender", getRootElement(), onSoundPlayRender )
</syntaxhighlight>
</syntaxhighlight>
</section>


==Requirements==
==المتطلبات==
{{Requirements|n/a|1.3.0-9.04162|}}
{{Requirements|n/a|1.3.0-9.04162|}}


==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 08:06, 10 May 2020

تحصل هذه الوظيفة على المستوى الأيسر / الأيمن من عنصر الصوت. إذا كان العنصر لاعبًا ، فستستخدم هذه الوظيفة صوت اللاعبين. sound element.

تركيب الوظيفة

int, int getSoundLevelData ( element theSound )

الفرغات المطلوبة

  • الصوت The sound element which level data you want to return.
  • الصوت عنصر الصوت الذي تريد جلب منة بينات مستوي الصوت.

sound element

المعطيات

تعطي عددان صحيحين في النطاق من 0 الي 32767

مثال

Click to collapse [-]
Client
soundHandler = playSound ( "sound.wav" )

function onSoundPlayRender ( )
    if ( soundHandler ) then
        local leftData, rightData = getSoundLevelData ( soundHandler )
	if ( leftData ) then
            dxDrawRectangle ( 0, 0, 64, leftData / 32767 * 256, tocolor ( 255, 0, 0 ) )
            dxDrawRectangle ( 64, 0, 64, rightData / 32767 * 256, tocolor ( 0, 0, 255 ) )
        end
    end
end
addEventHandler ( "onClientRender", getRootElement(), onSoundPlayRender )

المتطلبات

Minimum server version n/a
Minimum client version 1.3.0-9.04162

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.3.0-9.04162" />

التغير

Version Description
1.3.2 اضافة عنصر الاعب لاءستخدام صوت الاعب

أنظر أيضاً