Rileva l'orientamento dell'immagine del documento di testo in .NET

VintaSoft Imaging .NET SDK e VintaSoft Document Cleanup .NET Plug-in forniscono comandi per l'elaborazione e la pulizia delle immagini dei documenti.
GetTextOrientationCommand è rilevare l'orientamento delle immagini che contengono testo latino ruotato di 90, 180 o 270 gradi.
GetTextOrientationCommand non è adatto per l'elaborazione di:

immagini che non contengono testo
immagini che contengono testo non latino
immagini che contengono solo testo latino con lettere maiuscole
immagini che sono ruotate di un angolo diverso da 0, 90, 180 o 270 gradi (utilizzare il comando DeskewCommand per raddrizzare l'immagine prima del rilevamento del suo orientamento)
immagini, che contengono solo poche parole (questo non è sufficiente per prendere una decisione sull'orientamento dell'immagine)

VintaSoft Imaging .NET SDK e VintaSoft OCR .NET Plug-in forniscono GetTesseractOcrTextOrientationCommand, il cui scopo è rilevare l'orientamento dell'immagine del documento utilizzando il motore OCR Tesseract. Il comando GetTesseractOcrTextOrientationCommand può rilevare l'orientamento di qualsiasi immagine con testo (non ha limitazioni come il comando GetTextOrientationCommand), ma GetTesseractOcrTextOrientationCommand è fino a 5 volte più lento del comando GetTextOrientationCommand.

In base a quanto affermato sopra, è necessario utilizzare il comando GetTextOrientationCommand o il comando GetTesseractOcrTextOrientationCommand a seconda del tipo di immagini del documento di input.

Inoltre, è possibile utilizzare entrambi i comandi insieme,in particolare:

rileva l'orientamento dell'immagine utilizzando il comando GetTextOrientationCommand (funziona più velocemente e rileva correttamente l'orientamento per la maggior parte dei documenti con testo latino)
se il comando GetTextOrientationCommand non riesce a rilevare l'orientamento dell'immagine del documento, rileva l'orientamento dell'immagine utilizzando GetTesseractOcrTextOrientationCommand (più lento, ma rileva correttamente l'orientamento per quasi tutti i documenti)

L'uso combinato di entrambi i comandi consente di ottenere la massima efficienza e qualità nel rilevamento dell'orientamento delle immagini dei documenti.

Ecco il codice C# che dimostra come rilevare l'orientamento dell'immagine del documento utilizzando il comando GetTextOrientationCommand:

/// <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();
    }
}

Ecco il codice C# che dimostra come rilevare l'orientamento dell'immagine del documento utilizzando il comando GetTesseractOcrTextOrientationCommand:

/// <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();
    }
}

Ecco il codice C# che dimostra come rilevare l'orientamento dell'immagine del documento utilizzando Comando GetTextOrientationCommand e comando GetTesseractOcrTextOrientationCommand:

/// <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();
    }
}