Template:AR/Useful Functions

Table functions

• isValueInTable »هذه الوظيفة تعطي true إذا كانت القيمة موجودة في الجدول ، false إذا لم تكن القيمة موجودة في الجدول.
• setTableToSql » تستخدم هذه الوظيفة لحفظ الجدول في قاعدة البيانات (sql).
• getTableFromSql » يتم استخدام هذه الوظيفة للحصول على الجداول المحفوظة باستخدام الوظيفة (SetTableToSql ).
• rangeToTable » هذه الوظيفة تحول الترتيب النصي الي جدول يحتوي علي قيم راقمية.
• setTableProtected » تحمي هذه الوظيفة الجدول وتجعله للقراءة فقط.
• Sort_Functions » هذه الوظائف قادرة على فرز الجداول الخاصة بك حسب مفتاح.
• table.compare » تتحقق هذه الوظيفة مما إذا كان الجدولان متساويان.
• table.copy » تقوم هذه الوظيفة بنسخ جدول كامل وجميع الجداول في ذلك الجدول.
• table.empty » تتحقق هذه الوظيفة مما إذا كان الجدول فارغًا.
• table.map » هذه الوظيفة تمر علي جدول وتستبدل كل حقل مع الوظيفة الناجحة المعطاة في حقول القيم الناجحة كالفراغ المطلوب الاول او الفرغات المطلوبة الاختيارية.
• table.merge » تقوم هذه الوظيفة بدمج جدولين أو أكثر معًا.
• table.random » هذه الوظيفة تعطي قيمة عشوائية من الجدول.
• table.removeValue » تقوم هذه الوظيفة بإزالة قيمة محددة من الجدول.
• table.size » هذه الوظيفة تعطي الحجم المطلق للجدول.
• table.getRandomRows » هذه الوظيفة تعطي صفوف عشوائية من الجدول.
• table.element » تقوم هذه الوظيفة بإعطاء جدول جديد يحتوى العنصر.
• pairsByKeys » هذه الوظيفة تفرز أزواج الجدول.

ACL functions

• aclGroupClone » تعمل هذه الوظيفة على استنساخ مجموعة إلى مجموعة أخرى مع / بدون قوائم ACL و / أو عناصر

.

• getPlayersInACLGroup » تُرجع هذه الوظيفة جميع اللاعبين في مجموعة ACL.
• getPlayerAcls » تقوم هذه الوظيفة بأعطاء جدول لكل مجموعات ACL باللاعب.
• isPlayerInACL » تتحقق هذه الوظيفة إذا كان عنصر لاعب في مجموعة ACL.
• renameAclGroup » تعطي هذه الوظيفة مجموعة ACL حالية اسمًا جديدًا.

Account functions

• getPlayerFromAccountName » تستخدم هذه الوظيفة للحصول على لاعب باسم حسابه.

Camera functions

• smoothMoveCamera » تتيح لك هذه الوظيفة إنشاء رحلة كاميرا سينمائية.

Cursor functions

• getCursorMovedOn » تتحقق هذه الوظيفة من الطريقة التي يتحرك فيها المؤشر حاليًا.

Drawing functions

