DynaPDF 4.0 Reference & Manual API Reference Version 4.0.59 September 16, 2021 Legal Notices Copyright: © 2003-2021 Jens Boschulte, DynaForms GmbH. All rights reserved. DynaForms GmbH Burbecker Street 24 D-58285 Gevelsberg, Germany Trade Register HRB 9770, District Court Hagen CEO Jens Boschulte Phone: ++49 23 32-666 78 37 Fax: ++49 23 32-666 78 38 If you have questions please send an email to [email protected], or contact us by phone. This publication and the information herein is furnished as is, is subject to change without notice, and should not be construed as a commitment by DynaForms GmbH. DynaForms assumes no responsibility or liability for any errors or inaccuracies, makes no warranty of any kind (express, implied or statutory) with respect to this publication, and expressly disclaims any and all warranties of merchantability, fitness for particular purposes and no infringement of third-party rights. Adobe, Acrobat, and PostScript are trademarks of Adobe Systems Inc. AIX, IBM, and OS/390, are trademarks of International Business Machines Corporation. Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation. Apple, Mac OS, and Safari are trademarks of Apple Computer, Inc. registered in the United States and other countries. TrueType is a trademark of Apple Computer, Inc. Unicode and the Unicode logo are trademarks of Unicode, Inc. UNIX is a trademark of The Open Group. Solaris is a trademark of Sun Microsystems, Inc. Tru64 is a trademark of Hewlett-Packard. Linux is a trademark of Linus Torvalds. Other company product and service names may be trademarks or service marks of others. DynaPDF uses parts or modified versions of the following third-party software: AiCrypto. This product includes software developed by Akira Iwata Laboratory, Nagoya Institute of Technology in Japan (http://mars.elcom.nitech.ac.jp/). Antigrain Geometry Version 2.4. Copyright (C) 2002-2005 Maxim Shemanarev (McSeem). Clipper, Copyright 2010-2012 by Angus Johnson. Expat, Copyright 1998-2000 Thai Open Source Software Center Ltd and Clark Cooper. FreeType2, Copyright 2006-2018 by David Turner, Robert Wilhelm, and Werner Lemberg. LibJPEG, Independent JPEG Group's JPEG Software, Copyright 1991-1998 Thomas G. Lane. Little CMS Copyright (c) 1998-2011 Marti Maria Saguer LibPNG, PNG Reference Library, Copyright 1998-2004 Glenn Randers-Pehrson. LibTIFF, TIFF Image Library, Copyright 1988-1997 Sam Leffler, Copyright 1991-1997 Silicon Graphics, Inc. OpenJPEG, JPEG 2000 Image Library Copyright (c) 2002-2014, Universite catholique de Louvain (UCL), Belgium Copyright (c) 2002-2014, Professor Benoit Macq Copyright (c) 2001-2003, David Janssens Copyright (c) 2002-2003, Yannick Verschueren Copyright (c) 2003-2007, Francois-Olivier Devaux Copyright (c) 2003-2014, Antonin Descampe Copyright (c) 2005, Herve Drolon, FreeImage Team Copyright (c) 2006-2007, Parvatha Elangovan Copyright (c) 2008, Jerome Fimes, Communications & Systemes <[email protected]> Copyright (c) 2010-2011, Kaori Hagihara Copyright (c) 2011-2012, Centre National d'Etudes Spatiales (CNES), France Copyright (c) 2012, CS Systemes d'Information, France Zint barcode library, Copyright 2008 - 2020 Robin Stuart. Further copyright holders: • Copyright 2016 - 2020 Harald Oehlmann (CodablockE, Codablock-F) • Copyright 2004 Adrian Kennard, Andrews & Arnold Ltd, Cliff Hones, Stefan Schmidt (Data Matrix ECC 200) • Copyright 2004 Grandzebu, KL Chin (PDF417) • Copyright 2006 Kentaro Fukuchi (QR Code) • Copyright 2004 Cliff Hones (Reed-Solomon encoder) Zlib compression library, Copyright 1995-1998 Jean-Loup Gailly and Mark Adler. The JBIG2 encoder in DynaPDF based on jbig2enc, Copyright 2006 Google Inc. Author: Adam Langley ([email protected]). DynaPDF contains the RSA Security Inc. MD5 message digest algorithm as well as RC2, RC4, AES 128, and AES 256 encryption algorithms. DynaPDF contains also the Lempel-Ziv- Welch (LZW) compression algorithm, US Patent 4,558,302 Unisys Corporation. The patent expired worldwide in June 2004. Table of Contents External Signatures............................................... 59 How to export a Windows Certificate? ............. 60 Legal Notices ................................................................ 2 Importing signed PDF files ................................. 60 Table of Contents ........................................................ 4 How to sign a PDF file? ....................................... 60 Data types ................................................................... 14 How to create a signature field? ......................... 60 Var Parameters ...................................................... 15 How to modify the appearance of a signature Structures ............................................................... 15 field? ....................................................................... 61 Multi-byte Strings ................................................. 15 What is stored in a signature field? .................... 61 Data types used by different programming How to validate a signature? .............................. 61 languages ............................................................... 17 PDF/A and PDF/X Compatibility .......................... 62 Exception handling ................................................... 18 PDF/X ..................................................................... 62 Exception handling in C, C++, C#, Delphi .......... 18 PDF/A ..................................................................... 64 Exception handling in Visual Basic, Visual Basic Path Painting and Construction ............................. 66 .Net .......................................................................... 19 Nonzero Winding Number Rule ........................ 66 Special issues in Visual Basic and .Net ............... 20 Even-Odd Rule ..................................................... 67 Customized Exception handling ......................... 21 Color Spaces .............................................................. 71 Custom Library Changes ......................................... 22 Device Color Spaces ............................................. 71 Compiler Switches ................................................ 22 Device Independent Color Spaces ...................... 72 Main object types .................................................. 22 Special Color Spaces ............................................. 72 General design requirements............................... 23 Color Spaces and Images ..................................... 75 Requirements to add your own code to Layers (Optional Content) ...................................... 79 DynaPDF ................................................................ 24 PDF Transparency .................................................... 81 DPI Aware .Net applications .................................. 26 Alpha Blending ..................................................... 81 Enabling High DPI support in Windows Forms Transparency Groups / Soft Masks .................... 83 Apps ........................................................................ 26 Blend Modes .......................................................... 84 Scrolling issues on high dpi devices ................... 27 Tables ......................................................................... 88 Static contents in dpi aware applications ........... 27 General properties ................................................ 88 Language bindings ................................................... 28 Error Handling ...................................................... 88 Differences between DynaPDF interfaces .......... 28 Borders, Cell Spacing, Cell Padding .................. 88 Embarcadero C++ Builder .................................... 29 Background Objects ............................................. 89 Microsoft Visual C++ ............................................ 31 Foreground Objects .............................................. 90 Microsoft Visual Basic 6.0 .................................... 33 Cell Alignment and Orientation ......................... 90 Visual Basic .Net .................................................... 37 ColSpan, RowSpan ............................................... 90 Visual C# ................................................................ 41 Page breaks ............................................................ 90 Embarcadero Delphi ............................................. 44 Table and cell properties ..................................... 91 Compiling DynaPDF on Linux / UNIX ................. 48 Table color spaces ................................................. 91 Compiling DynaPDF on macOS ............................ 50 Table Creation ....................................................... 92 Compiling with XCode......................................... 50 Table Functions ........................................................ 93 Compiling on the Command Line ...................... 50 AddColumn .......................................................... 93 Interactive Forms....................................................... 52 AddRow ................................................................. 93 Field Appearance .................................................. 52 AddRows ............................................................... 94 Field Properties ..................................................... 53 ClearColumn ......................................................... 94 What is a Group