13.1.2. Skript, exempel och dokumentmappen

13.1.2.1. Nya filer

Skapa en ny fil så öppnar IDE:n en untitled_N.py-buffert förladdad med en minimal infångningsloop – återställ sensorn, konfigurera pixelformatet och bildstorleken, ta sedan en stillbild och skriv ut bildfrekvensen i all oändlighet. Startskriptet anpassas till det anslutna kortet, så det körs direkt som det skapats. Bufferten finns endast i minnet: du kan redigera och köra den upprepade gånger utan att någonsin spara den, vilket gör nya filer till det billigaste sättet att testa en idé. Spara den till disk så blir den ett vanligt skript.

13.1.2.2. Exempelmenyn

File → Examples innehåller ett kategoriserat bibliotek av exempelskript som täcker i princip varje funktion kameran har – en mapp per ämne, från enkla stillbilder via färgspårning, maskininlärning och kortets kringutrustning. Att öppna ett exempel läser in det i en minnesbuffert som en ny fil, så du kan ändra och köra det fritt utan att röra den installerade kopian.

Som standard filtreras menyn till det anslutna kortet och dess sensor: exempel som behöver hårdvara som din kamera inte har döljs, och menyn ber om en anslutning innan den visar något alls. Tools → Filter examples by board and sensor type stänger av filtret när du vill bläddra igenom hela uppsättningen.

Exempel anpassas också när de öppnas. Skripten är skrivna mot en typisk färgsensor, så när den anslutna kameran skiljer sig – en värme- eller händelsesensor, ett kort med en annan inbyggd upplösning – justerar IDE:n raderna för pixelformat och bildstorlek till värden som din hårdvara stöder under inläsningen, och exemplet körs direkt som det öppnats.

Att arbeta sig igenom exempelmenyn är det snabbaste sättet att lära sig vad kameran kan göra; de flesta applikationer börjar som ett exempel som växte.

13.1.2.3. Dokumentmappen

För dina egna skript bevakar IDE:n en OpenMV-katalog inuti din dokumentmapp (Documents/OpenMV). Allt du lagrar där visas under File → Documents Folder, inklusive underkataloger, så din skriptsamling är bara en meny bort. Menyn läser katalogen i realtid – filer du lägger till utanför IDE:n dyker upp nästa gång menyn öppnas.

IDE:n körs som en enda instans: öppna en .py-fil från din filhanterare, eller släpp en på IDE-fönstret, så öppnas den i det körande fönstret i stället för att starta en andra kopia.

13.1.2.4. Korskompilera ett skript

Tools → MicroPython Tools → Copy/Convert Python File kopierar en .py-fil till en destination – kamerans enhet, när en sådan är ansluten – och låter dig välja vad som händer på vägen: kopiera den oförändrad, ta bort blanksteg och/eller kommentarer för att krympa den, eller kompilera den till en .mpy-bytekodfil med mpy-cross-kompilatorn som matchar målkortet. En .mpy-fil importeras precis som den .py den kom från, läses in snabbare och levererar inte sin källkod – den form du använder när du distribuerar en biblioteksmodul till kamerans filsystem. Med en kamera ansluten väljer IDE:n målkortet automatiskt; annars frågar dialogrutan vilket kort som ska kompileras för. Kortvalet spelar roll eftersom det avgör vilken processorarkitektur kompilatorn riktar in sig på: en .mpy-fil matchas mot kameran den ska köras på, och en som kompilerats för en annan kortfamilj är inte garanterad att läsas in.

Se även

MicroPython-verktyg för mpy-cross och mpremote som fristående kommandoradsverktyg, och MicroPython .mpy-filer för själva .mpy-filformatet.