› Use OmniPage Capture SDK › IPRO Sample Reference

IPRO Sample Reference

The IPRO Sample library contains a sample viewer application implemented in C++, Visual Basic .NET and C#. All the implementations are equivalent with each other and distributed both in binary and source file sets. As several project files are distributed to allow building the samples in various environments, you freely can modify and build the samples to learn how to use IPRO in detail. The sample sources are located under the Samples subfolder in the installation directory. While the source files are collected in the Samples\ISApp subfolder, all the project files are stored directly in the Samples folder:

MyISApp80.sln

Points to the Visual Studio 2005 project files for the sample viewers (ISApp\MFC\MyISAppMFC80.vcproj, ISApp\CSHARP\MyISAppCSharp80.csproj, ISApp\VBNET\MyISAppVBNet80.vbproj)

MyISApp90.sln

Points to the Visual Studio 2008 project files for the sample viewers (ISApp\MFC\MyISAppMFC90.vcproj, ISApp\CSHARP\MyISAppCSharp90.csproj, ISApp\VBNET\MyISAppVBNet90.vbproj)

MyISApp100.sln

Points to the Visual Studio 2010 project files for the sample viewers (ISApp\MFC\MyISAppMFC100.vcproj, ISApp\CSHARP\MyISAppCSharp100.csproj, ISApp\VBNET\MyISAppVBNet100.vbproj)

MyCSApiSam.sln

(VS2005, user can convert it to appropriate version for VS2008 or VS2010)

Here are short descriptions of the included IPRO samples:

# Description

01

INITIALIZATION OF IPRO

  1. Inquiry on Version and Serial numbers
  2. Inquiry on recognition modules
  3. Engine Timeout
  4. Modules of IPRO

02

USING THE ImageFile OBJECT TO ENHANCE AND BINARIZE A LOW RESOLUTION COLOR IMAGE

  1. Inquiry on attributes of the image
  2. Create a copy in TIFF format
  3. Convert the TIFF image to B/W with the Resolution Enhancement option
  4. Saving the image in PCX format
  5. Getting detailed error information

03

IMAGE PREPROCESSING IN ONE STEP: INVERTING, DESKEWING AND ROTATING

  1. Loading a B/W image from a single-page image file
  2. Forcing image inversion, automatic image rotation and deskewing
  3. Saving the preprocessed image

04

IMAGE PREPROCESSING STEPS PERFORMED SEPARATELY

  1. Loading a B/W image from a single-page image file
  2. Step 1: Despeckling the image
  3. Step 2: Rotating the image
  4. Step 3: Inverting the image
  5. Step 4: Deskewing the image
  6. Saving the preprocessed image

05

SAVING PART OF AN IMAGE

  1. Loading a B/W image from a single-page image file
  2. Saving a portion of the image using different image file format

06

CREATING MULTI-PAGE IMAGE FILES

  1. Loading B/W images from single-page image files
  2. Saving the images into the same multi-page image file
  3. Inquiring the number of pages in a multi-page image file

07

DISPLAYING AN IMAGE ON THE SCREEN

  1. Loading B/W images from single-page image files
  2. Exporting a portion of it for displaying purposes

08

RECOGNITION, AND OUTPUT FORMATS

  1. Loading a B/W image from a single-page image file
  2. Enumeration of available Converters
  3. Specifying rejection symbol and code page for the plain text converter
  4. Recognition and conversion to the output file specified

09

RECOGNITION OF A MULTILINGUAL DOCUMENT

  1. Loading a B/W image from a single-page image file
  2. Specifying the Language environment (language selection and LanguagesPlus characters)
  3. Recognition
  4. Conversion to Microsoft Word format, retaining formatting information

10

RECOGNITION USING CHARACTER SET FILTERING

  1. Loading a B/W image from a single-page image file
  2. Specifying the Language environment as the English characters
  3. Applying filters and FilterPlus characters
  4. Saving all settings to a settings file for future use
  5. Recognition and conversion to the final output document

11

