13.1.2. Scripts, exemples et le dossier de documents

13.1.2.1. Nouveaux fichiers

Créez un nouveau fichier et l’IDE ouvre un tampon untitled_N.py préchargé avec une boucle de capture minimale – réinitialiser le capteur, configurer le format de pixel et la taille de trame, puis capturer et afficher la fréquence d’images indéfiniment. Le script de départ est adapté à la carte connectée, de sorte qu’il s’exécute tel quel. Le tampon n’existe qu’en mémoire : vous pouvez l’éditer et l’exécuter de façon répétée sans jamais l’enregistrer, ce qui fait des nouveaux fichiers le moyen le moins coûteux de tester une idée. Enregistrez-le sur le disque et il devient un script ordinaire.

13.1.2.2. Le menu des exemples

File → Examples contient une bibliothèque catégorisée de scripts d’exemple couvrant pour ainsi dire chaque fonctionnalité de la caméra – un dossier par sujet, des captures de base jusqu’au suivi de couleur, l’apprentissage automatique et les périphériques de la carte. L’ouverture d’un exemple le charge dans un tampon mémoire comme un nouveau fichier, de sorte que vous pouvez le modifier et l’exécuter librement sans toucher à la copie installée.

Par défaut, le menu est filtré selon la carte connectée et son capteur : les exemples qui nécessitent du matériel dont votre caméra ne dispose pas sont masqués, et le menu demande une connexion avant d’afficher quoi que ce soit. Tools → Filter examples by board and sensor type désactive le filtre lorsque vous souhaitez parcourir l’ensemble complet.

Les exemples sont également adaptés à leur ouverture. Les scripts sont écrits pour un capteur de couleur typique, donc lorsque la caméra connectée diffère – un capteur thermique ou événementiel, une carte avec une résolution native différente – l’IDE ajuste les lignes de format de pixel et de taille de trame à des valeurs prises en charge par votre matériel lors du chargement, et l’exemple s’exécute tel qu’ouvert.

Parcourir le menu des exemples est le moyen le plus rapide d’apprendre ce que la caméra sait faire ; la plupart des applications commencent comme un exemple qui a grandi.

13.1.2.3. Le dossier de documents

Pour vos propres scripts, l’IDE surveille un répertoire OpenMV à l’intérieur de votre dossier de documents (Documents/OpenMV). Tout ce que vous y stockez apparaît sous File → Documents Folder, y compris les sous-répertoires, de sorte que votre collection de scripts est à un menu de distance. Le menu lit le répertoire en direct – les fichiers que vous ajoutez en dehors de l’IDE apparaissent à la prochaine ouverture du menu.

L’IDE s’exécute en une seule instance : ouvrez un fichier .py depuis votre gestionnaire de fichiers, ou déposez-en un sur la fenêtre de l’IDE, et il s’ouvre dans la fenêtre en cours d’exécution plutôt que de lancer une seconde copie.

13.1.2.4. Compilation croisée d’un script

Tools → MicroPython Tools → Copy/Convert Python File copie un fichier .py vers une destination – le lecteur de la caméra, lorsqu’elle est connectée – et vous laisse choisir ce qui se passe au passage : le copier tel quel, supprimer les espaces et/ou les commentaires pour le réduire, ou le compiler en un fichier de bytecode .mpy avec le compilateur mpy-cross adapté à la carte cible. Un fichier .mpy s’importe exactement comme le .py dont il provient, se charge plus rapidement et ne livre pas son code source – la forme à utiliser lors de la distribution d’un module de bibliothèque vers le système de fichiers de la caméra. Avec une caméra connectée, l’IDE choisit automatiquement la carte cible ; sinon, la boîte de dialogue demande pour quelle carte compiler. Le choix de la carte importe car il détermine l’architecture du processeur ciblée par le compilateur : un fichier .mpy est adapté à la caméra sur laquelle il s’exécutera, et un fichier compilé pour une autre famille de cartes n’est pas garanti de se charger.

Voir aussi

Outils MicroPython pour mpy-cross et mpremote en tant qu’outils autonomes en ligne de commande, et Fichiers .mpy de MicroPython pour le format de fichier .mpy lui-même.