Multi Theft Auto: Wiki - User contributions [en]

AR/takePlayerMoney

2016-02-07T16:51:41Z

Strong100: /* Syntax */

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool takePlayerMoney ( player thePlayer, int amount )
</syntaxhighlight>
{{OOP||[[player]]:takeMoney|money|}}
====الارقمنتات المطلوبة====
*'''thePlayer:''' اللاعب الذي تريد سحب المال منه .
*'''amount:''' عدد صحيح محدد يسلب من الاعب اللذي تم تعريفه او تم اختياره لفعل شئ.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool takePlayerMoney ( int amount )
</syntaxhighlight>
{{OOP||[[Player]].takeMoney}}
====الارقمنتات المطلوبة====
*'''amount:''' عدد المال الذي تريد سحبها من اللاعب .
</section>

===Returns===
Returns ''true'' if تم اخذ الفلوس, or ''false'' if اذا تم اختيار باراميترز غير صحيحه.

==أمثله==
<section name="Server" class="server" show="true">
هذا المثال يأخذ فلوس من الاعب اذا كتب في "takecash ''number''" in الكونسول (F8).
<syntaxhighlight lang="lua">
function takeCash ( thePlayer, command, amount ) -- عندما يتم استدعاء takeCash
takePlayerMoney ( thePlayer, tonumber(amount) ) -- اخذ مبلغ من مال الاعب
end
addCommandHandler ( "takecash", takeCash ) -- أنشاء امر"
</syntaxhighlight>
</section>

AR/takePlayerMoney

2016-02-07T16:48:38Z

Strong100: /* Syntax */

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool takePlayerMoney ( player thePlayer, int amount )
</syntaxhighlight>
{{OOP||[[player]]:takeMoney|money|}}
====الارقمنتات المطلوبة====
*'''thePlayer:''' اللاعب الذي تريد سحب المال منه .
*'''amount:''' عدد صحيح محدد يسلب من الاعب اللذي تم تعريفه او تم اختياره لفعل شئ.
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool takePlayerMoney ( int amount )
</syntaxhighlight>
{{OOP||[[Player]].takeMoney}}
====الارقمنتات المطلوبة====
*'''amount:''' عدد صحيح محدد يسلب من الاعب اللذي تم تعريفه او تم اختياره لفعل شئ.
</section>

===Returns===
Returns ''true'' if تم اخذ الفلوس, or ''false'' if اذا تم اختيار باراميترز غير صحيحه.

==أمثله==
<section name="Server" class="server" show="true">
هذا المثال يأخذ فلوس من الاعب اذا كتب في "takecash ''number''" in الكونسول (F8).
<syntaxhighlight lang="lua">
function takeCash ( thePlayer, command, amount ) -- عندما يتم استدعاء takeCash
takePlayerMoney ( thePlayer, tonumber(amount) ) -- اخذ مبلغ من مال الاعب
end
addCommandHandler ( "takecash", takeCash ) -- اضافة دالة معالج للامر takeCash"
</syntaxhighlight>
</section>

SetBlipColor

2016-02-07T15:26:53Z

Strong100: /* مثال */

__NOTOC__
{{Server client function}}
This function will let you change the color of a blip. This color is only applicable to the default blip icon ([[Image:Blipid0s.png|12px]], [[Image:Blipid0u.png|12px]] or [[Image:Blipid0d.png|12px]]). All other icons will ignore this.

==Syntax==
<syntaxhighlight lang="lua">bool setBlipColor ( blip theBlip, int red, int green, int blue, int alpha )</syntaxhighlight>
{{OOP||[[blip]]:setColor||getBlipColor|}}
===Required Arguments===
*'''theBlip:''' العلامة المراد تلوينها .
*'''red:''' (0 - 255) تلوين العلامة باللون الاحمر .
*'''green:''' (0 - 255) تلوين العلامة باللون الاخضر .
*'''blue:''' (0 - 255) تلوين العلامة باللون الازرق .
*'''alpha:''' شفافية العلامة .

