إنشاء الإضافات (Plugins)

طور وحدات مخصصة باستخدام قوة Python.

Designer Window هو أسرع طريق من "أحتاج إلى عقدة خاصة" → "أستطيع استخدامها في المشهد".

تكتب (أو تولد) فئة Python صغيرة (كـ Block)، تضغط على CREATE BLOCK، وتظهر في قائمة Custom Blocks.

إذا أحببت البدء من قالب جاهز يعمل، افتح Coding Reference وانسخ عينة الـ block.

بداية سريعة

اتبع هذه الخطوات مرة واحدة، ثم عُد لاستكشاف التفاصيل.

1. افتح Designer Window.

2. احتفظ بالسكريبت الافتراضي، أو الصق سكريبتك الخاص أو اطلب من وكيل الذكاء الاصطناعي توليده.

3. تأكد أن السكريبت ينتهي بـ add_block(...).

4. اضغط CREATE BLOCK.

5. ابحث عن البلوك في قائمة Custom Blocks واسحبه إلى المشهد.

نصيحة: اجعل أسماء المقابس (sockets) ثابتة. هذا يجعل تحديث البلوك أكثر سلاسة.

محرر الكود

منطقة المحرر الكبيرة هي مصدر الحقيقة لبلوكك.

يجب أن يتضمن سكريبتك (على الأقل):

• from studio.custom_block import *

• فئة ترث من Block

• op_code مطابق

• السطر النهائي add_block(MyBlock.op_code, MyBlock)

عند الإنشاء، يقوم AugeLab Studio بتوحيد المسافات البادئة عن طريق استبدال التاب بمسافات طولها 4 قبل الحفظ.

مساعد الذكاء الاصطناعي

أسفل Designer Window يمكنك:

• كتابة موجه (مثال: “Write a block that converts a BGR image to grayscale”)

  • كن وصفياً للحصول على أفضل النتائج.

  • حتى الآن، مساعد البلوكات المخصصة مجاني للاستخدام.

• اختيار نموذج من القائمة المنسدلة

• الضغط على Submit لتوليد الكود في المحرر

هذا مخصص لمساعدتك على البدء بسرعة. أنت دائماً تتحكم — راجع وحرّر الكود قبل الضغط على CREATE BLOCK.

وكيل الذكاء الاصطناعي يتذكر مطالباتك السابقة، يمكنك طلب تحسينات أو تغييرات.

ميزة الذكاء الاصطناعي قد تكون غير متوفرة حسب الترخيص أو الاتصال أو حالة الخادم.

تحديث بلوك موجود

عند الضغط على CREATE BLOCK مرة أخرى:

• يتم استبدال الملف.

• يتم تحديث الإدخال في قائمة Custom Blocks.

• يحاول Studio استبدالاً آمناً قدر الإمكان في المشاهد المفتوحة (يحاول الحفاظ على الاتصالات).

إذا قمت بإعادة تسمية المقابس، قد يعيد Studio الاتصال حسب الفهرس كخيار احتياطي. لهذا السبب تهم ثبات أسماء المقابس.

متقدم: ماذا يفعل CREATE BLOCK فعلياً

• يقوم Studio بالبحث عن أول فئة ترث من Block ويأخذ اسم الفئة كاسم البلوك.

• يُحفظ سكريبتك كـ <BlockName>.py تحت مجلد Marketplace الخاص بالـ custom blocks.

• يستورد Studio custom_blocks.<BlockName> وينشئ منه مثيلاً مرةً واحدة للتحقق منه.

• إذا بدا كل شيء سليماً، يصبح البلوك متاحاً في قائمة Custom Blocks.

موقع الملف: .../AugeLab Studio/marketplace/custom_blocks/<BlockName>.py

إذا فشل الاستيراد/التحقق، يعرض Studio الخطأ ويزيل الملف. صحح السكريبت وحاول مجدداً.

إعادة تحميل البلوكات في Designer Window

لتحرير بلوك موجود، انقر بزر الفأرة الأيمن على اسمه في قائمة Custom Blocks واختر Load into Designer Window.

تحميل بلوك إلى Designer Window يعمل فقط على السكريبتات القابلة للتحرير للمستخدم (.py). البلوكات المترجمة/المشفرة (مثل .pyd أو سكربتات محمية بواسطة PyArmor) محظورة عمداً.

.png) Load Existing Block

"Reload" يحدث قائمة Custom Blocks (يضيف ملفات جديدة / يزيل الملفات المحذوفة). لا يقوم بتحديث العقد الموضوعة بالفعل في المشاهد بشكل فوري. Refresh Block List