RasterMaster® SDK RasterMaster ActiveX V18.3 Programmer’s Reference Guide Note: An online version of this manual contains information on the latest updates to RasterMaster. To find the most recent version of this manual, please visit the online version at www.rastermaster.com or download the most recent version from our website at www.snowbound.com/support/manuals.html. DOC-0121-07 Copyright Information While Snowbound® Software believes the information included in this publication is correct as of the publication date, information in this document is subject to change without notice. UNLESS EXPRESSLY SET FORTH IN A WRITTEN AGREEMENT SIGNED BY AN AUTHORIZED REPRESENTATIVE OF SNOWBOUND SOFTWARE CORPORATION MAKES NO WARRANTY OR REPRESENTATION OF ANY KIND WITH RESPECT TO THE INFORMATION CONTAINED HEREIN, INCLUDING WARRANTY OF MERCHANTABILITY AND FITNESS FOR A PURPOSE. Snowbound Software Corporation assumes no responsibility or obligation of any kind for any errors contained herein or in connection with the furnishing, performance, or use of this document. Software described in Snowbound documents (a) is the property of Snowbound Software Corporation or the third party, (b) isfurnished only under license, and (c) may be copied or used only as expressly permitted under the terms of the license. All contents of this manual are copyrighted by Snowbound Software Corporation. The information contained herein is the exclusive property of Snowbound Software Corporation and shall not be copied, transferred, photocopied, translated on paper, film, electronic media, or computer-readable form, or otherwise reproduced in any way, without the express written permission of Snowbound Software Corporation. Microsoft, MS, MS-DOS, Windows, Windows NT, and SQL Server are either trademarks or registered trademarks of Microsoft Corporation in the United States and/or other countries. Adobe, the Adobe logo, Acrobat, and the Acrobat logo are trademarks of Adobe Systems Incorporated. Sun, Sun Microsystems, the Sun Logo, and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. iText, the Initial Developers of the Original Code are Bruno Lowagie and Paolo Soares. Portions created by Bruno Lowagie are Copyright (C) 1999-2009 by Bruno Lowagie. Kakadu JPEG2000©, is copyrighted by Dr. David Taubman, and is proprietary to NewSouth Innovations, Pty. Ltd, Australia. Aspose™, Aspose.Cells© (copyrighted 2003), Aspose.Words© (copyrighted 2003), and Aspose.Slides© (copyrighted 2004), are all proprietary to Aspose Software, Pty. Ltd, Australia. United States Government Restricted Rights The Software is provided with RESTRICTED RIGHTS. Use, duplication or disclosure by the United States Government is subject to restrictions as set forth under subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause of DFARS 252.227 –19 or subparagraphs (c)(i) and (2) of the Commercial Computer Software-Restricted Rights at 48 CFR 52.227 – 19 as applicable. The Manufacturer is Snowbound Software Corporation, 309 Waverley Oaks Rd., Suite 401, Waltham, MA 02452, USA. All other trademarks and registered trademarks are the property of their respective holders. Manual Title: Snowbound RasterMaster® for ActiveX Platform Programmer’s Reference Guide Part Number:DOC-0121-07 Revision: 7 RasterMaster for the ActiveX Platform Release Number: 18.3 RasterMaster® SDK Release Number: 18.3 Printing Date: January 2014 Published by Snowbound Software Corporation. 309 Waverley Oaks Road Suite 401 Waltham, MA 02452 USA phone: 617-607-2000 fax: 617-607-2002 ©1996 - 2014 by Snowbound Software Corporation. All rights reserved. Table of Contents Chapter 1 - Additions and Improvements 24 Version 18.3 Additions and Improvements 24 New Features 24 Chapter 2 - Quick Start 25 Getting Started 25 Quickly Getting Started with the Format Conversion Sample 25 Viewing Samples Packaged with the Library 26 Sample Directory 26 Image Property 28 System Overview 29 Determining System Requirements 29 Determining Memory Requirements 31 Chapter 3 - Custom Control Properties 33 Properties Overview 39 About Property 39 ActiveImage Property 40 ActivePage Property 40 Alias Property 41 AnimateImage Property 42 AsciiBold Property 42 AsciiCharsPerLine Property 43 AsciiFont Property 44 iii AsciiItalic Property 44 AsciiLinesPerPage Property 45 AsciiMarginBottom, AsciiMarginTop Property 46 AsciiMarginLeft, AsciiMarginRight Property 47 AsciiPageHeight, AsciiPageWidth Property 47 AsciiPointSize Property 48 AsciiTab Property 49 AsciiXdpi, AsciiYdpi Property 49 AspectRatio Property 50 AutoColor Property 51 AutoCrop Property 52 AutoOrient Property 52 AutoRedraw Property 53 AutoReduce Property 54 AutoResizeX, AutoResizeY Property 54 AutoSize Property 55 BackColor Property 56 BayerColor Property 57 BayerMono Property 57 BlankControl Property 58 BorderStyle Property 58 Brightness Property 59 ClearImage Property 60 CmykToRGB Property 61 iv Contrast Property 61 Copy Property 62 CropXpos, CropYpos Property 63 CropXsize, CropYsize Property 64 DecompressScreen Property 65 DelImage Property 66 Deskew Property 66 Despeckle Property 67 Dialation Property 68 DibToRuns Property 68 DiffusionColor Property 69 DiffusionMono Property 69 DitherMode Property 70 DragIcon Property 70 DragMode Property 71 DrawMode Property 72 EdgeDetect Property 73 Effect Property 74 Encrypt Property 75 ErrorStr Property 75 ExtractBuff Property 76 ExtractText Property 76 Fax Property 77 FaxOffset Property 78 v FaxType Property 78 FaxXsize, FaxYsize Property 78 FileType Property 79 FileTypeName Property 79 FileTypeStr Property 80 FillColor Property 80 FillOrder Property 81 FitToHeight Property 81 FitToWidth Property 82 Filter Property 82 FlipX Property 83 FlipY Property 83 Gamma Property 84 GetBuffer Property 85 GetBytes Property 85 GetFileInfo Property 85 GetYpos Property 86 Gray Property 86 HalftoneMono Property 87 Height, Width Property 87 HelpContextID Property 87 HistoGramEqualize Property 88 HorzEdgeDetect Property 88 Image Property 89 vi ImageAccel Property 90 ImageAccelRot Property 91 ImageBitspix Property 91 ImageDate Property 92 ImageDib Property 92 ImageError Property 93 ImageHeight, ImageWidth Property 93 ImageName Property 94 ImagePosX, ImagePosY Property 94 ImageXdpi, ImageYdpi Property 95 Index Property 96 Interp Property 96 Invert Property 97 IsolatePoints Property 97 JpegInterleave Property 98 Laplacian Property 99 Left Property 100 MedianCut Property 100 MemLoad Property 100 MemSave Property 101 MergeMem Property 101 Mergename Property 102 MergeXpos, MergeYpos Property 103 MergeXsize, MergeYsize Property 104 vii Name Property 104 Neg45EdgeDetect Property 104 OctreeBpp Property 105 OctreeColors Property 106 OctreePal Property 107 OctreeStart Property 108 Orientation Property 109 Overlay Property 109 Page Property 110 Pages Property 110 Palette Property 111 PanWindow Property 112 Paste Property 112 PDFBitsPerPixel Property 113 PdfDpi Property 113 PdfXPageSize Property 113 PdfYPageSize Property 114 Picture Property 114 PixelValue Property 115 PixelXpos/PixelYpos Property 115 Popularity Property 116 Pos45EdgeDetect Property 116 PrintFast Property 117 PrintImage Property 118 viii PrintSize Property 119 PrintXs, PrintYs Property 120 PrintXsize, PrintYsize Property 120 Promote24, Promote8 Property 121 PutBuffer Property 122 PutBytes Property 122 PutYpos Property 122 Redraw Property 123 Resize Property 124 ResizeHeight, ResizeWidth Property 124 RGBToCmyk Property 125 RobertsCross Property 125 Rotate Property 126 RotateScreen Property 127 RunsToDib Property 128 Save Property 128 SaveFormat Property 129 SaveQuality Property 129 ScanAcquire Property 130 ScanAcquireFeeder Property 130 ScanBits Property 131 ScanBottom, ScanLeft, ScanRight, ScanTop Property 132 ScanCap Property 132 ScanCapGet Property 132 ix ScanCapValue Property 133 ScanCloseFeeder Property 133 ScanDuplex Property 134 ScanFast Property 134 ScanHres, ScanVres Property 135 ScanOpenSource Property 135 ScanPages Property 136 ScanSetup Property 136 ScrollBars Property 137 Select Property - VBXSelectflag Property - ActiveX 138 SetFormat Property 139 Sharpness Property 139 Showui Property 140 SizeControl Property 141 Status Property 142 TabIndex Property 142 TabStop Property 142 TagString/TagValue Property 143 Tag Property 143 TagtoRead Property 143 Thresh Property 144 TiledImage Property 144 Top Property 144 TranspColor Property 145 x TSCase Property 145 TSEnable Property 145 TSstring Property 146 UnSetFormat Property 146 UseDDBs Property 147 UseHdib Property 148 Version Property 148 VertEdgeDetect Property 148 Visible Property 149 WindowLevel Property 150 WhatsThisHelpID Property 150 WipeDelay Property 151 Zoom Property 151 ZoomBottom, ZoomLeft, ZoomRight, ZoomTop Property 153 Chapter 4 - AFP Font Mapping Property 154 AFP Font Mapping 154 Format of Font Mapping Data 154 FontMapPath Property 155 Chapter 5 - Properties by Category 156 Importing, Loading, Displaying and Saving Images Properties 156 ASCII Import Properties 157 Color Reduction Properties 157 Image Processing and Manipulation Function Properties 157 Sobel Image Processing Properties 158 xi Status And Informational Properties 158 Printing Properties 158 Gray Scale Images 159 PrintFast 159 PrintImage for Printing Bitmaps 159 Printing Large Documents 159 Scanning Properties 160 Steps for Scanning 160 Chapter 6 - Saving and Reading Multi-page Images 162 Multi-page Images 162 Supported Multi-page Formats 162 Decompressing a Multi-page Image 162 Determining Multi-page