1. IronOCR
  2. 操作指南
  3. 检测页面旋转
如何在 C# 中检测 OCR 的页面旋转 | IronOCR

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

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

确定页面旋转角度是指确定文档中页面所应用的旋转程度。 该过程专门确定页面是否顺时针或逆时针旋转了 0、90、180 和 270 度角。 该信息对于准确渲染或处理文档至关重要，可确保页面以正确的方向显示或打印。

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

在这个简单的示例中，开发人员使用 IronOCR 的 DetectPageOrientation 功能来检测已加载的 PDF，并立即获取最可靠的页面的 RotationAngle。 它是一种能够快速检测和纠正页面旋转的方法，只需极少的设置和代码。

Nuget Icon立即开始使用 NuGet 创建 PDF 文件：

  1. 使用 NuGet 包管理器安装 IronOCR

    PM > Install-Package IronOcr

  2. 复制并运行这段代码。

    var rotationResults = new IronOcr.OcrInput().LoadPdf("doc.pdf").DetectPageOrientation();
Console.WriteLine(rotationResults.First().RotationAngle);

  3. 部署到您的生产环境中进行测试

    立即开始在您的项目中使用 IronOCR，免费试用！
    arrow pointer

最小工作流程（5 个步骤）

  1. 下载用于检测页面旋转的 C# 库
  2. 导入 PDF 文档和图像进行读取
  3. 使用DetectPageOrientation方法检测所有页面的旋转方向
  4. 访问RotationAngle属性以校正页面旋转
  5. 访问HighConfidence属性以处理极端情况


检测页面旋转示例

加载文档后，您可以使用DetectPageOrientation方法来识别每一页的旋转方向。 该方法支持 0、90、180 和 270 度。对于倾斜图像，可以使用Deskew图像校正方法。 然后，使用函数返回的角度将图像旋转回其原始方向。 让我们来看一个示例PDF文件。

请注意当文档内容密集时，此函数表现良好。

:path=/static-assets/ocr/content-code-examples/how-to/detect-page-rotation-detect-page-rotation.cs
using IronOcr;
using System;

using var input = new OcrInput();

// Load PDF document
input.LoadPdf("Clockwise90.pdf");

// Detect page rotation
var results = input.DetectPageOrientation();

// Ouput result
foreach(var result in results)
{
    Console.WriteLine(result.PageNumber);
    Console.WriteLine(result.HighConfidence);
    Console.WriteLine(result.RotationAngle);
}
Imports IronOcr
Imports System

Private input = New OcrInput()

' Load PDF document
input.LoadPdf("Clockwise90.pdf")

' Detect page rotation
Dim results = input.DetectPageOrientation()

' Ouput result
For Each result In results
	Console.WriteLine(result.PageNumber)
	Console.WriteLine(result.HighConfidence)
	Console.WriteLine(result.RotationAngle)
Next result
$vbLabelText   $csharpLabel

理解结果

  • PageNumber ：表示页面的从零开始的索引。
  • RotationAngle ：提供以度为单位的旋转角度。 此外，该信息可与Rotate方法一起使用，使图像恢复到其正立方向。
  • HighConfidence ：表示对方向结果的置信度，有助于更有效地处理极端情况。

高级检测页面旋转

DetectPageOrientation 方法还允许您提供一个可选参数，以控制检测中的详细程度。 通过提供OreitnationDetectioMode枚举作为参数，用户可以根据自己的需要自定义和调整检测速度和细节。

以下是一个简单的使用代码示例。

:path=/static-assets/ocr/content-code-examples/how-to/detect-page-rotation-detect-page-rotation-advanced.cs
using IronOcr;
using System;

using var input = new OcrInput();

// Load PDF document
input.LoadPdf("Clockwise90.pdf");

// Detect page rotation with Fast mode
var results = input.DetectPageOrientation(OrientationDetectionMode.Fast);

// Ouput result
foreach(var result in results)
{
    Console.WriteLine(result.PageNumber);
    Console.WriteLine(result.HighConfidence);
    Console.WriteLine(result.RotationAngle);
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

目前OrientationDetectionMode有四种速度选项：

警告使用Balanced 、 Detailed和ExtremeDetailed选项需要安装 IronOcr.Extensions.AdvancedScan 包。 目前这些选项无法在 Windows x86 和 Mac ARM 上使用。

-快速：快速定位模式以高速度检测定位角度，但精度较低； 因此，它更适合对速度要求较高的草稿处理或批量处理。 这是DetectPageOrientation方法的默认设置。

-平衡：平衡定向模式以平衡的速度和精度确定定向角度； 它通常更适合默认或生产任务。

-详细模式：详细模式以低速但高精度确定方向角； 因此，它通常更适合执行精确或关键性任务。

-超精细模式：超精细模式以最慢的速度确定方向角，但提供最高的精度。 然而，与其他选项相比，其速度较慢，因此只有在"详细"选项不足以满足需求或文本输入本身严重倾斜和扭曲时，它才是理想的选择。

常见问题解答

如何使用 C# 检测文档中的页面旋转？

您可以使用 IronOCR 的 DetectPageOrientation 方法来识别文档中页面的旋转。该方法可以检测旋转角度为 0、90、180 和 270 度的情况。

在 IronOCR 中纠正页面旋转涉及哪些步骤？

首先，使用 DetectPageOrientation 方法确定旋转角度。然后，应用 Rotate 方法和 RotationAngle 属性来纠正页面的方向。

IronOCR 如何处理倾斜的文档图像？

对于倾斜的图像，IronOCR 提供了 Deskew 方法以在应用方向纠正之前纠正倾斜。

哪些属性有助于确保准确的页面旋转检测？

RotationAngle 属性指示所需的校正角度，而 HighConfidence 属性显示检测到的方向的置信度水平，有助于管理极端情况。

如何确保文档页面在使用 IronOCR 时正确显示？

使用 DetectPageOrientation 方法找到旋转角度，并使用此角度应用 Rotate 方法以纠正页面方向。

IronOCR 能有效处理文本密集型文档吗？

是的，IronOCR 的 DetectPageOrientation 功能旨在即使面对文本密集型文档也能表现良好。

IronOCR 中的 PageNumber 属性表示什么？

PageNumber 属性表示正在处理的页面的零基础索引，有助于跨多个页面跟踪方向校正。

如何纠正既旋转又倾斜的文档？

首先，使用 IronOCR 的 Deskew 方法纠正任何倾斜，然后应用 DetectPageOrientation 方法，之后用检测到的 RotationAngle 通过 Rotate 方法来纠正任何旋转。

在文档处理中检测页面旋转的重要性是什么？

检测页面旋转确保文档被准确呈现和处理，保持正确的显示或打印方向，这对 OCR 等应用至关重要。

IronOCR 能否处理单个文档中含有多个旋转角度的文档？

是的，IronOCR 可以使用 DetectPageOrientation 方法检测和纠正文档中每个页面的不同旋转角度。

Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

审核者
Jeff Fritz
Jeffrey T. Fritz
首席项目经理 - .NET 社区团队
Jeff 也是 .NET 和 Visual Studio 团队的首席项目经理。他是 .NET Conf 虚拟会议系列的执行制片人，并主持“Fritz and Friends”直播节目，每周两次与观众一起谈论技术并编写代码。Jeff 撰写研讨会、演示文稿并计划包括 Microsoft Build、Microsoft Ignite、.NET Conf 和 Microsoft MVP 峰会在内的最大型微软开发者活动的内容。
准备开始了吗？
Nuget 下载 5,167,857 | Version: 2025.11 刚刚发布