OCR en Azure vs. IronOCR: ¿Qué solución de reconocimiento óptico de caracteres se adapta mejor a los proyectos .NET?

La pila asíncrona de WinRT

Cada operación básica de OCR con Windows.Media.Ocr requiere navegar a través de múltiples capas de la superficie de la API de WinRT antes de que pueda comenzar el reconocimiento:

// Windows.Media.Ocr: 6+ async steps before receiving any text
// Requires net8.0-windows10.0.19041.0 TFM — will not compile cross-platform

public async Task<string> ExtractTextAsync(string imagePath)
{
    // Step 1: WinRT file system access
    var file = await StorageFile.GetFileFromPathAsync(imagePath);

    // Step 2: Open WinRT stream
    using var stream = await file.OpenAsync(FileAccessMode.Read);

    // Step 3: Create bitmap decoder
    var decoder = await BitmapDecoder.CreateAsync(stream);

    // Step 4: Decode to SoftwareBitmap
    var bitmap = await decoder.GetSoftwareBitmapAsync();

    // Step 5: Check language availability — null if not installed on this machine
    var engine = OcrEngine.TryCreateFromLanguage(
        new Windows.Globalization.Language("en-US"));
    if (engine == null)
        throw new Exception("OCR engine not available for this language");

    // Step 6: Recognize
    var result = await engine.RecognizeAsync(bitmap);
    return result.Text;
}

// Windows.Media.Ocr: 6+ async steps before receiving any text
// Requires net8.0-windows10.0.19041.0 TFM — will not compile cross-platform

public async Task<string> ExtractTextAsync(string imagePath)
{
    // Step 1: WinRT file system access
    var file = await StorageFile.GetFileFromPathAsync(imagePath);

    // Step 2: Open WinRT stream
    using var stream = await file.OpenAsync(FileAccessMode.Read);

    // Step 3: Create bitmap decoder
    var decoder = await BitmapDecoder.CreateAsync(stream);

    // Step 4: Decode to SoftwareBitmap
    var bitmap = await decoder.GetSoftwareBitmapAsync();

    // Step 5: Check language availability — null if not installed on this machine
    var engine = OcrEngine.TryCreateFromLanguage(
        new Windows.Globalization.Language("en-US"));
    if (engine == null)
        throw new Exception("OCR engine not available for this language");

    // Step 6: Recognize
    var result = await engine.RecognizeAsync(bitmap);
    return result.Text;
}

Imports System.Threading.Tasks
Imports Windows.Media.Ocr
Imports Windows.Storage
Imports Windows.Graphics.Imaging
Imports Windows.Storage.Streams
Imports Windows.Globalization

Public Async Function ExtractTextAsync(imagePath As String) As Task(Of String)
    ' Step 1: WinRT file system access
    Dim file As StorageFile = Await StorageFile.GetFileFromPathAsync(imagePath)

    ' Step 2: Open WinRT stream
    Using stream As IRandomAccessStream = Await file.OpenAsync(FileAccessMode.Read)

        ' Step 3: Create bitmap decoder
        Dim decoder As BitmapDecoder = Await BitmapDecoder.CreateAsync(stream)

        ' Step 4: Decode to SoftwareBitmap
        Dim bitmap As SoftwareBitmap = Await decoder.GetSoftwareBitmapAsync()

        ' Step 5: Check language availability — Nothing if not installed on this machine
        Dim engine As OcrEngine = OcrEngine.TryCreateFromLanguage(New Language("en-US"))
        If engine Is Nothing Then
            Throw New Exception("OCR engine not available for this language")
        End If

        ' Step 6: Recognize
        Dim result As OcrResult = Await engine.RecognizeAsync(bitmap)
        Return result.Text
    End Using
End Function

La verificación de nulo en engine no es opcional. Si el paquete de idioma de destino no está instalado en la máquina que ejecuta el código, TryCreateFromLanguage devuelve nulo y el reconocimiento es imposible. No hay plan B; La aplicación debe mostrar un error al usuario o fallar silenciosamente.

