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 як автономні інструменти командного рядка, і MicroPython .mpy файли – про формат файлу .mpy.