2.1. Seu primeiro script

Um script Python é uma sequência de instruções salva em um arquivo de texto com a extensão .py. A OpenMV Cam executa qualquer script que estiver aberto na IDE quando você pressiona o botão verde Run, e imprime qualquer saída no terminal serial da IDE, na parte inferior da janela.

O script mais simples possível tem uma única linha:

print("Hello, OpenMV!")

Pressionar Run envia esse script para a câmera, que o executa e imprime a mensagem de volta na IDE.

2.1.1. O que o print faz

print() é uma função embutida – um trecho de código que reside dentro do firmware e está sempre disponível sem nenhuma configuração. Passe a ela um ou mais valores entre parênteses e ela imprime uma representação textual desses valores na IDE.

Você pode passar qualquer coisa para print(), não apenas texto:

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

Múltiplos argumentos são separados por espaços na saída:

>>> temperature 25

2.1.2. Comentários

Um # inicia um comentário – o restante da linha é ignorado pelo Python. Use comentários para explicar por que o código faz o que faz; o próprio código já mostra o que ele faz.

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

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

Não existe uma sintaxe separada para comentários de múltiplas linhas no Python. Comente várias linhas individualmente, ou selecione as linhas na IDE e pressione Ctrl+/ para ativá-las e desativá-las.

2.1.3. A indentação importa

O Python usa indentação – o espaço em branco no início de uma linha – para agrupar linhas relacionadas. Dentro de uma função, de uma instrução if ou de um laço, toda linha que pertence ao bloco é indentada na mesma quantidade (quatro espaços é a convenção). Misturar tabs e espaços ou alterar a largura da indentação dentro de um bloco é um erro de sintaxe.

Instruções de nível superior, como as chamadas print acima, ficam na indentação zero. Blocos indentados aparecem assim que você começa a escrever ramificações e laços.

Dica

A IDE indenta automaticamente para você assim que você termina uma linha que finaliza com :. Se você alguma vez se deparar com um misterioso IndentationError, selecione o bloco problemático e pressione Tab / Shift+Tab para realinhá-lo.

2.1.4. Executando o script novamente

Toda vez que você pressiona Run, a câmera interrompe o que estava fazendo, carrega o script atual e começa do início. Não há uma etapa de compilação separada. Altere uma linha, pressione Run novamente, e a nova saída aparece no terminal.

Para fazer um script ser executado automaticamente sempre que a câmera é ligada, salve-o como main.py no sistema de arquivos da câmera.