• dxDrawAnimWindow »ترسم هذه الوظيفة نافذة متحركة ثنائية الأبعاد على الشاشة.
• dxDrawBorderedRectangle » هذه وظيفة ستنشئ مستطيلاً محاطاً.
• dxDrawBorderedText » هذه وظيفة ستنشئ نصًا محاطًا.
• dxDrawDashedLine » هذه الوظيفة ترسم خطًا مع شرطات.
• dxDrawRing » ترسم هذه الوظيفة حلقة بخطوط dx.
• dxDrawTextOnRectangle » تعمل هذه الوظيفة على إنشاء مستطيل بداخله نص.
• dxDrawGifImage » تحاكي هذه الوظيفة تأثير صورة GIF باستخدام الصور المتحركة ثنائية الأبعاد.
• dxDrawImage3D » ترسم هذه الوظيفة صورة ثلاثية الأبعاد في عالم GTA.
• dxDrawSprite » هذه الوظيفة ترسم نقشًا متحركًا في العالم ثلاثي الأبعاد.
• dxDrawImageOnElement » هذه الوظيفة ترسم صورة على أي عنصر.
• dxDrawLinedRectangle » هذه وظيفة ستقوم بإنشاء مخطط مستطيل مع خطوط dx.
• dxDrawLoading » هذه الوظيفة ترسم شريط تحميل على الشاشة.
• dxDrawOctagon3D » تقوم هذه الوظيفة بإنشاء مثمن ثلاثي الأبعاد
• dxDrawPolygon » تقوم هذه الوظيفة برسم مضلع مخصص على الشاشة.
• dxDrawRectangle3D » ترسم هذه الوظيفة مستطيل ثلاثي الأبعاد في عالم GTA.
• dxDrawProgressBar » تحاكي هذه الوظيفة شريط التقدم الذي تم رسمه باستخدام DirectDraw.
• dxDrawTextOnElement » تقوم هذه الوظيفة برسم نص على أي عنصر.
• dxDrawTriangle » هذه دالة ستقوم بإنشاء مثلث بخطوط dx.
• dxGetFontSizeFromHeight » تحسب هذه الوظيفة حجم الخط من ارتفاع معين.
• dxGetRealFontHeight » تحسب هذه الوظيفة ارتفاع الخط.
• wordWrap » تقوم هذه الوظيفة بتقسيم سلسلة طويلة إلى جدول من الخطوط المنفصلة المحددة بطول معين بالبكسل للرسم بشكل منفصل.
• dxDrawRombo » هذه الوظيفة تخلق المعين.

Effects functions

• attachEffect » تتيح لك هذه الوظيفة إرفاق تأثير بعنصر.

Elements functions

• getElementSpeed » تعطي هذه الوظيفة سرعة العنصر المحدد بوحدات م / ث ، كم / س أو ميل / س.
• getElementsInDimension » تُعطي هذه الوظيفة جدول العناصر الموجودة في البعد المحدد

.

• getElementsWithinMarker » تُعطي هذه الوظيفة جدول العناصر الموجودة داخل المنطقة المشكلة.
• isElementInPhotograph » تتحقق هذه الوظيفة من وجود عنصر في منطقة صورة الكاميرا الخاصة بالمشغل.
• isElementInRange » تتيح لك هذه الوظيفة التحقق مما إذا كان نطاق العنصر إلى نقطة رئيسية ضمن النطاق الأقصى

.

• isElementMoving» تتحقق هذه الوظيفة إذا كان العنصر يتحرك.
• isElementWithinAColShape» تتحقق هذه الوظيفة إذا كان العنصر داخل المنطقة المشكلة.
• multi_check » تقوم هذه الوظيفة بفحص عنصر واحد للعديد ، سهل الاستخدام ونظيف.
• setElementSpeed » تسمح لك هذه الوظيفة بضبط سرعة العنصر بوحدات kph أو mph.

Events

• onVehicleWeaponFire » يطبق هذا الرمز حدثًا يتم تشغيله عندما يطلق لاعب في مركبة يطلق بسلاح المركبة.

Input functions

• bindControlKeys » تتيح لك هذه الوظيفة ربط كل زر مرتبط بعنصر تحكم بشكل فردي. القيام بذلك يتجاوز قيود MTA قليلاً

.

• getBoundControls » تعطي هذه الوظيفة جدولاً بأسماء عناصر التحكم المرتبطة بالزر المحدد.
• unbindControlKeys » تتيح لك هذه الوظيفة إلغاء ربط كل زر مرتبط بعنصر تحكم بشكل فردي. استخدم هذه الوظيفة مع

bindControlKeys.

• getClipboard » Tيعرض هذا الحدث محتويات الحافظة بالضغط على ctrl + v / ctrl + V. يتم تشغيل الحدث فقط في حالة ظهور المؤشر.

Data functions

