Title page

 

Neevia

docuPrinter SDK

 

user’s manual

version 6.0


License Agreement

 

 

ELECTRONIC END USER LICENSE AGREEMENT

 

For One (1) Computer

 

This is an End User License Agreement. This is a contract. If you install this software, you must abide by the terms of this agreement. This license is applicable to all software products sold by Neevia Technology. The term software includes upgrades, modified versions or updates. This software is licensed and not sold. Only a personal, non-transferable and nonexclusive right to use the Neevia products is granted to the end user.

 

The following are definitions that should be noted by the user:

 

  1. COMPUTER

 

This is a single computer owned, rented or leased by a single individual or entity on which one or more applications load and execute software in the memory space of that computer. Software is installed on a server for one or more users. All servers must be licensed to utilize Neevia software.

 

THIS IS A CONTRACT BETWEEN YOU AND NEEVIA TECHNOLOGY. YOU SHOULD CAREFULLY READ THIS LICENSING AGREEMENT AND MUST ACCEPT ALL THE TERMS AND CONDITIONS BEFORE INSTALLING THIS NEEVIA SOFTWARE. BY INSTALLING THE SOFTWARE, YOU ARE AGREEING TO BE BOUND BY THE TERMS AND CONDITIONS OF THIS LICENSE. IF YOU DO NOT AGREE TO THE TERMS OF THIS LICENSE, DO NOT INSTALL THE SOFTWARE, AND DO NOT USE THE SOFTWARE. IF YOU VIOLATE THIS AGREEMENT, YOU WILL BE SUBJECT TO LEGAL ACTION BY NEEVIA TECHNOLOGY.

 

 

Subject to the payment of applicable license fees, Neevia Technology grants you a nonexclusive right to use its accompanying Neevia software product and related documents (the Software) in the terms and conditions provided as follow:

 

LICENSE

 

Until such time as Neevia Technology has issued a valid serial number to you, you may only use this software for a 30-day trial period. You agree to remove any copies of the software after the expiration of the trial period. No license is issued to you until you are issued a valid serial number.

 

You cannot use a license for the software concurrently on different computers. You may install and use the Software in a single location on a hard disk or other storage device of one computer only.

 

 

(a) Home Use:

 

The primary user of each computer on which the Software is installed or used may also install the Software on one home or portable computer.  However another person may not use the Software on a secondary computer at the same time the Software on the primary computer is being used.

 

 

(b)     Server or Network Use:

 

You may keep one copy of the Software on a single file server only for the purposes of downloading and installing the Software onto a hard disk of up to the Permitted Number of Computers that are on the same network as the file server. No other network use is permitted.

 


(c) Operating system or Language versions:

 

If you receive two or more copies of the Software with different operating systems or language versions, the total aggregate number of computers on which all versions of the Software are used may not exceed the Permitted Number of Computers. You may not rent, lease, sublicense, lend or transfer versions or copies of the Software you do not use, or Software contained on any unused media.

 

(d) Archiving:

 

You may make one copy of the Software solely for archival purposes. If the Software is an upgrade, you may use the Software only in conjunction with upgraded product. If you receive your first copy of the Software electronically, and a second copy on media afterward, the second copy can be used for archival purposes only.

 

 

For all Neevia Technology products, you agree that you will only use our software on a server and all applications that will access the server will reside on the server and you will not permit remote access to the software except through your application residing on the server. You agree to surrender your license(s) if you violate this agreement. If you violate this agreement, you will not receive a refund upon termination of this license. You agree not to utilize our software to violate the copyright of any third parties. If you do violate the copyright of a third party utilizing our software, you agree to hold Neevia Technology harmless and will indemnify Neevia Technology for any such activity even if the violation is unintentional.

 

 

COPYRIGHT

 

The Software is owned by Neevia Technology and/or its suppliers, and is protected by the copyright and trademark laws of the United States and related applicable laws. You may not copy the Software except as set forth in the "License" section. Any copies that you are permitted to make pursuant to this Agreement must contain the same copyright and other proprietary notices that appear on or in the Software.

 