===Returns===
Returns : "true" اذا تم بنجاح "false" اذا لم يتم بنجاح

==مثال==
هذا المثال يجلب جميع العلامات الموجودة , ويقوم بتلوينها الى اللون الإبيض اذا لم تكن بيضاء بالفعل .
<syntaxhighlight lang="lua">
local blips = getElementsByType ( "blip" )
for blipKey, blipValue in ipairs ( blips ) do
local red, green, blue, alpha = getBlipColor ( blipValue )
if ( red ~= 255 or green ~= 255 or blue ~= 255 or alpha ~= 255 ) then
setBlipColor ( blipValue, 255, 255, 255, 255 )
end
end
</syntaxhighlight>

==See Also==
{{Blip_functions}}

SetBlipColor

2016-02-07T15:26:12Z

Strong100: /* Example */

__NOTOC__
{{Server client function}}
This function will let you change the color of a blip. This color is only applicable to the default blip icon ([[Image:Blipid0s.png|12px]], [[Image:Blipid0u.png|12px]] or [[Image:Blipid0d.png|12px]]). All other icons will ignore this.

==Syntax==
<syntaxhighlight lang="lua">bool setBlipColor ( blip theBlip, int red, int green, int blue, int alpha )</syntaxhighlight>
{{OOP||[[blip]]:setColor||getBlipColor|}}
===Required Arguments===
*'''theBlip:''' العلامة المراد تلوينها .
*'''red:''' (0 - 255) تلوين العلامة باللون الاحمر .
*'''green:''' (0 - 255) تلوين العلامة باللون الاخضر .
*'''blue:''' (0 - 255) تلوين العلامة باللون الازرق .
*'''alpha:''' شفافية العلامة .

===Returns===
Returns : "true" اذا تم بنجاح "false" اذا لم يتم بنجاح

==مثال==
هذا المثال سوف يجد كل العلامات وتلوينهم باللون الأبيض , اذا لم تكن بيضاء بالفعل .
<syntaxhighlight lang="lua">
local blips = getElementsByType ( "blip" )
for blipKey, blipValue in ipairs ( blips ) do
local red, green, blue, alpha = getBlipColor ( blipValue )
if ( red ~= 255 or green ~= 255 or blue ~= 255 or alpha ~= 255 ) then
setBlipColor ( blipValue, 255, 255, 255, 255 )
end
end
</syntaxhighlight>

==See Also==
{{Blip_functions}}

SetBlipColor

2016-02-07T15:23:21Z

Strong100: /* Returns */

__NOTOC__
{{Server client function}}
This function will let you change the color of a blip. This color is only applicable to the default blip icon ([[Image:Blipid0s.png|12px]], [[Image:Blipid0u.png|12px]] or [[Image:Blipid0d.png|12px]]). All other icons will ignore this.

==Syntax==
<syntaxhighlight lang="lua">bool setBlipColor ( blip theBlip, int red, int green, int blue, int alpha )</syntaxhighlight>
{{OOP||[[blip]]:setColor||getBlipColor|}}
===Required Arguments===
*'''theBlip:''' العلامة المراد تلوينها .
*'''red:''' (0 - 255) تلوين العلامة باللون الاحمر .
*'''green:''' (0 - 255) تلوين العلامة باللون الاخضر .
*'''blue:''' (0 - 255) تلوين العلامة باللون الازرق .
*'''alpha:''' شفافية العلامة .

===Returns===
Returns : "true" اذا تم بنجاح "false" اذا لم يتم بنجاح