• byte2human » تعمل هذه الوظيفة على تحويل عدد صحيح (عدد وحدات البايت) إلى وحدة يمكن قراءتها بواسطة الإنسان

.

• capitalize » هذه الدالة تستهل سلسلة معينة.
• convertServerTickToTimeStamp » تعمل هذه الوظيفة على تحويل علامات الخادم إلى الطابع الزمني لليونيكس.
• convertTextToSpeech » تقوم هذه الوظيفة بتحويل النص المقدم إلى كلام باللغة التي يمكن للاعبين سماعها.
• findRotation » تأخذ هذه الوظيفة نقطتين وتعيد الاتجاه من النقطة أ إلى النقطة ب.
• findRotation3D » تأخذ هذه الوظيفة مجموعتين من إحداثيات XYZ. تقوم بإرجاع الاتجاه ثلاثي الأبعاد من النقطة أ إلى النقطة ب.
• FormatDate » تعمل هذه الوظيفة على تنسيق التاريخ على أساس سلسلة التنسيق وإعطائه.
• formatNumber » تعمل هذه الوظيفة على تنسيق أعداد كبيرة عن طريق إضافة الفواصل.
• generateString » تولد هذه الوظيفة سلسلة عشوائية بأي حروف.
• generateRandomASCIIString » تعطي هذه الدالة سلسلة عشوائية تستخدم أحرف ASCII.
• getDistance » يعطي المسافة بين عنصرين.
• getAge » تحسب هذه الوظيفة عمر عيد ميلاد معين.
• getDistanceBetweenPointAndSegment2D » تأخذ هذه الوظيفة إحداثيات النقطة والخط (مقطع) إحداثيات البداية والنهاية. تقوم بإرجاع أقصر مسافة بين النقطة والخط.
• getEasterDate » تعطي هذه الوظيفة تاريخ عيد الفصح كل شهر وشهر لسنة معينة.
• getKeyFromValueInTable » تعطي هذه الوظيفة مفتاح القيمة المحددة في جدول.
• getOffsetFromXYZ » تسمح لك هذه الوظيفة بأخذ كيان وموقف وحساب التعويض النسبي بينهما لحساب التناوب.
• getPointFromDistanceRotation » تجد هذه الوظيفة نقطة بناءً على نقطة البداية والاتجاه والمسافة.
• getRealMonthH » تعمل هذه الوظيفة على تحويل أشهر اللغة الإنجليزية إلى أشهر عربية
• getRealMonthM » تمنحك هذه الوظيفة اسم الشهور الحقيقيةe
• getRGColorFromPercentage »تعطي هذه الوظيفة رقمين صحيحين يمثلان اللونين الأحمر والأخضر وفقًا للنسبة المئوية المحددة.
• getScreenRotationFromWorldPosition » تعطي هذه الوظيفة دورانًا نسبيًا للشاشة إلى موقع عالم اللعبة.
• getTimestamp » تعطي هذه الوظيفة الطابع الزمني لـ UNIX لتاريخ ووقت محددين.
• isLeapYear » تعطي هذه الوظيفة تمثيلًا منطقيًا لسنة معينة هي سنة كبيسة.
• isValidMail » تتحقق هذه الوظيفة مما إذا كانت سلسلة البريد الإلكتروني المقدمة صالحة.
• removeHex » تُستخدم هذه الوظيفة لإزالة الأرقام السداسية العشرية (الألوان ، على سبيل المثال) من السلاسل.
• RGBToHex » تعطي هذه الوظيفة سلسلة تمثل اللون بالنظام الست عشري.
• secondsToTimeDesc » تعمل هذه الوظيفة على تحويل عدد صحيح للثواني إلى وصف زمني سهل الاستخدام.
• string.count » تحسب هذه الوظيفة مقدار تكرار النص في النص.
• string.insert » تقوم هذه الوظيفة بإدراج سلسلة داخل نص آخر في موضع معين.
• string.explode » تقوم هذه الوظيفة بتقسيم النص في نمط فاصل معين وإرجاع جدول بالقطع.
• switch » تسمح هذه الوظيفة بقيمة متغير أو تعبير للتحكم في تدفق تنفيذ البرنامج عبر فرع متعدد الاتجاهات.
• toHex » تعمل هذه الوظيفة على تحويل الرقم العشري إلى رقم سداسي عشري ، كحل يتم استخدامه من جانب العميل.
• var dump » تقوم هذه الوظيفة بإخراج معلومات حول متغير واحد أو أكثر باستخدام outputConsole.
• wavelengthToRGBA » تعمل هذه الوظيفة على تحويل الطول الموجي المادي للضوء إلى لون RGBA.
• getDistanceBetweenElements » يتم استخدام هذه الوظيفة للحصول على المسافة بين عنصرين.

