硬體掃描控制模組 (Scanner Controller) 深度分析

在 CB_IMGPSScanImp.pas 中，「硬體掃描控制模組」是系統與實體掃描設備溝通的唯一橋樑。它深度依賴 TWAIN 協定（透過第三方元件 EnScan 封裝），負責控制硬體行為並將紙本文件轉換為記憶體中的數位影像資料。

若要將此模組進一步細拆，其內部組成可分為以下三大子分類：

1. TWAIN 介面封裝與控制 (TWAIN Interface Wrapper)

職責：負責管理實體掃描機的連線狀態、開啟/關閉資料來源 (Data Source)，以及觸發掃描動作。
核心實作特性：
* 掃描機選擇與初始化：
* SelectScanner (scanner.SelectScanner)：呼叫 TWAIN 介面讓使用者選擇預設的掃描機硬體。
* initkscan / CheckScannerConfig：在系統啟動時檢查掃描機是否已正確配置並支援特定功能（例如檢查 Scanner.DuplexCap > 0 確認是否支援雙面掃描）。
* 掃描生命週期管理 (StatrTwainScan)：
* 負責設定 Scanner.OpenSource（開啟驅動）。
* 呼叫 Scanner.AcquireWithSourceOpen 開始非同步擷取，並傳入回呼函式 (Callback) 的指標與自訂的狀態結構 (LongInt(@ScanInfo))。
* 確保無論掃描成功、失敗或中斷，最終都會安全地執行 Scanner.CloseSource。

2. 掃描參數與設定管理器 (Scanner Profile Manager)

職責：負責載入、維護及套用掃描時所需的各項硬體與前處理參數。這些參數通常從資料庫 (WORK_INF) 或是本機的 FBScan.ini 中讀取。
核心實作特性：
* 硬體基本參數 (Hardware Params)：
* ScanDpi：解析度設定，對應 RequestedXDpi 與 RequestedYDpi。
* ScanColor (TImageFormat)：影像色彩模式（黑白 ifBlackWhite、灰階 ifGray256、彩色 ifTrueColor）。
* ScanDuplex：控制硬體是否開啟雙面進紙 (Scanner.Duplex)。
* TwainShowUI：是否顯示掃描機原廠的 TWAIN 設定畫面 (Scanner.ShowUI)。
* 硬體增強參數 (Enhancement Params)：
* ScanBright (亮度) 與 ScanContrast (對比度)：當啟用 ScanImgSetUse 時，將這些參數直接送入掃描硬體。
* 前置處理規則 (Pre-processing Rules)：
* DeviceDelete 與 DeviceDeleteSize：定義是否開啟「空白頁自動刪除」以及刪除的位元組閥值。
* ScannerReverse (反相)、ScanDeskew (硬體/初階去斜)、BoardClear (清除黑邊)。

3. 非同步影像接收與初始轉換器 (Acquisition Event Handler)

職責：做為掃描機與應用程式記憶體的交界點，負責攔截驅動程式傳回的原始記憶體區塊 (DibHandle)，並進行最基礎的安全轉換與前置判斷。
核心實作特性 (OnAcquire 回呼事件)：
* 記憶體接管 (Memory Handover)：
* 接收來自 TWAIN 驅動的 DibHandle（Device Independent Bitmap 記憶體指標）。
* 利用 pScanInfo^.Graphic.AssignFromDibHandle(DibHandle) 將非管理的記憶體轉換為 Delphi VCL 的 TTiffGraphic 物件。
* 早階條碼快篩與方向校正 (Early Barcode Detection & Rotation)：
* 為確保後續處理正確，系統會在剛拿到記憶體影像時，立刻進行一次快速的條碼掃描 (MpsGetBarcode)。
* 讀取條碼所帶的方向資訊 (MpsBarcodeinf.r180)，並在記憶體中立刻進行 Rotate 旋轉，將顛倒或橫放的文件轉正。
* 基礎裁切與壓縮決策 (Format & Crop Decision)：
* A3 裁 A4：呼叫 CheckNeedCrop 判斷長寬比例與特定條碼數量，若確認為 A3 合併頁，則立刻在記憶體中將其拆分為 iGraphic_First 與 iGraphic_Sec 兩張獨立影像。
* 格式與壓縮決策：針對色彩屬性 (ifBlackWhite, ifTrueColor, ifGray256)，決定應該套用哪種壓縮演算法（如黑白套用 tcGroup4 或 tcPackBits，彩色則轉換為 tcJpeg 並套用指定的 FJpgCompression 壓縮率）。

💡 未來重構與微服務化建議

若要將此「硬體掃描控制模組」進行現代化升級或跨平台轉型，建議考量以下方向：

與 UI 徹底解耦：
目前的 OnAcquire 回呼函式中混雜了大量 UI 操作（如 ImageScrollBox1.Graphic.Assign(...)）。應改用「發佈-訂閱模式 (Pub-Sub)」，讓 Scanner Controller 收到影像後只觸發事件，由外部的 UI 層去訂閱並更新畫面。
Web/雲端化架構 (Web TWAIN / WebSockets)：
若未來系統要走向純 Web 化（捨棄 ActiveX），由於瀏覽器無法直接呼叫 Windows 底層的 TWAIN API，此模組必須被改寫為一隻安裝於 Client 端的 背景常駐服務 (Local Windows Service / Daemon)。
該服務可以透過 WebSocket 或 Local REST API 接收來自網頁端的掃描指令，控制 TWAIN 掃描機，並將接收到的影像轉為 Base64 或二進位流回傳給網頁前端。
單一職責分離 (Separation of Concerns)：
應將 OnAcquire 中厚重的「條碼辨識」、「A3 裁切」與「黑邊處理」移出此模組。Scanner Controller 的唯一職責應該只有：**「將紙本轉為電腦中的 Bitmap」**。後續的處理應交給 Image Processor (影像處理模組) 透過管線 (Pipeline) 的方式接手處理。