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
ksizedimorph()è 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.
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).