GUI functions

• centerWindow » تعمل هذه الوظيفة على توسيط عنصر نافذة CEGUI بشكل متجاوب في أي دقة وضوح.
• guiMoveElement » تحرك هذه الوظيفة guiElement بواسطة / like باستخدام moveObject.
• isMouseOnGUICloseButton » تتيح لك هذه الوظيفة التحقق مما إذا كان مؤشر / مؤشر الماوس داخل زر الإغلاق الأصلي لنافذة واجهة المستخدم.

Comboboxes

• guiComboBoxAdjustHeight » تقوم هذه الوظيفة بضبط عنصر التحرير والسرد CEGUI للحصول على الارتفاع الصحيح

.

• guiComboBoxAddPlayersName » هذه الوظيفة هي إضافة اسم اللاعبين في مربع التحرير والسرد .

Gridlists

• guiGridListAddPlayers » تضيف هذه الوظيفة جميع اللاعبين عبر الإنترنت إلى قائمة الشبكات.
• guiGridListGetColumnIDFromTitle » تحصل هذه الوظيفة على معرف عمود قائمة الشبكات من عنوان العمود

.

• guiGridListSetColumnNonSortable » تجعل هذه الوظيفة عمود قائمة الشبكات غير قابل للفرز.
• guiGridListSetColumnsFixedWidth » تعمل هذه الوظيفة على جعل قائمة الشبكة تحتوي على جميع أعمدتها بعرض ثابت

.

• guiGridListGetSelectedText » هذه الوظيفة تعطي سلسلة تحتوي على النص الداخلي لعنصر قائمة الشبكة المحدد

.

• getGridListRowIndexFromText » هذه الوظيفة تعطي فهرس صف قائمة الشبكة من النص المحدد

.

• isTextInGridList » تتحقق هذه الوظيفة من وجود بعض النص أو عدم وجوده في قائمة الشبكة.
• convertGridListToText » وظيفه تحول محتويات قائمة الشبكة إلى نص.

Labels

• guiLabelAddEffect » تضيف هذه الوظيفة تأثيرات إلى بطاقة gui مثل (الظل ، المخطط التفصيلي).

Marker functions

• createMarkerAttachedTo » تنشئ هذه الوظيفة علامة مرتبطة بعنصر.

Math functions

• mathNumber » تعد هذه الوظيفة حلاً لدقة نقطة عائمة من جانب العميل تبلغ 24 بت.
• math.hypot » تقوم هذه الدالة بإرجاع الوتر للمثلث المعطى من الجانبين x و y.
• math.percent » تعطي هذه الوظيفة نسبة من قيمتين.
• math.round » لتقريب رقم بينما يمكن تعيين عدد الكسور العشرية والطريقة.
• reMap »يعيد تعيين رقم من نطاق إلى آخر.
• math.isPointInPolygon » تحقق مما إذا كانت النقطة داخل المضلع أم لا.
• math.polygonArea » حساب مساحة أي مضلع.
• math.randomDiff » يولد عددًا صحيحًا عشوائيًا زائفًا يختلف دائمًا عن آخر رقم عشوائي تم إنشاؤه.

Map functions

• assignLod » تتيح لك هذه الوظيفة إنشاء نموذج LOD وتطبيقه بشكل ملائم على تعيين مجسم