RECOGNIZING, RECOGNITION STATISTICS, WORDPROCESSOR OUTPUT

  1. Quick-recognizing a B/W single-page image file
  2. Inquiry and display of recognition statistics
  3. Selecting output format for final output document

12

RECOGNIZING, EXPORT THROUGH MEMORY

  1. Loading a B/W image from a single-page image file
  2. Exporting the output to the application through memory

13

RECOGNIZING DOCUMENTS COMPILED FROM SEVERAL SINGLE-PAGE IMAGE FILES

  1. Recognizing B/W pages from several single-page image files
  2. Setting output format: Wordprocessor output (Microsoft Word)

14

RECOGNIZING FROM MULTI-PAGE IMAGE FILE

  1. Recognizing all pages from a B/W multi-page image file
  2. Setting output format

15

HANDLING GRAY IMAGES, ADAPTIVE THRESHOLDING WHEN LOADING

  1. Loading a gray image file with automatic adaptive thresholding
  2. Recognition
  3. Conversion to text format.

16

HANDLING GRAY IMAGES, SPECIFYING THRESHOLD VALUE

  1. Loading a gray image file with specified threshold value
  2. Recognition
  3. Conversion to text format

17

WORKING WITH THE SCANNING SUBSYSTEM

  1. Displaying the Scanner Wizard if no configured scanner is detected
  2. Checking the availability of the configured scanners, initialization and inquiry on scanner characteristics
  3. Saving the available scanner settings into a setting file

18

SCANNING IN COLOR, ADJUSTING SCANNER SETTINGS

  1. Scanning a page in color, specifying some scanner parameters (resolution, color mode)
  2. Saving the scanned image

19

SCANNING IN BLACK AND WHITE WITH DEFAULT SCANNER SETTINGS

  1. Scanning a page in B/W with default scanner settings
  2. Recognizing the scanned image.
  3. Exporting recognition results to a text file

20

SCANNING IN GRAY, ADJUSTING SCANNER SETTINGS

  1. Inquiring and specifying different scanner parameters:

    1. resolution
    2. grayscale level
    3. brightness contrast
    4. dropout color
    5. scanning area

  3. Scanning the gray image
  4. Saving the image in gray

21

SCANNING WITH ADF (Automatic Document Feeder)

  1. Getting B/W pages from the scanner's ADF one after another with default scanner settings
  2. Handling missing or empty ADF situations
  3. Saving the pages into a multiple-page image file

22

HANDLING ZONES. PAGE-LAYOUT ANALYSIS (AUTO-ZONING)

  1. Loading a B/W image, auto-zoning
  2. Saving the zones to a zone file
  3. Loading another zone file, then recognizing the image

23

AUTO-ZONING, ZONE PROPERTY DISPLAY

  1. Loading a B/W image, auto-zoning
  2. Inquiry and display of zone properties

24

INSERTING, UPDATING AND DELETING ZONES

  1. Loading a B/W image, auto-zoning
  2. Inserting a new zone, updating (modifying)an existing one
  3. Deleting a zone

25

RECOGNIZING WITH CHECKING; SPELL CHECKING ENGLISH TEXT

  1. Setting the parameters of the checker to recognize and check English text
  2. Recognizing a B/W image from a single-page image file and saving it

26

SETTING TRADE-OFF, RECOGNIZING WITH CHECKING, SPELL CHECKING GERMAN TEXT

  1. Setting the parameters of the checker to recognize and check German text
  2. Specifying recognition trade-off
  3. Recognizing a B/W image from a single-page image file
  4. Saving it in a special format (XML)

27

LIST-TYPE ATTRIBUTES OF THE CAPTURE SDK

  1. Listing:

  1. modules of the Engine
  2. selectable languages
  3. installed language dictionaries
  4. available output formats

28

LOW LEVEL CUSTOM FORMATTING

  1. Recognizing an image into the memory
  2. Accessing low level recognition information
  3. Manipulating the Character collection
  4. Custom converting the text into a file

29

HANDWRITTEN NUMERAL RECOGNITION

  1. Defining a page-sized zone for handwritten numeral recognition
  2. Defining a local filter to validate digits only
  3. Excluding the plus and minus signs, the comma and the period (full stop)
  4. Recognizing handwritten numbers from a B/W image

