Próby oprogramowania OCR: Odkryj najlepsze opcje

Wzorzec inicjalizacji silnika

Każda integracja OmniPage rozpoczyna się od cyklu życia silnika, który obejmuje cały proces przetwarzania dokumentów w aplikacji:

// OmniPage: Engine must be initialized before any operations
// License file must exist at this path on every target machine
using var engine = new OmniPageEngine();
engine.SetLicenseFile(@"C:\Program Files\OmniPage\license.lic");
engine.Initialize();  // Contacts license server; loads 100MB+ of native components

// Configure recognition settings for the document
var settings = new RecognitionSettings
{
    PrimaryLanguage = "English",
    SecondaryLanguages = new[] { "German", "French" },
    AccuracyMode = "Maximum",
    PreserveLayout = true,
    DetectTables = true,
    DespeckleLevel = 2,
    ContrastEnhancement = true,
    AutoRotate = true,
    DeskewImage = true
};

// Document-centric workflow
var document = engine.CreateDocument();
document.AddPage(imagePath);
document.Recognize(settings);
string text = document.GetText();

// Explicit cleanup — omitting this can lock the license
document.Dispose();
engine.Shutdown();

// OmniPage: Engine must be initialized before any operations
// License file must exist at this path on every target machine
using var engine = new OmniPageEngine();
engine.SetLicenseFile(@"C:\Program Files\OmniPage\license.lic");
engine.Initialize();  // Contacts license server; loads 100MB+ of native components

// Configure recognition settings for the document
var settings = new RecognitionSettings
{
    PrimaryLanguage = "English",
    SecondaryLanguages = new[] { "German", "French" },
    AccuracyMode = "Maximum",
    PreserveLayout = true,
    DetectTables = true,
    DespeckleLevel = 2,
    ContrastEnhancement = true,
    AutoRotate = true,
    DeskewImage = true
};

// Document-centric workflow
var document = engine.CreateDocument();
document.AddPage(imagePath);
document.Recognize(settings);
string text = document.GetText();

// Explicit cleanup — omitting this can lock the license
document.Dispose();
engine.Shutdown();

Imports OmniPage

' OmniPage: Engine must be initialized before any operations
' License file must exist at this path on every target machine
Using engine As New OmniPageEngine()
    engine.SetLicenseFile("C:\Program Files\OmniPage\license.lic")
    engine.Initialize()  ' Contacts license server; loads 100MB+ of native components

    ' Configure recognition settings for the document
    Dim settings As New RecognitionSettings With {
        .PrimaryLanguage = "English",
        .SecondaryLanguages = {"German", "French"},
        .AccuracyMode = "Maximum",
        .PreserveLayout = True,
        .DetectTables = True,
        .DespeckleLevel = 2,
        .ContrastEnhancement = True,
        .AutoRotate = True,
        .DeskewImage = True
    }

    ' Document-centric workflow
    Dim document = engine.CreateDocument()
    document.AddPage(imagePath)
    document.Recognize(settings)
    Dim text As String = document.GetText()

    ' Explicit cleanup — omitting this can lock the license
    document.Dispose()
    engine.Shutdown()
End Using

Ten schemat musi być powtórzony dla każdego punktu integracji: procedury obsługi żądań ASP.NET, usługi Windows, zadania przetwarzania wsadowego i testy jednostkowe – wszystkie muszą zarządzać cyklem życia silnika. W konfiguracji licencji dynamicznej, zapomnienie Shutdown() w ścieżce błędu blokuje miejsce licencji dla innych procesów do momentu ponownego uruchomienia serwera.

Szczegółowe porównanie funkcji

Podejście Kofax OmniPage

Proces pozyskiwania OmniPage przebiega według ustalonej sekwencji, której żaden programista nie może pominąć:

Kroki wdrażania OmniPage (z pliku źródłowego kofax-enterprise-ocr.cs):