Ped functions

• getAlivePlayers » هذه الوظيفة تعطي جدولاً للاعبين الأحياء من جانب العميل

.

• getAlivePlayersInTeam » تعطي هذه الوظيفة جدولاً للاعبين الأحياء في الفريق
• getPlayersInVehicles » تعطي هذه الوظيفة جدولاً للاعبين يدخلون المركبات من بعد محدد.
• getGuestPlayers » هذه الوظيفة تجعل اللاعب لا يقوم بتسجيل الدخول أو اللاعبون الضيوف .
• getOnlineAdmins » تعطي هذه الوظيفة جدولاً لجميع المسؤولين الذين قاموا بتسجيل الدخول.
• getPedEyesPosition » تسمح لك هذه الوظيفة بالحصول على مكان العيون.
• getPedMaxHealth » توفر هذه الوظيفة أقصى صحة للمشاة عن طريق تحويلها من الحالة الصحة القصوى.
• getPedMaxOxygenLevel » توفر هذه الوظيفة أقصى مستوى للأ كسجين عند المجسم من خلال تحويله من أقصى درجة من القدرة على التحمل تحت الماء.
• getPedWeaponSkill » تقوم هذه الوظيفة بإرجاع اسم مستوى مهارة السلاح المقابل للقدم.
• getPlayerFromNamePart » هذه الوظيفة تمنح اللاعب اسمًا جزئيًا.
• getPlayerFromSerial » تعطي هذه الوظيفة لاعب من الرقم التسلسلي الخاص بهم.
• getPlayersByData » تُرجع هذه الوظيفة جدول اللاعبين الذين لديهم اسم البيانات المحدد.
• getPlayersInPhotograph » تقوم هذه الوظيفة بارجاع جدول لكل اللاعبين في الصورة.
• isPedAiming» تتحقق هذه الوظيفة مما إذا كان المشاة يصوب سلاحهم.
• isPedAimingNearPed » هذا مشابه لـ isPedAiming ولكنه يستخدم شكلاً أكثر دقة.
• isPedDrivingVehicle » تتحقق هذه الوظيفة مما إذا كان أحد المشاة المحدد يقود مركبة.
• isPlayerInTeam » تتحقق هذه الوظيفة إذا كان اللاعب في فريق محدد.

Player functions

• countPlayersInRange » تعطي هذه الوظيفة عدد اللاعبين الموجودين ضمن نطاق معين من الإحداثيات المحددة.
• isPlayerHitByVehicle» تقوم هذه الوظيفة بإلغاء الحدث عندما تصطدم سيارة بعنصر.
• warpToPlayer» هذه الوظيفة تجعل اللاعب يشوه لاعب آخر.

Resource functions

• getResourceScripts » تعطي هذه الوظيفة جدولاً لنصوص المصادر.
• getResourceSize » تعطي هذه الوظيفة حجم مورد محدد بالكيلو بايت

(كيلوبايت)

• getResourceSettings » تعطي هذه الوظيفة جدولاً لإعدادات الموارد.
• refreshResource » تعمل هذه الوظيفة على تحديث المورد الخاص بك إذا قمت بتغيير أي من الملفات

• setResourcePriority » تقوم هذه الوظيفة بتعيين مجموعة أولوية تنزيل المورد.

Sound functions

• isSoundFinished » تتحقق هذه الوظيفة من انتهاء عنصر الصوت.
• stopSoundSlowly » تعمل هذه الوظيفة على إيقاف عنصر الصوت ببطء.

Browser functions

• playVideo » تقوم هذه الوظيفة بتشغيل مقطع فيديو على الشاشة.

Team functions

• getTeamFromColor » هذه الوظيفة تعطي عنصر الفريق حسب اللون المحدد.
• getTeamWithFewestPlayers » هذه الوظيفة تعطي عنصر فريق مع أقل اللاعبين من جميع الفرق المحددة.

Vehicle functions

