如何從 C# 中的 System.Drawing 對象讀取
IronOCR 能夠通過將 System.Drawing 對象如 Bitmap 和 Image 包裝在 OcrImageInput 中,從而提供平穩的 OCR 功能以支援 Windows、macOS 和 Linux 平台的 .NET 應用程序。
System.Drawing.Bitmap 是 .NET Framework 中的一個類,用於處理位圖圖像。 它提供了建立、操作和顯示點陣圖影像的方法和屬性。
System.Drawing.Image 是 .NET Framework 中所有 GDI+ 圖像對象的基類。 這是各種圖像類型(包括 System.Drawing.Bitmap)的父類。
IronSoftware.Drawing.AnyBitmap 是 IronDrawing 中的位圖類,這是一個由 Iron Software 最初開發的開源程式庫。 這有助於 C# 軟體工程師在 Windows、macOS 和 Linux 平台上的 .NET 專案中替換 System.Drawing.Common。
通過一條語句創建 IronTesseract 並將其包裝在 OcrImageInput 的 System.Drawing.Bitmap 提供,從而提取所有文本。 此快速入門範例展示 IronOCR 如何以最少的設定將影像轉換成可讀的文字。
-
1使用 IronOCR 安裝 NuGet Package Manager
-
2複製並運行這段程式碼。
var result = new IronOcr.IronTesseract().Read(new IronOcr.OcrImageInput(new System.Drawing.Bitmap("image.png")));Dim result = New IronOcr.IronTesseract().Read(New IronOcr.OcrImageInput(New System.Drawing.Bitmap("image.png")))Dim result = New IronOcr.IronTesseract().Read(New IronOcr.OcrImageInput(New System.Drawing.Bitmap("image.png"))) -
3部署到您的生產環境進行測試
立即在您的項目中開始使用 IronOCR,並使用 免費試用
如何在 C# 中讀取 System.Drawing 對象
- 下載用於讀取 System.Drawing 對象的 C# 程式庫
- 獲取 System.Drawing 對象,如
Bitmap和Image - 使用取得的資料建構
OcrImageInput類別 - 在 Linux 和 macOS 上利用 Iron Software 的
AnyBitmap - 通過指定裁剪區域定義讀取區域
如何從 System.Drawing.Bitmap 中讀取?
首先,實例化 IronTesseract 類以執行 OCR。 從各種方法中創建 System.Drawing.Bitmap。 在程式碼範例中,使用了檔案路徑。
接下來,使用 using 語句創建 OcrImageInput 對象,將圖像從 System.Drawing.Bitmap 對象中傳遞給它。 最後,使用 Read 方法執行 OCR。
using IronOcr;
using System.Drawing;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Read image file to Bitmap
Bitmap bitmap = new Bitmap("Potter.tiff");
// Import System.Drawing.Bitmap
using var imageInput = new OcrImageInput(bitmap);
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);using IronOcr;
using System.Drawing;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Read image file to Bitmap
Bitmap bitmap = new Bitmap("Potter.tiff");
// Import System.Drawing.Bitmap
using var imageInput = new OcrImageInput(bitmap);
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);Imports IronOcr
Imports System.Drawing
' Instantiate IronTesseract
Private ocrTesseract As New IronTesseract()
' Read image file to Bitmap
Private bitmap As New Bitmap("Potter.tiff")
' Import System.Drawing.Bitmap
Private imageInput = New OcrImageInput(bitmap)
' Perform OCR
Private ocrResult As OcrResult = ocrTesseract.Read(imageInput)Imports IronOcr
Imports System.Drawing
' Instantiate IronTesseract
Private ocrTesseract As New IronTesseract()
' Read image file to Bitmap
Private bitmap As New Bitmap("Potter.tiff")
' Import System.Drawing.Bitmap
Private imageInput = New OcrImageInput(bitmap)
' Perform OCR
Private ocrResult As OcrResult = ocrTesseract.Read(imageInput)為什麼使用語句對 OcrImageInput 重要?
在使用 OcrImageInput 時,using 語句非常重要,因為它確保正確的資源管理和記憶體清理。OcrImageInput 實現了 IDisposable,這意味著它持有需要釋放的未管理資源,當您完成對象時。 沒有 using 語句,這些資源可能不會及時釋放,可能導致記憶體洩漏或文件鎖定。 在批次作業中處理多個影像時,這一點尤其重要。 如需獲取更多有關在 IronOCR 中進行適當資源管理的詳細資訊,請參見我們的 API 參考 文檔。
常見的位圖加載方法有哪些?
Bitmap 提供了多種加載方法,超出我們示例中使用的文件路徑構造函數。 您可以從流 (StreamReader)、現有的 Image (Image) 創建 Bitmap,甚至創建具有特定尺寸的空白位圖 (Bitmap)。 在使用 Web 應用程式時,從串流載入對於處理上傳的檔案特別有用。 對於嵌入式資源,您可以使用 Resources。 IronOCR 通過 Bitmap 構造函數處理所有這些 source 資源。 在我們的 圖像 (jpg, png, gif, tiff, bmp) 指南中了解更多有關不同輸入方法的信息。
什麼時候應該處理位圖對象?
位圖處理的時間取決於您應用程式的工作流程。 如果您只需要 bitmap 進行 OCR,請在創建 ocrResult 後立即處理它。 但是,如果需要執行多個作業或顯示圖片,請保持圖片的活力,直到所有作業完成為止。 始終使用 using 語句或 try-finally 塊以確保處理。 請記住,OcrImageInput 會創建自己的內部副本,因此原始 bitmap 可以在 OcrImageInput 創建後處理。 對於涉及多個圖像操作的複雜場景,請參考我們的 OCR 圖像優化過濾器 示例。
如何從 System.Drawing.Image 中讀取?
從 Image 中讀取就像創建 OcrInput 對象和 Image 一樣簡單,然後使用 Read 方法執行標準 OCR 過程。
using IronOcr;
using Image = System.Drawing.Image;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Open image file as Image
Image image = Image.FromFile("Potter.tiff");
// Import System.Drawing.Image
using var imageInput = new OcrImageInput(image);
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);using IronOcr;
using Image = System.Drawing.Image;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Open image file as Image
Image image = Image.FromFile("Potter.tiff");
// Import System.Drawing.Image
using var imageInput = new OcrImageInput(image);
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);Imports IronOcr
Imports Image = System.Drawing.Image
' Instantiate IronTesseract
Private ocrTesseract As New IronTesseract()
' Open image file as Image
Private image As Image = Image.FromFile("Potter.tiff")
' Import System.Drawing.Image
Private imageInput = New OcrImageInput(image)
' Perform OCR
Private ocrResult As OcrResult = ocrTesseract.Read(imageInput)Imports IronOcr
Imports Image = System.Drawing.Image
' Instantiate IronTesseract
Private ocrTesseract As New IronTesseract()
' Open image file as Image
Private image As Image = Image.FromFile("Potter.tiff")
' Import System.Drawing.Image
Private imageInput = New OcrImageInput(image)
' Perform OCR
Private ocrResult As OcrResult = ocrTesseract.Read(imageInput)圖像與位圖對於 OCR 的區別是什麼?
雖然 Bitmap 是一個針對位圖圖像的具體實現,而 Image 是一個抽象基類,可以表示 JPEG、PNG、GIF 和 TIFF 等多種圖像格式。 對於 OCR 目的,IronOCR 通過 OcrInput 對它們進行相同的處理,但 Image 在處理不同格式時提供了更多的靈活性。 Bitmap 提供像素級別的操作能力,而 Image 更適合一般的圖像處理。 兩者都可以與 IronOCR 的高級 Tesseract 5 引擎出色地協作。選擇取決於您更廣泛的應用需求,而不是 OCR 性能。
為什麼使用 Image.FromFile 而不是其他加載方法?
Image.FromFile 是最為簡單和最直接的從磁碟加載圖像的方法。 它會自動偵測影像格式並處理檔案讀取程序。 像 MemoryStream 這樣的替代方法更適合用於 Web 應用或與記憶體流配合使用時。 FileStream 會鎖定文件,直到 FileStream 被處理完畢,在多線程應用中這是需考慮的一點。 對於要求高性能或並發訪問的生產場景,考慮先將圖像加載到記憶體流中。我們的 多線程 Tesseract OCR 示例展示了併發圖像處理的最佳實踐。
如何從 IronSoftware.Drawing.AnyBitmap 讀取?
類似地,在創建或獲取 AnyBitmap 對象之後,您可以構建 OcrInput 類。 建構器會處理匯入資料的所有必要步驟。 下面的程式碼範例演示了這一點。
using IronOcr;
using IronSoftware.Drawing;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Open image file as AnyBitmap
AnyBitmap anyBitmap = AnyBitmap.FromFile("Potter.tiff");
// Import IronSoftware.Drawing.AnyBitmap
using var imageInput = new OcrImageInput(anyBitmap);
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);using IronOcr;
using IronSoftware.Drawing;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Open image file as AnyBitmap
AnyBitmap anyBitmap = AnyBitmap.FromFile("Potter.tiff");
// Import IronSoftware.Drawing.AnyBitmap
using var imageInput = new OcrImageInput(anyBitmap);
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);Imports IronOcr
Imports IronSoftware.Drawing
' Instantiate IronTesseract
Private ocrTesseract As New IronTesseract()
' Open image file as AnyBitmap
Private anyBitmap As AnyBitmap = AnyBitmap.FromFile("Potter.tiff")
' Import IronSoftware.Drawing.AnyBitmap
Private imageInput = New OcrImageInput(anyBitmap)
' Perform OCR
Private ocrResult As OcrResult = ocrTesseract.Read(imageInput)Imports IronOcr
Imports IronSoftware.Drawing
' Instantiate IronTesseract
Private ocrTesseract As New IronTesseract()
' Open image file as AnyBitmap
Private anyBitmap As AnyBitmap = AnyBitmap.FromFile("Potter.tiff")
' Import IronSoftware.Drawing.AnyBitmap
Private imageInput = New OcrImageInput(anyBitmap)
' Perform OCR
Private ocrResult As OcrResult = ocrTesseract.Read(imageInput)為什麼選擇 AnyBitmap 而不是 System.Drawing 類?
AnyBitmap 提供相較於 Bitmap 類的優越跨平台兼容性。 雖然 Bitmap 在 .NET 6+ 中對非 Windows 平台的支援有限,但 AnyBitmap 能在 Windows、Linux 和 macOS 上運行。 它提供一致的 API,沒有特定平台的依賴性,因此非常適合雲端部署和容器化應用程式。 AnyBitmap 也提供更好的記憶體管理和專為圖像處理任務設計的性能優化。 如需詳細的兼容性信息,請參見我們的 兼容性 文檔。
AnyBitmap 支援哪些平台?
AnyBitmap 支持所有 .NET 運行的主要平台:Windows(x86, x64, ARM)、Linux(包括供 Docker 使用的 Alpine Linux)和 macOS(包括 Intel 和 Apple Silicon)。 這種廣泛的平台支援使其成為需要在多樣化環境中執行的現代 .NET 應用程式的推薦選擇。 對於 AWS Lambda 或 Azure Functions 的雲端部署尤其有價值。 了解我們針對 Linux、macOS 和 Docker 環境指南的更多有關平台特定設置的信息。
AnyBitmap 如何處理記憶體管理?
AnyBitmap 通過自動垃圾收集整合和顯式處理模式實現高效的記憶體管理。 它使用記憶體池來處理頻繁分配的緩衝區,並實現寫入時複製的語義,以獲得更好的效能。 與可能持有文件鎖的 AnyBitmap 不同,AnyBitmap 將圖像完全加載到記憶體中,防止文件訪問問題。 它還可以在高吞吐量的情況下更好地控制記憶體的使用。 對於處理大量圖像的應用,AnyBitmap 的記憶體效率可以顯著減少整體記憶體佔用量。 請參見我們的 System.Drawing.Common 替代方案 指南以獲取遷移提示。
如何指定掃描區域?
在 OcrInput 類的構建中,您可以指定要掃描的區域。 這樣就可以定義影像文件中用於 OCR 的特定區域。 視影像文件而定,指定掃描區域可大幅提升效能。 在提供的程式碼範例中,只擷取了章節編號和標題。
using IronOcr;
using IronSoftware.Drawing;
using System;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Specify crop region
Rectangle scanRegion = new Rectangle(800, 200, 900, 400);
// Add image
using var imageInput = new OcrImageInput("Potter.tiff", ContentArea: scanRegion);
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);
// Output the result to console
Console.WriteLine(ocrResult.Text);using IronOcr;
using IronSoftware.Drawing;
using System;
// Instantiate IronTesseract
IronTesseract ocrTesseract = new IronTesseract();
// Specify crop region
Rectangle scanRegion = new Rectangle(800, 200, 900, 400);
// Add image
using var imageInput = new OcrImageInput("Potter.tiff", ContentArea: scanRegion);
// Perform OCR
OcrResult ocrResult = ocrTesseract.Read(imageInput);
// Output the result to console
Console.WriteLine(ocrResult.Text);Imports IronOcr
Imports IronSoftware.Drawing
Imports System
' Instantiate IronTesseract
Dim ocrTesseract As New IronTesseract()
' Specify crop region
Dim scanRegion As New Rectangle(800, 200, 900, 400)
' Add image
Using imageInput As New OcrImageInput("Potter.tiff", ContentArea:=scanRegion)
' Perform OCR
Dim ocrResult As OcrResult = ocrTesseract.Read(imageInput)
' Output the result to console
Console.WriteLine(ocrResult.Text)
End UsingImports IronOcr
Imports IronSoftware.Drawing
Imports System
' Instantiate IronTesseract
Dim ocrTesseract As New IronTesseract()
' Specify crop region
Dim scanRegion As New Rectangle(800, 200, 900, 400)
' Add image
Using imageInput As New OcrImageInput("Potter.tiff", ContentArea:=scanRegion)
' Perform OCR
Dim ocrResult As OcrResult = ocrTesseract.Read(imageInput)
' Output the result to console
Console.WriteLine(ocrResult.Text)
End Using什麼時候應該使用區域掃描以提高性能?
當您只需要一致文件佈局中特定區域的文字時,區域掃描可大幅提升效能。 常見的用例包括擷取標頭、表單欄位、發票總數或 ID 卡資訊。 對於文字只佔一小部分的大型圖片,效能提升最為顯著。 對於 3000x4000 像素的發票,只掃描總金額區域可能比整頁 OCR 快得多。 區域掃描也可消除其他區域可能產生的雜訊,從而提高精確度。 有關更多基於區域的示例,請參閱我們的 內容區域和 PDF 裁剪區域 指南。
我應如何確定我的區域的正確座標?
確定座標需要理解 Rectangle 使用 (X, Y, 寬度, 高度) 格式,其中 (0,0) 為左上角。 首先在可顯示游標座標的影像編輯器中開啟您的影像。 或者,使用 IronOCR 的除錯特徵來可視化檢測到的文本區域。 對於動態佈局,考慮使用 IronOCR 先進行完整掃描,然後分析 OcrResult 以編程方式查找文本位置。 我們的 除錯高亮文本 示例展示如何可視化 OCR 區域以準確確定座標。
如果區域超出圖像邊界會怎樣?
當指定的區域超出影像邊界時,IronOCR 會自動將其剪輯至有效的影像區域。 例如,如果您的圖片是 1000x1000 像素,而您指定一個矩形在 (900, 900, 200, 200),IronOCR 只會處理從 (900, 900) 到 (1000, 1000) 的區域。 此自動剪輯功能可避免錯誤,但如果您的座標不正確,可能會導致文字擷取不完整。 請務必根據實際影像尺寸來驗證您的區域。 對於動態影像大小,請以百分比而非固定像素計算區域。 圖像的 OCR 區域 指南提供了更多安全區域處理的示例。
OCR 結果

