Cómo detectar la rotación de páginas en C# con IronOCR
El método DetectPageOrientation de IronOCR identifica automáticamente los ángulos de rotación de página (0°, 90°, 180°, 270°) en documentos PDF e imágenes. Devuelve una propiedad RotationAngle para cada página, lo que permite la corrección programática de orientación con puntuaciones de confianza para una extracción precisa de texto.
La detección de la rotación de páginas identifica si la página de un documento ha girado 0, 90, 180 o 270 grados en el sentido de las agujas del reloj o en sentido contrario. Esta información garantiza que las páginas se muestren o procesen en su orientación correcta para una representación y extracción de texto precisas.
Inicio rápido: UseDetectPageOrientation para identificar la rotación de página
Este ejemplo demuestra el uso de DetectPageOrientation de IronOCR en un PDF para acceder a la propiedad RotationAngle. Proporciona una rápida detección y corrección de la rotación de páginas con un código mínimo.
-
1Instalar IronOCR con NuGet Package Manager
-
2Copie y ejecute este fragmento de código.
var rotationResults = new IronOcr.OcrInput().LoadPdf("doc.pdf").DetectPageOrientation(); Console.WriteLine(rotationResults.First().RotationAngle);Dim rotationResults = New IronOcr.OcrInput().LoadPdf("doc.pdf").DetectPageOrientation() Console.WriteLine(rotationResults.First().RotationAngle)Dim rotationResults = New IronOcr.OcrInput().LoadPdf("doc.pdf").DetectPageOrientation() Console.WriteLine(rotationResults.First().RotationAngle) -
3Despliegue para probar en su entorno real
Empiece a usar IronOCR en su proyecto hoy con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Descargar una biblioteca de C# para detectar la rotación de páginas
- Importe el documento PDF y las imágenes para su lectura
- Utilice el método
DetectPageOrientationpara detectar la rotación de todas las páginas - Acceda a la propiedad RotationAngle para corregir la rotación de la página
- Acceda a la propiedad HighConfidence para manejar casos extremos
¿Cómo puedo detectar la rotación de páginas en mis documentos?
Después de cargar un documento, utiliza el método DetectPageOrientation para identificar la rotación de cada página. Este método admite 0, 90, 180 y 270 grados. Para imágenes sesgadas más allá de estas rotaciones estándar, use el método Deskew de los filtros de corrección de imágenes de IronOCR. A continuación, vuelva a girar la imagen a su orientación original utilizando el ángulo detectado. Trabajemos con un PDF de muestra.
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);
}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 resultImports 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¿Qué significan los resultados de la detección?
PageNumber: Índice cero de la página.RotationAngle: Ángulo de rotación en grados. Use con el métodoRotatepara corregir la orientación.HighConfidence: Nivel de confianza en el resultado de la orientación para manejar casos extremos.
¿Cuándo debo utilizar valores de confianza altos?
La propiedad HighConfidence es crucial para documentos ambiguos o de baja calidad donde la detección de rotación puede ser incierta. Los documentos con texto escaso, diseños inusuales o escaneados de mala calidad suelen arrojar puntuaciones de confianza más bajas. En estos casos, implemente validación adicional o aplique filtros de corrección de calidad de imagen antes de la detección.
Utilice este valor para implementar estrategias de reserva o revisión manual para páginas con poca confianza. Por ejemplo, si la confianza cae por debajo del 80%, procesa la página con varias orientaciones y compara los resultados del OCR, o márcala para una revisión manual. Las funciones de visión por computadora de IronOCR ayudan a identificar regiones de texto con mayor precisión en documentos desafiantes.
¿Cómo corregir la rotación detectada?
Después de identificar el ángulo de rotación, use el método Rotate en su objeto OcrInput para corregir la orientación antes del OCR. Esto garantiza una precisión óptima en el reconocimiento de texto. Para correcciones de orientación completas, consulte la guía de corrección de orientación de imagen. He aquí el proceso de corrección:
// 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' Apply rotation correction based on detection results
If result.RotationAngle <> 0 Then
input.Rotate(360 - result.RotationAngle) ' Rotate back to 0°
End IfPara documentos que requieren preprocesamiento adicional, considere la Clase OcrInput que proporciona métodos extensivos de preparación de documentos antes del procesamiento OCR.
¿Cómo puedo personalizar la velocidad y la precisión de detección?
El método DetectPageOrientation acepta parámetros opcionales para controlar el detalle de detección y el uso de recursos. Proporcionando un OrientationDetectionMode enum, puede ajustar la velocidad y precisión de detección según sus requerimientos, y un segundo argumento maxDegreeOfParallelism limita cuántas páginas se analizan al mismo tiempo.
He aquí cómo llevarlo a cabo:
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);
}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);
}Imports IronOcr
Imports System
Using input As New OcrInput()
' Load PDF document
input.LoadPdf("Clockwise90.pdf")
' Detect page rotation with Fast mode
Dim results = input.DetectPageOrientation(OrientationDetectionMode.Fast)
' Output result
For Each result In results
Console.WriteLine(result.PageNumber)
Console.WriteLine(result.HighConfidence)
Console.WriteLine(result.RotationAngle)
Next
End UsingImports IronOcr
Imports System
Using input As New OcrInput()
' Load PDF document
input.LoadPdf("Clockwise90.pdf")
' Detect page rotation with Fast mode
Dim results = input.DetectPageOrientation(OrientationDetectionMode.Fast)
' Output result
For Each result In results
Console.WriteLine(result.PageNumber)
Console.WriteLine(result.HighConfidence)
Console.WriteLine(result.RotationAngle)
Next
End Using¿Qué modo de detección debo elegir?
Cuatro opciones de velocidad están disponibles para OrientationDetectionMode:
IronOcr.Extensions.AdvancedScan. Estas opciones no están disponibles en Windows x86 y Mac ARM.- Fast: Detección a alta velocidad con menor precisión. Ideal para borradores o procesamiento masivo donde la velocidad es crucial. Predeterminada para
DetectPageOrientation. Maneja miles de páginas eficientemente con soporte de multithreading, y reutiliza un motor por hilo de trabajo en lugar de asignar uno por página, manteniendo el uso de memoria bajo en documentos largos. - Balanced: Velocidad y precisión equilibradas. Adecuado para tareas de producción. Usa las capacidades de la extensión AdvancedScan para mejorar la precisión manteniendo el rendimiento.
- Detailed: Baja velocidad, alta precisión. La mejor opción para tareas precisas o críticas, especialmente documentos con diseños complejos o contenido mixto.
- ExtremeDetailed: Velocidad más lenta, máxima precisión. Utilizar sólo cuando Detallado sea insuficiente o el texto esté muy sesgado y distorsionado.
¿Cómo limito la memoria durante la detección de orientación?
En entradas de varias páginas, la detección de orientación analiza varias páginas a la vez, y cada página concurrente utiliza su propio motor nativo. Pase un valor maxDegreeOfParallelism para limitar esa concurrencia y mantener baja la memoria máxima, útil en servidores y contenedores con limitaciones de memoria, reflejando el control MaxDegreeOfParallelism disponible al leer documentos en paralelo.
using IronOcr;
using System.Collections.Generic;
using var input = new OcrInput();
input.LoadPdf("scanned.pdf");
// Cap orientation detection to 2 pages at a time. The default is one per CPU core.
IEnumerable<OcrPageOrientationResult> orientation =
input.DetectPageOrientation(OrientationDetectionMode.Fast, maxDegreeOfParallelism: 2);using IronOcr;
using System.Collections.Generic;
using var input = new OcrInput();
input.LoadPdf("scanned.pdf");
// Cap orientation detection to 2 pages at a time. The default is one per CPU core.
IEnumerable<OcrPageOrientationResult> orientation =
input.DetectPageOrientation(OrientationDetectionMode.Fast, maxDegreeOfParallelism: 2);Imports IronOcr
Imports System.Collections.Generic
Dim input As New OcrInput()
input.LoadPdf("scanned.pdf")
' Cap orientation detection to 2 pages at a time. The default is one per CPU core.
Dim orientation As IEnumerable(Of OcrPageOrientationResult) =
input.DetectPageOrientation(OrientationDetectionMode.Fast, maxDegreeOfParallelism:=2)Imports IronOcr
Imports System.Collections.Generic
Dim input As New OcrInput()
input.LoadPdf("scanned.pdf")
' Cap orientation detection to 2 pages at a time. The default is one per CPU core.
Dim orientation As IEnumerable(Of OcrPageOrientationResult) =
input.DetectPageOrientation(OrientationDetectionMode.Fast, maxDegreeOfParallelism:=2)Environment.ProcessorCount. La sobrecarga de un solo argumento DetectPageOrientation no ha cambiado y sigue siendo totalmente compatible, por lo que el código existente continúa funcionando sin modificaciones.¿Cuáles son las consideraciones comunes de rendimiento?
El rendimiento varía significativamente de un modo a otro. El modo rápido está optimizado para un procesamiento de alto rendimiento, mientras que ExtremeDetailed prioriza la precisión a costa de la velocidad. Elija en función de los requisitos de precisión y las limitaciones de tiempo. Para un rendimiento óptimo:
- Resolución de imagen: Configuraciones de DPI más altas mejoran la precisión pero aumentan el tiempo de procesamiento. 150-300 DPI son generalmente suficientes para la detección de rotación.
- Tipo de documento: Los documentos densos en texto se procesan más rápido y con más precisión que los diseños dispersos. Use el Asistente de filtros para optimizar la calidad de imagen antes de la detección.
- Uso de recursos: Monitoree el uso de memoria al procesar lotes grandes y pase un valor
maxDegreeOfParallelismpara limitar cuántas páginas se analizan a la vez. Implemente seguimiento del progreso para proporcionar retroalimentación y gestionar recursos del sistema. - Procesamiento paralelo: Para operaciones masivas, use el multithreading de IronOCR para procesar múltiples documentos simultáneamente mientras mantiene la precisión. Límitelo con
MaxDegreeOfParallelismcuando la memoria esté restringida.
¿Cómo se manejan los documentos de orientación mixta?
Para documentos de orientación mixta, procese cada página individualmente con DetectPageOrientation, luego aplique correcciones de rotación página por página antes del OCR. Esto garantiza una orientación adecuada independientemente del estado inicial. He aquí un enfoque eficaz:
// 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)
{
// Load the specific page as its own input and correct it
using var pageInput = new OcrInput();
pageInput.LoadPdfPage("doc.pdf", i);
pageInput.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)
{
// Load the specific page as its own input and correct it
using var pageInput = new OcrInput();
pageInput.LoadPdfPage("doc.pdf", i);
pageInput.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
' Load the specific page as its own input and correct it
Using pageInput = New OcrInput()
pageInput.LoadPdfPage("doc.pdf", i)
pageInput.Rotate(360 - pageResult.RotationAngle)
End Using
End If
Next i' 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
' Load the specific page as its own input and correct it
Using pageInput = New OcrInput()
pageInput.LoadPdfPage("doc.pdf", i)
pageInput.Rotate(360 - pageResult.RotationAngle)
End Using
End If
Next iPara escenarios complejos que involucren documentos escaneados con calidad variable o TIFFs de varias páginas, preprocese cada página individualmente para obtener resultados óptimos.
Al procesar entradas de formato mixto, la Clase OcrResult proporciona información detallada de página, lo que permite manejar errores de manera sofisticada y flujos de trabajo de control de calidad. Para entornos de producción de alto rendimiento, explore las opciones de Configuración rápida de OCR para equilibrar velocidad y precisión.
Si procesa documentos que contienen tanto texto como códigos de barras, use las capacidades de OCR con lectura de códigos de barras y QR de IronOCR para extraer toda la información en un solo paso, mejorando la eficiencia.
Preguntas frecuentes
¿Cómo detecta IronOCR la rotación de páginas?
IronOCR utiliza el método DetectPageOrientation para identificar automáticamente el ángulo de rotación de las páginas en PDFs e imágenes, detectando orientaciones de 0°, 90°, 180° y 270° para asegurar una extracción de texto precisa.
¿Cuál es el propósito de la propiedad RotationAngle en IronOCR?
La propiedad RotationAngle en IronOCR se utiliza para indicar el grado de rotación detectado para cada página. Esto permite a los desarrolladores corregir programáticamente la orientación de las páginas para una representación y extracción de texto precisa.
¿Puede IronOCR manejar rotaciones de página no estándar?
Sí, para imágenes inclinadas más allá de las rotaciones estándar de 0°, 90°, 180° y 270°, IronOCR sugiere utilizar el método Deskew de sus filtros de corrección de imágenes, permitiendo que la imagen se oriente correctamente.
¿Qué es la propiedad HighConfidence en IronOCR?
La propiedad HighConfidence en IronOCR refleja el nivel de confianza en la orientación detectada. Es especialmente útil para documentos con escaneos ambiguos o de baja calidad, donde se podría requerir más validación.
¿Cómo puede IronOCR mejorar la velocidad y precisión de detección?
IronOCR ofrece un parámetro opcional OrientationDetectionMode para DetectPageOrientation, permitiendo a los usuarios ajustar la velocidad y precisión de detección, desde modos Rápido hasta Extremadamente Detallado, según las necesidades del usuario.
¿Esta función funciona mejor con determinados tipos de documentos?
La función DetectPageOrientation de IronOCR funciona mejor con documentos con mucho texto. Para documentos con poco texto o diseños complejos, considere aplicar filtros de corrección de calidad de imagen antes de la detección para obtener resultados óptimos.
¿Cómo limito el uso de memoria al detectar la orientación en archivos PDF grandes?
Pase un valor maxDegreeOfParallelism a la sobrecarga de DetectPageOrientation, por ejemplo, input.DetectPageOrientation(OrientationDetectionMode.Fast, maxDegreeOfParallelism: 2). Esto limita cuántas páginas se analizan al mismo tiempo, y dado que cada página concurrente utiliza su propio motor nativo, limita directamente el pico de memoria. Un valor no positivo revierte a Environment.ProcessorCount.
¿Agregar el parámetro maxDegreeOfParallelism rompe el código existente?
No. La sobrecarga de un solo argumento de DetectPageOrientation no ha cambiado y sigue estando totalmente soportada, por lo que el código existente continúa funcionando sin modificaciones. En el modo Rápido, la detección de orientación también es más eficiente en memoria porque reutiliza un motor por hilo de trabajo en lugar de asignar uno por página, y los resultados no cambian.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.