• findEmptyCarSeat » تجد هذه الوظيفة أول مقعد فارغ في السيارة.
• getNearestVehicle » تحصل هذه الوظيفة على أقرب سيارة للاعب المحدد في مسافة محددة.
• getRandomVehicle » تحصل هذه الوظيفة على مركبة عشوائية.
• getValidVehicleModels » تحصل هذه الوظيفة على مركبة عشوائية.
• getVehiclesCountByType » هذه الوظيفة تعطي كمية المركبات حسب النوع المحدد كقيمة عددية.
• isVehicleEmpty » تتحقق هذه الوظيفة مما إذا كانت السيارة فارغة.
• isVehicleOccupied » تتحقق هذه الوظيفة مما إذا كانت مركبة معينة مشغولة.
• isVehicleOnRoof » تتحقق هذه الوظيفة مما إذا كانت السيارة على السطح.
• isVehicleReversing » تتحقق هذه الوظيفة إذا كانت المركبة المحددة تتحرك للخلف

.

• isVehicleUpgraded » تتحقق الوظيفة اذا كانت تحتوي علي تعديل وبواسطة راقم التعديل.
• setVehicleGravityPoint » تحدد هذه الوظيفة جاذبية السيارة في اتجاه إحداثيات ثلاثية الأبعاد مع القوة المحددة.
• getVehicleTurnVelocityCenterOfMass» تحصل هذه الوظيفة على سرعة دوران السيارة بالنسبة لمركز كتلة السيارة

.

• setVehicleTurnVelocityCenterOfMass» تحدد هذه الوظيفة سرعة دوران السيارة بالنسبة لمركز كتلة السيارة.

Weapon functions

• getJetpackWeaponsEnabled » تقوم هذه الوظيفة بأعطاء جدول الأسلحة الممكنة التي يمكن استخدامها على حقيبة نفاثة

.

• getPreviousAndNextWeapon » ترجع هذه الوظيفة السلاح التالي والسابق.

XML functions

• getXMLNodes » تعطي هذه الوظيفة جميع توابع عقدة XML.

Utility

• animate » تسمح لك هذه الوظيفة باستخدام interpolateB Between بدون حدث تقديم واستخدامها بسهولة.
• callClientFunction » تتيح لك هذه الوظيفة استدعاء أي وظيفة من جانب العميل من جانب الخادم.
• callServerFunction » تتيح لك هذه الوظيفة استدعاء أي وظيفة من جانب الخادم من جانب العميل.
• check » تتحقق هذه الوظيفة إذا كانت وسيطاتها من النوع الصحيح وتستدعي وظيفة الخطأ إذا لم تكن الوسيطات موجودة

.

• coroutine.resume » تطبق هذه الوظيفة إصلاحًا لرسائل خطأ coroutine المخفية.
• getBanFromName » هذه الوظيفة تعطي حظر اسم التشغيل المعطى.
• getCurrentFPS » تقوم هذه الوظيفة بإرجاع الإطارات في الثانية التي يعمل عندها GTA: SA.
• IfElse » تُعطي هذه الدالة إحدى القيمتين بناءً على تعبير منطقي.
• isMouseInCircle » تتحقق هذه الوظيفة إذا كان موضع المؤشر في منطقة دائرية أم لا.
• isMouseInPosition » تسمح لك هذه الوظيفة بالتحقق مما إذا كان مؤشر / مؤشر الماوس في وضع مستطيل.
• isCharInString » تتيح لك هذه الوظيفة المشتركة التحقق مما إذا كان الحرف المحدد في قيمة نصية.
• iterElements » هذه الوظيفة تعطي مكرر موفر للوقت للحلقات الخاصة بك.
• vector3:compare » تتحقق هذه الطريقة من تطابق متجهين بدقة اختيارية.
• preprocessor » تتيح لك هذه الوظيفة استخدام وحدات ماكرو دول مجلس التعاون الخليجي.
• PlotTrajectoryAtTime »احسب مسار المقذوفات / المياه.
• GetSkinNameFromID » تُرجع هذه الوظيفة اسم الشخصية من الرقم المحدد.