AR/getSoundProperties: Difference between revisions

Latest revision as of 23:06, 17 August 2021

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

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

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

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

الصوت: عنصر الصوت المصنوع ب playSound او playSound3D

المعطيات

تعطي هذه الوظيفة 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

أنظر أيضاً

@@ Line 2: / Line 2: @@
 {{Client function}}
 {{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>
-===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">
 <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>
 </section>
@@ Line 25: / Line 41: @@
 ==أنظر أيضاً==
 {{AR/Audio_functions}}
+[[hu:getSoundProperties]]
+[[en:getSoundProperties]]
+[[pt-br:getSoundProperties]]