13.1.2. Scripturi, exemple și dosarul de documente

13.1.2.1. Fișiere noi

Creează un fișier nou și IDE-ul deschide un tampon untitled_N.py preîncărcat cu o buclă minimă de captură – resetează senzorul, configurează formatul de pixeli și dimensiunea cadrului, apoi face un instantaneu și afișează la nesfârșit rata cadrelor. Scriptul de pornire este adaptat la placa conectată, astfel încât rulează așa cum a fost creat. Tamponul există doar în memorie: îl poți edita și rula în mod repetat fără să îl salvezi vreodată, ceea ce face din fișierele noi cea mai ieftină modalitate de a testa o idee. Salvează-l pe disc și devine un script obișnuit.

13.1.2.2. Meniul de exemple

File → Examples conține o bibliotecă categorisită de scripturi-exemplu care acoperă practic fiecare funcție pe care o are camera – câte un dosar per subiect, de la instantanee de bază până la urmărirea culorilor, învățarea automată și perifericele plăcii. Deschiderea unui exemplu îl încarcă într-un tampon de memorie ca un fișier nou, astfel încât îl poți modifica și rula liber fără a atinge copia instalată.

În mod implicit, meniul este filtrat pentru placa conectată și senzorul său: exemplele care necesită hardware pe care camera ta nu îl are sunt ascunse, iar meniul cere o conexiune înainte de a afișa ceva. Tools → Filter examples by board and sensor type dezactivează filtrul când vrei să răsfoiești setul complet.

Exemplele sunt de asemenea adaptate pe măsură ce se deschid. Scripturile sunt scrise pentru un senzor de culoare tipic, așa că atunci când camera conectată diferă – un senzor termic sau de evenimente, o placă cu o rezoluție nativă diferită – IDE-ul ajustează liniile pentru formatul de pixeli și dimensiunea cadrului la valori pe care hardware-ul tău le suportă în timpul încărcării, iar exemplul rulează așa cum a fost deschis.

Parcurgerea meniului de exemple este cea mai rapidă modalitate de a învăța ce poate face camera; majoritatea aplicațiilor încep ca un exemplu care s-a dezvoltat.

13.1.2.3. Dosarul de documente

Pentru propriile tale scripturi, IDE-ul monitorizează un director OpenMV din interiorul dosarului tău de documente (Documents/OpenMV). Tot ce stochezi acolo apare sub File → Documents Folder, inclusiv subdirectoarele, astfel încât colecția ta de scripturi este la un meniu distanță. Meniul citește directorul în timp real – fișierele pe care le adaugi în afara IDE-ului apar la următoarea deschidere a meniului.

IDE-ul rulează ca o instanță unică: deschide un fișier .py din managerul tău de fișiere sau trage unul peste fereastra IDE-ului, iar acesta se deschide în fereastra existentă în loc să lanseze o a doua copie.

13.1.2.4. Compilarea încrucișată a unui script

Tools → MicroPython Tools → Copy/Convert Python File copiază un fișier .py într-o destinație – unitatea camerei, când este conectată una – și îți permite să alegi ce se întâmplă pe parcurs: îl copiezi nemodificat, elimini spațiile albe și/sau comentariile pentru a-l micșora, sau îl compilezi într-un fișier de bytecode .mpy cu compilatorul mpy-cross potrivit plăcii țintă. Un fișier .mpy se importă exact ca fișierul .py din care provine, se încarcă mai rapid și nu livrează codul sursă – forma de utilizat când distribui un modul de bibliotecă către sistemul de fișiere al camerei. Cu o cameră conectată, IDE-ul alege automat placa țintă; altfel, dialogul întreabă pentru ce placă să compileze. Alegerea plăcii contează deoarece stabilește arhitectura procesorului vizată de compilator: un fișier .mpy este potrivit camerei pe care va rula, iar unul compilat pentru o altă familie de plăci nu este garantat să se încarce.

Vezi și

Instrumente MicroPython pentru mpy-cross și mpremote ca instrumente autonome de linie de comandă, și Fișiere .mpy MicroPython pentru formatul de fișier .mpy în sine.