Comparación detallada de características

Enfoque de Windows.Media.OCR

La dependencia de WinRT se manifiesta en el archivo del proyecto antes de que se ejecute una sola línea de código. El TargetFramework debe especificar una versión de plataforma de Windows:

<PropertyGroup>
  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
</PropertyGroup>

<PropertyGroup>
  <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
</PropertyGroup>

Con ese TFM, el proyecto no se puede utilizar desde un contenedor Linux. Una imagen Dockerbasada en mcr.microsoft.com/dotnet/aspnet:8.0 — la imagen base estándar de Linuxpara implementaciones ASP.NET — no tiene tiempo de ejecución WinRT. Intentar hacer referencia a tipos Windows.Media.Ocr en un proyecto dirigido a net8.0 (sin sufijo de Windows) produce errores de compilación, no errores de tiempo de ejecución. El bloqueo se impone en el momento de la compilación.

Cuando surgen requisitos de OCR en una arquitectura de microservicios donde el proceso de OCR se ejecuta en Linux, o en una canalización de CI/CD que produce imágenes Dockermultiplataforma, Windows.Media.Ocr no es una opción a evaluar; se descarta antes del primer pico de demanda.

Enfoque de IronOCR

IronOCR se dirige a net6.0, net7.0, net8.0 y net9.0 sin TFMs específicos de plataforma. El mismo paquete NuGet y el mismo archivo binario de la aplicación funcionan en Windows, Linuxy macOS. Implementar IronOCR en Docker requiere una línea apt-get para libgdiplus en la imagen base de Linux, nada más:

FROM mcr.microsoft.com/dotnet/aspnet:8.0
# Linuxdependency for System.Drawing
RUN apt-get update && apt-get install -y libgdiplus

COPY --from=build /app/publish /app
WORKDIR /app
ENTRYPOINT ["dotnet", "YourApp.dll"]

El código de la aplicación en sí no cambia entre las implementaciones de Windows y Linux:

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
// No platform TFM, no WinRT, no conditional compilation
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

// Same code — Windows, Linux, macOS, Docker, AWS Lambda
// No platform TFM, no WinRT, no conditional compilation
using IronOcr;

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";
var text = new IronTesseract().Read("document.jpg").Text;

Imports IronOcr

' Same code — Windows, Linux, macOS, Docker, AWS Lambda
' No platform TFM, no WinRT, no conditional compilation

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim text As String = New IronTesseract().Read("document.jpg").Text

IronOCR se ejecuta en AWS Lambda , Azure Functions en Linux y directamente en servidores Linux sin necesidad de modificar el código. El destino de la implementación es una cuestión de configuración, no una limitación arquitectónica.

Enfoque de Windows.Media.OCR

OcrEngine.TryCreateFromLanguage devuelve nulo cuando el idioma solicitado no está instalado. TryCreateFromUserProfileLanguages devuelve nulo cuando no existe en absoluto ningún paquete de idioma capaz de OCR. Ambos métodos requieren el manejo de valores nulos, y ninguno proporciona una vía de recuperación elegante; no hay forma de instalar un lenguaje desde el código ni de incluirlo en la aplicación:

// Windows.Media.Ocr: language availability is a runtime unknown
// Returns null if the language pack is not installed on this machine

var engine = OcrEngine.TryCreateFromLanguage(
    new Windows.Globalization.Language("fr-FR"));

if (engine == null)
{
    // French OCR is simply unavailable — no recovery path
    // User must go to Windows Settings > Language to install French
    throw new InvalidOperationException(
        "French OCR unavailable. Install the French language pack in Windows Settings.");
}

var result = await engine.RecognizeAsync(bitmap);

// Windows.Media.Ocr: language availability is a runtime unknown
// Returns null if the language pack is not installed on this machine

var engine = OcrEngine.TryCreateFromLanguage(
    new Windows.Globalization.Language("fr-FR"));

