2.1. Twój pierwszy skrypt

Skrypt Pythona (script) to sekwencja instrukcji zapisana w pliku tekstowym z rozszerzeniem .py. OpenMV Cam uruchamia skrypt aktualnie otwarty w IDE, gdy naciśniesz zielony przycisk Run, i wypisuje wszelkie dane wyjściowe w terminalu szeregowym IDE u dołu okna.

Najprostszy możliwy skrypt to jedna linijka:

print("Hello, OpenMV!")

Naciśnięcie Run wysyła ten skrypt do kamery, która go wykonuje i wypisuje komunikat z powrotem w IDE.

2.1.1. Co robi print

print() to funkcja wbudowana – fragment kodu, który znajduje się wewnątrz oprogramowania układowego i jest zawsze dostępny bez żadnej konfiguracji. Podaj jej jedną lub więcej wartości w nawiasach, a wypisze ona tekstową reprezentację tych wartości w IDE.

Funkcji print() możesz podać cokolwiek, nie tylko tekst:

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

W danych wyjściowych wiele argumentów jest oddzielanych spacjami:

>>> temperature 25

2.1.2. Komentarze

Znak # rozpoczyna komentarz – reszta linii jest ignorowana przez Pythona. Używaj komentarzy, aby wyjaśnić, dlaczego kod robi to, co robi; sam kod już pokazuje, co robi.

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

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

W Pythonie nie ma osobnej składni dla komentarzy wieloliniowych. Skomentuj kilka linii pojedynczo albo zaznacz linie w IDE i naciśnij Ctrl+/, aby je włączyć lub wyłączyć.

2.1.3. Wcięcia mają znaczenie

Python używa wcięć – białych znaków na początku linii – do grupowania powiązanych linii razem. Wewnątrz funkcji, instrukcji if lub pętli każda linia należąca do bloku jest wcięta o tę samą wielkość (przyjętą konwencją są cztery spacje). Mieszanie tabulatorów i spacji albo zmiana szerokości wcięcia wewnątrz bloku to błąd składni.

Instrukcje najwyższego poziomu, takie jak powyższe wywołania print, znajdują się na poziomie wcięcia zero. Wcięte bloki pojawiają się, gdy zaczynasz pisać rozgałęzienia i pętle.

Wskazówka

IDE automatycznie wcina kod, gdy tylko zakończysz linię kończącą się znakiem :. Jeśli kiedykolwiek pojawi się tajemniczy IndentationError, zaznacz problematyczny blok i naciśnij Tab / Shift+Tab, aby go wyrównać.

2.1.4. Ponowne uruchamianie skryptu

Za każdym razem, gdy naciśniesz Run, kamera przerywa to, co robiła, ładuje bieżący skrypt i zaczyna od góry. Nie ma osobnego etapu kompilacji. Zmień linię, naciśnij ponownie Run, a w terminalu pojawi się nowy wynik.

Aby skrypt uruchamiał się automatycznie przy każdym włączeniu kamery, zapisz go jako main.py w systemie plików kamery.