Aspose.OCR for Java 20.10 - Release Notes

All Features

KeySummaryCategory
OCRJAVA-86Extend API: add the language choose optionsEnhancement
OCRJAVA-80Make an option to set a custom angle for the skew correction featureEnhancement

Enhancements

The next opportunities:

  • skew (default 0) - allows setting skew correction
  • language(default Language.all) - allows to set language. Supported languages: English (en), German (de), Portuguese (pt), Spanish (es), French (fr), Italian (it).

Public API and Backwards Incompatible Changes

New API

MethodDescription
RecognitionResult RecognizePage(String fullPath, RecognitionSettings settings)fullPath - path on the image, settings - object for parameters

Removed APIs

No Changes

Will be deprecated

String RecognizePage(String fullPath, Rectangle box);

String RecognizePage(BufferedImage image_, Rectangle box);

Usage Example

import static java.lang.System.out;

import java.awt.Rectangle;
import java.io.IOException;
import java.util.ArrayList;

import com.aspose.ocr.AsposeOCR;
import com.aspose.ocr.License;
import com.aspose.ocr.RecognitionResult;
import com.aspose.ocr.RecognitionSettings;

////  for gpu version

// import com.aspose.ocr.gpu.AsposeOCR;
// import com.aspose.ocr.gpu.License;
// import com.aspose.ocr.gpu.RecognitionResult;
// import com.aspose.ocr.gpu.RecognitionSettings;

public class App {
       public static void main(String[] args) {

        // set license
        License.setLicense("Aspose.Total.lic");
        // Check license
        boolean resLicense = License.isValid();
        out.println("License is :" + resLicense);  

        // Create api instance
        AsposeOCR api = new AsposeOCR();

       String uri = "https://www.castlegateit.co.uk/wp-content/uploads/2016/09/justified_text.png";

       // set recognition options
       RecognitionSettings settings = new RecognitionSettings();
       settings.setAutoSkew(false);            
       ArrayList<Rectangle> rectangles = new ArrayList<Rectangle>();
       rectangles.add(new Rectangle(90,186,775,95));
       settings.setRecognitionAreas(rectangles);
       

       // get result object
       RecognitionResult result = null;
       try {
                result = api.RecognizePageFromUri(uri, settings);
            } catch (IOException e) {               
                e.printStackTrace();
            }

        // print result
        out.println("Result: \n" + result.RecognitionText+"\n\n");
        out.println("RecognitionAreasText: \n");
        for(String text: result.RecognitionAreasText) {
              System.out.println(text);
        } 
       out.println("JSON: \n" + result.GetJson());
       out.println("Warnings: \n");
       for(String warning: result.Warnings) {
              System.out.println(warning);
       }

        // Image recognition with settings
        api = new AsposeOCR();
       Strig file = samplesDir + "/images/p3.png";

        // set recognition options
        RecognitionSettings settings = new RecognitionSettings();
        settings.setAutoSkew(false);           
        ArrayList<Rectangle> rectangles = new ArrayList<Rectangle>();
        rectangles.add(new Rectangle(90,186,775,95));
        settings.setRecognitionAreas(rectangles);
        settings.setSkew(0.5);
        settings.setLanguage(RecognitionSettings.Language.en);
              

        // get result object
        try {
            result = api.RecognizePage(file, settings);
        } catch (IOException e) {              
            e.printStackTrace();
        }

       // print result
        out.println("Result: \n" + result.recognitionText+"\n\n");
        for(String n: result.recognitionAreasText) {
        System.out.println ( n );
        }            
        for(Rectangle n: result.recognitionAreasRectangles) {
            System.out.println(n.height+":"+n.width+":"+n.x+":"+n.y);
        }
        out.println("\nJSON:" + result.GetJson());               
        out.println("angle:" + result.skew);               
        for(String n: result.warnings) {
        System.out.println ( n );
        }

    }

}