You may not rent, lease, sub-license, transfer, or sell the Software. You may not modify, translate, reverse engineer, decompile, disassemble, or create derivative works based on the Software, except to the extent applicable law expressly prohibits such foregoing restriction. You may use the trademarks to identify the Software owner's name, or to identify printed output produced by the Software. Such use of any trademark does not give you any rights of ownership in that trademark.

 

 

NO WARRANTY LICENSED SOFTWARE (S) - "AS IS"

 

The Software is provided AS IS. NEEVIA TECHNOLOGY AND ITS SUPPLIERS MAKE NO WARRANTIES, EXPRESS OR IMPLIED, AS TO THE MERCHANTABILITY, QUALITY, NONINFRINGEMENT OF THIRD PARTY RIGHTS, FITNESS FOR A PARTICULAR PURPOSE, AND THOSE ARISING BY STATUTE OR OTHERWISE IN LAW OR FROM A COURSE OF DEALING OR USAGE OF TRADE. THE ENTIRE RISK AS TO THE QUALITY, RESULTS BY USING THE SOFTWARE, AND PERFORMANCE OF THE SOFTWARE IS WITH THE END USER. Some states or jurisdictions do not allow the exclusion or limitation of incidental, consequential or special damages, or the exclusion of implied warranties or limitations on how long an implied warranty may last, so the above limitations may not apply to you or your company.

 

 

LIMITATION OF REMEDIES AND LIABILITY

 

NEEVIA TECHNOLOGY OR ITS SUPPLIERS OR RESELLERS SHALL NOT UNDER ANY CIRCUMSTANCE BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, INDIRECT, OR CONSEQUENTIAL DAMAGES, LOST PROFITS OR LOST SAVINGS, OR FOR ANY CLAIM BY A THIRD PARTY, ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE, EVEN IF NEEVIA TECHNOLOLGY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.


GENERAL

 

This Agreement shall be construed, interpreted, and governed by the laws of the State of Florida, excluding the application of its conflicts of law rules. The United Nations Convention on Contracts of the International Sale of Goods, will not govern this Agreement. If any part of this Agreement is found void and unenforceable, it will not affect the validity of the rest of the Agreement, which shall remain valid and enforceable according to its terms.

 

If you need to redistribute this product with your own software products, you need to contact Neevia and negotiate a separate licensing and royalty agreement.

 

You may not ship, transfer, or export the Software into any country or used in any manner prohibited by any export laws, restrictions or regulations.

 

 

UPGRADES

 

You must be properly licensed to install upgrades to Neevia Software products. Neevia upgrades replace and or supplement the previous product that formed the basis for your eligibility to for the upgrade. You may use the upgrade only in accordance with the terms of this Agreement. Upgrades may not be separated and used on separate computers.

 

 

GOVERNEMENT USERS

 

For United States government users, the Software and associated Documentation are deemed to be "commercial computer software" and "commercial computer documentation", respectively pursuant to DFAR 227.7202 and FAR 12.212(b) as applicable.

 

 

ENTIRE AGREEMENT

 

You acknowledge that you have read this Agreement, understand it and agree to be bounded by its terms and conditions. It is the complete and exclusive statement of the Agreement between us, which supersedes any proposal or prior agreement, oral or written, and other communication between us relating to the subject matter of this Agreement.

 

 

 

CONTACT INFORMATION

 

NEEVIA TECHNOLOGY

103 NE 4th Street
Fort Lauderdale, Florida 33301
Tel: (954) 893.9343

Email: info@neevia.com

Web: http://neevia.com


                                                                                  Table of Contents

                                                                                                                                                                                                                                                                                                                                 

 

Title page. 1

License Agreement. 2

Table of Contents. 5

Introduction. 9

System Requirements. 9

Output Formats. 9

Installing and Uninstalling Neevia docuPrinter SDK. 10

Neevia docuPrinter SDK COM object. 12

Neevia docuPrinter SDK .NET assembly. 12