using
OcrImageInput
OcrImageInput
IDisposable
using
System.Drawing.Bitmap
Bitmaps
new Bitmap(stream)
Images
new Bitmap(image)
new Bitmap(width, height)
Assembly.GetManifestResourceStream()
Bitmap
OcrImageInput
Bitmap
OcrImageInput
using
OcrImageInput
Bitmap
OcrImageInput
System.Drawing.Image
OcrImageInput
Image
Read
System.Drawing.Bitmap
System.Drawing.Image
OcrImageInput
Image
Bitmap
Image
Image.FromFile
Image.FromStream
Image.FromFile
Image
AnyBitmap
OcrImageInput
AnyBitmap
System.Drawing
System.Drawing.Common
AnyBitmap
AnyBitmap
AnyBitmap
AnyBitmap
System.Drawing.Bitmap
AnyBitmap
AnyBitmap
OcrImageInput
Rectangle
OcrResult
常見問題
如何使用IronOCR對System.Drawing.Bitmap進行OCR?
您可以透過創建IronTesseract的實例並將System.Drawing.Bitmap圖像包裝在OcrImageInput中傳遞給Read方法來使用IronOCR程式庫。這將從圖像中提取文字。
為何在處理OcrImageInput時,'using'語句很重要?
‘using’語句通過自動調用Dispose來釋放未管理的資源,確保OcrImageInput的適當資源管理,防止記憶體洩漏和文件鎖。
使用AnyBitmap而非System.Drawing.Bitmap進行OCR的好處是什麼?
AnyBitmap提供了跨平台的兼容性和改進的記憶體管理,因為它能在Windows、Linux和macOS上運作,而不依賴平台特定的依賴項。
如何使用IronOCR指定特定的OCR區域?
在構建OcrInput類時,您可以通過指定定義區域的Rectangle物件來定義要掃描的圖像區域。這可以通過將OCR集中在相關部分來提高效能和準確度。
System.Drawing.Image和System.Drawing.Bitmap在OCR任務中有何區別?
System.Drawing.Image是一個能夠表示多種格式的抽象類,而System.Drawing.Bitmap是位圖圖像的特定實現。IronOCR對兩者的處理方式相同,但Image在跨格式上提供更多的靈活性。
在何時應選擇Image.FromFile方法而非其他圖像加載技術?
Image.FromFile是從磁碟中加載圖像的簡單方法,因為它會自動檢測格式。它適合簡單的桌面應用程式,而記憶體流則適用於網頁應用或高效能場景。
AnyBitmap在OCR任務中的記憶體管理如何運作?
AnyBitmap透過與垃圾回收整合和明確的處置模式來確保有效的記憶體管理。它將圖像完全載入記憶體中,防止在處理後的文件訪問問題,從而改善效能。
IronOCR能處理System.Drawing.Image中的不同圖像格式嗎?
是的,IronOCR支援各種圖像格式透過System.Drawing.Image,提供在處理JPEG、PNG、GIF和TIFF格式上的靈活性,均兼容其Tesseract 5引擎。
如果定義的區域超出圖像邊界,IronOCR如何管理區域掃描?
IronOCR會自動調整任何超出圖像邊界的區域至有效區域,避免錯誤,但如果座標不正確,可能導致未完全的文本提取。
在OCR處理後應考慮哪些圖像處置問題?
處置時間取決於您的應用需求。如果不再使用圖像,請在OCR後立即處置位圖圖像以確保資源被釋放,或選擇性地管理生命週期以進行其他操作。
Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。