Developer’s Guide V10.0 Preview July, 2014 10 Years of Experience in TWAIN SDKs and Version Control Solutions Contents Preface ................................................................................................................. 4 Description ............................................................................................................................ 4 Audience ................................................................................................................................ 4 Get Started ........................................................................................................... 5 What Is TWAIN ...................................................................................................................... 5 What Is Dynamic Web TWAIN ............................................................................................... 5 Basic Requirements ............................................................................................................... 5 Deciding Which Dynamic Web TWAIN Edition to Use .......................................................... 6 Build the "Hello World" page ................................................................................ 7 Step 1: Start a Web Application from Scratch ....................................................................... 7 Step 2: Start the integration .................................................................................................. 8 Step 3: Start using the component ........................................................................................ 9 Customize the Dynamic Web TWAIN Object ......................................................... 11 Name the Dynamic Web TWAIN object .............................................................................. 11 Change the Size of the Viewer............................................................................................. 11 Three ways to use Dynamic Web TWAIN .............................................................. 12 Via Properties ...................................................................................................................... 12 Via Methods ........................................................................................................................ 12 Via Events ............................................................................................................................ 12 License Verification .............................................................................................. 13 Basic Info ............................................................................................................................. 13 How to Generate a Product Key .......................................................................................... 13 How to Use the Product Key? .............................................................................................. 14 Use it for Initiation (recommended) ............................................................................... 14 Use it when necessary ..................................................................................................... 14 Common License Errors ....................................................................................................... 15 Your License Number is empty or it’s invalid .................................................................. 15 1 | P a g e The trial license for Web TWAIN Plug-in has expired...................................................... 15 Explore the Features ............................................................................................ 16 Using Image Viewer ............................................................................................................. 16 What is Image Viewer? .................................................................................................... 16 What can you achieve with Image Viewer ...................................................................... 16 How to use Image Viewer................................................................................................ 16 Customize the editor ....................................................................................................... 17 Customize your scan settings .............................................................................................. 17 Related settings ............................................................................................................... 19 Manipulate the image(s) ..................................................................................................... 19 Related methods ............................................................................................................. 21 Use Thumbnails ................................................................................................................... 21 Description ...................................................................................................................... 21 Load local image(s) into Dynamic Web TWAIN ................................................................... 22 Preparation ...................................................................................................................... 22 Calling the method .......................................................................................................... 23 Save the image(s) to local system ....................................................................................... 24 Preparation ...................................................................................................................... 24 Calling the method .......................................................................................................... 24 Upload the image(s) to a web server .................................................................................. 26 Preparation ...................................................................................................................... 26 Calling the method .......................................................................................................... 26 Action Page ...................................................................................................................... 27 Other information ........................................................................................................... 28 Upload the image(s) to a Database ..................................................................................... 29 Upload image(s) with extra data ......................................................................................... 30 Download and load image(s) from the web ........................................................................ 30 Web page authentication .................................................................................................... 31 Basic Authentication ........................................................................................................ 31 2 | P a g e Windows Authentication ................................................................................................. 31 Forms Authentication ...................................................................................................... 31 Handling Events ................................................................................................................... 33 Subscribe to an event ...................................................................................................... 33 Event with parameter(s) .................................................................................................. 33 Custom capabilities ............................................................................................................. 33 Troubleshooting .................................................................................................. 36 Installing the Virtual Scanner for testing ............................................................................. 36 Is my scanner driver TWAIN compatible? ........................................................................... 36 Why is my scanner not shown or not responding in the browser? .................................... 36 Red X on the image viewer .................................................................................................. 39 Useful Resources ................................................................................................. 41 Resources ............................................................................................................................ 41 Online Demo Site ............................................................................................................. 41 Knowledage Base ............................................................................................................. 41 Forum .............................................................................................................................. 41 FAQ .................................................................................................................................. 41 All APIs (Property, Method, Capability and Event) .......................................................... 41 Contact Us ........................................................................................................................... 41 Outsource development