13.1.2. Skriptit, esimerkit ja dokumenttikansio

13.1.2.1. Uudet tiedostot

Luo uusi tiedosto, ja IDE avaa untitled_N.py-puskurin, johon on valmiiksi ladattu minimaalinen kaappaussilmukka – nollaa sensori, määritä pikseliformaatti ja kehyskoko, ota sitten tilannekuva ja tulosta kehystaajuus loputtomasti. Aloitusskripti on mukautettu yhdistettyyn korttiin, joten se toimii sellaisenaan. Puskuri on vain muistissa: voit muokata ja suorittaa sitä toistuvasti koskaan tallentamatta sitä, mikä tekee uusista tiedostoista edullisimman tavan kokeilla ideaa. Tallenna se levylle, niin siitä tulee tavallinen skripti.

13.1.2.2. Esimerkkivalikko

File → Examples sisältää luokitellun kirjaston esimerkkiskriptejä, jotka kattavat käytännössä jokaisen kameran ominaisuuden – yksi kansio aihetta kohti, peruskuvien tilannekuvista värien seurantaan, koneoppimiseen ja kortin oheislaitteisiin. Esimerkin avaaminen lataa sen muistipuskuriin uuden tiedoston tapaan, joten voit muokata ja suorittaa sitä vapaasti koskematta asennettuun kopioon.

Oletuksena valikko on suodatettu yhdistettyyn korttiin ja sen sensoriin: esimerkit, jotka vaativat laitteistoa jota kamerassasi ei ole, on piilotettu, ja valikko pyytää yhteyttä ennen kuin se näyttää mitään. Tools → Filter examples by board and sensor type poistaa suodattimen käytöstä, kun haluat selata koko valikoimaa.

Esimerkit myös mukautetaan niitä avattaessa. Skriptit on kirjoitettu tyypilliselle värisensorille, joten kun yhdistetty kamera poikkeaa – lämpö- tai tapahtumasensori, kortti jolla on eri natiiviresoluutio – IDE säätää pikseliformaatti- ja kehyskokorivit latauksen aikana laitteistosi tukemiin arvoihin, ja esimerkki toimii sellaisena kuin se avataan.

Esimerkkivalikon läpikäynti on nopein tapa oppia, mitä kamera osaa tehdä; useimmat sovellukset alkavat esimerkistä, joka kasvoi.

13.1.2.3. Dokumenttikansio

Omille skripteillesi IDE tarkkailee dokumenttikansiosi sisällä olevaa OpenMV-hakemistoa (Documents/OpenMV). Kaikki sinne tallentamasi näkyy kohdassa File → Documents Folder, alihakemistot mukaan lukien, joten skriptikokoelmasi on yhden valikon päässä. Valikko lukee hakemiston reaaliaikaisesti – IDE:n ulkopuolella lisäämäsi tiedostot näkyvät seuraavan kerran kun valikko avataan.

IDE toimii yhtenä instanssina: avaa .py-tiedosto tiedostonhallinnastasi tai pudota se IDE-ikkunaan, ja se avautuu käynnissä olevassa ikkunassa eikä käynnistä toista kopiota.

13.1.2.4. Skriptin ristikääntäminen

Tools → MicroPython Tools → Copy/Convert Python File kopioi .py-tiedoston kohteeseen – kameran asemalle, kun sellainen on yhdistetty – ja antaa sinun valita mitä matkalla tapahtuu: kopioi se muuttumattomana, poista tyhjätila ja/tai kommentit sen pienentämiseksi, tai käännä se .mpy-tavukooditiedostoksi kohdekorttiin sovitetulla mpy-cross-kääntäjällä. .mpy-tiedosto tuodaan täsmälleen kuin .py-tiedosto, josta se on peräisin, latautuu nopeammin eikä toimita lähdekoodiaan – käytettävä muoto kirjastomoduulia kameran tiedostojärjestelmään jaettaessa. Kun kamera on yhdistetty, IDE valitsee kohdekortin automaattisesti; muuten dialogi kysyy, mille kortille kääntää. Korttivalinta on tärkeä, koska se määrittää suoritinarkkitehtuurin, jolle kääntäjä kohdistaa: .mpy-tiedosto on sovitettu kameraan, jolla se suoritetaan, eikä eri korttiperheelle käännetyn taata latautuvan.

Katso myös

MicroPython-työkalut käsittelee mpy-cross- ja mpremote-työkaluja itsenäisinä komentorivityökaluina, ja MicroPython .mpy -tiedostot käsittelee itse .mpy-tiedostomuotoa.