if (engine == null)
{
    // French OCR is simply unavailable — no recovery path
    // User must go to Windows Settings > Language to install French
    throw new InvalidOperationException(
        "French OCR unavailable. Install the French language pack in Windows Settings.");
}

var result = await engine.RecognizeAsync(bitmap);

Imports Windows.Globalization
Imports Windows.Media.Ocr

' Windows.Media.Ocr: language availability is a runtime unknown
' Returns Nothing if the language pack is not installed on this machine

Dim engine = OcrEngine.TryCreateFromLanguage(New Language("fr-FR"))

If engine Is Nothing Then
    ' French OCR is simply unavailable — no recovery path
    ' User must go to Windows Settings > Language to install French
    Throw New InvalidOperationException("French OCR unavailable. Install the French language pack in Windows Settings.")
End If

Dim result = Await engine.RecognizeAsync(bitmap)

Para implementar una aplicación de procesamiento de documentos multilingüe con Windows.Media.OCR, es necesario coordinar la instalación del paquete de idioma de Windows en todos los equipos del entorno de implementación. En un servidor compartido o en la máquina de un usuario administrada por la Política de grupo, esto no está bajo el control del desarrollador.

Enfoque de IronOCR

IronOCR distribuye los modelos de lenguaje como paquetes NuGet dedicados que se implementan junto con el binario de la aplicación. Los datos de idioma se transmiten con el artefacto de compilación, no con la configuración del sistema operativo. Soportar más de 125 idiomas es una operación dotnet add package:

dotnet add package IronOcr.Languages.French, IronOcr.Languages.German, IronOcr.Languages.Arabic, IronOcr.Languages.ChineseSimplified

// IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);

// Works on any machine, any OS, zero OS configuration required
var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

// IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
var ocr = new IronTesseract();
ocr.Language = OcrLanguage.French;
ocr.AddSecondaryLanguage(OcrLanguage.German);

// Works on any machine, any OS, zero OS configuration required
var result = ocr.Read("multilingual-document.jpg");
Console.WriteLine(result.Text);

Imports IronOcr

' IronOCR: language availability is a deploy-time guarantee, not a runtime unknown
Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.French
ocr.AddSecondaryLanguage(OcrLanguage.German)

' Works on any machine, any OS, zero OS configuration required
Dim result = ocr.Read("multilingual-document.jpg")
Console.WriteLine(result.Text)

El catálogo completo de idiomas abarca latín, CJK, árabe, hebreo, devanagari, cirílico y conjuntos especializados que incluyen notación matemática. Cada paquete de idioma está vinculado a la versión del paquete IronOCR, por lo que el modelo de idioma en producción coincide con el que se prueba localmente.

Enfoque de Windows.Media.OCR

La API acepta un SoftwareBitmap y devuelve texto. Lo que sucede con la calidad de la imagen entre esos dos puntos no es configurable. Los desarrolladores que necesiten mejorar la precisión en entradas subóptimas deben implementar el preprocesamiento manualmente utilizando las APIs de Windows Imaging Component antes de construir el SoftwareBitmap. Se trata de un código fuente independiente con su propia carga de mantenimiento, y sigue siendo específico de Windows por la misma razón que la propia API de OCR:

// Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
// Skewed, noisy, or low-resolution images degrade accuracy with no remedy
// Manual preprocessing via separate Windows Imaging APIs is the only option

var bitmap = await decoder.GetSoftwareBitmapAsync();
// bitmap goes directly to recognition with no quality improvement
var result = await engine.RecognizeAsync(bitmap);

// Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
// Skewed, noisy, or low-resolution images degrade accuracy with no remedy
// Manual preprocessing via separate Windows Imaging APIs is the only option

var bitmap = await decoder.GetSoftwareBitmapAsync();
// bitmap goes directly to recognition with no quality improvement
var result = await engine.RecognizeAsync(bitmap);

Imports System.Threading.Tasks

' Windows.Media.Ocr: no preprocessing — what you pass is what gets recognized
' Skewed, noisy, or low-resolution images degrade accuracy with no remedy
' Manual preprocessing via separate Windows Imaging APIs is the only option