1.  Pełny proces sprzedaży (4–12 tygodni)
2.  Pobierz instalator SDK od Tungsten
3.  Zainstaluj SDK na komputerach programistycznych
4.  Skonfiguruj pliki licencji (na komputer lub pływające)
5.  Skonfiguruj serwer licencji (jeśli korzystasz z licencji sieciowych)
6.  Zainstaluj komponenty środowiska uruchomieniowego na serwerach produkcyjnych
7.  Wdrożenie plików licencyjnych do środowiska produkcyjnego
8.  Skonfiguruj zaporę sieciową do komunikacji z serwerem licencji
9.  Skonfiguruj monitorowanie dostępności licencji
10. Procedury wyłączania dokumentów w celu zwolnienia licencji

Kroki 5, 8 i 9 nie są zadaniami dla programistów — wymagają koordynacji z zespołami ds. infrastruktury i bezpieczeństwa. Krok 7 oznacza, że każda produkcyjna instalacja wymaga obecności pliku .lic pod stałą ścieżką. Krok 10 istnieje, ponieważ zapomnienie Shutdown() w jakiejkolwiek ścieżce kodu blokuje miejsce licencji dynamicznej na czas nieokreślony.

Model licencjonowania na stronę stanowi dodatkowy element zwiększający złożoność operacyjną. Raporty dotyczące użytkowania trafiają do serwera licencji, rozliczenia odbywają się co miesiąc lub co kwartał, a każdy nieoczekiwany wzrost liczby dokumentów (nowy klient, przetworzone zaległości) generuje fakturę za nadwyżkę, której nikt nie uwzględnił w budżecie.

Podejście IronOCR

// Step 1: Install
// dotnet add package IronOcr

// Step 2: Configure license (one line at startup)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

// Step 3: Read a document
var text = new IronTesseract().Read("document.jpg").Text;

// Step 1: Install
// dotnet add package IronOcr

// Step 2: Configure license (one line at startup)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

// Step 3: Read a document
var text = new IronTesseract().Read("document.jpg").Text;

' Step 1: Install
' dotnet add package IronOcr

' Step 2: Configure license (one line at startup)
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

' Step 3: Read a document
Dim text As String = (New IronTesseract()).Read("document.jpg").Text

Brak instalatora. Bez odniesień do bibliotek DLL. Brak pliku licencji na dysku. Brak serwera licencji. Brak reguł zapory sieciowej. Brak procedury wyłączania. Klucz licencji to ciąg — przechowuj go w zmiennej środowiskowej, appsettings.json lub Azure Key Vault. Zmiana miejsc wdrożenia (na przykład z maszyny wirtualnej Windows na kontenerDockerw systemie Linux) nie wymaga ponownej konfiguracji licencji.

Podręcznik konfiguracji IronTesseract obejmuje wszystkie opcje konfiguracyjne, w tym wstrzykiwanie kluczy oparte na zmiennych środowiskowych, które całkowicie usuwa ciągi licencyjne z kodu źródłowego.

Podejście Kofax OmniPage

Model dystrybucji oparty na instalatorze OmniPage tworzy tarcie na każdym etapie nowoczesnego wdrożenia. Budowanie konteneraDockerwymaga uruchomienia niestandardowego instalatora SDK wewnątrz obrazu, włączenia pliku licencji w czasie rzeczywistym i wykonania engine.Shutdown() przed zatrzymaniem kontenera. Ponowne uruchomienie podu Kubernetes, które nie powoduje prawidłowego zamknięcia silnika OmniPage, może spowodować zablokowanie licencji pływających do momentu wygaśnięcia limitu czasu serwera licencji (zazwyczaj 30–60 minut).

W potokach CI/CD każdy agent, który uruchamia testy integracyjne, musi mieć zainstalowany zestaw SDK i dostępny ważny plik licencji. Równoległość testów jest ograniczona liczbą licencjonowanych stanowisk. W modelu OmniPage opartym na liczbie stron automatyczne testy zużywają strony podlegające rozliczeniu.

Przestrzeń nazw Kofax.OmniPage.CSDK jest odwołana poprzez dodanie ścieżek DLL ręcznie, a nie za pomocą menedżera pakietów. Aktualizacja do nowej wersji SDK oznacza ponowne uruchomienie instalatora na każdym komputerze deweloperskim, agencie budowy i serwerze produkcyjnym — a nie zwiększanie numeru wersji w pliku .csproj.

