Erkennen der Ausrichtung von Textdokumentbildern in .NET

VintaSoft Imaging .NET SDK und VintaSoft Document Cleanup .NET Plug-in bieten Befehle zur Verarbeitung und Bereinigung von Dokumentenbildern.
Der Befehl GetTextOrientationCommand dient dazu, die Ausrichtung von Bildern zu erkennen, die lateinischen Text enthalten, der um 90, 180 oder 270 Grad gedreht ist.
GetTextOrientationCommand ist nicht geeignet für die Verarbeitung von:

Bilder, die keinen Text enthalten
Bilder, die nicht-lateinischen Text enthalten
Bilder, die lateinischen Text nur in Großbuchstaben enthalten
Bildern, die um einen Winkel ungleich 0, 90, 180 oder 270 Grad gedreht sind (verwenden Sie den Befehl DeskewCommand, um das Bild vor der Erkennung seiner Ausrichtung zu entzerren).
Bilder, die nur wenige Wörter enthalten (dies reicht nicht aus, um eine Entscheidung über die Bildausrichtung zu treffen)

Das VintaSoft Imaging .NET SDK und das VintaSoft OCR .NET Plug-in stellen den Befehl GetTesseractOcrTextOrientationCommand bereit, der die Ausrichtung von Dokumentenbildern mithilfe der Tesseract-OCR-Engine erkennt. Der Befehl GetTesseractOcrTextOrientationCommand kann die Ausrichtung jedes Bildes mit Text erkennen (hat keine Einschränkungen wie der Befehl GetTextOrientationCommand), aber der Befehl GetTesseractOcrTextOrientationCommand arbeitet bis zu 5 Mal langsamer als der Befehl GetTextOrientationCommand.

Basierend auf den obigen Ausführungen ist es notwendig, je nach Art der Eingabedokumentbilder den Befehl GetTextOrientationCommand oder GetTesseractOcrTextOrientationCommand zu verwenden.

Es ist auch möglich, beide Befehle zusammen zu verwenden, insbesondere:

um die Ausrichtung eines Bildes mithilfe des Befehls GetTextOrientationCommand zu ermitteln (dieser Befehl ist schneller und erkennt die Ausrichtung bei den meisten Dokumenten mit lateinischem Text korrekt)
wenn der Befehl GetTextOrientationCommand die Ausrichtung des Dokumentbildes nicht erkennen kann, verwenden Sie den Befehl GetTesseractOcrTextOrientationCommand, um die Bildausrichtung zu ermitteln (dieser Befehl ist langsamer, erkennt die Ausrichtung aber für fast alle Dokumente korrekt)

Die kombinierte Verwendung beider Befehle ermöglicht die maximale Effizienz und Qualität der Erkennung der Dokumentbildausrichtung.

Hier ist C#-Code, der zeigt, wie man die Ausrichtung eines Dokumentbildes mithilfe des Befehls GetTextOrientationCommand erkennt:

/// <summary>
/// Returns an orientation angle of document image using statistics for Latin symbols.
/// </summary>
/// <param name="filename">The path to a file with document image.</param>
public static void GetDocumentImageOrientationUsingLatinSymbolStat(string filename)
{
    // create an image collection
    using (Vintasoft.Imaging.ImageCollection images = new Vintasoft.Imaging.ImageCollection())
    {
        // add images from file to the image collection
        images.Add(filename);

        // create an instance of GetTextOrientationCommand class
        Vintasoft.Imaging.ImageProcessing.Info.GetTextOrientationCommand getTextOrientationCommand1 =
            new Vintasoft.Imaging.ImageProcessing.Info.GetTextOrientationCommand();

        // for each image in image collection
        for (int i = 0; i < images.Count; i++)
        {
            // get image
            Vintasoft.Imaging.VintasoftImage image = images[i];

            // determine orientation of document image using statistics for Latin symbols
            getTextOrientationCommand1.ExecuteInPlace(image);

            // write result to the console
            System.Console.WriteLine(string.Format("Filename: {0}, page: {1}, page orientation: {2}, confidence: {3}",
                System.IO.Path.GetFileName(filename),
                i,
                getTextOrientationCommand1.Orientation,
                getTextOrientationCommand1.Confidence));
        }

        // free images
        images.ClearAndDisposeItems();
    }
}

Hier ist C#-Code, der zeigt, wie die Ausrichtung eines Dokumentbildes mithilfe des GetTesseractOcrTextOrientationCommand Befehls erkannt wird:

