如何使用 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 提供四種速度選項：

• 快速：檢測速度快，但準確度較低。 特別適合用於草稿或大量處理等速度至關重要的情境。 DetectPageOrientation 的預設值。 支援多執行緒，可高效處理數千頁內容。
• 平衡：在速度與準確性之間取得平衡。 適用於正式生產環境。 利用 AdvancedScan 擴充功能提升準確性，同時維持效能。
• 詳盡模式：速度較慢，準確度較高。 最適合用於精確或關鍵任務，特別是版面配置複雜或內容混合的文件。
• 極致詳盡：速度最慢，準確度最高。 僅在"詳細"模式不足以處理，或文字嚴重傾斜變形時使用。

常見的效能考量有哪些？

不同模式之間的效能差異顯著。 快速模式每分鐘可處理數百頁； ExtremeDetailed 每頁可能需要數秒時間。 請根據準確性要求與時間限制進行選擇。 為獲得最佳效能：

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

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

對於方向不一的文件，請先使用 DetectPageOrientation 分別處理每頁，然後在執行 OCR 之前，逐頁進行旋轉校正。 這可確保無論初始狀態為何，皆能正確顯示。 以下是一種有效的翻譯方法：

// Process each page with individual rotation detection
for (int i = 0; i < results.Co/unt; 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.Co/unt; 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 類別會提供詳細的頁面資訊，從而支援精細的錯誤處理與品質控制工作流程。 針對高吞吐量的生產環境，請探索"快速 OCR 設定"選項，以在速度與準確性之間取得平衡。

若需處理同時包含文字與 BARCODE 的文件，請使用具備 BARCODE 與 QR 碼讀取功能的 IronOCR OCR，以單次處理提取所有資訊，從而提升效率。