如何使用 IronOCR 在 C# 中检测页面旋转

IronOCR 的 DetectPageOrientation 方法可自动识别 PDF 文档和图像中的页面旋转角度（0°、90°、180°、270°）。 它可返回每个页面的 RotationAngle 属性，从而实现编程方向校正，并为准确提取文本提供置信度分数。

页面旋转检测可识别文档页面是否顺时针或逆时针旋转了 0、90、180 或 270 度。 这些信息可确保页面以正确的方向显示或处理，从而实现准确的渲染和文本提取。

快速入门：使用 DetectPageOrientation 来识别页面旋转

<! -- 待办事项：在此处添加图片 --> <! -- --> <！--说明：说明代码概念的图表或截图 -->

本示例演示了在 PDF 上使用 IronOCR 的 DetectPageOrientation 访问 RotationAngle 属性。 它以最少的代码提供快速的页面旋转检测和校正。

如何检测文档中的页面旋转？ <！--！[屏幕截图演示如何检测文档中的页面旋转？ in IronPDF](/static-assets/images/TODO/how-do-i-detect-page-rotation-in-my-documents-step_screenshot.webp) --> <！-- 说明：显示逐步过程的截图 --> 加载文档后，使用 `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 ```

---

检测结果意味着什么？ - `页码`：基于零的页面索引。 - `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 处理之前提供了广泛的文档准备方法。

如何自定义检测速度和精度？ <！--！[屏幕截图演示如何自定义检测速度和准确性？ in IronPdf](/static-assets/images/TODO/how-can-i-customize-detection-speed-and-accuracy-step_screenshot.webp) --> <！-- 说明：显示逐步过程的截图 --> `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 类](https://ironsoftware.com/csharp/ocr/examples/results-objects/)可提供详细的页面信息，从而实现复杂的错误处理和质量控制工作流。 对于高吞吐量的生产环境，请探索[快速 OCR 配置](https://ironsoftware.com/csharp/ocr/examples/tune-tesseract-for-speed-in-dotnet/)选项，以平衡速度和准确性。 如果要处理同时包含文本和条形码的文档，可使用 IronOCR 的 [OCR with Barcode & QR Reading](https://ironsoftware.com/csharp/ocr/examples/csharp-ocr-barcodes/) 功能一次性提取所有信息，提高效率。