Podejście IronOCR

<PackageReference Include="IronOcr" Version="2024.x.x" />

<PackageReference Include="IronOcr" Version="2024.x.x" />

# Docker: no installer, no license file mount required
FROM mcr.microsoft.com/dotnet/aspnet:8.0
RUN apt-get update && apt-get install -y libgdiplus
COPY --from=build /app/publish /app
WORKDIR /app
ENTRYPOINT ["dotnet", "YourApp.dll"]

Przewodnik dotyczący wdrażania na Docker obejmuje jedną zależność Linuksa (libgdiplus do renderowania obrazów) i nic więcej. Ten sam pakiet NuGet działa na systemie Linux, AWS Lambda i Azure App Service bez konieczności konfiguracji specyficznej dla danej platformy. Pipelines CI/CD przywracają pakiet poprzez dotnet restore w ten sam sposób, w jaki przywraca się każdą inną zależność — brak kroków instalatora, brak zarządzania plikami licencji, brak ograniczeń liczby miejsc przy testowaniu równoległym.

Podejście Kofax OmniPage

Sekwencja sprawdzania licencji OmniPage tworzy wiele trybów awarii, które nie mają nic wspólnego z OCR:

// OmniPage: License validation at engine startup
// Each of these can fail independently
public static void InitializeWithLicense(string licensePath)
{
    // Failure mode 1: File missing (deployment error, path misconfiguration)
    if (!File.Exists(licensePath))
        throw new LicenseException("License file not found");

    // Failure mode 2: File permissions (service account lacks read access)
    try { using var stream = File.OpenRead(licensePath); }
    catch (UnauthorizedAccessException)
    {
        throw new LicenseException("Cannot read license file — check permissions");
    }

    // Failure mode 3: License server unreachable (network partition, server restart)
    var engine = new OmniPageEngine();
    engine.SetLicenseFile(licensePath);

    try
    {
        engine.Initialize(); // Network call to license server
    }
    catch (LicenseValidationException ex)
    {
        // Could be: expired, invalid hardware, concurrent seat limit exceeded,
        // license server unreachable, or maintenance window
        throw new LicenseException($"License validation failed: {ex.Message}");
    }
}

// OmniPage: License validation at engine startup
// Each of these can fail independently
public static void InitializeWithLicense(string licensePath)
{
    // Failure mode 1: File missing (deployment error, path misconfiguration)
    if (!File.Exists(licensePath))
        throw new LicenseException("License file not found");

    // Failure mode 2: File permissions (service account lacks read access)
    try { using var stream = File.OpenRead(licensePath); }
    catch (UnauthorizedAccessException)
    {
        throw new LicenseException("Cannot read license file — check permissions");
    }

    // Failure mode 3: License server unreachable (network partition, server restart)
    var engine = new OmniPageEngine();
    engine.SetLicenseFile(licensePath);

    try
    {
        engine.Initialize(); // Network call to license server
    }
    catch (LicenseValidationException ex)
    {
        // Could be: expired, invalid hardware, concurrent seat limit exceeded,
        // license server unreachable, or maintenance window
        throw new LicenseException($"License validation failed: {ex.Message}");
    }
}

Imports System.IO

' OmniPage: License validation at engine startup
' Each of these can fail independently
Public Shared Sub InitializeWithLicense(licensePath As String)
    ' Failure mode 1: File missing (deployment error, path misconfiguration)
    If Not File.Exists(licensePath) Then
        Throw New LicenseException("License file not found")
    End If

    ' Failure mode 2: File permissions (service account lacks read access)
    Try
        Using stream = File.OpenRead(licensePath)
        End Using
    Catch ex As UnauthorizedAccessException
        Throw New LicenseException("Cannot read license file — check permissions")
    End Try

    ' Failure mode 3: License server unreachable (network partition, server restart)
    Dim engine As New OmniPageEngine()
    engine.SetLicenseFile(licensePath)

    Try
        engine.Initialize() ' Network call to license server
    Catch ex As LicenseValidationException
        ' Could be: expired, invalid hardware, concurrent seat limit exceeded,
        ' license server unreachable, or maintenance window
        Throw New LicenseException($"License validation failed: {ex.Message}")
    End Try