/// <summary>
/// Returns an orientation angle of document image using Tesseract OCR.
/// </summary>
/// <param name="filename">The path to a file with document image.</param>
/// <param name="tesseractOcrDllDirectory">A path to a directory, where Tesseract5.Vintasoft.xXX.dll files are located.</param>
public static void GetDocumentImageOrientationUsingTesseractOCR(string filename, string tesseractOcrDllDirectory)
{
    // create an image collection
    using (Vintasoft.Imaging.ImageCollection images = new Vintasoft.Imaging.ImageCollection())
    {
        // add images from file to the image collection
        images.Add(filename);

        // create an instance of GetTesseractOcrTextOrientationCommand class
        using (Vintasoft.Imaging.ImageProcessing.Ocr.Tesseract.GetTesseractOcrTextOrientationCommand getTextOrientationCommand =
            new Vintasoft.Imaging.ImageProcessing.Ocr.Tesseract.GetTesseractOcrTextOrientationCommand())
        {
            // specify path to a directory, where Tesseract5.Vintasoft.xXX.dll files are located
            getTextOrientationCommand.TesseractOcrDllDirectory = tesseractOcrDllDirectory;

            // for each image in image collection
            for (int i = 0; i < images.Count; i++)
            {
                // get image
                Vintasoft.Imaging.VintasoftImage image = images[i];

                // determine orientation of document image using Tesseract OCR
                getTextOrientationCommand.ExecuteInPlace(image);

                // write result to the console
                System.Console.WriteLine(string.Format("Filename: {0}, page: {1}, page orientation: {2}",
                    System.IO.Path.GetFileName(filename),
                    i,
                    getTextOrientationCommand.Orientation));
            }
        }

        // free images
        images.ClearAndDisposeItems();
    }
}

Hier ist C#-Code, der zeigt, wie die Ausrichtung eines Dokumentbildes mithilfe des GetTextOrientationCommand Befehl und GetTesseractOcrTextOrientationCommand Befehl:

/// <summary>
/// Returns an orientation angle of document image using statistics for Latin symbols and using Tesseract OCR.
/// </summary>
/// <param name="filename">The path to a file with document image.</param>
/// <param name="tesseractOcrDllDirectory">A path to a directory, where Tesseract5.Vintasoft.xXX.dll files are located.</param>
public static void GetDocumentImageOrientationUsingLatinSymbolStatAndOcrTesseract(string filename, string tesseractOcrDllDirectory)
{
    // create an image collection
    using (Vintasoft.Imaging.ImageCollection images = new Vintasoft.Imaging.ImageCollection())
    {
        // add images from file to the image collection
        images.Add(filename);

        // create an instance of GetTextOrientationCommand class
        Vintasoft.Imaging.ImageProcessing.Info.GetTextOrientationCommand getTextOrientationCommand1 =
            new Vintasoft.Imaging.ImageProcessing.Info.GetTextOrientationCommand();

        // create an instance of GetTesseractOcrTextOrientationCommand class
        using (Vintasoft.Imaging.ImageProcessing.Ocr.Tesseract.GetTesseractOcrTextOrientationCommand getTextOrientationCommand2 =
            new Vintasoft.Imaging.ImageProcessing.Ocr.Tesseract.GetTesseractOcrTextOrientationCommand())
        {
            // specify path to a directory, where Tesseract5.Vintasoft.xXX.dll files are located
            getTextOrientationCommand2.TesseractOcrDllDirectory = tesseractOcrDllDirectory;

            // for each image in image collection
            for (int i = 0; i < images.Count; i++)
            {
                // get image
                Vintasoft.Imaging.VintasoftImage image = images[i];

                // determine orientation of document image using statistics for Latin symbols (works for Latin text only)
                getTextOrientationCommand1.ExecuteInPlace(image);
                // if orientation is detected and orientation result has high confidence
                if (getTextOrientationCommand1.Orientation != Vintasoft.Imaging.ImageProcessing.Info.ImageOrthogonalOrientation.Undefined &&
                    getTextOrientationCommand1.Confidence > 0.3)
                {
                    // write result to the console
                    System.Console.WriteLine(string.Format("Filename: {0}, page: {1}, page orientation: {2}, confidence: {3}",
                        System.IO.Path.GetFileName(filename),
                        i,
                        getTextOrientationCommand1.Orientation,
                        getTextOrientationCommand1.Confidence));
                }
                // if orientation is not detected or orientation result has low confidence
                else
                {
                    // determine orientation of document image using Tesseract OCR (works for any text)
                    getTextOrientationCommand2.ExecuteInPlace(image);

                    // write result to the console
                    System.Console.WriteLine(string.Format("Filename: {0}, page: {1}, page orientation: {2}, confidence: {3}",
                        System.IO.Path.GetFileName(filename),
                        i,
                        getTextOrientationCommand2.Orientation,
                        getTextOrientationCommand2.Confidence));
                }
            }
        }

        // free images
        images.ClearAndDisposeItems();
    }
}