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

檢測結果代表什麼意義？

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

何時應該使用高置信度值？

HighConfidence（高置信度）屬性對於旋轉偵測可能不確定的含糊或低品質文件至關重要。 文字稀疏、佈局異常或掃描品質不佳的文件通常會得到較低的置信度分數。 在這些情況下，在偵測之前實施額外的驗證或套用 影像品質修正篩選程式。

對於置信度較低的頁面，使用此值來實施後備策略或人工審查。 例如，如果置信度低於 80%，則以多個方向處理頁面並比較 OCR 結果，或標示以進行人工審查。 IronOCR 的電腦視覺功能有助於在具有挑戰性的文件中更準確地識別文字區域。

如何糾正偵測到的旋轉？

確定旋轉角度後，在您的 OcrInput 物件上使用 Rotate 方法，以在 OCR 之前矯正方向。 這可確保最佳的文字辨識準確度。 如需全面的方向修正，請參閱 影像方向修正指南。 以下是修正過程：

// Apply rotation correction based on detection results
if (result.RotationAngle != 0)
{
    input.Rotate(360 - result.RotationAngle); // Rotate back to 0°
}

// Apply rotation correction based on detection results
if (result.RotationAngle != 0)
{
    input.Rotate(360 - result.RotationAngle); // Rotate back to 0°
}

' Apply rotation correction based on detection results
If result.RotationAngle <> 0 Then
    input.Rotate(360 - result.RotationAngle) ' Rotate back to 0°
End If

對於需要額外預處理的文件，可以考慮使用 OcrInput 類別，它在 OCR 處理之前提供了廣泛的文件準備方法。

我應該選擇哪一種偵測模式？

OrientationDetectionMode 提供四種速度選項：

[{w:(Balanced, Detailed, 和 ExtremeDetailed需要 IronOcr.Extensions.AdvancedScan 套件。 這些選項在 Windows x86 和 Mac ARM 上無法使用。

• 快速：高速偵測，準確度較低。 非常適合用於速度極為重要的草稿或大量處理。 DetectPageOrientation 的預設值。 透過 多執行緒支援，有效率地處理數以千計的頁面。
• 平衡：平衡速度和準確性。 適合生產任務。 使用 AdvancedScan 延伸功能，以提高精確度，同時維持效能。
• 詳細：低速度、高精度。 最適合精確或關鍵的任務，尤其是版面複雜或內容混雜的文件。
• ExtremeDetailed：速度最慢，精確度最高。 僅在 Detailed 不足或文字嚴重歪斜扭曲時使用。

哪些是常見的效能考量？

不同模式的效能差異很大。 快速模式每分鐘可處理數百頁； ExtremeDetailed 每頁可能需要數秒。 根據精確度要求和時間限制進行選擇。 為達到最佳效能：

1.影像解析度：較高的DPI設定可提高精確度，但會增加處理時間。150-300 DPI 通常已足以進行旋轉偵測。 2.文件類型：與稀疏的版面相比，文字密集的文件處理速度更快、更準確。 使用 Filter Wizard 在偵測前優化影像品質。 3.資源使用量：在處理大量批次時，監控記憶體使用量。 實施進度追蹤以提供回饋和管理系統資源。 4.平行處理：針對大量作業，可使用 IronOCR 的多執行緒同時處理多個文件，同時保持精確度。

如何處理混合方向的文件？

對於混合方向的文件，請使用 DetectPageOrientation 獨立處理每頁，然後在 OCR 之前應用逐頁旋轉修正。 這可確保無論初始狀態為何，都能正確定位。 以下是一個有效的方法：

// 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);
    }
}

// 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);
    }
}

' Process each page with individual rotation detection
For i As Integer = 0 To results.Count - 1
    Dim pageResult = results(i)

    ' Apply rotation only to pages that need it
    If pageResult.RotationAngle <> 0 AndAlso pageResult.HighConfidence Then
        ' Correct the specific page
        input.Pages(i).Rotate(360 - pageResult.RotationAngle)
    End If
Next

對於涉及不同品質的掃描文件或多頁 TIFF 文件的複雜情況，請個別預先處理每一頁，以獲得最佳效果。

在處理混合格式輸入時，OcrResult Class 會提供詳細的頁面資訊，讓複雜的錯誤處理和品質控制工作流程得以實現。 對於高產量的生產環境，請探索 Fast OCR Configuration 選項，以平衡速度與精確度。

如果要處理同時包含文字和 BarCode 的文件，請使用 IronOCR 的 OCR with Barcode & QR Reading 功能，一次擷取所有資訊，提高效率。