End Sub

Podział sieci pomiędzy serwerem aplikacji a serwerem licencji powoduje niepowodzenie każdej próby engine.Initialize() do momentu rozwiązania podziału, niezależnie od tego, czy licencja była wcześniej zweryfikowana na tym komputerze. Licencjonowanie per strona dodaje czwarty tryb awarii: wyczerpanie limitu stron w połowie partii.

Podejście IronOCR

// One line at application startup
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

// Optional: verify license status
bool isLicensed = IronOcr.License.IsLicensed;

// Works offline — no license server, no network calls at runtime
var text = new IronTesseract().Read("document.jpg").Text;

// One line at application startup
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

// Optional: verify license status
bool isLicensed = IronOcr.License.IsLicensed;

// Works offline — no license server, no network calls at runtime
var text = new IronTesseract().Read("document.jpg").Text;

Imports IronOcr

' One line at application startup
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

' Optional: verify license status
Dim isLicensed As Boolean = IronOcr.License.IsLicensed

' Works offline — no license server, no network calls at runtime
Dim text As String = New IronTesseract().Read("document.jpg").Text

IronOCR weryfikuje klucz licencyjny lokalnie. Podczas operacji OCR nie są wykonywane żadne wywołania sieciowe. Serwer produkcyjny, który po uruchomieniu traci dostęp do Internetu, kontynuuje przetwarzanie dokumentów bez zakłóceń. Strona licencyjna obejmuje wszystkie poziomy: $999 Lite do użytku jednego dewelopera dla jednego projektu aż po $5,999 Unlimited dla zespołów bez ograniczeń deweloperów lub projektów.

Klucz może pochodzić z zmiennej środowiskowej (IRONOCR_LICENSE_KEY) bez zmian w kodzie, co ułatwia korzystanie z różnych kluczy w środowiskach deweloperskim, testowym i produkcyjnym bez modyfikowania wdrożonych binariów.

Podejście Kofax OmniPage

Historia własności OmniPage od 2001 r.: Caere → Nuance → Kofax → Tungsten Automation. Każde przejęcie wiązało się z okresem przejściowym, w którym adresy URL dokumentacji przestały działać, zmieniły się kanały wsparcia, zreorganizowano sieci partnerskie, a umowy licencyjne dla przedsiębiorstw wymagały renegocjacji na nowych warunkach. Wydanie OmniPage Capture SDK 2025.3 ze stycznia 2026 r. (które dodało obsługę systemu Linux) potwierdza aktywny rozwój, ale rebranding Tungsten Automation ma mniej niż dwa lata, a dokumentacja planu rozwoju produktu była wymieniona jako "w trakcie przeglądu" podczas tej transformacji.

Dla zespołów kupujących 3–5-letnie umowy korporacyjne pytanie nie brzmi, czy OmniPage działa dzisiaj — bo działa — ale czy priorytety strategiczne Tungsten Automation w 2028 r. są zgodne z aktualnym planem rozwoju produktu. Przejęcia oprogramowania korporacyjnego często skutkują przejściem przejętych produktów w tryb utrzymania, gdy priorytety nabywcy w zakresie planu rozwoju przesuwają się w kierunku własnych komponentów platformy.

Sama migracja dokumentacji powoduje utrudnienia operacyjne: zgłoszenia do pomocy technicznej z czasów Kofax, zakładki w dokumentacji i posty na forach społeczności odwołujące się do starych struktur adresów URL nie działają już poprawnie, co utrudnia korzystanie z pomocy technicznej właśnie w momencie, gdy programiści najbardziej jej potrzebują (podczas incydentów i złożonych integracji).

Podejście IronOCR

Iron Software to firma zajmująca się narzędziami dla deweloperów, której cała linia produktów to biblioteki .NET. IronOCR, IronPDF, IronBarcode i powiązane produkty stanowią podstawową działalność firmy — nie są to produkty przejęte i włączone do większej platformy automatyzacji przedsiębiorstwa. Historia wydań pokazuje regularne aktualizacje dostosowane do cyklu wydawniczego .NET (obsługa .NET 8, .NET 9 i dążenie do kompatybilności z .NET 10). Centrum dokumentacji i samouczki są utrzymywane pod stałymi adresami URL z treściami specyficznymi dla danej wersji.

