Kofax DotImage 10.1.0 Enterprise Edition Developer’s Guide 2012-03-16 © 2011-2012 Kofax, Inc. Portions © 2001-2011 Atalasoft, Inc., a Kofax company. 15211 Laguna Canyon Road, Irvine, California 92618, U.S.A. All rights reserved. Use is subject to license terms. Third-party software is copyrighted and licensed from Kofax’s suppliers. This product is protected by U.S. Patents No. 6,370,277 & 7,738,730 and Patents pending. THIS SOFTWARE CONTAINS CONFIDENTIAL INFORMATION AND TRADE SECRETS OF KOFAX, INC. USE, DISCLOSURE OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF KOFAX, INC. Kofax, the Kofax logo, Kofax VRS, Kofax Capture, and Kofax DotImage are trademarks or registered trademarks of Kofax, Inc. in the U.S. and other countries. Atalasoft and DotImage are registered trademarks of Atalasoft, Inc. All other trademarks are the trademarks or registered trademarks of their respective owners. U.S. Government Rights Commercial software. Government users are subject to the Kofax, Inc. standard license agreement and applicable provisions of the FAR and its supplements. You agree that you do not intend to and will not, directly or indirectly, export or transmit the Software or related documentation and technical data to any country to which such export or transmission is restricted by any applicable U.S. regulation or statute, without the prior written consent, if required, of the Bureau of Export Administration of the U.S. Department of Commerce, or such other governmental entity as may have jurisdiction over such export or transmission. You represent and warrant that you are not located in, under the control of, or a national or resident of any such country. DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Kofax DotImage 10.1.0 Developer's Guide 1 1 Table of Contents 1. Table of Contents 1-13 2. Introduction 14 2.1. About DotImage 14 2.2. DotImage Add-ons 14 2.2.1. Introduction to DotImage Add-ons 14-15 2.2.2. Barcode Recognition 15-16 2.2.3. Barcode Writing 16-17 2.2.4. OCR 17-19 2.2.5. PDF Reader 19-21 2.2.6. JPEG2000 Codec 21 2.2.7. DICOM Codec 21-22 2.2.8. Advanced Document Cleanup 22 2.2.9. Advanced Photo Effects 22-23 2.2.10. DWG Decoder 23 2.2.11. DotImage ISIS Overview 23 3. Licensing DotImage 24 4. Installing DotImage 25 4.1. Installing DotImage 25 4.2. Activating a Serial Number 25-26 4.2.1. Requesting an Evaluation License 26 4.3. Updating DotImage 26-27 5. Learning DotImage 28 5.1. Information Sources 28-29 5.2. DotImage Demos 29-36 5.3. List of How to's 36-40 5.4. Tutorial: Document Management Solution 40 5.4.1. Introducing the Document Management Tutorial 40 5.4.2. Tutorial: Capturing and Viewing Documents with a Scanning Client 40-41 Kofax DotImage 10.1.0 Developer's Guide 2 5.4.2.1. Create the Windows Forms Project 41 5.4.2.2. Design the User Interface 41-42 5.4.2.3. Add Toolstrip Controls 42-43 5.4.2.4. Open a Multi-Page Document From a File 43-44 5.4.2.5. Configure AutoZoom and Image Scaling 44-45 5.4.2.6. Save a Multi-Page Document to a File 45 5.4.2.7. Capture Documents From a Scanner 45-46 5.4.2.8. Choosing a Scanner 46-47 5.4.2.9. Application Source Code 47-49 5.4.2.10. Further Suggestions 49 5.4.3. Tutorial: Submitting Captured Documents to a Central Database 49-50 Repository 5.4.3.1. Create the ASP.NET Web Project 50-51 5.4.3.2. Create the SQL Database 51 5.4.3.3. Create the Data Abstraction Layer 51-52 5.4.3.4. Create the Web Service 53-55 5.4.3.5. Connect the Capture Client to the Web Service 55-57 5.4.3.6. Show Progress While the Document Loads 57-60 5.4.4. Tutorial: Viewing Documents from a Central Database Repository in a 60 Web Browser using an AJAX-Enabled Image Viewer 5.4.4.1. Configure a Website to use DotImage Web Controls 60 5.4.4.2. Add a WebThumbnailViewer and WebAnnotationsViewer to the Form 61 5.4.4.3. Use a Data-Bound Drop-Down List to Navigate Documents Stored in 61-62 the Database 5.4.4.4. Load Documents from Database into the Web Viewer 62-63 5.4.4.5. Add No-Postback Navigation Controls to the Viewer 63 5.4.5. Tutorial: Collaborating on Documents using AJAX-Enabled Web 63-64 Annotations 5.4.5.1. Configure the Controls to Draw and View Annotations 64 5.4.5.2. Configure the Application to Draw Annotations 64-65 5.4.5.3. Configure the SQL Database to Store Annotations 65 Kofax DotImage 10.1.0 Developer's Guide 3 5.4.5.4. Store and Load Annotations from the Database 65-66 6. Programming with DotImage 67 6.1. Getting Started 67 6.1.1. Introduction to Programming with DotImage 67-70 6.1.2. Creating Images 70 6.1.3. Opening and Saving Images 70-72 6.1.4. Processing and Cleaning-up Images 72-73 6.1.5. Viewing Images in Windows Forms Applications 73-74 6.1.6. Viewing Images in ASP.NET WebForms Applications 74-77 6.1.7. Introduction to TWAIN Scanning 77 6.1.8. Viewing Images in Silverlight 77-78 6.2. Imaging Concepts 78 6.2.1. Imaging Concepts Overview 78 6.2.2. Dithering 78-79 6.2.3. Compression 79-80 6.2.4. Asynchronous Image Processing 80-81 6.2.5. Resampling 81-82 6.2.6. Morphology 82-86 6.3. Programming Practices 86 6.3.1. Memory Management 86 6.3.1.1. Garbage Collection 86-87 6.3.2. Pixel Memory 87 6.3.2.1. Memory Layout 87-88 6.3.2.2. Getting at Pixels 88-89 6.3.2.3. Getting at Memory Directly 89-90 6.3.2.4. Available PixelMemory Types 90-91 6.3.2.5. How to's 91 6.3.2.5.1. How to: Access Pixel Data 91-93 6.3.2.5.2. How to: Create Custom PixelMemory 93-94 6.3.3. Using ImageSource 94 Kofax DotImage 10.1.0 Developer's Guide 4 6.3.3.1. ImageSource Overview 94-95 6.3.3.2. Inside the DotImage ImageSource Class 95-98 6.3.3.3. How to's 98-99 6.3.3.3.1. How to: Use an ImageSource 99 6.3.3.3.2. How to: Create a Custom ImageSource 99-101 6.3.3.3.3. How to: Unload an Image 101-103 6.3.3.3.4. How to: Implement a Stream Reloader 103-104 6.3.3.3.5. How to: Write a Caching ImageSource 104-105 6.3.3.3.6. How to: Loop Over Images in a File System 105-106 6.3.3.3.7. How to: Create an ImageSource that Accesses Windows AVI Files 106-112 6.4. Accessing Images 112 6.4.1. Read and Write Images to a Database 112-114 6.4.2. Access Multi-Page Images 114 6.4.3. How to's 114-115 6.4.3.1. How to: Add Support for RAW Images 115 6.4.3.2. How to: Get Image Information 115-116 6.5. Viewing Images 116 6.5.1. ASP.NET Webform Controls 116 6.5.1.1. Document Imaging in ASP.NET 116-117 6.5.1.2. Server-Side Image Viewing with ASP.NET 117-118 6.5.1.3. Rubberbanding in ASP.NET 118-119 6.5.1.4. Image Cache 119-120 6.5.1.5. Configuration Parameters 120-121 6.5.1.6. Annotations in ASP.NET 121-123 6.5.1.7. Thumbnails in ASP.NET 123-125 6.5.1.8. How to's 125 6.5.1.8.1. How to: Choose a Thick or a Thin Client 125-126 6.5.1.8.2. How to: Work with Remote Events 126-128 6.5.1.8.3. How to: Remotely Invoke ASP.NET Page Methods 128-130 Kofax DotImage 10.1.0 Developer's Guide 5 6.5.1.8.4. How to: Open Images From Browser 130-133 6.5.1.8.5. How to: Display Image in the Current Output Stream 133-136 6.5.1.8.6. How to: Print Images in ASP.NET 136-138 6.5.1.8.7. How to: Stream Directly to a Browser 138 6.5.1.9. Client Side Scripting in ASP.NET 138 6.5.1.9.1. ClientSide Scripting in ASP.NET 138-141 6.5.1.9.2. WebImageViewer 141-153 6.5.1.9.3. WebThumbnailViewer 153-164 6.5.1.9.4. WebAnnotationViewer 164-182 6.5.1.9.5. ClientTools 182-186 6.5.1.9.6. Enums 186-192 6.5.2. Windows Form Control 192 6.5.2.1. Rubberbands and Selections 192-193 6.5.2.2. How to's 193 6.5.2.2.1. How to: Print Images 193-195 6.5.2.2.2. How to: Use DotImage in Winform Applications 195-197 6.5.2.2.3.