13.1.2. Szkriptek, példák és a dokumentumok mappa

13.1.2.1. Új fájlok

Hozz létre egy új fájlt, és az IDE megnyit egy untitled_N.py puffert, amely egy minimális rögzítési ciklussal van előre feltöltve – resetel az érzékelő, beállítja a képpontformátumot és a képkockaméretet, majd pillanatképet készít, és örökké kiírja a képkockasebességet. A kezdő szkript a csatlakoztatott kártyához van igazítva, így létrehozáskor futtatható. A puffer csak a memóriában él: ismételten szerkesztheted és futtathatod anélkül, hogy valaha is elmentenéd, ami az új fájlokat egy ötlet kipróbálásának legolcsóbb módjává teszi. Mentsd el a lemezre, és közönséges szkriptté válik.

13.1.2.2. A példák menü

A File → Examples a példaszkriptek kategorizált gyűjteményét tartalmazza, amely lényegében a kamera összes funkcióját lefedi – témánként egy mappa, az alapvető pillanatképektől a színkövetésen, a gépi tanuláson és a kártyaperifériákon át. Egy példa megnyitása egy memóriapufferbe tölti azt, akárcsak egy új fájlt, így szabadon módosíthatod és futtathatod a telepített másolat érintése nélkül.

Alapértelmezés szerint a menü a csatlakoztatott kártyára és annak érzékelőjére van szűrve: az olyan példák, amelyekhez a kamerádnál nem létező hardver szükséges, rejtve maradnak, és a menü egyáltalán nem mutat semmit, amíg nincs kapcsolat. A Tools → Filter examples by board and sensor type kikapcsolja a szűrőt, ha a teljes készletet szeretnéd böngészni.

A példák megnyitáskor is hozzáigazítódnak. A szkriptek egy tipikus színérzékelőre vannak megírva, így amikor a csatlakoztatott kamera eltér ettől – egy termikus vagy eseményérzékelő, egy másik natív felbontású kártya –, az IDE betöltés közben a hardvered által támogatott értékekre állítja a képpontformátum- és képkockaméret-sorokat, és a példa úgy fut, ahogyan megnyílt.

A példák menü végigjárása a leggyorsabb módja annak, hogy megtanuld, mire képes a kamera; a legtöbb alkalmazás egy olyan példaként indul, amely tovább nőtt.

13.1.2.3. A dokumentumok mappa

A saját szkriptjeid számára az IDE figyel egy OpenMV könyvtárat a dokumentumok mappádon belül (Documents/OpenMV). Minden, amit ide tárolsz, megjelenik a File → Documents Folder alatt, az alkönyvtárakat is beleértve, így a szkriptgyűjteményed egyetlen menünyi távolságra van. A menü élőben olvassa a könyvtárat – az IDE-n kívül hozzáadott fájlok a menü következő megnyitásakor jelennek meg.

Az IDE egyetlen példányként fut: nyiss meg egy .py fájlt a fájlkezelődből, vagy ejtsd egyet az IDE ablakára, és az a futó ablakban nyílik meg, nem pedig egy második másolatot indít el.

13.1.2.4. Szkript keresztfordítása

A Tools → MicroPython Tools → Copy/Convert Python File egy .py fájlt másol egy célhelyre – a kamera meghajtójára, ha van csatlakoztatva –, és lehetővé teszi, hogy kiválaszd, mi történjen közben: másold változatlanul, távolítsd el a szóközöket és/vagy a megjegyzéseket a zsugorításhoz, vagy fordítsd .mpy bájtkód fájllá a célkártyához illesztett mpy-cross fordítóval. Egy .mpy fájl pontosan úgy importálható, mint az a .py, amelyből származik, gyorsabban töltődik be, és nem szállítja a forrását – ez az a forma, amelyet egy könyvtármodul kamera fájlrendszerére való terjesztésekor érdemes használni. Csatlakoztatott kamera esetén az IDE automatikusan választja ki a célkártyát; egyébként a párbeszédablak megkérdezi, melyik kártyához fordítson. A kártyaválasztás azért fontos, mert az határozza meg, hogy a fordító melyik processzorarchitektúrát célozza: egy .mpy fájl ahhoz a kamerához van illesztve, amelyen futni fog, és egy másik kártyacsaládhoz fordított fájl betöltése nem garantált.

Lásd még

MicroPython eszközök, az mpy-cross és az mpremote önálló parancssori eszközökként, valamint a MicroPython .mpy fájlok magáról a .mpy fájlformátumról.