13.1.2. Skrip, contoh, dan folder dokumen

13.1.2.1. File baru

Buat file baru dan IDE akan membuka buffer untitled_N.py yang sudah terisi dengan loop penangkapan minimal -- reset sensor, konfigurasikan format piksel dan ukuran bingkai, lalu ambil snapshot dan cetak laju bingkai selamanya. Skrip awal disesuaikan dengan papan yang terhubung, sehingga langsung bisa dijalankan. Buffer tersebut hanya ada di memori: Anda bisa mengedit dan menjalankannya berulang kali tanpa pernah menyimpannya, yang menjadikan file baru sebagai cara paling mudah untuk menguji suatu ide. Simpan ke disk dan file itu menjadi skrip biasa.

13.1.2.2. Menu contoh

File → Examples berisi pustaka contoh skrip yang terkelompok berdasarkan kategori, mencakup hampir setiap fitur yang dimiliki kamera -- satu folder per topik, mulai dari snapshot dasar hingga pelacakan warna, machine learning, dan periferal papan. Membuka sebuah contoh memuatnya ke dalam buffer memori seperti file baru, sehingga Anda bisa memodifikasi dan menjalankannya dengan bebas tanpa menyentuh salinan yang terinstal.

Secara default, menu difilter berdasarkan papan yang terhubung dan sensornya: contoh yang memerlukan perangkat keras yang tidak dimiliki kamera Anda disembunyikan, dan menu meminta koneksi sebelum menampilkan apa pun. Tools → Filter examples by board and sensor type menonaktifkan filter saat Anda ingin menjelajahi set lengkapnya.

Contoh-contoh juga disesuaikan saat dibuka. Skrip ditulis untuk sensor warna tipikal, sehingga ketika kamera yang terhubung berbeda -- sensor termal atau event, papan dengan resolusi bawaan berbeda -- IDE menyesuaikan baris format piksel dan ukuran bingkai ke nilai yang didukung perangkat keras Anda saat memuat, dan contoh tersebut langsung bisa dijalankan.

Menjelajahi menu contoh adalah cara tercepat untuk mempelajari apa yang bisa dilakukan kamera; sebagian besar aplikasi dimulai dari sebuah contoh yang berkembang.

13.1.2.3. Folder dokumen

Untuk skrip Anda sendiri, IDE memantau direktori OpenMV di dalam folder dokumen Anda (Documents/OpenMV). Semua yang Anda simpan di sana muncul di bawah File → Documents Folder, termasuk subdirektori, sehingga koleksi skrip Anda hanya satu menu jauhnya. Menu membaca direktori secara langsung -- file yang Anda tambahkan di luar IDE akan muncul saat berikutnya menu dibuka.

IDE berjalan sebagai satu instance: buka file .py dari pengelola file Anda, atau seret satu ke jendela IDE, dan file itu akan terbuka di jendela yang sedang berjalan, bukan membuka salinan kedua.

13.1.2.4. Mengkompilasi silang sebuah skrip

Tools → MicroPython Tools → Copy/Convert Python File menyalin file .py ke tujuan -- drive kamera, bila ada yang terhubung -- dan memungkinkan Anda memilih apa yang terjadi dalam prosesnya: salin tanpa perubahan, hapus spasi kosong dan/atau komentar untuk mengecilkannya, atau kompilasi ke file bytecode .mpy dengan kompiler mpy-cross yang disesuaikan dengan papan target. File .mpy diimpor persis seperti .py asalnya, dimuat lebih cepat, dan tidak menyertakan kode sumbernya -- bentuk yang digunakan saat mendistribusikan modul library ke sistem file kamera. Dengan kamera yang terhubung, IDE memilih papan target secara otomatis; jika tidak, dialog akan menanyakan papan mana yang akan dikompilasi. Pilihan papan penting karena menentukan arsitektur prosesor yang menjadi target kompiler: file .mpy disesuaikan dengan kamera tempat ia akan berjalan, dan yang dikompilasi untuk keluarga papan berbeda tidak dijamin dapat dimuat.

Lihat juga

Alat MicroPython untuk mpy-cross dan mpremote sebagai alat baris perintah mandiri, dan File .mpy MicroPython untuk format file .mpy itu sendiri.