AR/getSoundProperties: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(getSoundProperties)
mNo edit summary
 
(One intermediate revision by one other user 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 gets the properties of a specific [[sound]].
هذه الوظيفة تحصل على خصائص صوت المحدد. [[sound]].
}}
}}


==Syntax==  
==تركيب الوظيفة==  
<syntaxhighlight lang="lua">float, float, float, bool getSoundProperties( element sound )</syntaxhighlight>  
<syntaxhighlight lang="lua">float, float, float, bool getSoundProperties( element sound )</syntaxhighlight>  


===Required Arguments===  
===الفرغات المطلوبة===  
*'''sound:''' A sound element that is created using [[playSound]] or [[playSound3D]]
*'''الصوت:''' عنصر الصوت المصنوع ب [[playSound]] او [[playSound3D]]


===Returns===
===المعطيات===
This function returns 3 floats and a boolean value:
* تعطي هذه الوظيفة 3 [[float|floats]] و قيمة [[boolean]]
* [https://ar.wikipedia.org/wiki/استعيان استعيان] القيمة الاولي
* [https://ar.wikipedia.org/wiki/سرعة_إيقاع سرعة إيقاع] القيمة الثانية
* [https://ar.wikipedia.org/wiki/حدة_(موسيقى) حدة] القيمة الثالثة
* القيمة المنطقية التي تمثل ما إذا كان الصوت معكوسًا أم لا.
==مثال==
'''مثال 1:''' هذا المثال يعطي 3 قيم [[float|floats]] تمثل استعيان, سرعة ايقاع, حدة وقيمة منطقية تمثل ما إذا كان الصوت معكوسًا أم لا ، كل 5 ثوانٍ.


The first float is the sound's [http://en.wikipedia.org/wiki/Sampling_rate sample rate], the second one the sound's [http://en.wikipedia.org/wiki/Tempo tempo], and the third one the [http://en.wikipedia.org/wiki/Pitch_%28music%29 pitch] of the sound. The boolean representing whether the sound is reversed or not.
==Example==
<section name="Client" class="client" show="true">
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- not done yet
local sound
local timer
 
addCommandHandler("playsound",
function ()
    sound = playSound("wasted.mp3")
    timer = setTimer(function() soundProperties(sound) end, 5000, 0)
end
)
 
function soundProperties(sound)
    local sampleRate, tempo, pitch, isReversed = getSoundProperties(sound) -- تجلب الاستعيان وسرعة الايقاع وحدة وقيمة منطقية تمثل ما إذا كان الصوت معكوسًا أم لا.
    outputChatBox(sampleRate.." "..tempo.." "..pitch.." "..tostring(isReversed))
end
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>
Line 25: Line 41:
==أنظر أيضاً==
==أنظر أيضاً==
{{AR/Audio_functions}}
{{AR/Audio_functions}}
[[hu:getSoundProperties]]
[[en:getSoundProperties]]
[[pt-br:getSoundProperties]]

Latest revision as of 23:06, 17 August 2021

هذه الوظيفة تحصل على خصائص صوت المحدد. sound.

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

float, float, float, bool getSoundProperties( element sound )

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

المعطيات

  • تعطي هذه الوظيفة 3 floats و قيمة boolean
  • استعيان القيمة الاولي
  • سرعة إيقاع القيمة الثانية
  • حدة القيمة الثالثة
  • القيمة المنطقية التي تمثل ما إذا كان الصوت معكوسًا أم لا.

مثال

مثال 1: هذا المثال يعطي 3 قيم floats تمثل استعيان, سرعة ايقاع, حدة وقيمة منطقية تمثل ما إذا كان الصوت معكوسًا أم لا ، كل 5 ثوانٍ.

Click to collapse [-]
Client
local sound 
local timer

addCommandHandler("playsound",
function () 
    sound = playSound("wasted.mp3")
    timer = setTimer(function() soundProperties(sound) end, 5000, 0)
end
)

function soundProperties(sound)
    local sampleRate, tempo, pitch, isReversed = getSoundProperties(sound) -- تجلب الاستعيان وسرعة الايقاع وحدة وقيمة منطقية تمثل ما إذا كان الصوت معكوسًا أم لا.
    outputChatBox(sampleRate.." "..tempo.." "..pitch.." "..tostring(isReversed))
end

أنظر أيضاً