v4.5.5

v4.5.5 是一個小型維護版本,著重於影像緩衝區快取一致性、感測器重置可靠性,以及形態學 API 的整理。

重點摘要

  • 更可靠的擷取——視訊緩衝區現在會在使用前進行快取失效處理,且感測器重置/斷電延遲時間已增加。

  • 破壞性: morph()ksize 現在為位置式引數,且已移除過時的池化方法(請參閱破壞性變更)。

其他變更與改進

  • 增加感測器重置/斷電後的延遲時間,以提供更可靠的相機啟動(Portenta H7 會針對其感測器覆寫這些延遲)。

錯誤修正

  • 修正 erode() 的遮罩檢查。

  • 視訊緩衝區現在會在回傳前進行快取失效處理,以防止過時/損壞的影像資料。

  • i.MX RT:若 DMA 仍忙碌中,相機傳輸會重試;STM32:丟棄影格時會重置視訊緩衝區狀態。

破壞性 API 變更

v4.5.4 與 v4.5.5 之間使用者可見的 API 破壞性變更。

每項變更都標註了其影響:

  • minor——範圍狹窄的 API;僅影響使用到它的指令碼。

  • behavior——相同的 API,但結果不同;請重新檢查已調校的指令碼。

變更依影響程度依此順序分組。每個 commit 雜湊值都連結至其在 GitHub 上的 diff。

morph()ksize 改為位置式;移除池化 (minor)

morph() 的核心大小 ksize 引數現在為位置式引數。已移除過時的 Image.pool() 系列池化方法。

Commits: f9289658908ca21fd1

影像轉換引數解析已標準化 (behavior)

影像轉換方法(Image.to_*() / to())已移至標準化的 mp_arg_parse_all 引數解析器。依賴舊有位置式/關鍵字順序的呼叫可能需要調整。

Commit: 3fee02ffb

移植檢查清單

若要乾淨地移植至 v4.5.5:將 morph()ksize 以位置式傳遞、捨棄任何對已移除池化方法的使用(形態學變更),並重新檢查影像轉換呼叫中的引數順序(轉換解析變更)。