Dim bitmap = Await decoder.GetSoftwareBitmapAsync()
' bitmap goes directly to recognition with no quality improvement
Dim result = Await engine.RecognizeAsync(bitmap)

Para escaneos de documentos estándar y limpios (entorno de escaneo controlado, iluminación uniforme, mínimo de 300 ppp, orientación correcta), esta limitación es manejable. Para los sistemas de procesamiento de documentos que reciben imágenes de cámaras de teléfonos móviles, escáneres planos con desalineación de alimentación automática, documentos enviados por fax o materiales fotocopiados, esto significa crear una capa de preprocesamiento desde cero o aceptar una degradación de la precisión.

Enfoque de IronOCR

La clase OcrInput de IronOCR proporciona una cadena de preprocesamiento con métodos de filtro individuales que se aplican en secuencia. Los filtros de corrección de calidad de imagen abordan los problemas más comunes que afectan la precisión en el procesamiento de documentos de producción:

// IronOCR: explicit preprocessing pipeline
// Each filter targets a specific quality defect
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();              // Correct page rotation up to ~40 degrees
input.DeNoise();             // Remove scanner speckle and compression artifacts
input.Contrast();            // Boost contrast on faded or washed-out text
input.Binarize();            // Convert to black/white with optimal threshold
input.EnhanceResolution(300); // Scale image to 300 DPI for recognition

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

// IronOCR: explicit preprocessing pipeline
// Each filter targets a specific quality defect
using var input = new OcrInput();
input.LoadImage("low-quality-scan.jpg");

input.Deskew();              // Correct page rotation up to ~40 degrees
input.DeNoise();             // Remove scanner speckle and compression artifacts
input.Contrast();            // Boost contrast on faded or washed-out text
input.Binarize();            // Convert to black/white with optimal threshold
input.EnhanceResolution(300); // Scale image to 300 DPI for recognition

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

Imports IronOcr

' IronOCR: explicit preprocessing pipeline
' Each filter targets a specific quality defect
Using input As New OcrInput()
    input.LoadImage("low-quality-scan.jpg")

    input.Deskew()              ' Correct page rotation up to ~40 degrees
    input.DeNoise()             ' Remove scanner speckle and compression artifacts
    input.Contrast()            ' Boost contrast on faded or washed-out text
    input.Binarize()            ' Convert to black/white with optimal threshold
    input.EnhanceResolution(300) ' Scale image to 300 DPI for recognition

    Dim result = New IronTesseract().Read(input)
    Console.WriteLine($"Confidence: {result.Confidence}%")
End Using

Para el caso común,IronOCR aplica preprocesamiento automático al llamar Read directamente en una ruta de archivo — el motor detecta problemas de calidad y los corrige sin configuración explícita de filtro. El tutorial de filtros de imagen cubre todo el conjunto de filtros, incluyendo Sharpen, Dilate, Erode, Invert y ToGrayScale para escenarios especializados. Los filtros de corrección de color y la corrección de orientación amplían aún más el proceso para documentos con perfiles de color no estándar o rotación multiángulo.

Enfoque de Windows.Media.OCR

La API no incluye ninguna ruta para archivos PDF. Para hacer OCR a un PDF escaneado con Windows.Media.Ocr, el desarrollador debe: renderizar cada página en un SoftwareBitmap usando una biblioteca de renderizado de PDF separada (ninguna de las cuales está integrada en Windows), iterar páginas, llamar RecognizeAsync por página, y concatenar los resultados manualmente. Dicha biblioteca de renderizado conlleva consideraciones adicionales en cuanto a licencias e implementación. El código Windows.Media.OCR es la parte más pequeña de la implementación total:

// Windows.Media.Ocr: no PDF support
// Requires external PDF renderer to rasterize pages before OCR
// Conceptual pattern — a PDF rendering library is not provided by Windows APIs

