RenderPageToMonochromeFileEx
描繪與列印、影像處理、最佳化
描述
把頁面描繪成 1 位元 BMP 檔案，可選擇閾值轉換與孤立黑點清理
掃描或描繪內容需要確定性的單色前置處理、之後要走 CCITT 或 JBIG2 流程時，先使用此函式
語法
Delphi
Function TPDFlib.RenderPageToMonochromeFileEx(DPI: Double; Page: Integer; Const FileName: WideString; Threshold, Despeckle: Integer): Integer;參數
| DPI | The render resolution |
|---|---|
| Page | 要描繪的頁碼（1 起算） |
| FileName | The destination BMP file |
| Threshold | Despeckle 也為 0 時，0 保留舊式 GDI 半色調路徑；否則 1 到 255 選擇判定黑點的灰階 cutoff |
| Despeckle | 0 停用清理；1 到 8 會移除周圍 3x3 區域內相鄰黑點數少於該值的黑點 |
傳回值
| 0 | 無法描繪頁面、選項超出範圍，或無法寫出輸出檔案 |
|---|---|
| 1 | 1 位元 BMP 檔案已寫出 |
備註
RenderPageToMonochromeFile 以 Threshold 與 Despeckle 為 0 呼叫本函式，保留先前 GDI 半色調的行為
以 Threshold 為 0 要求清理時，函式在執行清理程序前會改用 128 的閾值