View source for AR/createBlipAttachedTo

{{Server client function}} 
__NOTOC__
تعمل هذه الوظيفة على إنشاء علامة تتبع العناصر على الرادار.

==Syntax==
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
blip createBlipAttachedTo ( element elementToAttachTo, [int icon=0, int size=2, int r=255, int g=0, int b=0, 
int a=255, int ordering=0, float visibleDistance=99999.0, visibleTo = getRootElement()] )
</syntaxhighlight> 

===Required Arguments=== 
*'''elementToAttachTo:''' العنصر الذي تريد إلصاق العلامة فيه.

===Optional Arguments=== 
{{OptionalArg}} 
*'''icon:''' العلامة التي تظهر في الرادار:
{{Blip_Icons}}
*'''size:''' حجم الرادار, لا ينطبق الا على رمز الماركر, والقيمة الإفتراضية هي 2.
*'''r:''' قيمة اللون الأحمر للعلامة ( 0 - 255 ) , لا ينبطق الا على رمز ''الماركر'', والإفتراضي هو 255
*'''g:''' قيمة اللون الأخضر للعلامة ( 0 - 255 ) , لا ينبطق الا على رمز ''الماركر'', والإفتراضي هو 0
*'''b:''' قيمة اللون الأحمر للعلامة ( 0 - 255 ) , لا ينبطق الا على رمز ''الماركر'', والإفتراضي هو 0
*'''a:''' قيمة شفافية العلامة ( 0 - 255 ) , لا ينبطق الا على رمز ''الماركر'', والإفتراضي هو 255
{{New feature/item|3|1.0||
*'''ordering:''' This defines the blip's Z-level ordering (-32768 - 32767). Default is 0.
*'''visibleDistance:''' قيمة المسافة بين اللاعب والعلامة وهي من ( 0 - 65535 )
}}
*'''visibleTo:'''  انظر هنا [[visibility]].
</section>
<section name="Client" class="client" show="false">
<syntaxhighlight lang="lua">
blip createBlipAttachedTo ( element elementToAttachTo, [int icon=0, int size=2, int r=255, int g=0, int b=0, 
int a=255, int ordering=0, float visibleDistance=99999.0] )
</syntaxhighlight> 

===Required Arguments=== 
*'''elementToAttachTo:''' العنصر الذي تريد إلصاق العلامة فيه.

===Optional Arguments=== 
{{OptionalArg}} 
*'''icon:''' العلامة التي تظهر في الرادار:
{{Blip_Icons}}
*'''size:''' حجم الرادار, لا ينطبق الا على رمز الماركر, والقيمة الإفتراضية هي 2.
*'''r:''' قيمة اللون الأحمر للعلامة ( 0 - 255 ) , لا ينبطق الا على رمز ''الماركر'', والإفتراضي هو 255
*'''g:''' قيمة اللون الأخضر للعلامة ( 0 - 255 ) , لا ينبطق الا على رمز ''الماركر'', والإفتراضي هو 0
*'''b:''' قيمة اللون الأحمر للعلامة ( 0 - 255 ) , لا ينبطق الا على رمز ''الماركر'', والإفتراضي هو 0
*'''a:''' قيمة شفافية العلامة ( 0 - 255 ) , لا ينبطق الا على رمز ''الماركر'', والإفتراضي هو 255
{{New feature/item|3|1.0||
*'''ordering:''' This defines the blip's Z-level ordering (-32768 - 32767). Default is 0.
*'''visibleDistance:''' قيمة المسافة بين اللاعب والعلامة وهي من ( 0 - 65535 )
}}
</section>

===Returns===
Returns a [[blip]] if the blip was created succesfully, or ''false'' otherwise.

==Example== 
<section name="Server" class="server" show="true">
هذا المثال يُحضر لاعب عشوائي ويضع عليه العلامة ذات الرقم 52
<syntaxhighlight lang="lua">
-- اختيار لاعب عشوائي

function setupRandomRobber (  )
	local myPlayer = getRandomPlayer (  ); -- جلب لاعب عشوائي
	local myBlip = createBlipAttachedTo ( myPlayer, 52 ); -- نعمل إنشاء بلب يتبع اللاعب
end -- نغلق الـ function
addCommandHandler ( "createBlipAttachedTo", setupRandomRobber ); -- إنشاء الأمر
</syntaxhighlight>
</section>

==See Also==
{{AR/Blip_functions}}

[[en:CreateBlip]]