30

HANDWRITTEN TEXT RECOGNITION

  1. Loading a B/W image containing handwritten English text
  2. Creating a page-sized zone for handwritten text recognition
  3. Defining a local filter to validate uppercase letters and digits only
  4. Recognizing and saving the result

31

RECOGNIZING WITH UD-CHECKING. MAINTAINING THE USER DICTIONARY

  1. Creating a new User dictionary
  2. Adding items (literals) to the User dictionary
  3. Recognition using the User dictionary only

32

SCANNING WITH AUTOMATIC ADAPTIVE THRESHOLDING

  1. Asking whether the scanner supports grayscale
  2. Scanning in gray
  3. During the loading process the image will be automatically converted to B/W
  4. Saving the loaded image

33

RECOGNIZING OPTICAL MARKS

  1. Loading an image. Loading a Zone file
  2. Recognizing optical marks (checkboxes) using the Character collection
  3. Displaying the result

34

RECOGNIZING BAR CODES

  1. Getting information about the current setting of the bar code recognition module
  2. Specifying requested bar code types
  3. Loading an image, loading a Zone file
  4. Recognizing the bar code
  5. Displaying the result and the type of the bar code

35

SCANNING IN COLOR. TRANSFORMING A COLOR IMAGE

  1. Scanning a page in color with default parameters
  2. Specifying scanning area
  3. Transforming the original image to other image types and resolutions
  4. Saving the transformed images

36

RECOGNIZING WITH UD-CHECKING. REGULAR EXPRESSIONS

  1. Loading a B/W image from a single-page image file
  2. Recognizing without the support of the regular expression
  3. Specifying a regular expression to improve accuracy
  4. Recognizing with the support of the regular expression

37

RECOGNIZING WITH USER-WRITTEN CHECKING

  1. Loading a B/W image from a single-page image file
  2. Recognizing without the support of user-written checking
  3. Specifying a user written callback function to improve accuracy
  4. Recognizing with the support of user-written checking

38

RECOGNIZING MICR (E-13B) ZONE

  1. Loading a B/W image from a single-page image file
  2. Specifying the MICR-specific characters
  3. Recognition
  4. Conversion to UNICODE plain text file

39

FORM PROCESSING

  1. Loading an unfilled, master form; analyzing its layout and saving it as embedded form-template
  2. Loading a filled-in form of the same type and applying the saved form template on it
  3. Recognizing the filled-in form and accessing the recognition results through memory
  4. Saving the recognition result to an ASCII text file

40

3D DESKEW

  1. Loading a 3D-distorted image file; creating a 3D deskewed copy using the ImageFile object
  2. Loading the corrected image through memory; performing recognition
  3. Exporting the results in plain text format

41

WORKFLOW-BASED PROCESSING with WORKFLOW CREATED BY VISUAL TOOLBOX

  1. Create an empty document; execute Sample41.xwf workflow:

  1. Loading an image (prompt for input)
  2. Recognizing (in English)
  3. Proofreading
  4. Exporting results (prompt for output - defaulting to PDF, View Results)

42

ACCESSING TABLE STRUCTURE INFORMATION

  1. Create an empty document, load an image containing table
  2. Perform decomposition, look for tables only
  3. Perform recognition, access OCRZone table information

43

STORING APPLICATION SETTINGS WITH SETTING MANAGER

  1. Create some new application-specific settings
  2. Preset setting values and save the settings to a setting file
  3. Reload setting values from the created setting file

44

TEXT MARKING, EXPORTING AND SAVING TO OPD

  1. Loading B/W images from single-page image files
  2. Text marking (mark for redact, highlight, strikeout), bookmarking marked pages
  3. Exporting to RTF and saving the document also to and OPD file (latter used in Sample 45)

45

TEXT MARKING - REDACTING WORDS MARKED FOR REDACTION, EXPORTING AND SAVING TO OPD

  1. Loading the OPD saved in Sample 44
  2. Redacting (blacking out) words marked for redaction
  3. Exporting to PDF and saving the document also to an OPD file