Osiągnięto pułap budżetu

Zespół korporacyjny korzystający z OmniPage do przetwarzania umów napotyka naturalny limit, gdy rośnie liczba dokumentów, a wraz z nią rosną koszty licencji za stronę. Opłaty za działanie kumulują się rocznie na licencję SDK i konserwację. Biznesowa opłacalność jednorazowej licencji IronOCR Professional staje się jasna: licencja wieczysta szybko się opłaca w porównaniu do bieżących opłat za stronę. Zespoły zajmujące się tym zadaniem zazwyczaj przeprowadzają równoległą weryfikację dokładności na 1000 reprezentatywnych dokumentów, stwierdzają, że różnica w dokładności między OmniPage a IronOCR wynosi poniżej 1% w przypadku standardowych faktur i umów, a migrację kończą w mniej niż dwa tygodnie.

Harmonogram zamówień blokuje dostawę produktu

Startup lub średniej wielkości firma tworząca funkcję digitalizacji dokumentów odkrywa, że dostawca OCR, wymagający 4–12 tygodni współpracy handlowej, nie zdąży na termin premiery produktu. Menedżer produktu nie ma 8 tygodni na realizację zamówienia.IronOCR instaluje się z NuGet w 30 sekund; Klucz licencyjny ze strony produktu IronOCR jest dostępny w trybie samoobsługowym. Funkcja jest dostarczana. Ten scenariusz nie jest hipotetyczny — jest to najczęstszy powód, dla którego zespoły programistów dokumentują swoje wybory technologiczne, wyjaśniając je kierownictwu inżynieryjnemu po fakcie.

Zmiany w topologii wdrożenia

Zespół korzystający z OmniPage na serwerach Windows decyduje się na migrację do wdrożenia kontenerowego w Kubernetes. Instalator OmniPage SDK nie pasuje idealnie do potoku kompilacji Docker, plik licencji musi zostać zamontowany lub wbudowany w obraz (oba rozwiązania mają konsekwencje dla bezpieczeństwa), a ponowne uruchomienie kontenera wymaga prawidłowego zarządzania cyklem życia silnika (wyłączanie/uruchamianie). Skalowanie horyzontalne do 10 kontenerów wymaga 10 licencji typu floating lub 10 licencji typu node-locked. Model wdrażania IronOCR w NuGet, klucze licencyjne oparte na zmiennych środowiskowych oraz weryfikacja licencji w trybie offline sprawiają, że wdrażanie w kontenerach jest proste. Dokumentacja wdrożenia Docker obejmuje kompletną konfigurację, a skalowanie horyzontalne nie wymaga żadnych dodatkowych działań licencyjnych — Unlimited License obejmuje nieograniczoną liczbę wdrożeń.

Wymóg ICR znika

Wiele zespołów początkowo wdraża OmniPage, ponieważ wśród wymagań interesariuszy znalazła się funkcja "rozpoznawania pisma ręcznego". Kiedy zakres tego wymagania zostanie określony — a rzeczywistą potrzebą okażą się drukowane formularze z polami wyboru, a nie pola do ręcznego wpisywania — uzasadnienie ICR dla cen Enterprise znika.IronOCR obsługuje wykrywanie pól wyboru dzięki funkcjom zbliżonym do OMR oraz ekstrakcję danych strukturalnych za ułamek kosztów. Zespoły, które często dokonują ponownej oceny swojego rzeczywistego zbioru dokumentów, często stwierdzają, że ponad 95% ich objętości stanowią wydrukowane pliki PDF i zeskanowane faktury, w przypadku których zalety ICR programu OmniPage nigdy nie są wykorzystywane.

Niepewność związana z przejęciem firmy Tungsten powoduje przegląd ryzyka