==Example==
This example will find all the blips that exist and set them all to white if they aren't white already.
<syntaxhighlight lang="lua">
-- Retrieve a table containing all the blips that exist
local blips = getElementsByType ( "blip" )
-- Loop through the list, storing the blip from the table in the variable blipValue
for blipKey, blipValue in ipairs ( blips ) do
-- Retrieve the blip's colors into the variables red, green, blue and alpha
local red, green, blue, alpha = getBlipColor ( blipValue )
-- If the blip's icon isn't white already
if ( red ~= 255 or green ~= 255 or blue ~= 255 or alpha ~= 255 ) then
-- Set the blip's color to white
setBlipColor ( blipValue, 255, 255, 255, 255 )
end
end
</syntaxhighlight>

==See Also==
{{Blip_functions}}

SetBlipColor

2016-02-07T15:22:26Z

Strong100: /* Required Arguments */

__NOTOC__
{{Server client function}}
This function will let you change the color of a blip. This color is only applicable to the default blip icon ([[Image:Blipid0s.png|12px]], [[Image:Blipid0u.png|12px]] or [[Image:Blipid0d.png|12px]]). All other icons will ignore this.

==Syntax==
<syntaxhighlight lang="lua">bool setBlipColor ( blip theBlip, int red, int green, int blue, int alpha )</syntaxhighlight>
{{OOP||[[blip]]:setColor||getBlipColor|}}
===Required Arguments===
*'''theBlip:''' العلامة المراد تلوينها .
*'''red:''' (0 - 255) تلوين العلامة باللون الاحمر .
*'''green:''' (0 - 255) تلوين العلامة باللون الاخضر .
*'''blue:''' (0 - 255) تلوين العلامة باللون الازرق .
*'''alpha:''' شفافية العلامة .

===Returns===
Returns ''true'' if the blip's color was set successfully. Returns ''false'' if the blip passed to the function is invalid, or any of the colors are out of the valid range.

==Example==
This example will find all the blips that exist and set them all to white if they aren't white already.
<syntaxhighlight lang="lua">
-- Retrieve a table containing all the blips that exist
local blips = getElementsByType ( "blip" )
-- Loop through the list, storing the blip from the table in the variable blipValue
for blipKey, blipValue in ipairs ( blips ) do
-- Retrieve the blip's colors into the variables red, green, blue and alpha
local red, green, blue, alpha = getBlipColor ( blipValue )
-- If the blip's icon isn't white already
if ( red ~= 255 or green ~= 255 or blue ~= 255 or alpha ~= 255 ) then
-- Set the blip's color to white
setBlipColor ( blipValue, 255, 255, 255, 255 )
end
end
</syntaxhighlight>

==See Also==
{{Blip_functions}}

AR/setSoundVolume

2016-02-07T10:06:10Z

Strong100: /* Changelog */

__NOTOC__
{{Client function}}
This function is used to change the volume level of the specified [[sound]] element.
{{New_feature|3.0139|1.3.2|
Use a player element to control a players voice with this function.
}}
==Syntax==
<syntaxhighlight lang="lua">bool setSoundVolume ( element theSound, float volume )</syntaxhighlight>

===Required Arguments===
*'''theSound:''' .الصوت المراد رفع \ اخفاض مستوى الصوت
*'''volume:''' مستوى الصوت من "0.0" أو "1.0" ء

===Returns===
Returns "true" اذا تم بنجاح "false" اذا لم يتم بنجاح

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart) -- تعريف
local sound = playSound("sounds/wasted.mp3") -- "wasted" تشغيل صوت
setSoundVolume(sound, 0.5) -- تعين مستوى الصوت الى 0.5
end -- أغلاق

addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- اضافة حدث
</syntaxhighlight>
</section>

==التحديثات==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|اضافة تحكم اللاعب في الصوت}}

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

AR/setSoundVolume

2016-02-07T10:05:31Z

Strong100: /* Example */

__NOTOC__
{{Client function}}
This function is used to change the volume level of the specified [[sound]] element.
{{New_feature|3.0139|1.3.2|
Use a player element to control a players voice with this function.
}}
==Syntax==
<syntaxhighlight lang="lua">bool setSoundVolume ( element theSound, float volume )</syntaxhighlight>

