v4.5.5

La v4.5.5 è una piccola release di manutenzione incentrata sulla coerenza della cache dei buffer immagine, sull’affidabilità del reset del sensore e sul riordino dell’API di morfologia.

In evidenza

  • Acquisizione più affidabile — i buffer video ora vengono invalidati nella cache prima dell’uso, e il ritardo di reset/spegnimento del sensore è stato aumentato.

  • Modifica incompatibile: il ksize di morph() è ora posizionale e i metodi di pooling obsoleti sono stati rimossi (vedi le modifiche incompatibili).

Altre modifiche e miglioramenti

  • Aumentato il ritardo dopo il reset/spegnimento del sensore per un avvio della camera più affidabile (il Portenta H7 sovrascrive questi ritardi per il suo sensore).

Correzioni di bug

  • Corretto il controllo della maschera di erode().

  • I buffer video ora vengono invalidati nella cache prima di essere restituiti, prevenendo dati immagine obsoleti/corrotti.

  • i.MX RT: un trasferimento dalla camera viene ritentato se il DMA è ancora occupato; STM32: lo stato del buffer video viene azzerato quando i frame vengono persi.

Modifiche incompatibili dell’API

Interruzioni dell’API visibili all’utente tra la v4.5.4 e la v4.5.5.

Ogni modifica è contrassegnata con il suo impatto:

  • minore — API ristretta; interessa solo gli script che la usavano.

  • comportamento — stessa API, risultati diversi; ricontrolla gli script ottimizzati.

Le modifiche sono raggruppate per impatto in quest’ordine. Ogni hash di commit rimanda al suo diff su GitHub.

ksize di morph() posizionale; pooling rimosso (minore)

L’argomento della dimensione del kernel ksize di morph() è ora un argomento posizionale. La famiglia di metodi di pooling Image.pool() obsoleta è stata rimossa.

Commit: f92896589, 08ca21fd1

Analisi degli argomenti della conversione di immagini standardizzata (comportamento)

I metodi di conversione di immagini (Image.to_*() / to()) sono stati spostati sul parser di argomenti standardizzato mp_arg_parse_all. Le chiamate che facevano affidamento sul vecchio ordinamento posizionale/per parola chiave potrebbero richiedere aggiustamenti.

Commit: 3fee02ffb

Checklist di migrazione

Per un porting pulito alla v4.5.5: passa il ksize di morph() posizionalmente, elimina qualsiasi uso dei metodi di pooling rimossi (la modifica della morfologia), e ricontrolla l’ordine degli argomenti nelle chiamate di conversione di immagini (la modifica dell’analisi della conversione).