13.1.2. Scripts, exemplos e a pasta de documentos

13.1.2.1. Arquivos novos

Crie um arquivo novo e o IDE abre um buffer untitled_N.py pré-carregado com um laço mínimo de captura – reinicia o sensor, configura o formato de pixel e o tamanho do quadro, depois tira um snapshot e imprime a taxa de quadros indefinidamente. O script inicial é adaptado à placa conectada, então ele roda assim como foi criado. O buffer existe apenas na memória: você pode editá-lo e executá-lo repetidamente sem nunca salvá-lo, o que torna os arquivos novos a forma mais barata de testar uma ideia. Salve-o em disco e ele se torna um script comum.

13.1.2.2. O menu de exemplos

File → Examples contém uma biblioteca categorizada de scripts de exemplo cobrindo essencialmente cada recurso que a câmera possui – uma pasta por tópico, desde snapshots básicos até rastreamento de cor, aprendizado de máquina e periféricos da placa. Abrir um exemplo o carrega em um buffer de memória como um arquivo novo, então você pode modificá-lo e executá-lo livremente sem tocar na cópia instalada.

Por padrão, o menu é filtrado para a placa conectada e seu sensor: exemplos que precisam de hardware que sua câmera não tem ficam ocultos, e o menu pede uma conexão antes de exibir qualquer coisa. Tools → Filter examples by board and sensor type desliga o filtro quando você quer navegar pelo conjunto completo.

Os exemplos também são adaptados ao serem abertos. Os scripts são escritos para um sensor de cor típico, então quando a câmera conectada difere – um sensor térmico ou de eventos, uma placa com uma resolução nativa diferente – o IDE ajusta as linhas de formato de pixel e tamanho do quadro para valores que seu hardware suporta durante o carregamento, e o exemplo roda assim como foi aberto.

Percorrer o menu de exemplos é a forma mais rápida de aprender o que a câmera pode fazer; a maioria das aplicações começa como um exemplo que cresceu.

13.1.2.3. A pasta de documentos

Para os seus próprios scripts, o IDE observa um diretório OpenMV dentro da sua pasta de documentos (Documents/OpenMV). Tudo o que você armazena ali aparece em File → Documents Folder, incluindo subdiretórios, então sua coleção de scripts fica a um menu de distância. O menu lê o diretório ao vivo – arquivos que você adiciona fora do IDE aparecem na próxima vez que o menu for aberto.

O IDE roda como uma única instância: abra um arquivo .py a partir do seu gerenciador de arquivos, ou solte um sobre a janela do IDE, e ele abre na janela em execução em vez de iniciar uma segunda cópia.

13.1.2.4. Compilando um script de forma cruzada

Tools → MicroPython Tools → Copy/Convert Python File copia um arquivo .py para um destino – o drive da câmera, quando há uma conectada – e permite escolher o que acontece no caminho: copiá-lo sem alterações, remover espaços em branco e/ou comentários para reduzi-lo, ou compilá-lo para um arquivo de bytecode .mpy com o compilador mpy-cross compatível com a placa de destino. Um arquivo .mpy é importado exatamente como o .py do qual veio, carrega mais rápido e não distribui seu código-fonte – a forma a ser usada ao distribuir um módulo de biblioteca para o sistema de arquivos da câmera. Com uma câmera conectada, o IDE escolhe a placa de destino automaticamente; caso contrário, a caixa de diálogo pergunta para qual placa compilar. A escolha da placa importa porque ela define a arquitetura de processador que o compilador tem como alvo: um arquivo .mpy é compatível com a câmera em que será executado, e um compilado para uma família de placas diferente não tem garantia de carregamento.

Ver também

Ferramentas do MicroPython para mpy-cross e mpremote como ferramentas autônomas de linha de comando, e Arquivos .mpy do MicroPython para o próprio formato de arquivo .mpy.