===Required Arguments===
*'''theSound:''' .الصوت المراد رفع \ اخفاض مستوى الصوت
*'''volume:''' مستوى الصوت من "0.0" أو "1.0" ء

===Returns===
Returns "true" اذا تم بنجاح "false" اذا لم يتم بنجاح

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart) -- تعريف
local sound = playSound("sounds/wasted.mp3") -- "wasted" تشغيل صوت
setSoundVolume(sound, 0.5) -- تعين مستوى الصوت الى 0.5
end -- أغلاق

addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) -- اضافة حدث
</syntaxhighlight>
</section>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element for voice control}}

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

AR/setSoundVolume

2016-02-07T10:03:50Z

Strong100: /* Returns */

__NOTOC__
{{Client function}}
This function is used to change the volume level of the specified [[sound]] element.
{{New_feature|3.0139|1.3.2|
Use a player element to control a players voice with this function.
}}
==Syntax==
<syntaxhighlight lang="lua">bool setSoundVolume ( element theSound, float volume )</syntaxhighlight>

===Required Arguments===
*'''theSound:''' .الصوت المراد رفع \ اخفاض مستوى الصوت
*'''volume:''' مستوى الصوت من "0.0" أو "1.0" ء

===Returns===
Returns "true" اذا تم بنجاح "false" اذا لم يتم بنجاح

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart)
local sound = playSound("sounds/wasted.mp3") --Play wasted.mp3 from the sounds folder
setSoundVolume(sound, 0.5) -- set the sound volume to 50%
end

addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) --add the event handler
</syntaxhighlight>
</section>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element for voice control}}

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

AR/setSoundVolume

2016-02-07T10:03:07Z

Strong100: /* Required Arguments */

__NOTOC__
{{Client function}}
This function is used to change the volume level of the specified [[sound]] element.
{{New_feature|3.0139|1.3.2|
Use a player element to control a players voice with this function.
}}
==Syntax==
<syntaxhighlight lang="lua">bool setSoundVolume ( element theSound, float volume )</syntaxhighlight>

===Required Arguments===
*'''theSound:''' .الصوت المراد رفع \ اخفاض مستوى الصوت
*'''volume:''' مستوى الصوت من "0.0" أو "1.0" ء

===Returns===
Returns ''true'' if the [[sound]] element volume was successfully changed, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function wasted (killer, weapon, bodypart)
local sound = playSound("sounds/wasted.mp3") --Play wasted.mp3 from the sounds folder
setSoundVolume(sound, 0.5) -- set the sound volume to 50%
end

addEventHandler("onClientPlayerWasted", getLocalPlayer(), wasted) --add the event handler
</syntaxhighlight>
</section>

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.3.2|Added player element for voice control}}

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

AR/setRadioChannel

2016-02-07T09:54:33Z

Strong100: /* Returns */

__NOTOC__
{{Client function}}
This function sets the currently active radio channel.

This function also works while not in a vehicle.

==Syntax==
<syntaxhighlight lang="lua">
bool setRadioChannel ( int ID )
</syntaxhighlight>

===Required Arguments===
*'''ID:''' .ايدي الراديو الذي تريد تشغيله

{{SoundID}}

===Returns===
"true" اذا تم تعين محطة راديو بنجاح
"false" اذا لم يتم تعين محطة راديو

==مثال==
هذا المثال يقوم بأضافة امر "setradio " لتغير قناة الراديو الحالية عبر الايدي
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addCommandHandler ( "setradio", -- "setradio" اضافة امر
function ( command, stationID ) -- تعريف
local result = setRadioChannel ( tonumber( stationID ) ) -- وضع قناة الراديو عبر الايدي
if result then -- if we had a valid ID
outputChatBox ( "Changed your radio station to " .. getRadioChannelName ( tonumber ( stationID ) ) .. "!" ) -- اضهار نص في الشات
else
outputChatBox ( "Invalid radio station ID, valid ones are 0-12." ) -- اضهار نص في الشات
end
end
)
</syntaxhighlight>
</section>

