13.1.2. البرامج النصية والأمثلة ومجلد المستندات

13.1.2.1. ملفات جديدة

أنشئ ملفاً جديداً وستفتح بيئة التطوير المتكاملة مخزناً مؤقتاً باسم untitled_N.py محمّلاً مسبقاً بحلقة التقاط بسيطة -- إعادة ضبط المستشعر، وتهيئة صيغة البكسل وحجم الإطار، ثم التقاط لقطة وطباعة معدل الإطارات إلى ما لا نهاية. البرنامج النصي الابتدائي مُكيَّف للوحة المتصلة، لذا يعمل كما أُنشئ. يعيش المخزن المؤقت في الذاكرة فقط: يمكنك تحريره وتشغيله مراراً دون حفظه قط، مما يجعل الملفات الجديدة أرخص طريقة لاختبار فكرة. احفظه على القرص فيصبح برنامجاً نصياً عادياً.

13.1.2.2. قائمة الأمثلة

تحتوي File → Examples على مكتبة مصنفة من البرامج النصية الأمثلة تغطي عملياً كل ميزة تمتلكها الكاميرا -- مجلد واحد لكل موضوع، من اللقطات الأساسية مروراً بتتبع الألوان والتعلم الآلي وطرفيات اللوحة. يؤدي فتح مثال إلى تحميله في مخزن مؤقت في الذاكرة مثل ملف جديد، فيمكنك تعديله وتشغيله بحرية دون المساس بالنسخة المثبتة.

بشكل افتراضي، تُرشَّح القائمة وفق اللوحة المتصلة ومستشعرها: تُخفى الأمثلة التي تحتاج إلى عتاد لا تمتلكه كاميرتك، وتطلب القائمة اتصالاً قبل أن تعرض أي شيء على الإطلاق. يوقف Tools → Filter examples by board and sensor type المرشِّح عندما تريد تصفح المجموعة الكاملة.

تُكيَّف الأمثلة أيضاً أثناء فتحها. فالبرامج النصية مكتوبة لمستشعر ألوان نموذجي، لذا عندما تختلف الكاميرا المتصلة -- مستشعر حراري أو مستشعر أحداث، أو لوحة بدقة أصلية مختلفة -- تضبط بيئة التطوير المتكاملة سطري صيغة البكسل وحجم الإطار إلى قيم يدعمها عتادك أثناء التحميل، فيعمل المثال كما فُتح.

العمل عبر قائمة الأمثلة هو أسرع طريقة لتعلم ما يمكن للكاميرا فعله؛ ومعظم التطبيقات تبدأ كمثال نما وتطور.

13.1.2.3. مجلد المستندات

لبرامجك النصية الخاصة، تراقب بيئة التطوير المتكاملة دليلاً باسم OpenMV داخل مجلد المستندات لديك (Documents/OpenMV). كل ما تخزنه هناك يظهر ضمن File → Documents Folder، بما في ذلك الأدلة الفرعية، فتكون مجموعة برامجك النصية على بُعد قائمة واحدة. تقرأ القائمة الدليل مباشرة -- فالملفات التي تضيفها خارج بيئة التطوير المتكاملة تظهر في المرة التالية التي تُفتح فيها القائمة.

تعمل بيئة التطوير المتكاملة كنسخة واحدة فقط: افتح ملف .py من مدير الملفات لديك، أو أسقط واحداً على نافذة بيئة التطوير المتكاملة، فيُفتح في النافذة قيد التشغيل بدلاً من تشغيل نسخة ثانية.

13.1.2.4. تجميع برنامج نصي تجميعاً متقاطعاً

ينسخ Tools → MicroPython Tools → Copy/Convert Python File ملف .py إلى وجهة -- محرك الكاميرا، عند اتصال واحدة -- ويتيح لك اختيار ما يحدث في أثناء ذلك: نسخه دون تغيير، أو إزالة المسافات البيضاء و/أو التعليقات لتقليص حجمه، أو تجميعه إلى ملف شفرة بايت .mpy بواسطة مُجمِّع mpy-cross المطابق للوحة الهدف. يُستورد ملف .mpy تماماً مثل ملف .py الذي جاء منه، ويُحمَّل أسرع، ولا يشحن شفرته المصدرية -- وهو الشكل المناسب لاستخدامه عند توزيع وحدة مكتبة إلى نظام ملفات الكاميرا. مع اتصال كاميرا تختار بيئة التطوير المتكاملة اللوحة الهدف تلقائياً؛ وإلا فإن مربع الحوار يسأل عن اللوحة المراد التجميع لها. لاختيار اللوحة أهمية لأنه يحدد معمارية المعالج التي يستهدفها المُجمِّع: فملف .mpy مطابق للكاميرا التي سيعمل عليها، وملف مُجمَّع لعائلة لوحات مختلفة ليس مضموناً تحميله.

شاهد أيضا

أدوات MicroPython لـ mpy-cross وmpremote كأدوات سطر أوامر مستقلة، وملفات ‎.mpy‎ في MicroPython لصيغة ملف .mpy نفسها.