13.1.2. Scripts, ejemplos y la carpeta de documentos

13.1.2.1. Archivos nuevos

Crea un archivo nuevo y el IDE abre un búfer untitled_N.py precargado con un bucle de captura mínimo: reinicia el sensor, configura el formato de píxel y el tamaño de fotograma, y luego toma una captura e imprime la velocidad de fotogramas indefinidamente. El script inicial se adapta a la placa conectada, así que se ejecuta tal cual se crea. El búfer reside solo en memoria: puedes editarlo y ejecutarlo repetidamente sin llegar a guardarlo nunca, lo que hace de los archivos nuevos la forma más económica de probar una idea. Guárdalo en disco y se convierte en un script corriente.

13.1.2.2. El menú de ejemplos

File → Examples contiene una biblioteca categorizada de scripts de ejemplo que cubre prácticamente todas las funciones que tiene la cámara –una carpeta por tema, desde capturas básicas hasta seguimiento de color, aprendizaje automático y periféricos de la placa. Abrir un ejemplo lo carga en un búfer de memoria como un archivo nuevo, de modo que puedes modificarlo y ejecutarlo libremente sin tocar la copia instalada.

Por defecto el menú se filtra según la placa conectada y su sensor: los ejemplos que necesitan hardware que tu cámara no tiene quedan ocultos, y el menú pide una conexión antes de mostrar nada en absoluto. Tools → Filter examples by board and sensor type desactiva el filtro cuando quieres explorar el conjunto completo.

Los ejemplos también se adaptan al abrirse. Los scripts están escritos para un sensor de color típico, así que cuando la cámara conectada difiere –un sensor térmico o de eventos, una placa con una resolución nativa distinta– el IDE ajusta las líneas de formato de píxel y tamaño de fotograma a valores que tu hardware admite mientras carga, y el ejemplo se ejecuta tal cual se abre.

Recorrer el menú de ejemplos es la forma más rápida de aprender lo que la cámara puede hacer; la mayoría de las aplicaciones empiezan como un ejemplo que fue creciendo.

13.1.2.3. La carpeta de documentos

Para tus propios scripts, el IDE vigila un directorio OpenMV dentro de tu carpeta de documentos (Documents/OpenMV). Todo lo que almacenes ahí aparece bajo File → Documents Folder, incluidos los subdirectorios, de modo que tu colección de scripts queda a un menú de distancia. El menú lee el directorio en vivo –los archivos que añadas fuera del IDE aparecen la próxima vez que se abre el menú.

El IDE se ejecuta como una única instancia: abre un archivo .py desde tu gestor de archivos, o arrástralo a la ventana del IDE, y se abrirá en la ventana en ejecución en lugar de lanzar una segunda copia.

13.1.2.4. Compilación cruzada de un script

Tools → MicroPython Tools → Copy/Convert Python File copia un archivo .py a un destino –la unidad de la cámara, cuando hay una conectada– y te deja elegir qué ocurre por el camino: copiarlo sin cambios, eliminar espacios en blanco y/o comentarios para reducirlo, o compilarlo a un archivo de código de bytes .mpy con el compilador mpy-cross correspondiente a la placa de destino. Un archivo .mpy se importa exactamente igual que el .py del que procede, carga más rápido y no incluye su código fuente –la forma adecuada al distribuir un módulo de biblioteca al sistema de archivos de la cámara. Con una cámara conectada, el IDE elige la placa de destino automáticamente; en caso contrario, el cuadro de diálogo pregunta para qué placa compilar. La elección de placa importa porque establece la arquitectura del procesador a la que apunta el compilador: un archivo .mpy se ajusta a la cámara en la que se ejecutará, y uno compilado para una familia de placas distinta no tiene garantizada la carga.

Ver también

Herramientas de MicroPython para mpy-cross y mpremote como herramientas autónomas de línea de comandos, y Archivos .mpy de MicroPython para el propio formato de archivo .mpy.