2.1. برنامجك النصي الأول

البرنامج النصي script في Python هو سلسلة من التعليمات المحفوظة في ملف نصي بامتداد .py. تقوم OpenMV Cam بتشغيل أي برنامج نصي مفتوح حاليًا في OpenMV IDE عندما تضغط على زر Run الأخضر، وتطبع أي مخرجات في الطرفية التسلسلية لـ OpenMV IDE أسفل النافذة.

أبسط برنامج نصي ممكن يتكون من سطر واحد:

print("Hello, OpenMV!")

يؤدي الضغط على Run إلى إرسال هذا البرنامج النصي إلى الكاميرا، التي تنفذه وتطبع الرسالة مرة أخرى في OpenMV IDE.

2.1.1. ما الذي تفعله print

print() هي دالة مدمجة -- جزء من الكود يوجد داخل البرنامج الثابت ومتاح دائمًا دون أي إعداد. مرّر إليها قيمة واحدة أو أكثر بين قوسين فتطبع تمثيلًا نصيًا لتلك القيم في OpenMV IDE.

يمكنك تمرير أي شيء إلى print()، وليس النص فقط:

print(42)
print(3.14)
print("temperature", 25)

يتم الفصل بين الوسائط المتعددة بمسافات في المخرجات:

>>> temperature 25

2.1.2. التعليقات

تبدأ علامة # تعليقًا -- ويتجاهل Python بقية السطر. استخدم التعليقات لشرح لماذا يفعل الكود ما يفعله؛ فالكود نفسه يبيّن بالفعل ماذا يفعل.

# Send a startup banner over the serial terminal.
print("camera ready")

print("running")  # Marker for the operator monitoring the IDE.

لا يوجد بناء جملة منفصل للتعليقات متعددة الأسطر في Python. علّق على عدة أسطر كلٌّ على حدة، أو حدّد الأسطر في OpenMV IDE واضغط على Ctrl+/ لتبديل تفعيلها وإلغائه.

2.1.3. المسافة البادئة مهمة

يستخدم Python المسافة البادئة -- وهي الفراغ في بداية السطر -- لتجميع الأسطر المترابطة معًا. داخل دالة، أو عبارة if، أو حلقة، تكون كل الأسطر التي تنتمي إلى الكتلة مزاحة بالمقدار نفسه (أربع مسافات هي العُرف المتّبع). إن خلطت بين علامات الجدولة والمسافات أو غيّرت عرض المسافة البادئة داخل كتلة فهذا خطأ في بناء الجملة.

تقع العبارات على المستوى الأعلى مثل استدعاءات print أعلاه عند مسافة بادئة صفرية. وتظهر الكتل المزاحة بمجرد أن تبدأ في كتابة التفرعات والحلقات.

نصيحة

تقوم OpenMV IDE بالمسافة البادئة تلقائيًا نيابةً عنك بمجرد أن تنهي سطرًا ينتهي بـ :. وإذا واجهت يومًا IndentationError غامضًا، فحدّد الكتلة المخالفة واضغط على Tab / Shift+Tab لإعادة محاذاتها.

2.1.4. تشغيل البرنامج النصي مجددًا

في كل مرة تضغط فيها على Run، توقف الكاميرا ما كانت تفعله، وتحمّل البرنامج النصي الحالي، وتبدأ من الأعلى. لا توجد خطوة تجميع منفصلة. غيّر سطرًا، واضغط على Run مجددًا، وستظهر المخرجات الجديدة في الطرفية.

لجعل برنامج نصي يعمل تلقائيًا في كل مرة تُشغَّل فيها الكاميرا، احفظه باسم main.py في نظام ملفات الكاميرا.