2.1. Votre premier script

Un script Python est une suite d’instructions enregistrées dans un fichier texte portant l’extension .py. L’OpenMV Cam exécute le script actuellement ouvert dans l’IDE lorsque vous appuyez sur le bouton vert Run, et affiche toute sortie dans le terminal série de l’IDE, en bas de la fenêtre.

Le script le plus simple possible tient sur une seule ligne :

print("Hello, OpenMV!")

Appuyer sur Run envoie ce script à la caméra, qui l’exécute et réaffiche le message dans l’IDE.

2.1.1. Ce que fait print

print() est une fonction intégrée – un morceau de code qui réside dans le micrologiciel et qui est toujours disponible sans aucune configuration. Donnez-lui une ou plusieurs valeurs entre parenthèses et elle affiche une représentation textuelle de ces valeurs dans l’IDE.

Vous pouvez passer n’importe quoi à print(), pas seulement du texte :

print(42)
print(3.14)
print("temperature", 25)

Plusieurs arguments sont séparés par des espaces dans la sortie :

>>> temperature 25

2.1.2. Commentaires

Un # débute un commentaire – le reste de la ligne est ignoré par Python. Utilisez les commentaires pour expliquer pourquoi le code fait ce qu’il fait ; le code lui-même montre déjà ce qu’il fait.

# Send a startup banner over the serial terminal.
print("camera ready")

print("running")  # Marker for the operator monitoring the IDE.

Il n’existe pas en Python de syntaxe distincte pour les commentaires sur plusieurs lignes. Commentez chaque ligne individuellement, ou sélectionnez les lignes dans l’IDE et appuyez sur Ctrl+/ pour les activer et les désactiver.

2.1.3. L’indentation a son importance

Python utilise l’indentation – les espaces en début de ligne – pour regrouper les lignes apparentées. À l’intérieur d’une fonction, d’une instruction if ou d’une boucle, chaque ligne appartenant au bloc est indentée de la même quantité (quatre espaces par convention). Mélanger tabulations et espaces ou modifier la largeur d’indentation à l’intérieur d’un bloc constitue une erreur de syntaxe.

Les instructions de premier niveau comme les appels print ci-dessus se situent à l’indentation zéro. Les blocs indentés apparaissent dès que vous commencez à écrire des branches et des boucles.

Astuce

L’IDE indente automatiquement pour vous dès que vous terminez une ligne se finissant par :. Si jamais vous obtenez une mystérieuse IndentationError, sélectionnez le bloc fautif et appuyez sur Tab / Shift+Tab pour le réaligner.

2.1.4. Réexécuter le script

Chaque fois que vous appuyez sur Run, la caméra arrête ce qu’elle faisait, charge le script courant et repart du début. Il n’y a pas d’étape de compilation distincte. Modifiez une ligne, appuyez de nouveau sur Run, et la nouvelle sortie apparaît dans le terminal.

Pour qu’un script s’exécute automatiquement à chaque mise sous tension de la caméra, enregistrez-le sous le nom main.py sur le système de fichiers de la caméra.