Zespoły ds. zamówień w Enterprise przeprowadzają okresowe przeglądy ryzyka dostawców. Kiedy dostawca narzędzi zmienił właściciela cztery razy w ciągu 25 lat, ostatnia zmiana marki miała miejsce niecałe dwa lata temu, a dokumentacja planu rozwoju produktu została oznaczona jako "w trakcie przeglądu" podczas okresu przejściowego, niektóre zespoły decydują się na zmniejszenie ryzyka koncentracji dostawców poprzez przeniesienie obciążenia do stabilnego, wyspecjalizowanego dostawcy narzędzi programistycznych. Jest to decyzja zarówno biznesowa, jak i techniczna — dokładność OCR IronOCR w przypadku standardowych dokumentów biznesowych jest konkurencyjna w stosunku do OmniPage, a migracja eliminuje dyskusję na temat przedłużenia umowy Enterprise z rocznego cyklu budżetowego.

Cykl życia silnika do wywołań bezstanowych

Integracje z OmniPage są zbudowane na bazie długotrwałej instancji OmniPageEngine, którą trzeba zainicjować podczas uruchamiania i zamknąć po zakończeniu procesu.IronOCR nie ma odpowiednika w cyklu życia. Klasa IronTesseract jest instancjonowana przy każdym wywołaniu lub udostępniana jako długotrwała usługa — oba wzorce działają.

// OmniPage pattern: service class with engine lifecycle
public class KofaxDocumentService : IDisposable
{
    private OmniPageEngine _engine;

    public KofaxDocumentService(string licensePath)
    {
        _engine = new OmniPageEngine();
        _engine.SetLicenseFile(licensePath);
        _engine.Initialize();
    }

    public string ProcessDocument(string imagePath)
    {
        var document = _engine.CreateDocument();
        document.AddPage(imagePath);
        document.Recognize(new RecognitionSettings { Language = "English" });
        string text = document.GetText();
        document.Dispose();  // Must not be forgotten
        return text;
    }

    public void Dispose()
    {
        _engine.Shutdown();  // Must not be forgotten
    }
}

//IronOCR equivalent: no lifecycle management needed
public class IronOcrDocumentService
{
    private readonly IronTesseract _ocr;

    public IronOcrDocumentService()
    {
        _ocr = new IronTesseract();
        _ocr.Language = OcrLanguage.English;
    }

    public string ProcessDocument(string imagePath)
    {
        using var input = new OcrInput();
        input.LoadImage(imagePath);
        return _ocr.Read(input).Text;
    }
    // Nie Dispose — no unmanaged resources to release
}

// OmniPage pattern: service class with engine lifecycle
public class KofaxDocumentService : IDisposable
{
    private OmniPageEngine _engine;

    public KofaxDocumentService(string licensePath)
    {
        _engine = new OmniPageEngine();
        _engine.SetLicenseFile(licensePath);
        _engine.Initialize();
    }

    public string ProcessDocument(string imagePath)
    {
        var document = _engine.CreateDocument();
        document.AddPage(imagePath);
        document.Recognize(new RecognitionSettings { Language = "English" });
        string text = document.GetText();
        document.Dispose();  // Must not be forgotten
        return text;
    }

    public void Dispose()
    {
        _engine.Shutdown();  // Must not be forgotten
    }
}

//IronOCR equivalent: no lifecycle management needed
public class IronOcrDocumentService
{
    private readonly IronTesseract _ocr;

    public IronOcrDocumentService()
    {
        _ocr = new IronTesseract();
        _ocr.Language = OcrLanguage.English;
    }

    public string ProcessDocument(string imagePath)
    {
        using var input = new OcrInput();
        input.LoadImage(imagePath);
        return _ocr.Read(input).Text;
    }
    // Nie Dispose — no unmanaged resources to release
}

Imports System

' OmniPage pattern: service class with engine lifecycle
Public Class KofaxDocumentService
    Implements IDisposable

    Private _engine As OmniPageEngine

    Public Sub New(licensePath As String)
        _engine = New OmniPageEngine()
        _engine.SetLicenseFile(licensePath)
        _engine.Initialize()
    End Sub

    Public Function ProcessDocument(imagePath As String) As String
        Dim document = _engine.CreateDocument()
        document.AddPage(imagePath)
        document.Recognize(New RecognitionSettings With {.Language = "English"})
        Dim text As String = document.GetText()
        document.Dispose()  ' Must not be forgotten
        Return text
    End Function

    Public Sub Dispose() Implements IDisposable.Dispose
        _engine.Shutdown()  ' Must not be forgotten
    End Sub
