13.1.2. Skripte, Beispiele und der Dokumentenordner

13.1.2.1. Neue Dateien

Erstellen Sie eine neue Datei, und die IDE öffnet einen untitled_N.py-Puffer, der mit einer minimalen Aufnahmeschleife vorbelegt ist – den Sensor zurücksetzen, das Pixelformat und die Bildgröße konfigurieren, dann einen Schnappschuss machen und die Bildrate endlos ausgeben. Das Startskript wird an die verbundene Platine angepasst, sodass es so läuft, wie es erstellt wurde. Der Puffer existiert nur im Speicher: Sie können ihn wiederholt bearbeiten und ausführen, ohne ihn jemals zu speichern, was neue Dateien zur kostengünstigsten Möglichkeit macht, eine Idee zu testen. Speichern Sie ihn auf der Festplatte, und er wird zu einem gewöhnlichen Skript.

13.1.2.2. Das Beispielmenü

File → Examples enthält eine kategorisierte Bibliothek von Beispielskripten, die im Wesentlichen jede Funktion der Kamera abdecken – ein Ordner pro Thema, von einfachen Schnappschüssen über Farbverfolgung, maschinelles Lernen bis hin zu Platinen-Peripheriegeräten. Das Öffnen eines Beispiels lädt es wie eine neue Datei in einen Speicherpuffer, sodass Sie es frei ändern und ausführen können, ohne die installierte Kopie zu berühren.

Standardmäßig ist das Menü auf die verbundene Platine und ihren Sensor gefiltert: Beispiele, die Hardware benötigen, die Ihre Kamera nicht hat, werden ausgeblendet, und das Menü verlangt eine Verbindung, bevor überhaupt etwas angezeigt wird. Tools → Filter examples by board and sensor type schaltet den Filter aus, wenn Sie den vollständigen Satz durchsuchen möchten.

Beispiele werden ebenfalls beim Öffnen angepasst. Die Skripte sind für einen typischen Farbsensor geschrieben, sodass die IDE beim Laden die Zeilen für Pixelformat und Bildgröße auf Werte anpasst, die Ihre Hardware unterstützt, wenn die verbundene Kamera abweicht – ein Thermal- oder Event-Sensor, eine Platine mit einer anderen nativen Auflösung – und das Beispiel läuft so, wie es geöffnet wurde.

Das Durcharbeiten des Beispielmenüs ist der schnellste Weg, um zu lernen, was die Kamera kann; die meisten Anwendungen beginnen als ein Beispiel, das gewachsen ist.

13.1.2.3. Der Dokumentenordner

Für Ihre eigenen Skripte überwacht die IDE ein OpenMV-Verzeichnis in Ihrem Dokumentenordner (Documents/OpenMV). Alles, was Sie dort speichern, erscheint unter File → Documents Folder, einschließlich Unterverzeichnissen, sodass Ihre Skriptsammlung nur ein Menü entfernt ist. Das Menü liest das Verzeichnis live – Dateien, die Sie außerhalb der IDE hinzufügen, erscheinen beim nächsten Öffnen des Menüs.

Die IDE läuft als einzelne Instanz: Öffnen Sie eine .py-Datei aus Ihrem Dateimanager oder ziehen Sie eine auf das IDE-Fenster, und sie öffnet sich im laufenden Fenster, anstatt eine zweite Kopie zu starten.

13.1.2.4. Ein Skript cross-kompilieren

Tools → MicroPython Tools → Copy/Convert Python File kopiert eine .py-Datei an ein Ziel – das Laufwerk der Kamera, sofern eine verbunden ist – und lässt Sie wählen, was dabei geschieht: sie unverändert kopieren, Leerraum und/oder Kommentare entfernen, um sie zu verkleinern, oder sie mit dem zur Zielplatine passenden mpy-cross-Compiler zu einer .mpy-Bytecode-Datei kompilieren. Eine .mpy-Datei importiert genau wie die .py, aus der sie stammt, lädt schneller und liefert ihren Quellcode nicht mit – die Form, die beim Verteilen eines Bibliotheksmoduls an das Dateisystem der Kamera zu verwenden ist. Mit einer verbundenen Kamera wählt die IDE die Zielplatine automatisch aus; andernfalls fragt der Dialog, für welche Platine kompiliert werden soll. Die Platinenwahl ist wichtig, weil sie die Prozessorarchitektur festlegt, auf die der Compiler abzielt: Eine .mpy-Datei ist auf die Kamera abgestimmt, auf der sie laufen wird, und eine für eine andere Platinenfamilie kompilierte Datei lädt nicht garantiert.

Siehe auch

MicroPython-Tools für mpy-cross und mpremote als eigenständige Kommandozeilen-Tools und MicroPython .mpy-Dateien für das .mpy-Dateiformat selbst.