Neevia docuPrinter SDK Type Library (TLB file). 12

Properties. 13

DocumentOutputFolder. 13

DocumentOutputName. 13

DocumentOutputFormat. 13

DocumentResolution. 13

PDF Specific Properties. 14

DocumentTitle. 14

DocumentAuthor. 14

DocumentSubject. 14

DocumentKeywords. 14

OptimizePDFfor. 14

PDFLinearized. 15

PDFCompatibilityLevel 15

PDFAutoRotatePage. 16

PDFEmbedAllFonts. 16

PDFProcessColorModel 16

PDFCompressPages. 16

PDFSubsetFonts. 16

PDFFontsMaxSubset. 17

ConvertCMYKImagesToRGB. 17

CompressColorImages. 17

CompressGrayImages. 17

CompressMonoImages. 17

ColorCompressMethod. 18

GrayCompressMethod. 18

MonoCompressMethod. 18

ColorImageResolution. 18

GrayImageResolution. 18

MonoImageResolution. 19

DownsampleColorImages. 19

DownsampleGrayImages. 19

DownsampleMonoImages. 19

MaxInlineImageSize. 19

ColorImageDownsampleType. 20

GrayImageDownsampleType. 20

MonoImageDownsampleType. 20

PDF/A Specific Properties. 21

OutputIntent. 21

PDF Encryption Properties. 22

PDFEncryption. 22

PDFEncryptionType. 22

PDFUserPassword. 22

PDFOwnerPassword. 22

PDFNoCopyPermission. 23

PDFNoPrintPermission. 23

PDFNoChangePermission. 23

PDFNoAddPermission. 23

PDFContentAccess. 23

PDFAllowExtraction. 24

PDFChangesAllowed. 24

PDFPrintingPermissions. 24

PDF Viewer specific properties. 25

HideToolBar. 25

HideMenuBar. 25

HideMainWindow.. 25

PDFOpenView.. 25

PDFOpenAtPage. 25

PDFOpenMagnification. 26

PDFPageLayout. 26

Watermark and Stationery Properties. 27

StampFontName. 27

StampFontColor. 27

StampFontSize. 27

StampMessage. 27

StampDrawMode. 28

PlaceStampOnPages. 28

Watermark. 28

Stamp_X. 28

Stamp_Y. 29

StampUnits. 29

StampOpacity. 29

StampRotate. 29

StationeryFile. 29

PlaceStationeryOnPages. 29

StationeryAsWatermark. 30

Stationery_X. 30

Stationery_Y. 30

StationeryUnits. 30

StationeryOpacity. 30

StationeryRotate. 30

Image specific properties. 31

ImageType. 31

JPEGImageQuality. 32

MultipageTiff. 32

TiffFillOrder. 32

TextAplhaBits. 32

GraphicsAplhaBits. 33

UseCIEColor. 33

Interpolate. 33

UseWTS. 33

FileMask. 34

User Interface specific properties. 35

HideSaveAsWindow.. 35

HideWatermarkButton. 35

HideConfigureButton. 35

HideEmailCheckBox. 35

HideViewCheckBox. 35

HidePDFdesktopCheckBox. 35

DefaultAction. 36

ViewDocumentAfterConversion. 36

EmailDocumentAfterConversion. 36

OpenInPDFdesktopAfterConversion. 36

Methods. 37

NewGUID.. 37

GetDefaultPrinter. 37

SetDefaultPrinter. 37

BackupSettings. 37

RestoreSettings. 37

ApplySettings. 37

Create. 38

TrueTypeFontDownloadOption. 38

FileDelete. 38

FileInUse. 38

FileExists. 38

FileCopy. 38

docuPrinter Word macro. 39

CHBookmarks. 39

CInternetLink. 39

CCrosRef. 39

CCrosDoc. 39

LinkFootEnd. 40

CWordTextBox. 40

CDocInfo. 40

LinkType. 40

LinkHighlight. 40

LinkColor. 41

LinkStyle. 41

CBookNameDest. 41

BookmarkDepth. 41

