2.1. Ваш первый скрипт

Python-скрипт – это последовательность инструкций, сохранённая в текстовом файле с расширением .py. OpenMV Cam выполняет тот скрипт, который в данный момент открыт в IDE, когда вы нажимаете зелёную кнопку Run, и выводит весь результат в последовательном терминале IDE в нижней части окна.

Самый простой возможный скрипт состоит из одной строки:

print("Hello, OpenMV!")

Нажатие Run отправляет этот скрипт на камеру, которая выполняет его и выводит сообщение обратно в IDE.

2.1.1. Что делает print

print() – это встроенная функция, то есть фрагмент кода, который находится внутри прошивки и всегда доступен без какой-либо настройки. Передайте ей одно или несколько значений в скобках, и она выведет текстовое представление этих значений в IDE.

Функции print() можно передать что угодно, а не только текст:

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

В выводе несколько аргументов разделяются пробелами:

>>> temperature 25

2.1.2. Комментарии

Символ # начинает комментарий – остальная часть строки игнорируется Python. Используйте комментарии, чтобы объяснить, почему код делает то, что он делает; сам код уже показывает, что он делает.

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

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

В Python нет отдельного синтаксиса для многострочных комментариев. Комментируйте несколько строк по отдельности или выделите строки в IDE и нажмите Ctrl+/, чтобы включить или выключить комментирование.

2.1.3. Отступы имеют значение

Python использует отступы – пробелы в начале строки – для группировки связанных строк вместе. Внутри функции, оператора if или цикла каждая строка, принадлежащая блоку, имеет отступ одинаковой величины (по соглашению – четыре пробела). Смешивание табуляций и пробелов или изменение ширины отступа внутри блока приводит к синтаксической ошибке.

Операторы верхнего уровня, такие как вызовы print выше, находятся на нулевом отступе. Блоки с отступом появляются, как только вы начинаете писать ветвления и циклы.

Совет

IDE автоматически делает отступ за вас, как только вы заканчиваете строку, оканчивающуюся на :. Если у вас когда-нибудь появится загадочная ошибка IndentationError, выделите проблемный блок и нажмите Tab / Shift+Tab, чтобы выровнять его заново.

2.1.4. Повторный запуск скрипта

Каждый раз, когда вы нажимаете Run, камера прекращает то, что делала, загружает текущий скрипт и начинает выполнение с начала. Отдельного этапа компиляции нет. Измените строку, снова нажмите Run – и новый вывод появится в терминале.

Чтобы скрипт запускался автоматически каждый раз при включении камеры, сохраните его как main.py в файловой системе камеры.