2.1. Je eerste script

Een Python-script is een reeks instructies die wordt opgeslagen in een tekstbestand met de extensie .py. De OpenMV Cam voert het script uit dat op dat moment in de IDE is geopend wanneer je op de groene knop Run drukt, en print alle uitvoer in de seriële terminal van de IDE onderaan het venster.

Het eenvoudigst denkbare script bestaat uit één regel:

print("Hello, OpenMV!")

Door op Run te drukken stuur je dit script naar de camera, die het uitvoert en het bericht terugprint in de IDE.

2.1.1. Wat print doet

print() is een ingebouwde functie – een stukje code dat in de firmware leeft en altijd beschikbaar is zonder enige voorbereiding. Geef er een of meer waarden tussen haakjes aan mee en het print een tekstuele weergave van die waarden in de IDE.

Je kunt print() van alles meegeven, niet alleen tekst:

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

Meerdere argumenten worden in de uitvoer gescheiden door spaties:

>>> temperature 25

2.1.2. Commentaar

Een # begint een commentaar – de rest van de regel wordt door Python genegeerd. Gebruik commentaar om uit te leggen waarom de code doet wat hij doet; de code zelf laat al zien wat hij doet.

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

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

Python heeft geen aparte syntaxis voor commentaar over meerdere regels. Plaats commentaar op meerdere regels afzonderlijk, of selecteer de regels in de IDE en druk op Ctrl+/ om ze in en uit te schakelen.

2.1.3. Inspringing is belangrijk

Python gebruikt inspringing – de witruimte aan het begin van een regel – om bij elkaar horende regels te groeperen. Binnen een functie, een if-statement of een lus springt elke regel die bij het blok hoort met dezelfde hoeveelheid in (vier spaties is de conventie). Tabs en spaties door elkaar gebruiken of de inspringbreedte binnen een blok wijzigen levert een syntaxisfout op.

Statements op het hoogste niveau, zoals de print-aanroepen hierboven, staan op inspringniveau nul. Ingesprongen blokken verschijnen zodra je vertakkingen en lussen gaat schrijven.

Tip

De IDE springt automatisch voor je in zodra je een regel afsluit die eindigt op :. Mocht je ooit een mysterieuze IndentationError krijgen, selecteer dan het probleemblok en druk op Tab / Shift+Tab om het opnieuw uit te lijnen.

2.1.4. Het script opnieuw uitvoeren

Telkens als je op Run drukt, stopt de camera met wat hij aan het doen was, laadt het huidige script en begint vanaf het begin. Er is geen aparte compileerstap. Wijzig een regel, druk opnieuw op Run en de nieuwe uitvoer verschijnt in de terminal.

Om een script automatisch te laten uitvoeren elke keer dat de camera wordt ingeschakeld, sla je het op als main.py op het bestandssysteem van de camera.