End Class

' IronOCR equivalent: no lifecycle management needed
Public Class IronOcrDocumentService

    Private ReadOnly _ocr As IronTesseract

    Public Sub New()
        _ocr = New IronTesseract()
        _ocr.Language = OcrLanguage.English
    End Sub

    Public Function ProcessDocument(imagePath As String) As String
        Using input As New OcrInput()
            input.LoadImage(imagePath)
            Return _ocr.Read(input).Text
        End Using
    End Function
    ' No Dispose — no unmanaged resources to release
End Class

Wzorzec using var input = new OcrInput() obsługuje sprzątanie zasobów dla danych wejściowych. Sama instancja IronTesseract nie niesie ze sobą żadnego niezarządzanego stanu wymagającego wyraźnego zakończenia.

Przetwarzanie plików PDF bez konieczności licencjonowania oddzielnych modułów

Przetwarzanie plików PDF w OmniPage zazwyczaj wymaga określonej konfiguracji formatu wyjściowego oraz, w zależności od wersji SDK, oddzielnej licencji na moduł PDF. Obsługa plików PDF w IronOCR jest wbudowana w podstawowy pakiet NuGet. Zeskanowane pliki PDF, pliki PDF w formacie natywnym oraz pliki PDF chronione hasłem korzystają z tego samego interfejsu API.

// Extract text from a scanned PDF — no extra module or license
using var input = new OcrInput();
input.LoadPdf("scanned-contract.pdf");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// Create a searchable PDF from a scanned-only PDF
result.SaveAsSearchablePdf("contract-searchable.pdf");

// Process specific pages from a large PDF
using var input = new OcrInput();
input.LoadPdfPages("large-report.pdf", 1, 10);  // Pages 1–10 only
var result = new IronTesseract().Read(input);

// Extract text from a scanned PDF — no extra module or license
using var input = new OcrInput();
input.LoadPdf("scanned-contract.pdf");
var result = new IronTesseract().Read(input);
Console.WriteLine(result.Text);

// Create a searchable PDF from a scanned-only PDF
result.SaveAsSearchablePdf("contract-searchable.pdf");

// Process specific pages from a large PDF
using var input = new OcrInput();
input.LoadPdfPages("large-report.pdf", 1, 10);  // Pages 1–10 only
var result = new IronTesseract().Read(input);

Imports IronOcr

' Extract text from a scanned PDF — no extra module or license
Using input As New OcrInput()
    input.LoadPdf("scanned-contract.pdf")
    Dim result = New IronTesseract().Read(input)
    Console.WriteLine(result.Text)
End Using

' Create a searchable PDF from a scanned-only PDF
result.SaveAsSearchablePdf("contract-searchable.pdf")

' Process specific pages from a large PDF
Using input As New OcrInput()
    input.LoadPdfPages("large-report.pdf", 1, 10)  ' Pages 1–10 only
    Dim result = New IronTesseract().Read(input)
End Using

Przewodnik dotyczący plików PDF z funkcją wyszukiwania obejmuje osadzanie warstwy tekstowej, które sprawia, że zeskanowane pliki PDF można indeksować w systemach zarządzania dokumentami — jest to powszechny wymóg w tych samych przepływach pracy, w których wdrażany jest OmniPage.

Dystrybucja pakietów językowych

Słowniki językowe OmniPage są częścią instalacji SDK i ładują się przy uruchomieniu silnika, niezależnie od tego, czy bieżący dokument ich potrzebuje, czy nie. Pakiety językowe IronOCRsą oddzielnymi pakietami NuGet; ładowane są tylko te języki, które są zainstalowane i do których istnieje odwołanie.

// Add language packs as NuGet packages, not installer components
// dotnet add package IronOcr.Languages.German
// dotnet add package IronOcr.Languages.French

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;
ocr.AddSecondaryLanguage(OcrLanguage.German);
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("multilingual-document.jpg");
var result = ocr.Read(input);