==أنظر أيضاً==

{{AR/Audio_functions}}

AR/setRadioChannel

2016-02-07T09:52:52Z

Strong100: /* Example */

__NOTOC__
{{Client function}}
This function sets the currently active radio channel.

This function also works while not in a vehicle.

==Syntax==
<syntaxhighlight lang="lua">
bool setRadioChannel ( int ID )
</syntaxhighlight>

===Required Arguments===
*'''ID:''' .ايدي الراديو الذي تريد تشغيله

{{SoundID}}

===Returns===
Returns ''true'' if channel was set successfully, ''false'' otherwise.

==مثال==
هذا المثال يقوم بأضافة امر "setradio " لتغير قناة الراديو الحالية عبر الايدي
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addCommandHandler ( "setradio", -- "setradio" اضافة امر
function ( command, stationID ) -- تعريف
local result = setRadioChannel ( tonumber( stationID ) ) -- وضع قناة الراديو عبر الايدي
if result then -- if we had a valid ID
outputChatBox ( "Changed your radio station to " .. getRadioChannelName ( tonumber ( stationID ) ) .. "!" ) -- اضهار نص في الشات
else
outputChatBox ( "Invalid radio station ID, valid ones are 0-12." ) -- اضهار نص في الشات
end
end
)
</syntaxhighlight>
</section>

==أنظر أيضاً==

{{AR/Audio_functions}}

AR/setRadioChannel

2016-02-07T09:51:49Z

Strong100: /* Example */

__NOTOC__
{{Client function}}
This function sets the currently active radio channel.

This function also works while not in a vehicle.

==Syntax==
<syntaxhighlight lang="lua">
bool setRadioChannel ( int ID )
</syntaxhighlight>

===Required Arguments===
*'''ID:''' .ايدي الراديو الذي تريد تشغيله

{{SoundID}}

===Returns===
Returns ''true'' if channel was set successfully, ''false'' otherwise.

==Example==
هذا المثال يقوم بأضافة امر "setradio " لتغير قناة الراديو الحالية عبر الايدي
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addCommandHandler ( "setradio", -- "setradio" اضافة امر
function ( command, stationID ) -- تعريف
local result = setRadioChannel ( tonumber( stationID ) ) -- وضع قناة الراديو عبر الايدي
if result then -- if we had a valid ID
outputChatBox ( "Changed your radio station to " .. getRadioChannelName ( tonumber ( stationID ) ) .. "!" ) -- اضهار نص في الشات
else
outputChatBox ( "Invalid radio station ID, valid ones are 0-12." ) -- اضهار نص في الشات
end
end
)
</syntaxhighlight>
</section>

==أنظر أيضاً==

{{AR/Audio_functions}}

AR/setRadioChannel

2016-02-07T09:48:24Z

Strong100: /* Required Arguments */

__NOTOC__
{{Client function}}
This function sets the currently active radio channel.

This function also works while not in a vehicle.

==Syntax==
<syntaxhighlight lang="lua">
bool setRadioChannel ( int ID )
</syntaxhighlight>

===Required Arguments===
*'''ID:''' .ايدي الراديو الذي تريد تشغيله

{{SoundID}}

===Returns===
Returns ''true'' if channel was set successfully, ''false'' otherwise.

==Example==
This example adds a command ''setradio'' which can be used to change the current radio station by ID.
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
addCommandHandler ( "setradio",
function ( command, stationID )
local result = setRadioChannel ( tonumber( stationID ) )
if result then -- if we had a valid ID
outputChatBox ( "Changed your radio station to " .. getRadioChannelName ( tonumber ( stationID ) ) .. "!" )
else
outputChatBox ( "Invalid radio station ID, valid ones are 0-12." )
end
end
)
</syntaxhighlight>
</section>

==أنظر أيضاً==

{{AR/Audio_functions}}