13.1.2. Skripty, příklady a složka dokumentů

13.1.2.1. Nové soubory

Když vytvoříte nový soubor, IDE otevře buffer untitled_N.py předvyplněný minimální záchytnou smyčkou – reset senzoru, konfigurace formátu pixelů a velikosti snímku, poté snímek a nekonečné vypisování snímkové frekvence. Úvodní skript je přizpůsoben připojené desce, takže běží tak, jak je vytvořen. Buffer existuje pouze v paměti: můžete jej opakovaně upravovat a spouštět, aniž byste jej kdy uložili, což z nových souborů činí nejlevnější způsob, jak otestovat nápad. Uložte jej na disk a stane se z něj běžný skript.

13.1.2.2. Nabídka příkladů

File → Examples obsahuje kategorizovanou knihovnu ukázkových skriptů pokrývajících v podstatě každou funkci kamery – jedna složka na téma, od základních snímků přes sledování barev, strojové učení až po periferie desky. Otevření příkladu jej načte do paměťového bufferu jako nový soubor, takže jej můžete volně upravovat a spouštět, aniž byste se dotkli nainstalované kopie.

Ve výchozím nastavení je nabídka filtrována na připojenou desku a její senzor: příklady, které vyžadují hardware, jaký vaše kamera nemá, jsou skryty a nabídka před zobrazením čehokoli vyžaduje připojení. Volba Tools → Filter examples by board and sensor type filtr vypne, když chcete procházet celou sadu.

Příklady se také přizpůsobují při otevírání. Skripty jsou napsány pro typický barevný senzor, takže když se připojená kamera liší – termální nebo událostní senzor, deska s jiným nativním rozlišením – IDE při načítání upraví řádky s formátem pixelů a velikostí snímku na hodnoty, které váš hardware podporuje, a příklad běží tak, jak je otevřen.

Procházení nabídky příkladů je nejrychlejší způsob, jak se naučit, co kamera dokáže; většina aplikací začíná jako příklad, který se rozrostl.

13.1.2.3. Složka dokumentů

Pro vaše vlastní skripty IDE sleduje adresář OpenMV uvnitř vaší složky dokumentů (Documents/OpenMV). Vše, co tam uložíte, se objeví v nabídce File → Documents Folder, včetně podadresářů, takže vaše sbírka skriptů je na dosah jedné nabídky. Nabídka čte adresář naživo – soubory, které přidáte mimo IDE, se objeví při příštím otevření nabídky.

IDE běží jako jediná instance: otevřete soubor .py ze svého správce souborů nebo jej přetáhněte na okno IDE a otevře se v běžícím okně místo spuštění druhé kopie.

13.1.2.4. Křížová kompilace skriptu

Volba Tools → MicroPython Tools → Copy/Convert Python File zkopíruje soubor .py do cíle – na disk kamery, pokud je nějaký připojen – a umožní vám zvolit, co se cestou stane: zkopírovat jej beze změny, odstranit bílé znaky a/nebo komentáře pro jeho zmenšení, nebo jej zkompilovat do bytecode souboru .mpy pomocí kompilátoru mpy-cross přiřazeného k cílové desce. Soubor .mpy se importuje přesně jako .py, ze kterého vznikl, načítá se rychleji a nedodává svůj zdrojový kód – forma, kterou použijete při distribuci knihovního modulu do filesystému kamery. S připojenou kamerou IDE cílovou desku vybere automaticky; jinak se dialog zeptá, pro kterou desku kompilovat. Na volbě desky záleží, protože nastavuje architekturu procesoru, na kterou kompilátor cílí: soubor .mpy je přiřazen ke kameře, na které poběží, a u souboru zkompilovaného pro jinou rodinu desek není zaručeno, že se načte.

Viz také

Nástroje MicroPython popisuje mpy-cross a mpremote jako samostatné nástroje příkazové řádky a Soubory .mpy v MicroPythonu popisuje samotný formát souboru .mpy.