v1.2.0

v1.2.0 je základní, velmi rozsáhlé vydání, které buduje většinu klasického zobrazovacího API OpenMV: metody pro kreslení, binární / morfologické operace, deskriptory klíčových bodů (FAST / FREAK / LBP), barevné konverze a image.statistics, vstup/výstup souborů BMP / PPM / JPEG, moduly lcd, mjpeg, gif a termální modul mlx, kameru OV7725 a mnoho ovládacích prvků sensor. Některé základní chování sensor se změnilo — přečtěte si níže uvedené zásadní změny.

Hlavní novinky

  • Kreslicí API — draw_line() / draw_rectangle() / draw_circle() / draw_string() / draw_cross() / draw_keypoints().

  • Binární / morfologie — binary(), invert(), and/or/xor/..., erode() / dilate() / morph(), negate() / difference().

  • Klíčové body — deskriptory FAST / FREAK / LBP s match_descriptor() / save_descriptor() / load_descriptor().

  • Nové moduly — lcd, mjpeg, gif (barevný) a termální mlx.

  • Podpora kamery OV7725; image.statistics; vstup/výstup souborů BMP/PPM/JPEG.

  • Zásadní: chování sensor.reset(), sensor.snapshot() a sensor.set_pixformat() se změnilo — viz zásadní změny.

Nové funkce

  • Kreslení — přidány image.draw_line() / draw_rectangle() / draw_circle() / draw_string() / draw_cross() / draw_keypoints() s pojmenovanými argumenty (barva, tloušťka, …).

  • Binární / morfologie — přidány image.binary(), invert(), and() / nand() / or() / nor() / xor() / xnor(), erode() / dilate() / morph(), negate() / difference(), pixels(), centroid(), orientation_radians() / orientation_degrees() a width() / height() / format().

  • Klíčové body / deskriptory — extrakce klíčových bodů FAST přes find_keypoints(), jednotné match_descriptor() a save_descriptor() / load_descriptor() pro FREAK / LBP a navíc Haar/LBP kaskáda pro profil obličeje.

  • Barva / statistiky — image.statistics a funkce pro barevné konverze (rgb_to_lab / lab_to_rgb / rgb_to_grayscale / grayscale_to_rgb).

  • Vstup/výstup souborů — načítání a ukládání BMP / PPM (P2/P3/P5/P6) / JPEG (včetně JPEG ve stupních šedi a podvzorkování barevnosti 4:2:0 / 4:2:2).

  • Moduly — nový lcd (LCD shield), mjpeg (nahrávání videa), barevný gif (s Gif.loop()) a termální moduly kamery mlx, každý s ukázkovými skripty.

  • Senzor — přidány sensor.get_id() (+ PID konstanty OV9650/OV2640/OV7725), sensor.set_special_effect() (konstanty SDE_*), sensor.set_image_filter() (FILTER_BW / FILTER_SKIN), velikost snímku HQVGA a image.set_pixel(x, y, …).

  • WiFi — přidán ovladač WiFi ATWINC1500 a základy BSP pro OpenMV 1/2, plus příklad BLE.

Další změny a vylepšení

  • Snímkový buffer (frame buffer) je nyní před streamováním do OpenMV IDE komprimován do JPEG (nižší šířka pásma); komprese JPEG probíhá na místě; H/V zoom OV7725 umožňuje libovolné škálování; vylepšená (rychlejší) detekce obličejů pomocí Haar, která běží na QVGA.

Opravy chyb

Zpracování obrazu:

  • Opraven výpočet integrálního obrazu, poškození filtru median(), výpočet těžiště, RGB filtry pleti / černobílé na RGB vstupu a rychlejší čtení/zápis BMP/PPM ve stupních šedi.

Senzor a systém:

  • Opraveny časovače pyb.Servo (Servo nyní funguje), rozlišení HQVGA, spolehlivost inicializace SD karty, opětovná inicializace úložiště po softwarovém resetu a opětovné spuštění REPL, pokud není přítomen žádný skript.

Hardware a podpora desek

  • Obrazový senzor OV7725.

  • LCD shield (modul lcd), termální kamera mlx a základy WiFi ATWINC1500.

Zásadní změny API

Pro uživatele viditelné změny API mezi v1.1.0 a v1.2.0. Rozsah: C-moduly Pythonu v modules/ a knihovny Pythonu v scripts/libraries/.

Všechny tři zásadní změny jsou změny chování základních funkcí sensor (stejné API, jiné chování) — znovu zkontrolujte dotčené skripty. Každý hash commitu odkazuje na svůj diff na GitHubu. (Naprostá většina tohoto vydání je nové API vybudované v rozsahu v1.1→v1.2, a je tedy přídavná, nikoli zásadní.)

sensor.reset() již neaplikuje výchozí konfiguraci (chování)

sensor.reset() již neaplikuje vestavěnou výchozí konfiguraci (pixformat / framesize / framerate / gain / contrast / brightness / saturation). Skripty, které se spoléhaly na to, že reset() zanechá použitelnou výchozí konfiguraci, musí nyní po reset() explicitně volat sensor.set_pixformat() a sensor.set_framesize() (a jakákoli další nastavení).

Commity: d1e782df3

sensor.snapshot() vyvolá výjimku při vypršení časového limitu (chování)

sensor.snapshot() nyní vyvolá RuntimeError("Sensor Timeout!!"), když senzoru vyprší časový limit, místo nekonečného zaseknutí. Pokud potřebujete tolerovat časové limity, obalte snapshot() do try / except RuntimeError.

Commity: e3f41d674

sensor.set_pixformat() vyvolá výjimku při nepodporovaném formátu (chování)

sensor.set_pixformat() nyní vyvolá výjimku, je-li jí předán nepodporovaný pixelový formát, místo vrácení False. Kód, který kontroloval návratovou hodnotu False, musí místo toho zachytit výjimku.

Commity: e0c5822c2

Kontrolní seznam pro migraci

Pro čistý přechod na v1.2.0 obvykle platí toto:

  1. Po sensor.reset() explicitně nastavte sensor.set_pixformat() / sensor.set_framesize() (změna resetu).

  2. Pokud potřebujete tolerovat časové limity senzoru, obalte sensor.snapshot() do try / except RuntimeError (změna snapshotu).

  3. Zachyťte výjimku z sensor.set_pixformat() místo kontroly na False (změna set_pixformat).

Všechny ostatní skripty běží beze změny.