13.1.2. Skrypty, przykłady i folder dokumentów

13.1.2.1. Nowe pliki

Utwórz nowy plik, a IDE otworzy bufor untitled_N.py wstępnie wypełniony minimalną pętlą przechwytywania – resetuj sensor, skonfiguruj format pikseli i rozmiar ramki, a następnie wykonuj zrzut obrazu i w nieskończoność wypisuj liczbę klatek na sekundę. Skrypt startowy jest dostosowany do podłączonej płytki, więc działa w postaci, w jakiej został utworzony. Bufor istnieje tylko w pamięci: możesz go wielokrotnie edytować i uruchamiać, nie zapisując go ani razu, co czyni nowe pliki najtańszym sposobem na przetestowanie pomysłu. Zapisz go na dysku, a stanie się zwykłym skryptem.

13.1.2.2. Menu przykładów

File → Examples zawiera skategoryzowaną bibliotekę przykładowych skryptów obejmujących praktycznie każdą funkcję kamery – jeden folder na temat, od podstawowych zrzutów obrazu, przez śledzenie kolorów, uczenie maszynowe, po urządzenia peryferyjne płytki. Otwarcie przykładu wczytuje go do bufora w pamięci jak nowy plik, więc możesz go swobodnie modyfikować i uruchamiać bez naruszania zainstalowanej kopii.

Domyślnie menu jest filtrowane do podłączonej płytki i jej sensora: przykłady wymagające sprzętu, którego twoja kamera nie ma, są ukryte, a menu prosi o połączenie, zanim w ogóle cokolwiek pokaże. Tools → Filter examples by board and sensor type wyłącza filtr, gdy chcesz przeglądać pełny zestaw.

Przykłady są również dostosowywane podczas otwierania. Skrypty są napisane pod typowy sensor kolorów, więc gdy podłączona kamera się różni – sensor termiczny lub zdarzeniowy, płytka o innej natywnej rozdzielczości – IDE podczas wczytywania dostosowuje linie z formatem pikseli i rozmiarem ramki do wartości obsługiwanych przez twój sprzęt, i przykład działa w postaci, w jakiej został otwarty.

Przerabianie menu przykładów to najszybszy sposób na poznanie możliwości kamery; większość aplikacji zaczyna się jako przykład, który się rozrósł.

13.1.2.3. Folder dokumentów

Dla twoich własnych skryptów IDE obserwuje katalog OpenMV wewnątrz twojego folderu dokumentów (Documents/OpenMV). Wszystko, co tam przechowujesz, pojawia się pod File → Documents Folder, włącznie z podkatalogami, więc twoja kolekcja skryptów jest o jedno menu dalej. Menu odczytuje katalog na żywo – pliki dodane poza IDE pojawiają się przy następnym otwarciu menu.

IDE działa jako pojedyncza instancja: otwórz plik .py z menedżera plików lub przeciągnij go na okno IDE, a otworzy się on w działającym oknie, zamiast uruchamiać drugą kopię.

13.1.2.4. Kompilacja krzyżowa skryptu

Tools → MicroPython Tools → Copy/Convert Python File kopiuje plik .py do miejsca docelowego – na dysk kamery, gdy jest podłączona – i pozwala wybrać, co stanie się po drodze: skopiować go bez zmian, usunąć białe znaki i/lub komentarze, aby go zmniejszyć, lub skompilować go do pliku bajtkodu .mpy za pomocą kompilatora mpy-cross dopasowanego do docelowej płytki. Plik .mpy importuje się dokładnie tak jak plik .py, z którego powstał, wczytuje się szybciej i nie przesyła swojego kodu źródłowego – to forma, której należy użyć przy dystrybucji modułu biblioteki do systemu plików kamery. Przy podłączonej kamerze IDE wybiera docelową płytkę automatycznie; w przeciwnym razie okno dialogowe pyta, dla której płytki kompilować. Wybór płytki ma znaczenie, ponieważ ustala architekturę procesora, na którą celuje kompilator: plik .mpy jest dopasowany do kamery, na której będzie działać, i taki skompilowany dla innej rodziny płytek nie ma gwarancji, że się wczyta.

Zobacz także

Narzędzia MicroPython – o mpy-cross i mpremote jako samodzielnych narzędziach wiersza poleceń, oraz Pliki .mpy w MicroPython – o samym formacie pliku .mpy.