// Add language packs as NuGet packages, not installer components
// dotnet add package IronOcr.Languages.German
// dotnet add package IronOcr.Languages.French

var ocr = new IronTesseract();
ocr.Language = OcrLanguage.English;
ocr.AddSecondaryLanguage(OcrLanguage.German);
ocr.AddSecondaryLanguage(OcrLanguage.French);

using var input = new OcrInput();
input.LoadImage("multilingual-document.jpg");
var result = ocr.Read(input);

Imports IronOcr

' Add language packs as NuGet packages, not installer components
' dotnet add package IronOcr.Languages.German
' dotnet add package IronOcr.Languages.French

Dim ocr As New IronTesseract()
ocr.Language = OcrLanguage.English
ocr.AddSecondaryLanguage(OcrLanguage.German)
ocr.AddSecondaryLanguage(OcrLanguage.French)

Using input As New OcrInput()
    input.LoadImage("multilingual-document.jpg")
    Dim result = ocr.Read(input)
End Using

Przewodnik po wielu językach obejmuje wzorce kombinacji językowych. Pakiety językowe są przywracane poprzez dotnet restore w pipelines CI/CD bez udziału instalatora. Pełny katalog języków zawiera listę wszystkich ponad 125 dostępnych pakietów.

Przetwarzanie wstępne: obiekt ustawień a potok metod

OmniPage konfiguruje wstępne przetwarzanie poprzez obiekt RecognitionSettings lub PreprocessingSettings przekazywany do silnika.IronOCR udostępnia wstępne przetwarzanie jako metodę potokową na OcrInput. Zachowanie jest równoważne; model wywoływania jest inny.

// OmniPage: preprocessing embedded in RecognitionSettings
var preprocessSettings = new PreprocessingSettings
{
    AutoRotate = true,
    Deskew = true,
    DespeckleLevel = 2,
    ContrastEnhancement = true,
    NoiseReduction = true
};
var recognitionSettings = new RecognitionSettings
{
    Language = "English",
    Preprocessing = preprocessSettings
};

// IronOCR: preprocessing as method pipeline on OcrInput
using var input = new OcrInput();
input.LoadImage(imagePath);
input.Deskew();
input.DeNoise();
input.Contrast();
input.Binarize();
input.EnhanceResolution(300);
var result = new IronTesseract().Read(input);

// OmniPage: preprocessing embedded in RecognitionSettings
var preprocessSettings = new PreprocessingSettings
{
    AutoRotate = true,
    Deskew = true,
    DespeckleLevel = 2,
    ContrastEnhancement = true,
    NoiseReduction = true
};
var recognitionSettings = new RecognitionSettings
{
    Language = "English",
    Preprocessing = preprocessSettings
};

// IronOCR: preprocessing as method pipeline on OcrInput
using var input = new OcrInput();
input.LoadImage(imagePath);
input.Deskew();
input.DeNoise();
input.Contrast();
input.Binarize();
input.EnhanceResolution(300);
var result = new IronTesseract().Read(input);

Imports IronOcr

' OmniPage: preprocessing embedded in RecognitionSettings
Dim preprocessSettings As New PreprocessingSettings With {
    .AutoRotate = True,
    .Deskew = True,
    .DespeckleLevel = 2,
    .ContrastEnhancement = True,
    .NoiseReduction = True
}
Dim recognitionSettings As New RecognitionSettings With {
    .Language = "English",
    .Preprocessing = preprocessSettings
}

' IronOCR: preprocessing as method pipeline on OcrInput
Using input As New OcrInput()
    input.LoadImage(imagePath)
    input.Deskew()
    input.DeNoise()
    input.Contrast()
    input.Binarize()
    input.EnhanceResolution(300)
    Dim result = New IronTesseract().Read(input)
End Using

Przewodnik po korekcji jakości obrazu obejmuje wszystkie dostępne filtry. W przypadku dokumentów, w których wystarczające jest domyślne automatyczne przetwarzanie wstępne, nie są potrzebne żadne wyraźne wywołania —IronOCR automatycznie stosuje korekcję przekrzywienia, redukcję szumów i poprawę kontrastu.