Home

3-Heights™ Image to PDF Converter API, User Manual

1. Get or set the compression type of indexed images in the PDF document Supported compressions are Flate and LZW see also enumeration TPDFCompression InfoEntry Property String InfoEntry String Key Accessors Get Set Parameters Key A key as string Return value Value The value as string Retrieve or add a key value pair to the documents info object Values of predefined keys are also stored in the XMP metadata package Popular entries defined by the PDF Specification and used by most PDF viewers are Title Author Subject Creator sometimes referred to as Application and Producer sometimes referred to as PDF Creator Examples in Visual Basic 6 Get document title t InfoEntry Title Set document title InfoEntry Title my title Set the creation date to 13 55 33 April 5 2010 UTC 2 InfoEntry CreationDate D 20100405135533 02 00 Lang Property String Lang Accessors Get Set Default US EN Set the language for the alternate text that is set using the property Alt The default language is US EN Other languages can be set using the corresponding abbreviations e g DE German FR French etc PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 23 39 Linearize Property Boolean Linearize Accessors Get Set Default False Get or set whether to line
2. 37 39 TPDFCompression eComprRaw No compression eCompr JPEG Joint Photographic Expert Group eComprF late Flate compression eComprLZW Lempel Ziv Welch eComprGroup3 CCITT Fax Group 3 eComprGroup3_2D CCITT Fax Group 3 2D eComprGroup4 CCITT Fax Group 4 eCompr JBIG2 Joint Bi level Image Experts Group eCompr JPEG2000 JPEG2000 eComprUnknown Unknown compression Note that not all image formats color depths support all compression types TPDFErrorCode All TPDFErrorCode enumerations start with PDF_ followed by a single letter which is one of S E W or I an underscore and a descriptive text The single letter gives in an indication of the type of error These are Success Error Warning Information With respect to corrupt PDF files An error indicates a corruption in the PDF the file may or may not be readable A warning indicates the file is readable but not valid A full list of all PDF Tools error codes is available in the header file pdferror h Note that only a few are relevant for the Image to PDF Converter API The most common are listed here PDF_S_SUCCESS The operation was completed successfully LIC_E_NOTSET Various license management related errors LIC_E_NOTFOUND PDF_E_FILEOPEN Failed to open the file PDF_E_FILECREATE Failed to create the file The following warnings can occur when creating PDF A PDF_12P_W_OUTPUTINTENT An output intent was required An sRGB profile was
3. SetPageSize Method Boolean SetPageSize Single Width Single Height Set the page size of the current and following pages in the PDF document in points 1 point 1 72 inch Parameters Width The width of the page in points Height The height of the page in points Return value True The page size was be set successfully False otherwise The default values if the property AdjustPage is set false is Width 595 and Height 842 A4 ThresholdDPI Property Single ThresholdDPI Accessors Get Set Default 225 Get the threshold in dpi to selectively activate re sampling Only images with a resolution above the threshold dpi will be re sampled The typical threshold value when optimizing for the web is 225 dpi default This property affects all three image compression types bi tonal monochrome color Set to 1 to deactivate re sampling 6 2 The PDFCodec Interface The codec interface provides information about the image Such as bits per component components per pixel color space the image data itself etc This data can be used by other applications such as the PDF Prep Tool Suite Keep in mind that most properties are not read before a page number is defined using the PageNo method This is also true for images with just one page BitsPerComponent Property Integer BitsPerComponent Accessors Get Return the number of bits that are used to represent a single color
4. User Manual ARRE ywPDE A compliant Contents 1 Introduction sss s 5 oie ios ne dic rier ore e A wee EE E A A dw ROR Ie eee 1 els DESERIDUOM A a RR te a RL ahah A RAGS Alon Wa LARA ASA ARS a OR aca aes 1 12 FUNCUONS a s a eaaa A A A Angus Ghd anand as aa 2 13 WMtEHAGES 44 4 asi as de Sons tea de nt A Aaa dee head ee bee 3 1 4 Operating Systems osa ria aoe he deal aon poh iy dea wae eb ay dea Aude h dea AG 3 2 INSTAMMAtION lt lt 6 sie a ci 6 dee Sb es iw eS A RE Bree Eee eR Oe Cale Eee oe 4 2 1 Download and Installation 2 ee 4 Z2 WIN COWS aoaea Wet hg a dnt Si apd a i ae dd EA cats Gs hee eA ana ce cee ow ee teins ae Wht Es 5 2 3 Uninstall Install a New Version ee eee eee 6 24 IDO aint do fo oe AAR A th ale Ve ar anaes w Wael Rea able AA ata Gin a a Ata wads Ve aaa 6 3 License Management oc sce be ee ra Ee Pee Ess issor Eso ee HOES Pee 7 3 1 Graphical License Manager Tool 1 ee 7 3 2 Command Line License Manager Tool 1 1 eee 8 3 3 LICENSE Key Storage ht nae oth eave avin ae ll a ah anus Ghee Mate Ata aud eaten sy 8 4 Programming Interfaces o oooooocoocconornconoraonaor ao 9 41 VISUalBasiCiO a ara dar da a ad a a da ae aca ae A aos 9 AZ CCEE a aie ada ca do Gad ws Na A A a de on bea 10 AS ANET hice rs ee eh arn ae We wh ar AAA oes Ae LA AS DA Aan OU A we Ae es Gea ats 10 AA NANA a A AR Reda Hos A a a dale Od asa teas A ace deo SEAS 12 5 Users GUIAS eiii ae er aa d
5. GetOCRENSINE seh Pr ee eh er e tice ee Be ae o ih sgn he As ate ee RA Ao E GP edna Beco Golden ww ew 19 GetOCRENgiNECOUINE is ek as aa ace oe elas les ec che A taa a ea RGR aad Da Oe ca 19 GetOCGRPluginCount 25 5 40d 5 4 haw diane debe eee ie Seb od Ee be edd e Gate Ghats at 19 GetOCRPIUSINNAME hoi a eke he ee ae LS er ee eee Se A GES ed 19 GetPDF isa Bead e eee UAE RASS ee WER AE PRE ee eG ee ee eee ee ek a 20 ImapeQuallity re deta ee eee WES a ERS Ee EGA ae de TES ES des 20 IMAeXEAEOMPRKESSION i jase so a oda a a SoA a ha ands ace a e GO Soh dogo ala a AS aa 20 ITO EMU eed aioe dred A ok aS eh eae REE E Mtb ae A eee Dee eae RA amp BAe aes 20 Lang si aa ds ada a ee a ae ace oa ake A a ake Se eae eed a ee a 20 LINEGANIZE s 2 05 ee eae CR eA RA ERR A RR SRR A ee PEER Oe eG SEE EER a eo 21 OCREMbedOCRi image 5 ita Oe wea we we A Bee a ea Be ee Ae Ee Se A eS 21 OCRBitonalRecosnition scs s cee bed bee wR SR p a RR ee EG ee AA ee ee 21 OCRDESKEWIMABS sona pe eh he RO SR hw RS EAA SESE ORR eee Ga oe Phas Ses 21 OCREMbDedBarcodeS erica ae Dae ae ede Ghar ena a Bene Abe Sad tl a alae eek wee 21 OCRResolutioNnDPl saw eA ASS ak SEES RES EMRE AS we ee eee Ee Oe RS Ca deals 22 OGREhresholadDPl ruso iio oe tied Gok oF PE EUS Hike ASS G Gd WOES Re Sas ok SS RW bd 22 Orientation 2c ese ase de Ren Mahe PRED ARR WSR DR EERE DEES OGRE EDA EO A EEE RE es 22 PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July
6. NET 1 0 0 0 True C Program Files pdF tools bin Img2PdFNET dll libpdfFNET NET 1 0 0 0 True C Program Files pdf tools bin libpdf NET dll Resources System NET 2 0 0 0 False C WINNT Microsoft NET Framework v2 0 50727 System dll System Data NET 2 0 0 0 False C WINNT Microsoft NET Framework v2 0 50727 System Data dll Settings System Deployment NET 2 0 0 0 False C AWINNT Microsoft NET Framework w2 0 5072715ystem Deployment dil System Drawing NET 2 0 0 0 False C WINNT Microsoft NET Framework y2 0 50727 System Drawing dll Signing System Windows Forms NET 2 0 0 0 False C WINNT Microsoft NET Framework y2 0 50727 System Windows Forms dll System Xml NET 2 0 0 0 False C WINNT Microsoft NET Framework w2 0 5072715ystem Xml dll Security Publish Update Web Reference Add Remove Imported namespaces Paftools Img2PdF Add User Import C Microsoft VisualBasic MyServices ry C Microsoft isualBasic MyServices Internal C Microsoft win32 Microsoft Win32 SafeHandles Pdftools Pdf System CodeDom System CodeDom Compiler System Collections ObjectModel xl ION KOOL OL Update User Import 4 The NET interface can now be used as shown below Dim converter As New Pdftools Img2Pdf Img2Pdf converter Create converter CreatePagesFromFile converter Close C 3 Add the following namespaces using Pdftools Pdf using Pdfto
7. 16 2015 35 39 Text Property String Text Accessors Get Get the recognized text PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 36 39 6 6 Enumerations Note Depending on the interface enumerations may have TPDF as prefix COM C or PDF as prefix NET or no prefix at all Java TPDFColorSpace eColorGray Gray eColorGrayA Gray with alpha channel eColorRGB Red Green Blue eColorRGBA RGB with alpha channel eColorCMYK Cyan Magenta Yellow Key eColorYCbCr YCbCr eColorYCbCrK YCbCrK eColorPalette Color space using a palette eColorLAB CIE L a b eColorOther Other TPDFCompliance ePDF10 PDF Version 1 0 ePDF11 PDF Version 1 1 ePDF12 PDF Version 1 2 ePDF13 PDF Version 1 3 ePDF14 PDF Version 1 4 corresponds to Acrobat 5 ePDF15 PDF Version 1 5 ePDF16 PDF Version 1 6 corresponds to Acrobat 7 ePDF17 PDF Version 1 7 ePDFAla PDF A 1a ISO 19005 1 Level A compliance ePDFA1b PDF A 1b ISO 19005 1 Level B compliance ePDFA2a PDF A 2a ISO 19005 2 Level A compliance ePDFA2b PDF A 2b ISO 19005 2 Level B compliance ePDFA2u PDF A 2u ISO 19005 2 Level U compliance ePDFA3a PDF A 3a ISO 19005 3 Level A compliance ePDFA3b PDF A 3b ISO 19005 3 Level B compliance ePDFA3u PDF A 3u ISO 19005 3 Level U compliance ePDFUnk Unknown format default PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015
8. AA ar SG ee Se ee Geen PS 32 EOMtNaMe 2 ooh eee o A A A RRA AS Bas 32 FONUSIZE lt gt a A ad A oe ae A A d da A ae ea 32 A 32 O PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 2 39 SHINS UEM SCM iaa a aS ann ake a etal Mat ee ane a 32 TEKE incense AS MOR eR A ean Bw ee doe A Ok A Ge ais os ee she Gah ed a aA A as 33 6 6 EMUIMEFALONS sc Sai ai aod eos Saad ale ae a ais Aldi ace Hawa a4 God wee IAs Od aaa A Ale aes 34 TIRDE OlOPS PAGO is ina 2 nance as Aa aes ada Maes Ate Shans E Aa Aas Sit a ease 34 TPDFGOmplianee neue ke a Be a a ae A eee a aes Gees 34 TPDFCOMPreSSION socra 4d 2 4 ai BEG aoe we tk PE Saw We Se A Sere ae ES A ED Ae 34 TPDFEFrFOrCOdE sii OAR AR RR REE AA TR ROE ERS OE OD et ba ea Peas Bae A 35 VPDEQMe nta tion sea ae aa A A a AO Bete ae Ry Saeco A ARA AAN ae es 35 TPDFPermission ss ch cs eid a a kota a wa a op At e a cadens am AA ds ow ae waa ey bak ogy once a 36 6 7 Supported Image Extensions 1 eee 36 6 8 Supported Image Compression Types o 37 No Compression RaW e ees eneit eea ds Hk Co RE Re ER DE eS SE ee 37 DCT PEG 2323 sees eee ck eee a REE ERE Eee EEE REEMA RD GR AAA eee ee 37 Flate ZUR or ed ech ahd Boake ae cae Sah een ee ep sy ease id ed 37 ZW aa a ca aa a Sac BRE gy a EE E le Uda saa Saad BLEW as SLE as Wook asa eG ey os bel mh A ced 37 CITT Fax Group 3 and As coco ett BY dete be he ee ee Ob oS BEE be ee hah de ea 37 JEIGZ u
9. IMG2PDFAPILib Img2Pdf conv Create App Path amp output pdf conv CreatePageFromImage App Path input jpg conv Close End Sub The four steps of the above code are very simple 1 Create a Img2Pdf object 2 create an PDF file for output 3 open an image file for input and copy its page s 4 close PDF and image file And that s all a few lines of code To modify your program and set options consult the Reference Manual section PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 12 39 4 2 C C The header file img2pdfapi_c h needs to be included in the C program The library ib img2PdfAPI lib needs to be linked to the project 4 3 NET References The 3 Heights Image to PDF Converter API does not provide a pure NET interface Instead it consists of NET assemblies and a native DLL This has to be accounted for when installing and deploying the software 1 The NET assemblies NET d are to be added as references to the project see screenshot below To do so in the Solution Explorer right click your project and select Add Reference The Add Reference dialog will appear In the tab Browse browse for the NET assemblies ibpdfNET dll and Img2PafNET dll add them to the project as shown below NET com Projects Browse Recent Look in a bin ef EA File name ibpdfNET DLL Img2PdfNET dll z File
10. The registration can also be done silently e g for deployment using the switch s The other DLLs do not need to be registered but for simplicity it is suggested that they are in the same directory as the mg2PdfAPI dill Identify which interface you are using Perform the specific installation steps for that interface described in chapter Interfaces 1Otherwise you get the following message LoadLibrary Img2PdfAPI dll failed The specified module could not be found PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 7 39 2 2 Windows General Here is an overview of the relevant files that come with the 3 Heights Image to PDF Converter API Tool bin Img2PdfAPI d11 binYpdcjx d11 binX NET d11 bin ocr liblImg2PafAPT 1ib jar I2PA jar doc Img2Pdf API idl include Img2PdfAPI h Include Img2PdfAPI_c h Include Img2PdfAPI_i c Include pdferror h This is the DLL that contains the main functionality required This DLL contains support for Asian languages optional It is loaded from the mod ule path The NET assemblies required if using the NET interface These are an OCR interface DLLs that are used in combination with the 3 Heights OCR Enterprise Add On which can be purchased as a separate product These files must reside in the same directory as Img2Pdf dll Import library for C programs Java API archive COM interface definition C API
11. format of the same color depth Modify TIFF image compression Set quality index for lossy image compression Create lossy and lossless JPEG2000 and JBIG2 images Read input and output document from file or memory Formats Input Formats BMP 1 2 4 8 24 bit GIF 2 to 8 bit JBIG2 lossy compression lossless compression JPEG JPEG2000 and JPEG LS Grayscale RGB CMYK PBM and PNG 1 to 8 24 bit TIFF Bitonal uncompressed CCITT G3 CCITT G3 2D CCITT G4 LZW ZIP Packbits Grayscale RGB and CMYK uncompressed LZW JPEG JPEG old ZIP Packbits Output formats Image to PDF Converter PDF 1 x e g PDF 1 4 PDF 1 5 etc PDF A 1a PDF A 1b PDF A 2a PDF A 2b PDF A 2u PDF A 3a PDF A 3b PDF A 3u Output formats Image to Image Converter All input formats plus EPS Compliance Standards ISO 19005 1 PDF A 1 ISO 19005 2 PDF A 2 ISO 19005 3 PDF A 3 ISO 32000 PDF 1 7 TIFF V6 Quality assurance Isartor test suite PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 5 39 1 3 Interfaces The following interfaces are available C Java NET COM 1 4 Operating Systems Windows XP Vista 7 8 8 1 32 and 64 bit Windows Server 2003 2008 2008 R2 2012 2012 R2 32 and 64 bit HP UX 11 and later PA RISC2 0 32 bit or HP UX 11i and later ia64 Itanium 64 bit IBM AIX 5 1 and later 64 bit Lin
12. of 10 are supported For both JPEG2000 and JBIG2 a quality index of 100 means lossless compression JPEG compression is always lossy IndexedCompression Property TPDFCompression IndexedCompression Accessors Set Set the compression type for indexed images in the output image See also enumeration TPDFCompression Quality Deprecated use ImageQuality instead 6 4 The ImgOcr Interface The image OCR interface allows you to extract OCR text from an image opened using the PDFCodec interface During that process no output file is created The ImgOcr interface is not needed to create a searchable PDF use the Img2Pdf interface for that task GetFirstOcrText Method OcrText GetFirstOcrText Get the first text fragment recognized or NULL if none available GetNextOcrText Method OcrText GetNextOcrText Get the next text fragment recognized or NULL if none available GetOCREngineName Method String GetOCREngineName Get the name of the currently set OCR engine GetOCRPluginCount Method Integer GetOCRPluginCount Get the number of available OCR plugins see GetOCRPluginCount of the Img2Pdf interface GetOCRPluginName Method String GetOCRPluginName Integer i0CREngine Get the name of the i th OCR plugin engine PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 34 39 Recognize Method Bo
13. or a PDF A document The output is used for any purpose such as sending it back to the submitter of the original image archive it or forward it for post processing How does the API work The way to use the 3 Heights Image to PDF Converter API is output oriented An Img2Paf object is bound to a PDF output document which can be a PDF file or a PDF in memory One or multiple images can be opened and their pages or a selection of pages are converted to PDF pages and added to the PDF output document This allows for single document conversion as well as merging multiple image documents into one PDF docu ment or split one multi page image e g a TIFF to single page PDF documents The basic call sequence is Create object Set PDF output document compliance such as PDF 1 5 or PDF A 2b Create PDF output document Apply settings page size quality color profiles etc Create page s from image input document s Close PDF In Visual Basic 6 these calls could look as below Dim conv As New IMG2PDFAPILib Img2Pdf conv Compliance IMG2PDFAPILib ePDFA1b If Not conv Create outputPDF txt Then conv AdjustPage 1 If Not conv CreatePagesFromFile inputImage txt 1 1 Then conv Close Use in Conjuction with the PDF Prep Tool Suite The 3 Heights Image to PDF Converter API is also bundled to the PDF Prep Tool Suite PTS in order to convert raster images to PDF images which then can be added to PDF d
14. re compressed Advantages Invalid streams are repaired as far as possible Standard JPEG streams are created which should be readable by any application Disadvantages Recompressing a lossy stream usually increases the file size and lowers the Quality ResolutionDPI Property Single ResolutionDPI Accessors Get Set Default 150 Get or set the resolution in dpi after re sampling images This property affects all three image compression types bi tonal monochrome color The typical value for the resolution when optimizing for the web is 150 dpi For printing typically no re sampling is applied see property ThresholdDPI Pre blended images images with a color key mask mask and soft mask images are not re sampled O PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 25 39 SetColorSpaceProfile Method Boolean SetColorSpaceProfile String Profile Set a color space profile for embedding in the output PDF See also SetOutputintent for color profiles The color profile provided here is used directly for the image s color space Parameters Profile The file name of the color profile Return value True The color profile was set successfully False The file name points to an invalid color profile Only PDF A compliant profiles are accepted At maximum three profiles one RGB profile one CMYK profile and one Gray profile can be set by using at
15. 16 2015 1 39 QUAY carito a Io Acme ee Bera aaa asis 22 RECOMPLESS aair aara a A A A A A WER eh a Goat Ae Rac Stn Bhs 22 Resolution DPI s kosea a a Jay A A ad we aa A aed 22 SetGolorSpaceProfile vocera SERED EA A A RA 23 SetMetadata s 00 cesa aos de BEES A E a eae 4 23 SetOCRENSING awa aoe sa diep A A AR ARA Bak lw ape a 23 SCTOGRESMSUARES isabel wy hot aR ae e tke a He ab BE Se chee to vdeo ee oe 24 SETOGRPARAMS aor oi vei gese we RLF Bue ee gaa a ley A A ay Bos BOE Ras en Berea ee a S 24 SCTOUCOULIMCEM Essie ssc ate A ge eRe A aca aay te A e Gites ahs anh od pho AA ds 24 Setragesizo via a ip ao a GL GE ds eater ay de Hever eats Sa See Ee agit 25 ThresholdDPl 2 60446 cee eae RRR ER ERD PRE EES DLS SME AAA REE ORE EE Eee ae 25 6 2 The PDFCodec Interface ee eee eee eee eee 25 BItsPer COMPONENT esa se Ged Med Bod oka Rae wee ee ae de Glee Soe SRE we Rok SL Ge a RE Ges 25 A NA Bankok BOR whedon eae 25 ColorSpace sido Be A A ee Se I eet AR PB he ede Ged AR Ge A ee 26 ComponentSPerPixel s as a whale ace a Sig a ars lo EGS cee heck Fat Bs a wou ae a ala lee aoa a aoe cece 26 GOMPHKESSION errada BY BARRE EE OY ESS Hat ey Ga AAA 26 Create A Se inde Ge cyte shone neces Wo Serves ties Senay se Ee SGN ee Sansa a NRE os ated a toate Stree Ne do ds 26 CreatelMMemory a eiia 3 tek cao aCe ee wy pee ey a eco Bd BLS Bae ts al ba Hoa a LA a ar ee ga ad Ge a 26 PADDR U TYP sos id rad iii A ad a Read che con She sae dde o 26 A RA 26 DECO puss ssa
16. 2 Bit 12PA200x64 zip build 2 0 final 8 8 2011 Image to PDF Converter API SDK 64 Bit XMPS200WIN32 zip build 2 0 final 5 16 2011 XMP Transformer Utility 12PA210PreWIN32 MSI Zip build 2 1 24 0 11 22 2011 Image to PDF Converter API SDK 32 Bit 12PA210PreWiN32 zip build 2 1 24 0 11 22 2011 Image to PDF Converter API SDK 32 Bit 12PA210Prex64 zip build 2 1 24 0 11 22 2011 Image to PDF Converter API SDK 64 Bit AMPS210PreWiN32 Zip build 21 240 11 22 2011 x There are 32 and 64 bit versions available The 32 bit version runs on both 32 and 64 bit platforms There is a zipped MSI MSI zip and a ZIP zip version available The MSI Microsoft Installer provides an installation routine that installs and uninstalls the product for you The ZIP version allows you to select and install everything individually Download the version you wish to install PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 6 39 3 If you select an MSI version extract the MSI start it and follow the steps in the installation routine No further steps are needed If you are using the ZIP version follow the steps below Open the ZIP archive Check the appropriate option to preserve file paths folder names and unzip the archive to a local folder e g C program files pdf tools The unzip process now creates the following subdirectories bin Contains the runtime executable binary code an
17. 5 40 39 CCITT Fax Group 3 and 4 Developer Version Color depth Compression type Compression algorithm Application area JBIG2 Developer Version Color depth Compression type Compression algorithm Application area JPEG2000 Developer Version Color depth Compression type Compression algorithm Application area PDF Tools AG Premium PDF Technology International Telecommunications Union ITU formerly known as the Comit Consultatif International T l phonique et T l graphique PDF 1 0 PDF A 1 1 bit per pixel Lossless Group 3 1 dimensional version of the CCITT Group 3 Huffman encoding algorithm 4 Group 3 2D 2 dimensional version of the CCITT Group 3 Huffman encoding algorithm 5 Group 4 An advanced version of a bi tonal algorithm based on the CCITT Fax Group 3 2D compression 6 Line art image bi tonal faxes Joint Bi Level Image Experts Group PDF 1 4 PDF A 1 1 bit per pixel Lossless if the image quality index is set to 100 Lossy otherwise The image is broken down into individual symbols which are stored in a table A symbol is added to the table if it doesn t exist yet If a matching symbol already exists it is used as a reference This algorithm works especially well for images with a lot of similar symbols such as scanned text or images that use patterns Generally JBIG2 provides a better compression ratio than CCITT G3 or G4 compression Typical compression rati
18. OCR plug in Each plug in corresponds to one OCR engine The number of OCR plug ins is retrieved using n GetOCRPluginCount The method GetOCRPluginName n returns the name of the nth OCR Engine which corresponds to that OCR plug in At present there are three OCR engines available Abbyy service and tesseract Parameters iOCREngine The nth OCR engine The total number of engines is retrieved using GetOCRPluginCount Return value The name of the nth OCR engine Null if it doesn t exist PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 22 39 GetPDF Method Variant GetPDF Get the output file from memory See also method CreatelnMemory Return value A byte array containing the output PDF In certain programming languages such as Visual Basic 6 the type of the byte array must explicitly be Variant ImageQuality Property Single ImageQuality Accessors Get Set Default 75 Get or set the quality index of the lossy compression This is a value from 1 to 100 This can be applied for JPEG JPEG2000 and JBIG2 compression For JBIG2 only the values from 10 to 100 that are multiples of 10 are supported For both JPEG2000 and JBIG2 a quality index of 100 means lossless compression JPEG compression is always lossy IndexedCompression Property TPDFCompression IndexedCompression Accessors Get Set Default eComprFlate
19. age range to be copied from a multi page input file Default 1 ToPageNo optional The last page of the page range to be copied from a multi page input file Default 1 last page Return value True The file of the image was created successfully False otherwise CopyPage Method Boolean CopyPage PDFCodec InputCodec PDFCodec OutputCodec This method copies the current page PDFCodec Page from a PDFCodec object to another PDFCodec object Target codec has to be an opened file using Open or Create Parameters nputCodec A PDFCodec object containing a valid image at the currently set page number of the input codec OutputCodec A PDFCodec object to which the page is appended The currently set page number in the output codec is not relevant Return value True The page was copied successfully False otherwise DPI Property Long DPI Accessors Set Get Default O not applied Set the resolution in dpi dots per inch This property supports up sampling but not down sampling PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 33 39 ImageQuality Property Single ImageQuality Accessors Get Set Default 75 Get or set the quality index of the lossy compression This is a value from 1 to 100 This can be applied for JPEG JPEG2000 and JBIG2 compression For JBIG2 only the values from 10 to 100 that are multiples
20. alue True The page s in the PDF document were created successfully False otherwise CreatePagesFromFile Method Boolean CreatePagesFromFile String FileName Long FromPageNo Long ToPageNo This method adds the page or a page range for multi page TIFF images of an image file to the current PDF output It must be called after Create or CreatelnMemory PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 20 39 Parameters FileName The file name and optionally the file path drive or server string according to the operating systems file name specification rules FromPageNo optional The starting page number Default 1 ToPageNo optional The last page number Default 1 last page Return value True The page s in the PDF document were created successfully False otherwise DefaultDPI Property Single DefaultDPI Accessors Get Set Default 96 Set the default resolution in DPI dots per inch if it s not provided by the image Default is 96 dpi If the resolution is given by the image then this option doesn t have any effect Basically it changes the amount of dots per inch by changing the size of the image in the PDF document The size of the raster image in pixel is not changed ErrorCode Property TPDFErrorCode ErrorCode Accessors Get This property can be accessed to receive the latest error code See also e
21. an also split multi page image files into single page PDF files Further options include defining page size and resolution image scaling and the inclusion of external metadata Optical character recognition OCR is also available as an option Features Image to PDF Convert single page or multi page raster images to PDF Definable output format PDF A 1 PDF A 2 PDF A 3 PDF 1 x Automatic or selectable image compression depending on the image type Automatic or selectable PDF page size Selectable page area Selectable image quality for lossy compression PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 4 39 Set image position Set scaling Set standard resolution DPI X and Y coordinates Set encryption and access rights Selectable and embeddable ICC color profile Define alternative texts tagging and image language Set document attributes Input and output document from file or memory Set cropbox for the generated PDF file Optional JPEG image recompression Set image orientation List available OCR engines Set OCR engine Set OCR engine language s Set options specific to OCR engine performance optimization Embedding metadata Support for image masks Image to Image Split single page or multi page raster images into individual single page images Merge multiple images to form one multi page image Convert to an image
22. and RR ay hog Ae OS a ape SUE aa a glee aie 30 GOMVENFIIG aio a aie oe SE ace E ee diese a whee I Some Hecate GF ae Eine ah ae Ae chee te Gh ees 30 COPY PAS a 2000 rica iia aCe Sac om hy as gal ve a a eck eo eos a QOS fe Wee ay LAA aed oo Gaus aba Ge eld 30 DP sae ae eS RRA HEE ERR AR OR EE RARER EEDA SRR Oe EERE Re ee SE TE ES Ree Geo 30 IMageQUalW iii e a Ee wey Se HR Ghee e Be WARE a NE we eee ee Mine tiated 31 IndexedCoOmpression morder HSE E SEER MESS ORE ee PEG Ow pe ee ee a 31 Quality a Era Sch ao POSEY Bah eae de SM bh ae ee SS eh Bad be de Shae aoe 31 6 4 ThelmgOcr Interface eee eee eee ee 31 GetFlrstOCrTeXE iii a ug ee ee OA eos se le oles A Bho em GE ROR ace ee a aa a A 31 GEtNEXCOEKT OKC eaa d aaa waa aa a a a a aah Re eh peak a eked deol ob ee Sea eae hte ew 31 G EtOCRENgsineNaMe iiss dea ee a Eee ee a rebel a eS we ate APS A Se ae dae 31 GetOCRPluginGoOUNt ss osa ck RGA a EERE HRS AER Re RR ee Eb ee al pas ae ea ee 31 GetOCRPIUSINNAME sora eas eae rd hae DEES A Be eee Slee e wee 4 Sawa ke 31 REGOSMIZG Ss ier iros Geass jara a Gy Bob dag i aes ee ae ene Gtk BME aay nM ane Go Geen Gh aie baa oes 32 SetlMages o is a We AR Ree ee Se a oh REE eS Bc ary are eee ign hs Go a hie OM En a ee 32 SetOCRLanguages soii e ae ene a A we ae ae AO a Goa Ale eg 32 SETOCRPARAMS 2 a tes wad rad Ss Seta Lage E OOO SG Pee a Se Bale ch eles BE hades 32 6 5 The OcrText Interface 2 ee ee nee eee ee 32 BaseLINS s Fii a E A AA A o Resign
23. arize the PDF output file for fast web access Linearization is the process of preparing a PDF file in a way that permits random page access by a web browser While the whole non linearized PDF file must be downloaded before the first page can be displayed this is not the case for a linearized file OCREmbedOCRIimage Property Boolean OCREmbedOCRImage Accessors Get Set Default True This property specifies whether or not the deskewed and denoised image created by the OCR engine is used in the output file If this property is set to False the input image is copied to the output file OCRBitonalRecognition Property Boolean OCRBitonalRecognition Accessors Get Set Default false Specifiy whether the images should be converted to bi tonal black and white before OCR recognition Enabling this feature can improve the memory consumption of the OCR process It is suggest to set this prop erty to true when using ABBYY 8 or Tesseract Enabling this feature automatically re embeds the original images in the output document The setting of the property OCRReembedImages is therefore ignored OCRDeskewlmage Property Boolean OCRDeskewImage Accessors Get Set Default True Do not de skew original image if OCRReembedImages is set to True only This option specifies whether the image and text are de skewed according to the recognized skew angle True Rotate image such that lines of text are made hori
24. ault eComprGroup4 Get or set the compression type for bi tonal images Normally either CCITT G4 or JBIG2 is used for bi tonal compression Due to the simpler algorithm CCITT G4 has the advantage of being faster JBIG2 can achieve compression ratios that are up to twice as high as CCITT G4 at the cost of longer computation time See also enumeration TPDFCompression PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 32 39 ContinuousCompression Property TPDFCompression ContinuousCompressionCompression Accessors Set Set the compression type for color and grey scale images in the output image See also enumeration TPDF Compression ContinousCompression Deprecated use ContinuousCompression instead ConvertFile Method Boolean ConvertFile String InputFileName String OutputFileName Long FromPageNo Long ToPageNo Convert an image from one type to another and save it to a file The image type is defined by the extension of the parameter OutputFileName See also chapter Supported Image Extensions Parameters nputFileName The file name and optionally the file path drive or server string according to the operating systems file name specification rules OutputFileName The file name and optionally the file path drive or server string according to the operating systems file name specification rules FromPageNo optional The first page of the p
25. ava API archive include h Contains files to include in your C C Project Example code written in different programming languages are available at product page of the PDF Tools AG website http www pdf tools com All Unix Platforms 1 Unpack the archive in an installation directory e g opt pdf tools com 2 Copy or link the shared object into one of the standard library directories e g ln s opt pdf tools com bin libImg2PdfAPI so usr lib 3 Verify that the GNU shared libraries required by the product are available on your system On Linux ldd libImg2PdfAPT so OnAIX dump H libImg2PdfAPI so In case you have not installed the GNU shared libraries yet proceed as follows a Go to http www pdf tools com and navigate to Support gt Resouces b Download the GNU shared libraries for your platform c Extract the archive and copy or link the libraries into your library directory e g usr lib or usr lib64 d Verify that the GNU shared libraries required by the product are available on your system now 4 Optionally register your license key using the Command Line License Manager Tool 5 Identify which interface you are using Perform the specific installation steps for that interface described in chapter Interfaces MAC OS X The shared library must have the extension nilib for use with Java We suggest that you create a file link for this purpose by using the following command ln libImg2PdfAPI dylib libIm
26. b a ar ee ec ee eee 13 5 1 Overview or the API erorien ceed dae aad a ne bodes mde hbo A ebay dad cae bo ac 13 6 Reference Manuall iii a eae See a Kv eee se ES 14 6 1 The lme2Pdt Interface usina ee Hae heater we WEN A ee Ae Helene O RS 14 AdjustPage st k ad rn eons ue wt be Ie al trod iaa ade Be wees ane Ate ect ad aca eo ae aise 14 Aliado Dario a RO BERG A A eat A ee le a a had A RA ie os 14 BitonalCOMPressi N iis eg ae Wee a die arca GARG a ales a we elle Redes ae alae a A 15 BOrderSiz sese eae bee AAA DET EEE EDO RA a Pe ae a eo 15 CenterlMage sown ei SLO a EOE ERR E E a Se ae a ee BS eee we Ged 15 OS ees a See SE Oe AA A PGE Se SO Ee BE A Eee dea a wD ee ee a 15 Compliance beis Sah Sok Bd ed aly ees Ba SO eS ee he e hae Gd hee 16 GONTINUGUSEOMPFESSIONE sae ecc rr eas adi Rete dy owe ey eS OG eR Uae Oe en eels 16 Create aie here ow ase se AR Sete We AA tee eee A A a ae Gan hed MCR cre hanes ac Shon wae 16 CreatelnMeMOry ica ees eek a oe a Ew Ee Ss OE RSE EERE SEE ADR SESS Eee a ee 17 CreatePageFromCodec ee ee eee es 17 CreatePageFromimageFile 0 0 ce ee en eee eee ees 17 CreatePagesFromFile ees 17 DefaultDPli e saes g dis Bae sot doh ddl id ad Sie ba ee hee eek aed 18 EG FOLC OGG zaa ti AO Ree ares e tc o r a 18 ErrorMes5Sage jcc yee RA ERA A A AAA AA ees 18 EXPORTTOXE vicio etches Bard ee tr A dd eae RG ad sic da REG ol de a EOE oe EN ee 18 FIDE sco ea a ee OR RRO A RR ER AA RSE A REDS RY he Re Dae A es 19
27. cim etek A Wk le ha Ghai tat Gane eee eS 38 JPEG2000 coi RARE RES SEED PARE SEE PRG Da ee ae Sa REA ae eo 38 7 Samples cia sc shee a o a a Pa ads Phe bead Ha wea des 39 8 Licensing and Copyright c cuccccis be bee ON Ee hee eK EE Dae NEE EE sons OO eo 39 9 CONTact degoe ea PE sesso ve es eis EOS DIO ely cents e eine ser O Seber os des O eerie gee ee ee ee ese 39 PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 3 39 1 Introduction 1 1 Description The 3 Heights Image to PDF Converter API converts raster image formats to PDF and PDF A PDF A has been acknowledged world wide as the ISO standard for long term archiving since 2005 The Image to PDF Converter is used to convert images into a standardized format for instance for electronic archiving or electronic data exchange It is also possible to include metadata from external sources The Converter is characterized by a robust design high throughput and accurate image reproduction The optional OCR add in makes output files searchable in full text mode Image to PDF PDF v E A e 5 5 TIFF JPEG D E u etc o O o v Q PDF EL ee amp ap s A SH E E a CM GH 5 PDF A al Ei fS 5 gt Metadata Parameters 1 2 Functions The 3 Heights Image to PDF Converter API converts raster image formats such as JPEG TIFF or PNG to PDF or PDF A It can merge pages from various image files to form a single PDF and c
28. component of an image sample The number of color components per image data sample can be retrieved through the image s color space interface Close Method Boolean Close Close an opened input file If the document is already closed the method does nothing Return value True The file was closed successfully False Otherwise PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 28 39 ColorSpace Property TPDFColorSpace ColorSpace Accessors Get This property returns the color space See also enumeration TPDFColorSpace ComponentsPerPixel Property Integer ComponentsPerPixel Accessors Get Return the number of components per pixel Compression Property TPDFCompression Compression Accessors Get This property returns the compression type See also enumeration TPDFCompression and the property Re compress This property is initially set to eComprRaw Create Method Boolean Create String FileName Create an empty image file Parameters FileName The file name and optionally the file path drive or server string according to the operating systems file name specification rules of the image file Supported extensions are listed in the chapter Supported Image Extensions Return value True The file was created successfully False The file was not created e g the file already exists an
29. created PDF_12P_W_SMASK The soft mask of the image was removed during the conversion PDF A 1 only PDF_12P_W_JPXDECODE JPEG2000 compression was replaced by JPEG compression PDF A 1 only TPDFOrientation eOrientationUndef Undefined eOrientationTopLeft Image is untransformed eOrientationTopRight Before viewing image is flipped horizontally eOrientationBottomRight Before viewing image is rotated by 180 eOrientationBottomLeft Before viewing image is flipped vertically PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 38 39 eOrientationLeftTop eOrientationRightTop eOrientationRightBottom eOrientationLeftBottom TPDFPermission Before viewing image is rotated by 90 clockwise and then flipped horizontally Before viewing image is rotated by 90 clockwise Before viewing image is rotated by 90 clockwise and flipped vertically Before viewing image is rotated by 90 counter clockwise An enumeration for permission flags If a flag is set the permission is granted ePermNoEncryption ePermA11 ePermPrint ePermModify ePermCopy ePermAnnotate ePermFillForms ePermSupportDisabilities ePermAssemble ePermDigitalPrint Do not apply encryption This enumeration shall not be combined with another enumeration When using this enumeration set both passwords to an empty string or null Grant all Permissions Low resolution printing Changing the do
30. cument Content copying or extraction Annotations Filling of form fields Support for disabilities Document Assembly High resolution printing Changing permissions or granting multiple permissions is done using a bitwise or operator Changing the cur rent permissions in Visual Basic should be done like this Allow Printing Prohibit Printing Permission Permission Or ePermPrint Permission Permission And Not ePermPrint 6 7 Supported Image Extensions The following extensions are supported stif stiff jpg jpe jpeg png gif bmp jb2 jp2 PE pbm pgm pnm ppm eps Tagged Image File Format Joint Photographic Expert Group Portable Network Graphics Graphics Interchange Format Window Bitmap Joint Bi level Image Experts Group JPEG2000 Extended JPEG2000 Portable Bitmap File Format Encapsulated PostScript Output only PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 39 39 6 8 Supported Image Compression Types For additional information about compressions in PDF see also ISO 32000 chapter 7 4 No Compression Raw 0 Raw means no compression is applied DCT JPEG Developer Version Color depth Compression type Compression algorithm Application area Flate ZIP Developer Version Color depth Compression type Compression algorithm Application area LZW Developer Version Color depth Compress
31. d is read only CreatelnMemory Method Boolean CreateInMemory String Extension Create an image in memory Parameters Extension The type of the image to be created Supported extensions are listed in the chapter Supported Image Extensions Return value True The image was created successfully in memory False otherwise fXDPI fYDPI Deprecated use XDPI and YDPI instead Getlmage Method Variant GetImage This method returns an image which was previously created in memory using the methods CreatelnMemory and Close O PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 29 39 Decode Property Boolean Decode Accessors Get Indicates if the samples of the compressed stream need to be decoded inverted ErrorCode Property TPDFErrorCode ErrorCode Accessors Get This property can be accessed to receive the latest error code See also enumeration TPDFErrorCode PDF Tools error codes are listed in the header file pdferror h Please note that only few of them are relevant for the 3 Heights Image to PDF Converter API ErrorMessage Property String ErrorMessage Accessors Get Return the error message text associated with the last error see property ErrorCode Note that the property is NULL if no message is available Height Property Long Height Accessors Get Re
32. d the NET assemblies bin fonts Contains the fonts Symbol and ZapfDingbats and the font mapping file bin icc Contains color profile and link to download more color profiles doc Contains documentation files include Contains header files to include in your C C project jar Contains the Java wrapper when using JNI lib Contains the object file library to include in your C C project samples Contains samples in various programming languages COM interface only Before you can use the 3 Heights Image to PDF Converter API component in your COM application program you have to register the component using the regsvr32 exe program that is provided with the Windows operating system it resides in the directory System32 If you are using a newer operating system such as Vista or Windows 7 start the command prompt as Administrator The following screenshot shows the registration of the Image to PDF Converter API DLL Command Prompt C Program Files pdf tools bin gt regsur32 Img2PdfAPI d1ll C Program Files pdf tools bin gt _ If you are using a 64 bit operating system and would like to register the 32 bit version of the 3 Heights Im age to PDF Converter API you need to use the regsvr32 from the directory SystemRoot ASysW0W64 instead of SystemRoot ASystem32 1 If the registration process succeeds the following dialog window is displayed RegS vr32 X gt DilRegisterServer in Img2PdfAPI dll succeeded
33. e left pane of the window This includes licenses of other PDF Tools products The user can choose between Licenses available for all users Administrator rights are needed for modifications Licenses available for the current user only Add and delete license keys License keys can be added or deleted with the Add Key and Delete buttons in the toolbar The Add key button installs the license key into the currently selected list The Delete button deletes the currently selected license keys Display the properties of a license If a license is selected in the license list its properties are displayed in the right pane of the window Select between different license keys for a single product More than one license key can be installed for a specific product The checkbox on the left side in the license list marks the currently active license key PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 10 39 3 2 Command Line License Manager Tool The command line license manager tool 1icmgr is available in the bin directory for all platforms except Windows A complete description of all commands and options can be obtained by running the program without param eters licmgr List all installed license keys licmgr list Add and delete license keys Install new license key licmgr store X XXXXX XXXXX XXXXX XXXXX XXXXX XXXXX Delete old license key licmgr del
34. ed use GetOCRPluginName instead GetOCREngineCount Deprecated use GetOCRPluginCount instead GetOCRPluginCount Method Integer GetOCRPluginCount OCR engines are accessed through the corresponding OCR interface DLLs At present there are four OCR en gine supported Abbyy FineReader 10 0 OCR Engine This engine is accessed by the OCR interface DLL pafocrpluginAbbyy10 ocr Abbyy FineReader 8 1 OCR Engine This engine is accessed by the OCR interface DLL pdfocrpluginAbbyy ocr 3 Heights OCR Service This service is accessed by the OCR interface DLL pdfocrpluginService ocr The service accesses the Abbyy FineReader 8 1 OCR Engine Tesseract This engine is accessed by the OCR interface DLL pdfocrpluginTesseract ocr The OCR interface DLL is provided by the 3 Heights Image to PDF Converter API The OCR engine is provided as a separate product 3 Heights OCR Enterprise Add On In order to make use of the OCR engine the OCR interface DLL and the OCR engine must be installed The property GetOCRPluginCount returns the number of available OCR interface DLLs It does not verify the corre sponding OCR engines are installed and can be initialized The OCR engine is loaded with the method SetOCRE ngine Return value The number of available OCR engines i e their corresponding OCR interface DLLs GetOCRPluginName Method String GetOCRPluginName Integer i0CREngine An OCR engine is accessed through an
35. ed using the properties GetOCREngineCount and GetOCREngine Return value True The OCR interface DLL was found the OCR engine was found and the OCR engine was successfully initialized False otherwise PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 26 39 SetOCRLanguages Method Boolean SetOCRLanguages String Languages This method requires the 3 Heights OCR Add On which is a separate product to be installed See also docu mentation for the 3 Heights OCR Add On Setting a languages helps the OCR engine to minimize errors by means of using dictionaries of the defined languages This method must be called after SetOCREngine If SetOCRParams is used SetOCRLanguages must be called after SetOCRParams Parameters Languages A string of one or multiple comma separated languages The supported names are OCR engine dependant The OCR engine will only use dictionaries of the set languages Return value True The Language s were successfully set False Otherwise Example SetOCREngine abbyy SetOCRLanguages English German SetOCRParams Method Boolean SetOCRParams String Params This method requires the 3 Heights OCR Add On which is a separate product to be installed See also docu mentation for the 3 Heights OCR Add On By means of this method OCR engine specific settings can be applied in the form
36. epee A A ARA AA AAA A Aa 27 ErrOrCode ia ica a e a e ind EE da es Ew as de CESS ees 27 ENTOFMESSABE sur A AA A ROA 27 Height Sai a A o A aes 27 IimageQUaliWY 008 caia ta a a a eb a Li a alla Se doe cai Ge Bed 27 IsPr emultiplicdAlpha sep aid id a A bbe e a 27 Mask a a Eire We A A ala A A di dee 27 ODOM ta A A A A A A RAE RA IA ek Sk hy ee 28 OPENMEM s ecu wastes ead ri Se Ra Baek eas dd A cd ee RG RES a dd 28 PAGS t aia ias de an ay danas de Mapes dt edie atk BASIN Meigs ih AC aes Gees We ee Shue Seated gedaan se 28 Page Couso SR eth cant oes BOREAS we dhe age Wade Bi HR E aw A len hh Xs 28 PAge oO ses fake ole ias ica a a ee ale ke a a esd on oe ay ea wo Ree Woe i ald eke Gee abe ia 28 Palette sirios dr AAA SR RG DRE EERE EE EEE TS ES EGS wes 28 Quality lt lt eee beige seas a et Se Ue SV Sd GH A eS SS Se Sy Mead 28 RECOMPTESS sak a oe RRR AE ER AE eG AR AA AR A ee 29 Samples cata Hadar Ge eet oa Be oh ke di dared Pee ai ode y RHEL Gs 29 SMAaSKe s e 2 dood elie ees ae ae es ER a eee har eee eas ae eho Vas waa ae Ree Ena A 29 WMI br o a ie EA A Sho Sea ata ee athe OS A A AAA 29 XDP YDP sei g Stet a edi eck ed Sara eee a AM eh ere al aE SE Ee we as So eS a eS Ae 29 63 The lmg2img Interface sist Gu ee dew Gu A hy Sue Hecate bs ope we aaa 6 29 BitonalCOmpression sies esaa npa ir SRR REG ARA eS a ee 29 CoOntinNUOUSCOMPFeSSION eo oia Se BA a ee BS ALE ee EERE Se ERASE DES Ge ew Ra ee 30 GONTINOUSCOMPKESSION ss co a ee aoe ec
37. erver string according to the operating systems file name specification rules of the image file Return value True The file was opened successfully False Otherwise OpenMem Method Boolean OpenMem Variant varMem This method opens an image from memory Parameters varMem A byte array containing the image Return value True The file was opened successfully False Otherwise Page Deprecated use PageNo instead PageCount Property Long PageCount Accessors Get Return the number of pages of an open document If the document is closed then 0 is returned PageNo Property Long PageNo Accessors Get Set Default 1 Set or get the current page number in the image The page number must always be set also for single page images Palette Property Variant Palette Accessors Get This property returns the palette of the image if existing Quality Deprecated use ImageQuality instead PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 31 39 Recompress Property Boolean Recompress Accessors Get Set Default True If set to false JPEG JPEG2000 and CCITT Fax Group4 streams are not de compressed As a result the Samples property will return the compressed stream as indicated by the Compression property If possible the Recom press property should be set before calling the Open met
38. ete X XXXXX XXXXX XXXXX XXXXX XXXXX XXXXX Both commands have the optional argument s that defines the scope of the action g For all users ut Current user Select between different license keys for a single product licmgr select X XXXXX XXXXX XXXXX XXXXX XXXXX XXXXX 3 3 License Key Storage Depending on the platform the license management system uses different stores for the license keys Windows The license keys are stored in the registry HKLM Software PDF Tools AG for all users HKCU Software PDF Tools AG for the current user Mac OS X The license keys are stored in the file system Library Application Support PDF Tools AG for all users Library Application Support PDF Tools AG for the current user Unix Linux The license keys are stored in the file system etc opt pdf tools for all users pdf tools for the current user Note The user group and permissions of those directories are set explicitly by the license manager tool It may be necessary to change permissions to make the licenses readable for all users Example chmod R gotrx etc opt pdf tools O PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 11 39 4 Programming Interfaces 4 1 Visual Basic 6 After installing the 3 Heights Image to PDF Converter API and registering the COM interface see chapter Download and Installation you find a Visual Basic 6 example Img2PdfAPI vbp in t
39. g2PdfAPI jnilib O PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 9 39 3 License Management There are three possibilities to pass the license key to the application 1 The license key is installed using the GUI tool Graphical user interface This is the easiest way if the licenses are managed manually It is only available on Windows 2 The license key is installed using the shell tool This is the preferred solution for all non Windows systems and for automated license management 3 The license key is passed to the application at runtime via the LicenseKey property This is the preferred solution for OEM scenarios 3 1 Graphical License Manager Tool The GUI tool LicenseManager exe is located in the bin directory of the product kit y PDF Tools License Manager File Edit Help xX 2 Add Key Delete Refresh List License Properties 3 Heights TM Document Converter Name Value Y Y 0 10A0M TARAF HA O Key 0 J0A94 NAGE LIC Y 0 BCASN W EN RIOT LL POLE Product 3 Heights TM Image 3 Heights TM Image to PDF Converter API af Intended Use Productive TY 0 J0A94 iniiai cl a a fa Y Platform Windows 3 Heights TM Image to PDF Converter Service dd a ver pedian A jox a u aan Y Maintainance Expiration 2033 12 31 List all installed license keys The license manager always shows a list of all installed license keys in th
40. he directory samples VB You can either use this sample as a base for an application or you can start from scratch If you start from scratch here is a quick start guide for you 1 First create a new Standard Exe Visual Basic 6 project Then include the 3 Heights Image to PDF Converter API component to your project References Img2PdfAPI vbp 3 xl Available References Visual Basic For Applications Visual Basic runtime objects and procedures Visual Basic objects and procedures OLE Automation 3 Heiahts TM Image to PDF Converter API 1 50 Cancel Browse JKKK E pur IAS Helper COM Component 1 0 Type Library al IAS RADIUS Protocol 1 0 Type Library _ 3 Heights TM Font To PDF Conversion API 1 50 Priority 3 Heights TM PDF Annotation API Help _ 3 Heights TM PDF Checker API 1 50 3 Heights TM PDF Content To Image API 1 40 3 Heights TM PDF Export API 1 50 3 Heights TM PDF Optimizer API 1 50 1 3 Heiahts TM PDF Printer API 1 50 ot 4 3 Heights TM Image to PDF Converter API 1 50 Location D Bin bin Img2PdFAPI dil Language Standard 2 Draw anew Command Button and optionally rename it if you like 3 Double click the command button and insert the few lines of code below All that you need to change is the path of the file name Example Private Sub Command1_Click Dim conv As New
41. he output document set PermissionFlags to 1 user and owner password to 0 In order to allow high quality printing both flags ePermPrint and ePermDigitalPrint need to be set See also enumeration TPDFPermission To combine multiple flags use a bitwise or operator ex VB PermissionFlags ePermPrint OR ePermDigitalPrint Return value True The file was created successfully False The file could not be created because e g the file already exists and is locked read only CreatelnMemory Method Boolean CreateInMemory This method creates a PDF in memory Once the document is completed and after the Close call it can be accessed using the method GetPDF CreatePageFromCodec Method Boolean CreatePageFromCodec PDFCodec pCodec This method creates a page from an image object It must be called after Create or CreatelnMemory Parameters pCodec A PDFCodec object holding an image Return value True The page in the PDF document was created successfully False otherwise CreatePageFromimageFile Method Boolean CreatePageFromImageFile String FileName This method adds the page or pages for multi page TIFF images of an image file to the current PDF output It must be called after Create or CreatelnMemory Parameters FileName The file name and optionally the file path drive or server string according to the operating systems file name specification rules Return v
42. hod because for some image formats changing the Recompress property might result in reloading some image data Samples Property Variant Samples Accessors Get Return the image s data samples in a byte array The sample data is ordered by line from top to bottom and within a line from left to right The lines are byte aligned If the number of bits per component is less than one byte then the samples are ordered beginning with the most significant bit first If Recompress is set to false Samples returns a stream compressed with the algorithm indicated by the prop erty Compression SMask Property Variant SMask With this property the soft mask of an image can be extracted Width Property Long Width Accessors Get Return the width of the image in pixels also called samples The unit of pixels can be converted to a distance unit such as inch millimeter etc using a resolution value i e 72 dpi dots per inch XDPI YDPI Property Single XDPI Property Single YDPI Accessors Get These properties return the resolution in dots per inch in X and Y direction 6 3 The Img2lmg Interface The image to image interface is a separate interface that provides functionality to convert images from one format to another It allows changing the compression type and up sampling BitonalCompression Property TPDFCompression BitonalCompression Accessors Get Set Def
43. include file COM API include file COM API identifier definitions Supplementary C header file containing error codes 2 3 Uninstall Install a New Version If you used the MSI for the installation go to Start gt 3 Heights Image to PDF Converter API gt Uninstall If you used the ZIP file In order to uninstall the product undo all the steps done during installation e g un register using regsvr32 u delete all files etc Installing a new version does not require to previously uninstall the old version The files of the old version can directly be overwritten with the new version If using the COM interface the new DLL must be registered un registering the old version is not required PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 8 39 2 4 Unix This section describes installation steps required on all Unix platforms which includes Linux Mac OS X Sun Solaris IBM AIX HP UX FreeBSD and others The Unix version of the 3 Heights Image to PDF Converter API provides two interfaces Java interface Native C interface Here is an overview of the shared libraries and other files that come with the 3 Heights Image to PDF Converter API Table File Description Description bin libImg2PdfAPI so This is the shared library that contains the main functionality The file extension varies depending on the UNIX platform doc Documentation bin I2PA jar J
44. ion type Compression algorithm Application area PDF Tools AG Premium PDF Technology Joint Photographic Experts Group committee PDF 1 2 PDF A 1 8 24 bits per pixel Lossy The image is broken up into blocks that are 8 by 8 samples On each of these blocks and color channel a discrete cosine transformation DCT is applied and its coefficients are quantized The visual quality of the resulting image depends on the loss of information defined by the step size of the quantization and on the image that is being compressed The compression can be controlled via an image quality parameter a value from 1 to 100 default 75 Typical compression ratios are 15 1 no perceptible loss of information to 30 1 Sampled continuous tone pictures photographs Flate compression is based on the public domain zlib deflate compression method PDF 1 2 PDF A 1 1 8 24 bits per pixel Lossless A lossless data compression algorithm that uses a combination of the LZ77 algorithm and Huffman coding Images Abraham Lempel Jacob Ziv and Terry Welch Copyright based issues which expired in most countries in 2003 2004 reduced the popularity of this compression As one of its consequences it is not included in PDF A standard PDF 1 2 2 8 bits per pixel Lossless An indexed based compression that is also used in the GIF and TIFF image formats Gray scale images artificial images Image to PDF Converter API Version 4 5 July 16 201
45. jar I2PA jar img2pdf java Unix javac classpath home path I2PA jar img2pdf java Execution The Java archive 12PA jar must reside on the classpath The path to the native library must be provided This can be achieved in two ways It is added on the environment variable PATH Windows Itis added at execution time using Djava library path Windows java classpath C pdf tools jar I2PA jar Djava library path C pdf tools bin img2pdf parameters Unix java classpath path to jar I2PA jar Djava library path path to bin img2pdf parameters Note 12PA jar is a Java wrapper and does not provide any functionality natively therefore the library is always required for execution PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 15 39 5 User s Guide 5 1 Overview of the API What is the 3 Heights Image to PDF Converter API about The API can be used in any application that requires a process to convert images to PDF documents or split or merge images Here is a typical use case An application takes raster images as input These can come from any source such as a scanner or are up loaded from the internet The application processes these images e g resizes them applies down sampling compresses them merges them with other images etc Finally it creates an output document The output document can be an image again or a PDF
46. most one call to SetOutputintent and or at most three calls to SetColorSpaceProfile SetMetadata Method Boolean SetMetadata Single FileName Set the document s XMP metadata The XMP metadata is inserted as is which means it is not parsed and vali dated If no XMP metadata is provided the 3 Heights Image to PDF Converter API generates it automatically Parameters FileName The file name and optionally the file path drive or server string according to the operating systems file name specification rules of the file containing the XMP metadata Return value True The XMP metadata file was set successfully False otherwise SetOCREngine Method Boolean SetOCREngine String Engine This method require the 3 Heights OCR Add On which is a separate product to be installed See also docu mentation for the 3 Heights OCR Add On Set the OCR engine that is used when OCR information shall be added during the conversion If the engine s name is set to an empty string OCR is not applied See also documentation for the 3 Heights OCR Add On Parameters Engine The name of the OCR engine e g abbyy For every available OCR engine there is a corresponding OCR interface DLL The OCR interface DLLs e g pdfocrAbbyy ocr are distributed with the 3 Heights Image to PDF Converter API and are required to communicate with the OCR engine The names of all available OCR engines can be retriev
47. numeration TPDFErrorCode PDF Tools error codes are listed in the header file pdferror h Please note that only few of them are relevant for the 3 Heights Image to PDF Converter API ErrorMessage Property String ErrorMessage Accessors Get Return the error message text associated with the last error see property ErrorCode Note that the property is NULL if no message is available ExportText Method Boolean ExportText String FileName L This function is used in combination with OCR only It allows to write the text which is detected by the OCR engine during conversion not only as invisible text in the PDF but additionally to a text file The text file is closed when output PDF document is closed using the function Close Parameters FileName Defines the text file and optionally its path If the parameter is an empty string no text file is created Return value True if the function call was successful False otherwise PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 21 39 Fitlmage Property Boolean FitImage Accessors Get Set Default False Scale the image to fit the size of the page of the PDF The image is scaled so that either width or height match the dimensions of the page the other dimension is scaled proportionally If set to true the property AdjustPage is automatically set to false GetOCREngine Deprecat
48. ocuments The PTS does not support NET therefore any comments in this manual about NET can be neglected if working in combination with the PTS The NET assemblies are not bundled with the PTS O PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 16 39 OCR Recognition of Images The 3 Heights Image to PDF Converter API can also be used to perform OCR on an image and extract the detected text During this process no PDF output document is created This feature can for example be used to read a barcode from an image The basic call sequence in Visual Basic 6 is as follows Create a PDFCodec object Open the image file and set the page number Create an ImgOcr object and configure it OCR engine parameters language Set the image using the Setlmage method of the ImgOcr object and call the Recognize method to perform OCR recognition Read the OCR text using the GetFirstOcrText and GetNextOcrText methods 6 Reference Manual The reference manual is based on the COM interface However there is an equivalent function to each COM function in the C NET and Java interface See img2pdfapi_c h and 2pa jar The main DLL contains five classes Img2Img This class can be used to convert images or a page range of them from one type to another Img2Pdf This class can be used to convert images to PDF documents PDFCodec This class can be used to retrieve various informati
49. of key value pairs These pairs are OCR engine dependant and are described in the corresponding manual Parameters Params A list of comma separated key value pairs See example Return value True The OCR parameters were successfully set False otherwise Example SetOCREngine abbyy SetOCRParams BalancedMode TRUE DetectBold FALSE SetOutputintent Method Boolean SetOutputIntent String Profile The output intent represents the output color profile Color profiles are usually provided with the OS On Windows for example they can be found at C WINNT system32 spool drivers color Alternatively profiles can be found here www pdf tools com public downloads resources colorprofiles zip www color org srgbprofiles htm www adobe com support downloads iccprofiles icc_eula_win_dist html Please note that most color profiles are copyrighted therefore you should read the license agreements on the above links before using the color profiles PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 27 39 Parameters Profile The name of the color profile An example could be C WINNT system32 spool drivers color sRGB Color Space Profile icm If compliance level PDF A is selected and no output intent is defined a default output intent sRGB Color Space Profile icm is embedded This method must be called after Create has been called
50. olean Recognize Perform OCR recognition The return value indicates whether or not the recognition has been successful Setlmage Method Boolean SetImage PDFCodec Image Set the image to OCR Before calling this method the image must be opened and the correct page set The return value indicates whether or not the image could be set SetOCRLanguages Method Boolean SetOCRLanguages String Languages Set the OCR languages see SetOCRLanguages of the Img2Pdf interface SetOCRParams Method Boolean SetOCRParams String Parameters Set the OCR parameters see SetOCRParams of the Img2Pdf interface 6 5 The OcrText Interface The OCR text interface represents a text fragment detected by the image OCR interface BaseLine Property Single BaseLine Accessors Get Get the Y coordinate of the text s base line FontName Property String FontName Accessors Get Get the name of the font For barcodes the font name is Barcode FontSize Property Single FontSize Accessors Get Get the size of the font in points Rect Property Variant Rect Accessors Get Get the bounding box rectangle of the text StringLength Property Integer StringLength Accessors Get Get the number of characters of the recognized string O PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July
51. ols Img2Pdf 4 The NET interface can now be used as shown below PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 14 39 Img2Pdf converter new Img2Pdf converter Create converter CreatePagesFromFile converter Close Deploying in NET When deploying a NET solution please refer to the following FAQ Deploying in NET http www paf tools com pdf Support FAQ Article aspx name Deployment In NET Troubleshooting TypelnitializationException The most common issue when using the NET interface is ifthe native DLL is not found at execution time This normally manifests when the constructor is called for the first time and exception is thrown normally of type System TypelnitializationException To resolve that ensure the native DLL is found at execution time For this see section NET Interface in the chapter Installation or the following FAQ https www pdf tools com pdf Support FAQ Article aspx name Exception type initializer 4 4 Java This chapter briefly describes how to compile and execute the sample application img2pdf java on Windows or Unix Compilation When using the Java interface the Java wrapper jar 2PA jar needs to be on the CLASSPATH This can be achieved in two ways Itis added to the variable CLASSPATH Itis provided at compilation time using the switch classpath Windows javac classpath C pdf tools
52. on from images such as image compression color depth resolution size image mask etc This class can also be used to interface with other libraries such as the PDF Prep Tool to import images into a PDF document ImgoOcr This class can be used to perform OCR recognition on an image and extract the detected text OcrText This class represents a text fragment detected by the ImgOcr class 6 1 The Img2Pdf Interface The interface Img2Pdf provides the functionality to create a PDF documents from various image formats Image related properties such as compression or quality are related to the target output file For example if BitonalCompression is set to eComprGroup4 any bi tonal image that is converted to a PDF document is saved with compression CCITT G4 In order to read the property e g the compression of an exiting image file use the interface PDFCodec AdjustPage Property Boolean AdjustPage Accessors Get Set Default True When set to true the page dimensions of the PDF will be chosen so that the image fits exactly on the page If set to true the property Fitlmage is automatically set to false Alt Property String Alt Accessors Get Set Default Imported image In order to create a PDF A level A compliant document PDF A 1 a PDF A 2a PDF A 3a each image must have an alternate text with a description of the image in support of accessibility to users with disabilities This prop er
53. os for text pages are 20 1 to 50 1 Line art image bi tonal Joint Photographic Experts Group committee PDF 1 5 PDF A 2 8 24 bits per pixel Lossless if the image quality index is set to 100 Lossy otherwise JPEG 2000 is a wavelet based image compression standard It was developed with the intention of superseding the original discrete cosine transform based JPEG standard Sampled continuous tone pictures photographs Image to PDF Converter API Version 4 5 July 16 2015 41 39 7 Samples The latest versions of samples for various programming languages are available at www pdf tools com asp products asp name 2PA 8 Licensing and Copyright The 3 Heights Image to PDF Converter API is copyrighted This user s manual is also copyright protected it may be copied and given away provided that it remains unchanged including the copyright notice 9 Contact PDF Tools AG Kasernenstrasse 1 8184 Bachenb lach Switzerland http www pdf tools com PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 42 39
54. output but it can also cause memory leaks Return value True The PDF file was closed successfully False Otherwise PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 18 39 Compliance Compliance Property TPDFCompliance Compliance Accessors Get Set Default ePDF17 This property allows setting a PDF compliance level It must be set before calling Create Supported compliance modes are ePDFix Regular PDF Versions such as 1 4 1 5 1 6 1 7 ePDFAib PDF A 1b format ePDFAia PDF A 1a format accessibility ePDFA2b PDF A 2b format ePDFA2u PDF A 2u format Unicode ePDFA2a PDF A 2a format accessibility ePDFA3b PDF A 3b format ePDFA3u PDF A 3u format Unicode ePDFA3a PDF A 3a format accessibility In order to create PDF A compatible documents there are additional requirements besides setting the compli ance level Metadata Selecting a PDF A compliance level will automatically generate the XML metadata and other requirements to meet the PDF A specification Tagging For PDF A level A accessibility it is also requested to have an alternate descriptive text for images This text can be set using the properties Alt and Lang Color Profiles For non calibrated colors a color profile must be embedded See methods SetOutputIntent and SetColorSpaceProfile If no color profile is set then for RGB and Grayscale colors calibrated color spaces are genera
55. s of type Component Files dll tlb olb ocx exe manifest 2 Img2PdfAPI dil is not a NET assembly but a native DLL It is not to be added as a reference to the project Doing so would use its COM interface and create an Interop DLL mg2PdfAPi dil is called by the NET assem bly Img2PdfNET dll Img2PdfAPI dl must be found at execution time The common way to do this is adding it as an existing item to the project and set its property Copy to Output Directory to Copy if newer Alternatively the directory where Img2PdfAPI dll resides can be added to the environment variable PATH or it can simply be copied manually to the output directory Solution Explorer Solution Img2PdfSample 1 Y X alae lod Solution Img2PdfSample 1 project Properties 4 Img2PdfSample Img2PdfAPL dll File Properties Sa Properties E Ey References i 3 Img2PdfNET 3 libpdFNET Build Action Content 43 System Copy to Output Directory Copy iF newer 43 System Drawing Custom Tool e AD System Windows Forms Custom Tool Namespace 3 Resources El Misc E La Img2PdFAPI dll File Name Img2PdFAPI dll H ES Img2PdfForm cs Full Path D bin bin Imq2PdF API dll It is required to use the 32 bit version of the software on a 32 bit platform On a 64 bit platform either version of the software can be used Should you use the 32 bit version of the software on a 64 bit platform the platform configura
56. ted while for CMYK colors a default CMYK output intent is set If JPEG2000 images are to be converted to PDF A and the JPEG2000 compression shall be retained a compliance level of PDF A 2 or later must be selected ContinuousCompression Property TPDFCompression ContinuousCompression Accessors Get Set Default eComprJPEG Get or set the compression type of color and grey scaled images in the PDF document See also enumeration TPDFCompression Create Method Boolean Create String PDFFileName String UserPwd String OwnerPwd TPDFPermission PermissionFlags This method creates a PDF file Note that in order to meet PDF A compliance the document mustn t be encrypted PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 19 39 Parameters PDFFileName The file name and optionally the file path drive or server string according to the operating systems file name specification rules UserPwd optional Set the user password of the PDF document If this parameter is omitted the default password is used Use 0 to set no password OwnerPwd optional Set the owner password of the PDF document If this parameter is omitted the default password is used Use 0 to set no password PermissionFlags optional Set the permission flags of the PDF document This option requires an owner password to be set By default no permissions are granted To not encrypt t
57. tion must not be set to Any CPU but explicitly to x86 PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 13 39 The version of the NET assemblies and the native DLL must be the same e g 4 2 26 0 The version can be found in the version tag of the file s properties Create a New Project There should be at least one NET sample for MS Visual Studio 2005 available in the ZIP archive of the Windows Version of the 3 Heights Image to PDF Converter API The easiest for a quick start is to refer to this sample In order to create a new project from scratch do the following steps Start Visual Studio and create a new C or VB project Add a reference to the NET assemblies import namespaces Note This step is optional but useful Write Code Pe Na Steps 3 and 4 are shown separately for C and Visual Basic Visual Basic 3 Double click My Project to view its properties On the left hand side select the menu References The NET assemblies you added before should show up in the upper window In the lower window import the namespaces Pdftools Pdf and Pdftools mg2Pdf You should now have settings similar as in the screenshot below Application Configuration N A y Platform N A v Compile Unused References Reference Paths Debug References Reference Name Type version Copy Local Path References Img2PdFNET
58. turn the height of the image in pixels also called samples The unit of pixels can be converted to a distance unit such as inch millimeter etc using a resolution value i e 72 dpi dots per inch ImageQuality Property Single ImageQuality Accessors Get Set Default 75 Get or set the quality index of the lossy compression This is a value from 1 to 100 This can be applied for JPEG JPEG2000 and JBIG2 compression For JBIG2 only the values from 10 to 100 that are multiples of 10 are supported For both JPEG2000 and JBIG2 a quality index of 100 means lossless compression JPEG compression is always lossy IsPremultipliedAlpha Property Boolean IsPremultipliedAlpha Accessors Get This property returns true if the image pixels are stored as the original pixel times the alpha value i e pixel backdrop alpha 1 image alpha Mask Property Variant Mask Accessors Get Return the image s explicit mask if available The mask s sample data is organized the same way as the image data except that the data contains one bit per pixel A one bit indicates an opaque pixel and a zero bit indicates a transparent pixel PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 30 39 Open Method Boolean Open String FileName This method opens an image file Parameters FileName The file name and optionally the file path drive or s
59. ty sets this alternate text used for images added subsequently The property should be set before adding images It is only relevant in combination with PDF A level A See also properties Lang and Compliance O PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 17 39 BitonalCompression Property TPDFCompression BitonalCompression Accessors Get Set Default eComprGroup4 Get or set the compression type for bi tonal images Normally either CCITT G4 or JBIG2 is used for bi tonal compression Due to the simpler algorithm CCITT G4 has the advantage of being faster JBIG2 can achieve compression ratios that are up to twice as high as CCITT G4 at the cost of longer computation time See also enumeration TPDFCompression BorderSize Property Single BorderSize Accessors Get Set Default 0 This property sets or gets the border between the image and the page border The units are points 1 point 1 72 inch The border does not change the dimension of the page set by the property SetPageSize Centerlmage Property Boolean Centerlmage Accessors Get Set Default False Center the image on the page horizontally and vertically Close Method Boolean Close This method closes the PDF file It is called after a PDF document has been created and the desired pages from images are added Avoiding the call to this function may still result in a valid
60. ux 32 and 64 bit MacOSX 10 4 and later 32 and 64 bit Sun Solaris 2 8 and later SPARC and Intel FreeBSD 4 7 and later 32 bit or FreeBSD 9 3 and later 64 bit on request 2 Installation 2 1 Download and Installation The installation of the software requires the following steps 1 You need administrator rights to install this software 2 Login to your download account at http www pdf tools com Select the product Image to PDF Converter API If you have multiple versions available select an SDK version The download account will show you one or multiple download links If you have no active downloads available or cannot log in please contact pdfsales pdf tools com for assistance You will find product version of different builds available We always suggest using a so called Final Release version which is a well tested and stable version and labeled with final Other versions are called Pre Release and they normally contain new features and bug fixes We suggest using Pre Release versions for evaluation and if you explicitly need a new feature or specific bug fix Licensed Products y all Image to PDF Converter API Developer Kit SDK Windows 11 30 2012 show 1 Server Run Time License Download kits Version Datum I2PA200WIN32 MSLzip build 2 0 final 5 16 2011 Image to PDF Converter API SDK 32 Bit I2PA200WIN32 zip build 2 0 final 8 8 2011 Image to PDF Converter API SDK 3
61. zontal This might change the appearance of the page This setting is recommended for scanned documents False Do not change skew of images This setting is recommended for born digital documents OCREmbedBarcodes Property Boolean OCREmbedBarcodes Accessors Get Set Default False This property specifies whether the recognized barcodes are embedded in the XMP metadata PDF Tools AG Premium PDF Technology Image to PDF Converter API Version 4 5 July 16 2015 24 39 OCRResolutionDPI Property Single OCRResolutionDPI Accessors Get Set Default 300 Resample images to target resolution before they are sent to the OCR engine The default is 300 dpi which is the preferred resolution for most OCR engines OCRThresholdDPI Property Single OCRThresholdDPI Accessors Get Set Default 400 Only images with a higher resolution than the threshold are re sampled before OCR The default is 400 dpi If set to 1 no re sampling is applied Orientation Property TPDFOrientation Orientation Accessors Get Return the orientation rounded to the next 90 degrees The orientation is an enumeration with eight different values rotation times flipping See enumeration TPDFOrientation Quality Deprecated use ImageQuality instead Recompress Property Boolean Recompress Accessors Get Set Default False If set to true JPEG JPEG2000 and CCITT Fax Group4 streams are

3-Heights™ Image to PDF Converter API, User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents

3-Heights&trade; Image to PDF Converter API, User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents

3-Heights™ Image to PDF Converter API, User Manual