13.1.2. סקריפטים, דוגמאות, ותיקיית המסמכים

13.1.2.1. קבצים חדשים

צור קובץ חדש וה-IDE פותח חוצץ untitled_N.py שטעון מראש בלולאת לכידה מינימלית – אפס את החיישן, הגדר את פורמט הפיקסל וגודל הפריים, ולאחר מכן צלם תמונת בזק והדפס את קצב הפריימים לנצח. סקריפט ההתחלה מותאם ללוח המחובר, ולכן הוא רץ כפי שנוצר. החוצץ קיים בזיכרון בלבד: אתה יכול לערוך ולהריץ אותו שוב ושוב מבלי לשמור אותו אי פעם, מה שהופך קבצים חדשים לדרך הזולה ביותר לבדוק רעיון. שמור אותו לדיסק והוא הופך לסקריפט רגיל.

13.1.2.2. תפריט הדוגמאות

File → Examples מכיל ספרייה מקוטלגת של סקריפטים לדוגמה המכסים למעשה כל תכונה שיש למצלמה – תיקייה אחת לכל נושא, החל מתמונות בזק בסיסיות דרך מעקב צבע, למידת מכונה, והתקנים היקפיים של הלוח. פתיחת דוגמה טוענת אותה לחוצץ בזיכרון כמו קובץ חדש, כך שאתה יכול לשנות ולהריץ אותה בחופשיות מבלי לגעת בעותק המותקן.

כברירת מחדל התפריט מסונן ללוח המחובר ולחיישן שלו: דוגמאות הדורשות חומרה שאין למצלמה שלך מוסתרות, והתפריט דורש חיבור לפני שהוא מציג כל דבר. Tools → Filter examples by board and sensor type מכבה את הסינון כאשר אתה רוצה לעיין בסט המלא.

דוגמאות גם מותאמות כשהן נפתחות. הסקריפטים כתובים מול חיישן צבע טיפוסי, ולכן כאשר המצלמה המחוברת שונה – חיישן תרמי או חיישן אירועים, לוח עם רזולוציה טבעית שונה – ה-IDE מתאים את שורות פורמט הפיקסל וגודל הפריים לערכים שהחומרה שלך תומכת בהם בזמן הטעינה, והדוגמה רצה כפי שנפתחה.

מעבר דרך תפריט הדוגמאות הוא הדרך המהירה ביותר ללמוד מה המצלמה יכולה לעשות; רוב היישומים מתחילים כדוגמה שצמחה.

13.1.2.3. תיקיית המסמכים

עבור הסקריפטים שלך, ה-IDE עוקב אחר תיקיית OpenMV בתוך תיקיית המסמכים שלך (Documents/OpenMV). כל מה שאתה מאחסן שם מופיע תחת File → Documents Folder, כולל תיקיות משנה, כך שאוסף הסקריפטים שלך נמצא במרחק תפריט אחד. התפריט קורא את התיקייה באופן חי – קבצים שאתה מוסיף מחוץ ל-IDE מופיעים בפעם הבאה שהתפריט נפתח.

ה-IDE רץ כמופע יחיד: פתח קובץ .py ממנהל הקבצים שלך, או גרור אחד אל חלון ה-IDE, והוא נפתח בחלון הרץ במקום להפעיל עותק שני.

13.1.2.4. הידור צולב של סקריפט

Tools → MicroPython Tools → Copy/Convert Python File מעתיק קובץ .py אל יעד – כונן המצלמה, כאשר מחובר אחד – ומאפשר לך לבחור מה קורה בדרך: להעתיק אותו ללא שינוי, להסיר רווחים ו/או הערות כדי לכווץ אותו, או להדר אותו לקובץ קוד-בייט .mpy עם המהדר mpy-cross המותאם ללוח היעד. קובץ .mpy מיובא בדיוק כמו ה-.py שממנו הגיע, נטען מהר יותר, ואינו שולח את קוד המקור שלו – הצורה לשימוש בעת הפצת מודול ספרייה אל מערכת הקבצים של המצלמה. כאשר מצלמה מחוברת ה-IDE בוחר את לוח היעד אוטומטית; אחרת תיבת הדו-שיח שואלת עבור איזה לוח להדר. בחירת הלוח חשובה משום שהיא קובעת את ארכיטקטורת המעבד שהמהדר מכוון אליה: קובץ .mpy מותאם למצלמה שעליה הוא ירוץ, ואחד שהודר עבור משפחת לוחות שונה אינו מובטח להיטען.

ראה גם

כלי MicroPython עבור mpy-cross ו-mpremote ככלי שורת פקודה עצמאיים, ו-קובצי .mpy של MicroPython עבור פורמט קובץ ה-.mpy עצמו.