BookmarkMagn. 41

CFormFields. 42

RenameFormFields. 42

HideTextInputBorder. 42

HideCheckBoxBorder. 42

HideDropDownBorder. 42

CComNotes. 42

ConvertDocument. 43

docuPrinter Excel macro. 44

CHBookmarks. 44

CInternetLink. 44

CDocInfo. 44

LinkType. 45

LinkHighlight. 45

LinkColor. 45

LinkStyle. 45

CBookNameDest. 46

BookmarkDepth. 46

BookmarkMagn. 46

ConvertDocument. 46

docuPrinter PowerPoint macro. 47

CTransition. 47

CHBookmarks. 47

CInternetLink. 47

CDocInfo. 47

LinkType. 48

LinkHighlight. 48

LinkColor. 48

LinkStyle. 48

BookmarkDepth. 49

BookmarkMagn. 49

BlackAndWhitePrinting. 49

ConvertDocument. 49

Examples. 50

Example 1. Create a PDF file from Visual Basic. 50

Example 2. Convert a MS Word document into PDF from Visual Basic. 51

Example 3. Convert a MS Word document into PDF from Visual Basic (using the docuPrinter MS Word Macro)  52

Example 4. Convert a MS Excel document into PDF from Visual Basic. 53

Example 5. Convert a MS PowerPoint document into PDF from Visual Basic. 54

Example 6. Convert a PowerPoint document into PDF from Visual Basic. 55

Example 7. Convert a MS Access report into PDF from Visual Basic. 56

Example 8. Convert an URL / HTML into PDF from Visual Basic. 57


Introduction

docuPrinter SDK is a software development tool that can be used by developers and programmers to control docuPrinter LT, Pro or TSE and programmatically create PDF or Image files from their own applications.

docuPrinter SDK works on every Windows operating system from Windows 2000 to Windows Server 2008 and because it includes both C/C++ libraries and ActiveX controls, the functionality of the product can be accessed from most programming languages like C, C++, Visual Basic, Delphi, MS FoxPro, and MS Access. docuPrinter SDK is also .NET compatible meaning that VB.NET, C#, and J# programmers can also take full advantage of the product.

 

System Requirements

 

Supported Operation Systems
The operating systems listed here have been tested with docuPrinter SDK and are officially supported:

·         Windows Server 2008 32-bit and 64-bit editions;

·         Windows Vista 32-bit and 64-bit editions;

·         Windows Server 2003 x64 64-bit Web Edition, Standard Edition and Enterprise Edition;

·         Windows XP x64 64-bit Professional with Service Pack 2;

·         Windows Server 2003 32-bit Web Edition, Standard Edition and Enterprise Edition;

·         Windows XP 32-bit Professional and Home Edition with Service Pack 1 or 2;

·         Windows 2000 Professional, Server and Advanced Server;

 

Recommended hardware

 

·         Standard PC; 300MHz or faster compatible x86 processor;

·         RAM: 128MB RAM recommended, 32MB minimum;

·         Hard-disk: 15MB free space recommended, 5MB free space required;

·         Display: 16-bit display adapter recommended; greater than 4-bit display adapter required;

 

Output Formats

 

If you have docuPrinter LT installed on the computer, docuPrinter SDK only supports PDF, PDF/A and PostScript as output formats. If you have docuPrinter Pro or TSE installed, docuPrinter SDK supports the following output formats:

 

·         PDF (Portable Document Format) v1.2, v1.3, v1.4, v1.5, v1.6, v1.7;

·         PDF/A-1b

·         PostScript level 1, 1.5, 2, 3;

·         TIFF (uncompressed, LZW, Packbits, G3, G4);

·         JPEG;

·         PCX;

·         PNG;

·         BMP;

·         EPS level 1, 1.5, 2, 3;

·         PSD (Adobe PhotoShop);

·         HP PCL-XL (color and mono);

·         Text;


Installing and Uninstalling Neevia docuPrinter SDK

 

