3-Heights™ PDF Creator Library, User Manual
Contents
1. 244u44ran nenne eee ee eee ee eee nett nena namen namen nennen 7 Display the properties of a license zsssesnnnennnnnnnn nenne nen nennen nennen nn nenn 8 Select between different license keys for a single product eeeeeeee 8 3 2 Command Line License Manager Tool sr r4sHeran nenne nenne nennen nenn nennen 8 List all installed license keyS nunnennennennennennennnnennennenn nun nun nun nun une n nennen nennen 8 Add and delete license keyS cecceeeee eee e rene teens eee en namen nn nnn a nenn 8 Select between different license keys for a single product eeeeeeee 8 3 3 License Key SOFA A ne ner 8 MINS A a A 8 MAIS A A Ae ae ee ee we 9 UNIX LINUX are Ad iaa 9 4 User s Guide uunuuunuunnunnunnunnannunnannunnannunnunnunnunnunnunnunnnunnunnunnunnunnannunnannen 9 1 PONS hese iin aii ie ee ea eis idan 9 5 gt A O OO 10 Di K 3 SEPPERFRUUERPPFEUPFTEREPEUFRFEREPUEFEUFELUEREUERUUETEFRLTSOSTETEUELEFERLLENSTERTUSTEUERLTTERRERUTTE 10 A A 11 5 3 Vector GA 11 5 4 CUPPING eein aieeaa er suse adaa aaaea 12 PDF Tools AG Premium PDF Technology 1 1 3 Heights PDF Creator Library Version 4 5 Page 3 of 12 July 7 2015 Introduction Description 1 2 The 3 Heights PDF Creator Library is a component to create PDF A 1 compliant documents The interface is based on a comprehensible object model which reflects the functional range of PDF A 1 The interface2. TOOLS COM Premium PDF Technology 3 Heights PDF Creator Library Version 4 5 User Manual Contact pdfsupport pdf tools com Owner PDF Tools AG Kasernenstrasse 1 8184 Bachenb lach Switzerland http www pdf tools com Copyright 2001 2015 3 Heights PDF Creator Library Version 4 5 Page 2 of 12 July 7 2015 Table of Contents 1 Introduction uuuuunnunnunnunnnnnnunnunnunnunnunnunnunnunnunnunnunnunnunnnunnunnunnunnannunnunen 3 ded Descriptio ee LEHE 3 172 FUNCIONS a nenne 3 Features re ea ae Bea Ra ERITREA ER EEE EEE 3 Compliance u len Palin 4 1 3 Interfaces a a dt dia 4 1 4 gt Operating Systemsi a 2 Hain u Rainer 4 2 Installation uunuunuunnnnnnnnnunnunnunnunnannunnunnunnunnunnunnunnunnunnnunnunnunnunnannunnunen 5 2 1 Interface specific Installation Steps ernernennennennnn en esse nn nun nun nun nun nun nennen nennen 5 COM Interface aid a En een 5 Java Native Interface uzeusensennennennennen nennen enn nun narrar nar nun nun nennen nennen 5 NET Interface iis tes cies iin 5 C Interface eines a baie DA Vesa Aa hdd AN ieee AA ATA AA dba 6 3 License Management zanranuannannnnnannunnunnunnunnunnunnunnnunnunnunnunnannunnunnannene 7 3 1 Graphical License Manager Tool uur4sreranrennn nennen ernennen ernennen ernennen 7 List all installed license keyS unsusennnnnennennon non nn nun nun nun nun nun nun nun rr 7 Add and delete license keyS
3. 11 9 9 PDF Tools AG Premium PDF Technology 3 Heights PDF Creator Library Version 4 5 Page 12 of 12 July 7 2015 qgl FillPath path2 paint2 pagel AddGraphics document1 AddPage document1 Close gl pagel 5 4 Clipping private void buttonClip Click object sender EventArgs e string fileName C temp clip pdf Document documentl PdfCreatorAPI GetInstance NewDocument fileName Conformance ePdfAlb Page pagel documentl NewPage new PdfTools Pdf Rectangle 0 0 595 421 Create an image element requires a graphics object PdfTools Pdf Graphics gl documentl NewGraphics PdfTools Pdf Image imagel documentl NewlImage input gif Set clipping path Path pathl gl NewPath pathl AddCircle 110 130 90 gl IntersectClipPath pathl gl Save gl ModifyTransform gl NewTransform imagel Width 0 0 imagel Height 10 10 gl PaintImage imagel gl Restore pagel AddGraphics gl document1 AddPage pagel documentl Close PDF Tools AG Premium PDF Technology
4. Document information entries Title Author Subject Keywords Creator Producer Custom entries e 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 e Quality assurance Isartor test suite 1 3 Interfaces The following interfaces are available e C e Java e NET e COM 1 4 Operating Systems e Windows XP Vista 7 8 8 1 32 and 64 bit e Windows Server 2003 2008 2008 R2 2012 2012 R2 32 and 64 bit e HP UX 11 and later PA RISC2 0 32 bit or HP UX 11i and later ia64 Itanium 64 bit e IBM AIX 5 1 and later 64 bit e Linux 32 and 64 bit e Mac OS X 10 4 and later 32 and 64 bit e Sun Solaris 2 8 and later SPARC and Intel e FreeBSD 4 7 and later 32 bit or FreeBSD 9 3 and later 64 bit on request PDF Tools AG Premium PDF Technology 2 1 3 Heights PDF Creator Library Version 4 5 Page 5 of 12 July 7 2015 Installation Interface specific Installation Steps COM Interface Registration Before you can use the 3 Heights PDF Creator Library 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 The following command shows the registration of PdfCreatorAPI dil C gt regsvr32 exe PdfCreatorAPI d1l The registration can also be done silently e g for deployment using the switch s Other Files The other DLLs do not
5. XXXXX XXXXX Both commands have the optional argument s that defines the scope of the action e y For all users e u Current user Select between different license keys for a single product licmgr select X XXXXX XXXXX XXXXX XXXXX XXXXX XXXXX 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 e HKLM Software PDF Tools AG for all users PDF Tools AG Premium PDF Technology 4 1 3 Heights PDF Creator Library Version 4 5 Page 9 of 12 July 7 2015 e HKCU Software PDF Tools AG for the current user Mac OS X The license keys are stored in the file system e Library Application Support PDF Tools AG for all users e Library Application Support PDF Tools AG for the current user Unix Linux The license keys are stored in the file system e etc opt pdf tools for all users e 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 go rx etc opt pdf tools User s Guide C sample project called PDFCreatorSample is a very good basis to start with it shows virtually all features provided in the library Fonts Fonts can be set in different ways When using the function PdfNewInstalle
6. is designed in a way that it can be easily enhanced It will continuously be adapted to new requirements such as the evolvement of the PDF A standard The component ensures that all PDF A provisions are enforced such as file formatting rules the embedding of fonts and color profiles and many more Functions Features There is a C sample project called PDFCreatorSample that creates the file PDFCreatorAPINet_test pdf This PDF file shows many of the features Here is a summary e Path o Single and Multi segment lines o Rectangle Circle Bezier curves o Filling Stroking Clipping and combinations thereof o Line width cap join dash array dash phase and miter limit o Font size Character spacing Word spacing o Horizontal scaling Leading Rise o Standard Type 1 fonts TrueType fonts o Unicode characters o Text stroke line width line join and dashes o Fill and stroke text invisible text o Use text as clipping path o RGB and CMYK colors e Images o Bi level CCITT G3 G3 2D and G4 Flate LZW Packbits uncompressed o 4 bit and 8 bit grayscale Flate LZW Packbits JPEG and JPEG 6 8 bit only uncompressed o RGB Flate JPEG and JPEG 6 LZW Packbits uncompressed e Transformations PDF Tools AG Premium PDF Technology 3 Heights PDF Creator Library Version 4 5 Page 4 of 12 July 7 2015 o Translation o Scaling o Skewing Horizontal Vertical o Rotation e Metadata O Compliance
7. need to be registered but for simplicity it is suggested that they are in the same directory as the PdfCreatorAPI dll Java Native Interface For compilation and execution The Java Archive jar plba jar needs to be on the class search path This can be done by either adding it to the environment variable CLASSPATH or by specifying it using the switch classpath javac classpath C pdf tools jar plba jar sample java For execution Additionally the Library bin PdfCreatorAPI dil needs to be on the library path This can be achieved by either adding it to the environment variable PATH or by specifying it using the switch Djava library path java classpath C pdf tools jar plba jar Djava library path C pdf tools bin sample NET Interface The 3 Heights PDF Creator Library does not provide a pure NET solution Instead it consists of NET assemblies which are added to the project and a native DLL which is called by the NET assemblies This has to be accounted for when installing and deploying the tool The NET assemblies NET d are to be added as references to the project They are required at compilation time PdfCreatorAPI dil is not a NET assembly but a native DLL It is not to be added as a reference in the project The native DLL PdfCreatorAPI dil is called by the NET assembly PdfCreatorNET dll PdfCreatorAPI dl must be found at execution time by the Windows operating system There are various approach
8. needed for modifications e 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 e The Add key button installs the license key into the currently selected list e The Delete button deletes the currently selected license keys PDF Tools AG Premium PDF Technology 3 2 3 Heights PDF Creator Library Version 4 5 Page 8 of 12 July 7 2015 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 Command Line License Manager Tool 3 3 The command line license manager tool icmgr 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 parameters liengr List all installed license keys licmgr list The currently active license for a specific product ist marked with a star on the left side Add and delete license keys Install new license key licmgr store X XXXXX XXXXX XXXXX XXXXX XXXXX XXXXX Delete old license key licmgr delete X XXXXX XXXXX XXXXX XXXXX
9. 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 Graphical License Manager Tool The GUI tool LicenseManager exe is located in the bin directory of the product kit fa amp PDF Tools License Ma File Edit Help x 65 Add Key Delete Refresh List All Users Current User License Properties 3 Heights TM Document Converter Name Value v f 0 10A0M T AF hi a OP ae Key 0 JOAQ4 SU LT Y 0 BCASN W DN STS ITALO PODES Product 3 Heights TM Image 3 Heights TM Image to PDF Converter API af Intended Use Productive TY 0 J0A94 Bia al a LA Y Platform Windows 3 Heights TM Image to PDF Converter Service Y Volume a Page s eu F Y 0 1CA0 ATEHH PAE ALDAE BEA Y EDI o Does not expire E Y Maintainance Expiration 2033 12 31 2 Lisiahlic TAN Torno ta NNE Cannone Chall List all installed license keys The license manager always shows a list of all installed license keys in the left pane of the window This includes licenses of other PDF Tools products The user can choose between e Licenses available for all users Administrator rights are
10. amples This section provides a selection of small C samples which cover one specific topic each 5 1 Text private void buttonPlain Click object sender EventArgs e Create document and set its document attributes string fileName C temp text pdf Document documentl PdfCreatorAPI GetInstance NewDocument fileName Conformance ePdfAlb Create a page Page pagel documentl NewPage new PdfTools Pdf Rectangle 0 0 595 421 Create a text element requires a graphics and font object PdfTools Pdf Graphics gl documentl NewGraphics PdfTools Pdf Font fontl documentl1 NewFont Helvetica BoldOblique PdfTools Pdf Text textl gl NewText font1 20 Hello World 100 300 gl FillText textl null Add graphics to page pagel AddGraphics gl Add page to document and close document1 AddPage pagel documentl Close PDF Tools AG Premium PDF Technology 3 Heights PDF Creator Library Version 4 5 Page 11 of 12 July 7 2015 5 2 Image private void buttonImage Click object sender EventArgs e string fileName C temp image pdf Document documentl PdfCreatorAPI GetInstance NewDocument fileName Conformance ePdfAlb Page pagel documentl NewPage new PdfTools Pdf Rectangle 0 0 595 421 Create an image element requires a graphics object PdfTools Pdf Graphics gl documentl NewGraphics PdfTools Pdf I
11. dFont a font is set using its family name and its style If no style is defined the base font is used Example The following two samples in C set the font Arial and Arial Bold TPdfFont pFont PdfNewInstalledFont pDocument Arial NULL 1 TPdfFont pFont PdfNewInstalledFont pDocument Arial Bold 1 For 12 out of the 14 PDF Standard fonts there is a special behavior Fonts are replaced if they are not found on the local system The replacement is as shown in the table below Family Name Style Replacement Font Courier CourierNew Courier Oblique CourierNew Italic Courier Bold CourierNew Bold Courier BoldOblique CourierNew BoldItalic PDF Tools AG Premium PDF Technology 3 Heights PDF Creator Library Version 4 5 Page 10 of 12 July 7 2015 Helvetica Arial Helvetica Oblique Arial Italic Helvetica Bold Arial Bold Helvetica BoldOblique Arial Bolditalic Times Roman TimesNewRoman Times Italic TimesNewRoman Italic Times Bold TimesNewRoman Bold Times BoldItalic TimesNewRoman BoldItalic The two PDF Standard Fonts Symbol and ZapfDingbats are not replaced Example If the local system has Helvetica and Helvetica Bold installed they will be used otherwise Arial and Arial Bold will be selected as replacement font TPdfFont pFont PdfNewInstalledFont pDocument Helvetica NULL 1 TPdfFont pFont PdfNewInstalledFont pDocument Helvetica Bold 1 5 Ex
12. es to ensure this Below two are listed e PdfCreatorAPI dll is copied to a directory that is on the environment variable PATH e g it is either copied to o anew dedicated directory which is then added to the PATH or PDF Tools AG Premium PDF Technology 3 Heights PDF Creator Library Version 4 5 Page 6 of 12 July 7 2015 o an existing directory which already is on the PATH such as SystemRoot System32 e g C Windows System32 This approach is usually used for development e PafCreatorAPl dll is copied to the directory where the executable resides If you look at the C example that is provided by PDF Tools This is the same directory as where PDFCreatorSample exe resides which is something like PDFCreatorSample bin Debug or equivalent for release This approach is usually used for deployment C Interface e The header file pdfcreatorapi_c needs to be included in the C C program e The Object File Library PdfCreatorAPI lib needs to be linked to the project e PdfCreatorAPI dil should be on the environment variable PATH or if using MS Visual Studio in the directory for executable files PDF Tools AG Premium PDF Technology 3 Heights PDF Creator Library Version 4 5 Page 7 of 12 July 7 2015 License Management 3 1 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
13. mage imagel documentl NewImage input gif Save and later restore the graphics state to ensure the transformation has no sideeffects gl Save gl ModifyTransform gl NewTransform imagel Width 0 0 imagel Height 10 10 gl PaintImage imagel gl Restore pagel AddGraphics gl document1 AddPage pagel documentl Close 5 3 Vector Graphic private void buttonVector Click object sender EventArgs e string fileName C temp vector pdf Document documentl PdfCreatorAPI GetInstance NewDocument fileName Conformance ePdfAlb Page pagel documentl NewPage new PdfTools Pdf Rectangle 0 0 595 421 PdfTools Pdf Graphics gl documentl NewGraphics Add two Bezier curves to approximate a circle double x 100 double y 117 double s 100 double k 0 66 guessed apporoximation Path pathl gl NewPath pathl MoveTo x y pathl BezierTo x y s k x s y s k Xx s y pathl BezierTo x s Y s k x y s k x y Paint paintl gl NewRGBPaint 216 256 216 256 256 216 gl FillPath pathl paintl Add rectangles with different colors for int row 0 row lt 5 rowtt for int col 0 col lt 5 col Paint paint2 gl NewRGBPaint uint 256 256 255 1 col 0 2 256 255 row 0 2 255 col row 0 2 Path path2 gl NewPath path2 AddRectangle 100 col 11 100 row
Download Pdf Manuals
Related Search