2.1. O seu primeiro script

Um script Python é uma sequência de instruções guardadas num ficheiro de texto com extensão .py. A OpenMV Cam executa o script que estiver aberto no IDE quando prime o botão verde Run, e apresenta qualquer saída no terminal série do IDE na parte inferior da janela.

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

print("Hello, OpenMV!")

Premir Run envia este script para a câmara, que o executa e imprime a mensagem de volta no IDE.

2.1.1. O que faz o print

print() é uma função incorporada – um fragmento de código que reside dentro do firmware e está sempre disponível sem qualquer configuração prévia. Passe-lhe um ou mais valores entre parênteses e ela imprime uma representação textual desses valores no IDE.

Pode passar print() qualquer coisa, 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 resto da linha é ignorado pelo Python. Use comentários para explicar porquê o código faz o que faz; o próprio código já mostra o que 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 multilinha em Python. Comente várias linhas individualmente, ou selecione as linhas no IDE e prima Ctrl+/ para as ativar e desativar.

2.1.3. A indentação é importante

O Python utiliza a 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 ciclo, cada linha que pertence ao bloco é indentada pela mesma quantidade (quatro espaços é a convenção). Misturar tabulações e espaços ou alterar a largura de indentação dentro de um bloco é um erro de sintaxe.

Instruções de nível superior como as chamadas a print acima ficam com indentação zero. Os blocos indentados aparecem assim que começa a escrever ramificações e ciclos.

Dica

O IDE auto-indenta assim que termina uma linha a acabar em :. Se alguma vez obtiver um misterioso IndentationError, selecione o bloco problemático e prima Tab / Shift+Tab para o realinhar.

2.1.4. Executar o script novamente

Cada vez que prime Run, a câmara para o que estava a fazer, carrega o script atual e começa do início. Não existe uma etapa de compilação separada. Altere uma linha, prima Run novamente e a nova saída aparece no terminal.

Para que um script seja executado automaticamente cada vez que a câmara liga, guarde-o como main.py no sistema de ficheiros da câmara.