Before installing and/or using this product, please make sure you carefully read the copyright notice and agree to all of its terms. If you have any questions about the licensing agreement, please feel free to call (954) 981.9252 or email sales@neevia.com.

 

If you are using an earlier version of Neevia docuPrinter SDK on your system, it is recommended that you uninstall it before installing Neevia docuPrinter SDK v6.0.

 

To install Neevia docuPrinter SDK:

 

If you already have docuPrinter LT, PRO or TSE installed on your computer:

download and save the http://neevia.com/prods/dpsdk.exe file to your hard disk. After downloading the file, double-click it and follow the instructions. The installation procedure automatically detects your operating system, copies the needed files to your system directory and installs Neevia docuPrinter SDK.

 

If you don’t have docuPrinter LT, PRO or TSE installed on your computer:

download and install docuPrinter LT, PRO or TSE then download and save the http://neevia.com/prods/dpsdk.exe file to your hard disk. After downloading the file, double-click it and follow the instructions. The installation procedure automatically detects your operating system, copies the needed files to your system directory and installs Neevia docuPrinter SDK.

 

Unattended installation:

To perform an unattended (silent) installation launch docuPrinter SDK installer with /sp- /verysilent /norestart command line switches. Here is the full list of supported switches:

 

/SP-

Disables the "This will install... Do you wish to continue?" prompt at the beginning of Setup.

 

/SILENT, /VERYSILENT

Instructs Setup to be silent or very silent. When Setup is silent the wizard and the background window are not displayed but the installation progress window is. When a setup is very silent this installation progress window is not displayed. Everything else is normal so for example error messages during installation are displayed and the startup prompt is (if you haven't disabled it with '/SP-' command line option explained above). If a restart is necessary and the '/NORESTART' command isn't used (see below) and Setup is silent, it will display a “Reboot now?” dialog. If it's very silent it will reboot without asking.

 

/NOCANCEL

Prevents the user from canceling during the installation process, by disabling the Cancel button and ignoring clicks on the close button. Useful along with /SILENT.

 

/NORESTART

Instructs Setup not to reboot even if it's necessary.

 

/DIR="x:\dirname"

Overrides the default directory name displayed on the Select Destination Directory wizard page. A fully qualified pathname must be specified.


/GROUP="folder name"

Overrides the default folder name displayed on the Select Start Menu Folder wizard page.

 

/user="username", /company="company name", /serial="serial number"

Use these switches to pass the registration info (username, company name and serial number) to the installer.


To remove Neevia docuPrinter SDK from your system:

 

1. Select Settings -> Control Panel from the Start menu.

 

2. In the Control Panel click Add/Remove programs and select docuPrinter SDK from the list.

 

3. Click the Add/Remove button to remove the program.

 

A confirmation prompt is displayed.

 

 

Unattended uninstall:

To perform an unattended (silent) uninstall, launch unins000.exe from the folder where docuPrinter SDK has been installed, with /verysilent /norestart command line switches. Here is the full list of supported switches:

 

/SILENT, /VERYSILENT

When specified, the uninstaller will not ask the user for startup confirmation or display a message stating that uninstall is complete. Shared files that are no longer in use are deleted automatically without prompting. Any critical error messages will still be shown on the screen. When '/VERYSILENT' is specified, the uninstallation progress window is not displayed. If a restart is necessary and the '/NORESTART' command isn't used (see below) and '/VERYSILENT' is specified, the uninstaller will reboot without asking.

 

/NORESTART

Instructs the uninstaller not to reboot even if it's necessary.

 


Before calling the docuPrinter SDK COM object, make sure that you have

docuPrinter LT, PRO or TSE installed!!!

 

Neevia docuPrinter SDK COM object

 

Class ID

   docuPrinter.SDK

 

Example:

        Visual Basic:  Set DPSDK = CreateObject("docuPrinter.SDK")

 

                 Delphi: DPSDK := CreateOLEObject(‘docuPrinter.SDK’);

 

                    ASP:  Set DPSDK = Server.CreateObject("docuPrinter.SDK")

 

                    VC#: