如何使用 IronOCR 在 C# 中偵測頁面旋轉

IronOCR 的 DetectPageOrientation 方法可自動識別 PDF 文件和影像中的頁面旋轉角 (0°、90°、180°、270°)。 它會回傳每個頁面的 RotationAngle 屬性，使程式化的方向修正與信心分數能夠準確地擷取文字。

頁面旋轉檢測可辨識文件頁面是否已順時針旋轉或逆時針旋轉 0、90、180 或 270 度。 此資訊可確保頁面以正確的方向顯示或處理，以達到精確的呈現和文字擷取。

快速入門：使用 DetectPageOrientation 來辨識頁面旋轉

<! -- --> <！--說明：說明程式碼概念的圖表或截圖 -->

本範例示範在 PDF 上使用 IronOCR 的 DetectPageOrientation 來存取 RotationAngle 屬性。 它以最少的程式碼提供快速的頁面旋轉檢測與修正。

如何在我的文件中檢測頁面旋轉？ 譯文 <！--說明：顯示逐步過程的截圖 --> 載入文件後，使用 `DetectPageOrientation` 方法來識別每個頁面的旋轉。 此方法支援 0、90、180 及 270 度。 對於這些標準旋轉之外的歪斜影像，請使用 [ IronOCR 的影像修正濾鏡](https://ironsoftware.com/csharp/ocr/how-to/image-quality-correction/)中的 `Deskew` 方法。 然後使用偵測到的角度將影像旋轉回原始方向。 讓我們使用 [範例 PDF](/static-assets/ocr/how-to/detect-page-rotation/Clockwise90.pdf)。 [{i:(此功能對於文字密集的文件效果最佳。 ```csharp :path=/static-assets/ocr/content-code-examples/how-to/detect-page-rotation-detect-page-rotation.cs ```

---

檢測結果代表什麼意義？ - `PageNumber`：以零為基礎的頁面索引。 - `RotationAngle`：旋轉角度，單位為度。 與 `Rotate` 方法一起使用以修正方向。 - `HighConfidence`：對於處理邊緣情況的定位結果的信心等級。

何時應該使用高置信度值？ `HighConfidence`（高置信度）屬性對於旋轉偵測可能不確定的含糊或低品質文件至關重要。 文字稀疏、佈局異常或掃描品質不佳的文件通常會得到較低的置信度分數。 在這些情況下，在偵測之前實施額外的驗證或套用 [影像品質修正篩選程式](https://ironsoftware.com/csharp/ocr/examples/ocr-image-filters-for-net-tesseract/)。 對於置信度較低的頁面，使用此值來實施後備策略或人工審查。 例如，如果置信度低於 80%，則以多個方向處理頁面並比較 OCR 結果，或標示以進行人工審查。 IronOCR 的[電腦視覺功能](https://ironsoftware.com/csharp/ocr/how-to/computer-vision/)有助於在具有挑戰性的文件中更準確地識別文字區域。

如何糾正偵測到的旋轉？ 確定旋轉角度後，在您的 `OcrInput` 物件上使用 `Rotate` 方法，以在 OCR 之前矯正方向。 這可確保最佳的文字辨識準確度。 如需全面的方向修正，請參閱 [影像方向修正指南](https://ironsoftware.com/csharp/ocr/how-to/image-orientation-correction/)。 以下是修正過程： ```csharp // Apply rotation correction based on detection results if (result.RotationAngle != 0) { input.Rotate(360 - result.RotationAngle); // Rotate back to 0° } ``` 對於需要額外預處理的文件，可以考慮使用 [OcrInput 類別](https://ironsoftware.com/csharp/ocr/examples/csharp-ocr-input-for-iron-tesseract/)，它在 OCR 處理之前提供了廣泛的文件準備方法。

如何自訂偵測速度和精確度？ 譯文 <！--說明：顯示逐步過程的截圖 --> `DetectPageOrientation` 方法接受一個可選參數以控制偵測細節。 透過提供 `OrientationDetectionMode` 枚舉，您可以根據需求調整偵測速度和精確度。 以下是實作方法： ```csharp :path=/static-assets/ocr/content-code-examples/how-to/detect-page-rotation-detect-page-rotation-advanced.cs ```

我應該選擇哪一種偵測模式？ `OrientationDetectionMode` 提供四種速度選項： [{w:(**Balanced**, **Detailed**, 和 **ExtremeDetailed**需要 IronOcr.Extensions.AdvancedScan 套件。 這些選項在 Windows x86 和 Mac ARM 上無法使用。 - **快速**：高速偵測，準確度較低。 非常適合用於速度極為重要的草稿或大量處理。 `DetectPageOrientation` 的預設值。 透過 [多執行緒支援](https://ironsoftware.com/csharp/ocr/how-to/async/)，有效率地處理數以千計的頁面。 - **平衡**：平衡速度和準確性。 適合生產任務。 使用 [AdvancedScan 延伸功能](https://ironsoftware.com/csharp/ocr/product-updates/milestones-advancedscan-extension/)，以提高精確度，同時維持效能。 - **詳細**：低速度、高精度。 最適合精確或關鍵的任務，尤其是版面複雜或內容混雜的文件。 - **ExtremeDetailed**：速度最慢，精確度最高。 僅在 **Detailed** 不足或文字嚴重歪斜扭曲時使用。

哪些是常見的效能考量？ 不同模式的效能差異很大。 快速模式每分鐘可處理數百頁； ExtremeDetailed 每頁可能需要數秒。 根據精確度要求和時間限制進行選擇。 為達到最佳效能： 1.**影像解析度**：較高的[DPI設定](https://ironsoftware.com/csharp/ocr/how-to/dpi-setting/)可提高精確度，但會增加處理時間。150-300 DPI 通常已足以進行旋轉偵測。 2.**文件類型**：與稀疏的版面相比，文字密集的文件處理速度更快、更準確。 使用 [Filter Wizard](https://ironsoftware.com/csharp/ocr/how-to/filter-wizard/) 在偵測前優化影像品質。 3.**資源使用量**：在處理大量批次時，監控記憶體使用量。 實施[進度追蹤](https://ironsoftware.com/csharp/ocr/how-to/progress-tracking/)以提供回饋和管理系統資源。 4.**平行處理**：針對大量作業，可使用 IronOCR 的多執行緒同時處理多個文件，同時保持精確度。

如何處理混合方向的文件？ 對於混合方向的文件，請使用 `DetectPageOrientation` 獨立處理每頁，然後在 OCR 之前應用逐頁旋轉修正。 這可確保無論初始狀態為何，都能正確定位。 以下是一個有效的方法： ```csharp // Process each page with individual rotation detection for (int i = 0; i < results.Count; i++) { var pageResult = results[i]; // Apply rotation only to pages that need it if (pageResult.RotationAngle != 0 && pageResult.HighConfidence) { // Correct the specific page input.Pages[i].Rotate(360 - pageResult.RotationAngle); } } ``` 對於涉及不同品質的[掃描文件](https://ironsoftware.com/csharp/ocr/how-to/read-scanned-document/)或[多頁 TIFF 文件](https://ironsoftware.com/csharp/ocr/examples/csharp-tesseract-multipage-tiff/)的複雜情況，請個別預先處理每一頁，以獲得最佳效果。 在處理混合格式輸入時，[OcrResult Class](https://ironsoftware.com/csharp/ocr/examples/results-objects/) 會提供詳細的頁面資訊，讓複雜的錯誤處理和品質控制工作流程得以實現。 對於高產量的生產環境，請探索 [Fast OCR Configuration](https://ironsoftware.com/csharp/ocr/examples/tune-tesseract-for-speed-in-dotnet/) 選項，以平衡速度與精確度。 如果要處理同時包含文字和 BarCode 的文件，請使用 IronOCR 的 [OCR with Barcode & QR Reading](https://ironsoftware.com/csharp/ocr/examples/csharp-ocr-barcodes/) 功能，一次擷取所有資訊，提高效率。