// Step 1: Use external PDF library to render page to bitmap (not shown)
// Step 2: Pass rendered bitmap to Windows OCR
// var bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex); // external library required

var engine = OcrEngine.TryCreateFromUserProfileLanguages();
if (engine == null)
    throw new Exception("No OCR language available");

// Step 3: Recognize the rasterized page
// var result = await engine.RecognizeAsync(bitmap);
// Step 4: Collect and concatenate results across all pages manually

// Windows.Media.Ocr: no PDF support
// Requires external PDF renderer to rasterize pages before OCR
// Conceptual pattern — a PDF rendering library is not provided by Windows APIs

// Step 1: Use external PDF library to render page to bitmap (not shown)
// Step 2: Pass rendered bitmap to Windows OCR
// var bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex); // external library required

var engine = OcrEngine.TryCreateFromUserProfileLanguages();
if (engine == null)
    throw new Exception("No OCR language available");

// Step 3: Recognize the rasterized page
// var result = await engine.RecognizeAsync(bitmap);
// Step 4: Collect and concatenate results across all pages manually

' Windows.Media.Ocr: no PDF support
' Requires external PDF renderer to rasterize pages before OCR
' Conceptual pattern — a PDF rendering library is not provided by Windows APIs

' Step 1: Use external PDF library to render page to bitmap (not shown)
' Step 2: Pass rendered bitmap to Windows OCR
' Dim bitmap = RenderPdfPageToBitmap(pdfPath, pageIndex) ' external library required

Dim engine = OcrEngine.TryCreateFromUserProfileLanguages()
If engine Is Nothing Then
    Throw New Exception("No OCR language available")
End If

' Step 3: Recognize the rasterized page
' Dim result = Await engine.RecognizeAsync(bitmap)
' Step 4: Collect and concatenate results across all pages manually

El paso de generación de PDF externo por sí solo añade una dependencia, una curva de aprendizaje independiente y una superficie de fallo adicional a lo que comenzó como una solución "gratuita e integrada".

Enfoque de IronOCR

IronOCR lee archivos PDF de forma nativa. Sin renderizador externo, sin paso de rasterización, sin ensamblaje manual de páginas. El mismo método IronTesseract.Read que acepta rutas de imagen acepta rutas de PDF. El OCR de PDF en .NET es una sola línea:

// IronOCR: native PDF support — no external renderer needed
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// Password-protected PDFs
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// PDF con función de búsqueda output: make a scanned PDF text-searchable
var ocrResult = new IronTesseract().Read("scanned-archive.pdf");
ocrResult.SaveAsSearchablePdf("searchable-output.pdf");

// IronOCR: native PDF support — no external renderer needed
var text = new IronTesseract().Read("scanned-document.pdf").Text;

// Password-protected PDFs
using var input = new OcrInput();
input.LoadPdf("encrypted.pdf", Password: "secret");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// PDF con función de búsqueda output: make a scanned PDF text-searchable
var ocrResult = new IronTesseract().Read("scanned-archive.pdf");
ocrResult.SaveAsSearchablePdf("searchable-output.pdf");

Imports IronOcr

' IronOCR: native PDF support — no external renderer needed
Dim text As String = New IronTesseract().Read("scanned-document.pdf").Text

' Password-protected PDFs
Using input As New OcrInput()
    input.LoadPdf("encrypted.pdf", Password:="secret")
    Dim result = New IronTesseract().Read(input)
    Console.WriteLine(result.Text)
End Using

' PDF con función de búsqueda output: make a scanned PDF text-searchable
Dim ocrResult = New IronTesseract().Read("scanned-archive.pdf")
ocrResult.SaveAsSearchablePdf("searchable-output.pdf")

La función de PDF con capacidad de búsqueda inserta una capa de texto sobre la imagen escaneada original, lo que produce un PDF que conserva la fidelidad visual a la vez que permite la búsqueda de texto completo y la función de copiar y pegar. Este es un requisito común para los sistemas de gestión documental y los archivos de cumplimiento normativo. Windows.Media.OCR no puede producir esta salida en ninguna capa de su API.

La aplicación supera las capacidades del escritorio de Windows.

El desencadenante más común es un cambio en los requisitos que introduce un destino de implementación distinto a Windows. Una utilidad de escritorio que comienza como una herramienta interna de Windows se convierte en un servicio web, un microservicio basado en Dockero una función en la nube. En el momento en que eso sucede, Windows.Media.OCR se convierte en un obstáculo. El componente OCR requiere una reescritura completa porque la API no existe en la plataforma de destino; no hay ningún puerto, ningún adaptador de compatibilidad ni ninguna bandera de compilación condicional que solucione el problema. Los equipos que planificaron con antelación utilizando IronOCR no se enfrentan a esta reescritura.

Los requisitos de idioma superan los paquetes instalados.

Los procesos de gestión de documentos suelen ampliar su alcance. Un sistema diseñado para procesar facturas en inglés recibe ahora el requisito de gestionar documentos en francés, alemán, árabe o japonés. Con Windows.Media.OCR, la compatibilidad con esos idiomas requiere coordinar la instalación del paquete de idioma del sistema operativo en todos los destinos de implementación: máquinas de desarrolladores, máquinas virtuales de prueba, servidores de producción y cualquier contenedor incluido. En entornos gestionados mediante directivas de grupo o en máquinas virtuales en la nube con una mínima huella del sistema operativo, esa coordinación resulta poco práctica. Los paquetes de idioma de IronOCR, basados ​​en NuGet, se implementan con la aplicación y no requieren coordinación con el sistema operativo.

Se añade el procesamiento de PDF al alcance.

Cuando el requisito original era "imágenes OCR de un escáner plano", Windows.Media.Ocr funciona. Cuando el requisito se amplía a "procesar también el cúmulo de archivos PDF escaneados en nuestro archivo", se añade una segunda biblioteca al proceso. Esa biblioteca supone una dependencia adicional, una consideración adicional en materia de licencias y una superficie de fallo adicional. Los equipos que necesitan reconocimiento óptico de caracteres (OCR) tanto para imágenes como para PDF en una API unificada descubren que IronOCR elimina la arquitectura de dos bibliotecas desde el principio.

La precisión se degrada con la entrada de datos del mundo real.

Los entornos de escaneo controlados producen imágenes nítidas. Los datos de entrada del mundo real (fotografías tomadas con teléfonos móviles, escaneos planos ligeramente sesgados, documentos antiguos recibidos por fax, materiales fotocopiados) producen una degradación de la precisión que no tiene solución en Windows.Media.OCR. Cuando empiezan a llegar las quejas de los clientes sobre textos que faltan, los equipos descubren que el paso de preprocesamiento que omitieron se ha vuelto necesario. Adaptar el preprocesamiento mediante las API de imágenes de Windows supone un esfuerzo de desarrollo considerable que limita la solución exclusivamente a Windows. El proceso de preprocesamiento de IronOCR ya está implementado.

Surge la pregunta sobre la implementación del servidor.

La documentación de Windows.Media.OCR especifica claramente la ubicación de la API para las aplicaciones cliente. Ejecutarlo en un contexto de servidor (una aplicación ASP.NET que procesa documentos subidos por el usuario, un servicio de Windows que consume una cola de documentos) requiere un entorno de Servidor Windowscon Desktop Experience instalado, que es un perfil de máquina virtual más pesado y costoso que un contenedor Linux. Cuando el equipo de infraestructura pregunta si el proceso de OCR puede ejecutarse en una instancia de Linuxpara reducir los costos de alojamiento, la respuesta con Windows.Media.Ocr es no.

Cambio en el archivo TFM del proyecto

Windows.Media.Ocr requiere un TFM específico de Windows en el archivo de proyecto (net8.0-windows10.0.19041.0 o similar). Eliminar esa dependencia para admitir objetivos multiplataforma implica eliminar el sufijo TFM.IronOCR se dirige a net6.0, net8.0, y net9.0 sin sufijos específicos de Windows. Al migrar, confirme que ninguna otra dependencia de la API WinRT en el proyecto requiera el TFM de Windows; es posible que otras características de la plataforma Windows (integración con el shell, notificaciones de Windows, etc.) deban abstraerse mediante comprobaciones de la plataforma.

Migración de asíncrona a síncrona

Windows.Media.Ocr es completamente async — RecognizeAsync devuelve IAsyncOperation<OcrResult> que se mapea a Task<OcrResult> a través de la interoperabilidad WinRT.IronOCR proporciona rutas tanto sincrónicas como asincrónicas. El ocr.Read("file.jpg") sincrónico reemplaza directamente la cadena de espera de múltiples pasos. Para aplicaciones de servidor en las que la llamada OCR se encuentra dentro de un servicio en segundo plano o una canalización basada en tareas, también está disponible la ruta asíncrona. En cualquier caso, la transición de más de 6 pasos asíncronos a una sola llamada es sencilla:

// Before: Windows.Media.Ocr — 6+ await operations
var file = await StorageFile.GetFileFromPathAsync(imagePath);
using var stream = await file.OpenAsync(FileAccessMode.Read);
var decoder = await BitmapDecoder.CreateAsync(stream);
var bitmap = await decoder.GetSoftwareBitmapAsync();
var engine = OcrEngine.TryCreateFromUserProfileLanguages();
var winResult = await engine.RecognizeAsync(bitmap);
string text = winResult.Text;

// After:IronOCR— 1 call, same result, any platform
string text = new IronTesseract().Read(imagePath).Text;

// Before: Windows.Media.Ocr — 6+ await operations
var file = await StorageFile.GetFileFromPathAsync(imagePath);
using var stream = await file.OpenAsync(FileAccessMode.Read);
var decoder = await BitmapDecoder.CreateAsync(stream);
var bitmap = await decoder.GetSoftwareBitmapAsync();
var engine = OcrEngine.TryCreateFromUserProfileLanguages();
var winResult = await engine.RecognizeAsync(bitmap);
string text = winResult.Text;

// After:IronOCR— 1 call, same result, any platform
string text = new IronTesseract().Read(imagePath).Text;

Imports Windows.Storage
Imports Windows.Graphics.Imaging
Imports Windows.Media.Ocr

' Before: Windows.Media.Ocr — 6+ await operations
Dim file As StorageFile = Await StorageFile.GetFileFromPathAsync(imagePath)
Using stream = Await file.OpenAsync(FileAccessMode.Read)
    Dim decoder As BitmapDecoder = Await BitmapDecoder.CreateAsync(stream)
    Dim bitmap = Await decoder.GetSoftwareBitmapAsync()
    Dim engine = OcrEngine.TryCreateFromUserProfileLanguages()
    Dim winResult = Await engine.RecognizeAsync(bitmap)
    Dim text As String = winResult.Text
End Using

' After: IronOCR— 1 call, same result, any platform
Dim text As String = New IronTesseract().Read(imagePath).Text

Sustitución del paquete de idiomas

Para cada idioma previamente resuelto a través de OcrEngine.TryCreateFromLanguage(new Windows.Globalization.Language("fr-FR")), instale el paquete de idiomas de IronOCR correspondiente y establezca ocr.Language = OcrLanguage.French. El catálogo de idiomas de IronOCR incluye los más de 125 paquetes disponibles. Los códigos de idioma se asignan directamente de etiquetas BCP-47 al enum OcrLanguage.

Eliminación del manejo del motor nulo

Windows.Media.OCR requiere una comprobación de nulidad en cada llamada de creación del motor.IronOCR genera excepciones estructuradas en lugar de devolver null en caso de fallos de configuración o inicialización. Elimine las cláusulas de protección contra valores nulos y sustitúyalas por el manejo de excepciones estándar donde sea necesario. El resultado es un sitio de llamadas más limpio y sin el modo de fallo de "idioma no disponible silenciosamente".