Neevia

PDFmerge/split

 

user’s manual

version 4.0

 

(http://neeviaPDF.com/PDFmerge)

 

                        

                        

                                        


 

License Agreement

  

ELECTRONIC END USER LICENSE AGREEMENT

 

For One (1) Computer

 

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

 

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

 

a. COMPUTER/SERVER

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

 

b. VIRTUAL SERVER

This is a single computer or a virtual machine (a software implementation of a machine that executes programs like a physical machine) that is owned, rented or leased by an individual or entity that turns around and rents or leases access to others. The virtual server may have one or more applications on it for the end users to use. The purpose of the virtual server is to give multiple users access to many software programs.

 

c. DEVELOPMENT

This means that you are programming a specific application or tool that will interact with the software that you are licensing from Neevia Tech.

 

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

 

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

 

LICENSE

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

 

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

 

 

 

 

(a) Home Use:

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

 

       (b) Server or Network Use:

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

 

(c) Operating system or Language versions:

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

 

(d) Archiving:

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

  

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

 

COPYRIGHT

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

 

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

 

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

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

  

LIMITATION OF REMEDIES AND LIABILITY

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

  

GENERAL

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

 

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

 

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

  

UPGRADES

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

 

GOVERNEMENT USERS

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

  

ENTIRE AGREEMENT

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

  

 

 

CONTACT INFORMATION

 

neeviaPDF.com

Tel: (954) 893.9343

Email: info@neeviaPDF.com

Web: http://neeviaPDF.com


 

Table of Contents

 

 

License Agreement. 2

Table of Contents. 5

Introduction. 8

Installing and Uninstalling Neevia PDFmerge/split. 9

How to register Neevia PDFmerge/split. 10

PDFmerge command line interface (CLmerge.exe) 11

Supported Options. 11

PDFsplit command line interface (CLsplit.exe). 15

Supported Options. 15

Using the COM interface to merge PDF files. 19

Using the .NET assembly to merge PDF files. 19

Properties: 19

version. 19

Linearize. 19

CreateNewBookmarks. 19

CreatePageBookmarks. 19

BookmarksFile. 20

NoOriginalBookmarks. 20

removeAnnotations. 20

removeAcroForms. 20

removePageLabels. 20

removeLayers. 20

removeArticleThreads. 20

removeTaggedInfo. 21

removeNamedDestinations. 21

removeEmbeddedFiles. 21

removeDuplicates. 21

CreatePortfolio. 21

NoPortfolio. 21

PreservePDFA. 21

SkipPDFonError. 22

KeepModifiedDate. 22

CreateObjectStreams. 22

PDF Encryption related properties. 23

PDFEncrypt. 23

PDFEncryptMetaData. 23

PDFEncryptionType. 23

PDFUserPassword. 23

PDFOwnerPassword. 23

PDFPermissions. 24

PDF Initial View & Metadata related properties. 25

DocumentTitle. 25

DocumentSubject. 25

DocumentAuthor. 25

DocumentKeywords. 25

PageMode. 25

PageLayout. 25

OpenMagnification. 26

OpenAtPage. 26

FitWindow.. 26

CenterWindow.. 26

HideMenuBar. 26

HideToolbar. 26

HideWindowUI 26

Methods. 27

MergePDF. 27

Using the COM interface to split PDF files. 28

Using the .NET assembly to split PDF files. 28

Properties. 28

version. 28

PDFPassword. 28

Linearize. 28

pages. 28

splitByBookmarks. 28

BkLevel 29

nameByBk. 29

removeBookmarks. 29

removeAnnotations. 29

removeAcroForms. 29

removePageLabels. 29

removeLayers. 29

removeArticleThreads. 30

removeNamedDestinations. 30

removeEmbeddedFiles. 30

RemoveTaggedInfo. 30

PreservePDFA. 30

KeepModifiedDate. 30

FixLinks. 30

LinkFormat. 31

ReplChar. 31

CreateObjectStreams. 31

PDF Encryption related properties. 32

PDFEncrypt. 32

PDFEncryptionType. 32

PDFEncryptMetaData. 32

PDFUserPassword. 32

PDFOwnerPassword. 32

PDFPermissions. 33

PDF Initial View & Metadata related properties. 33

DocumentTitle. 33

DocumentSubject. 33

DocumentAuthor. 33

DocumentKeywords. 33

PageMode. 34

PageLayout. 34

OpenMagnification. 34

OpenAtPage. 34

FitWindow.. 34

CenterWindow.. 34

HideMenuBar. 35

HideToolbar. 35

HideWindowUI 35

Methods. 35

SplitPDF. 35

Using the graphic interface to merge PDF files. 36

Output Settings. 37

Using the graphic interface to split PDF files. 42

Output Settings. 43

CODE SAMPLES. 48

Example 1vb. Merge 2 PDF files (Visual Basic). 48

Example 1delphi. Merge 2 PDF files (Delphi). 48

Example 1c#. Merge 2 PDF files (Visual C#). 48

Example 2vb. Split an existing PDF file into single pages (Visual Basic). 48

Example 2delphi. Split an existing PDF file into single pages (Delphi). 48

Example 2c#. Split an existing PDF file into single pages (Visual C#). 49

 

   


 

Introduction

   

Neevia PDFmerge/split is a software product that can be used to merge/split PDF files.

It comes as a command line tool, a graphic interface application, COM object and .NET assembly.

 

Supported platforms are: Windows  XP, 2003, Vista, 7, 2008, 2012, 8, 10 - 32 and 64 bit.

 

 

PDFmerge/split can be used to do the following:

 

·         Merge several PDF files into one file

·         Merge a specified range of pages

·         Create bookmarks for each input PDF

·         Remove text annotations

·         Remove PDF forms

·         Encrypt output PDF

·         Linearize (optimize for Fast Web View) output PDF

·         Set document information (Title, Author, etc)

·         Set the open action

·         Split a PDF file into parts with a specified number of pages

·         Split a PDF file into parts according to bookmarks

·         Restrict splitting to a specific bookmark level

·         Create Object Streams so the output file is smaller

 


 

Installing and Uninstalling Neevia PDFmerge/split

 

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

 

   To install Neevia PDFmerge/split:

 

download and save the http://neeviaPDF.com/prods/PDFmerge_setup.exe file onto your hard drive. After downloading the file, double-click on it and follow the instructions. The installation procedure automatically detects your operating system, copies the needed files into your system directory and installs Neevia PDFmerge/split.

 

Unattended installation:

To perform an unattended (silent) installation launch the PDFmerge/split installer with /sp /very silent /norestart command line switches. Here is the full list of supported switches:

 

/SP

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

 

/SILENT, /VERYSILENT

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

 

/NOCANCEL

Prevents the user from canceling during the installation process, by
disabling the Cancel button and ignoring clicks on the close button.

Useful along with /SILENT.

 

/NORESTART

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

 

/DIR="x:\dirname"

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

 
/GROUP="folder name"

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

 

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

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

 

        To remove Neevia PDFmerge/split from your computer:

 

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

 

2. In the Control Panel click Add/Remove programs and select Neevia PDFmerge/split from the applications list.

 

3. Click the Add/Remove button to remove the program. A confirmation prompt is displayed.

  

Unattended uninstall:

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

 

/SILENT, /VERYSILENT

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

 

/NORESTART

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

 

          How to register Neevia PDFmerge/split

After you downloaded the product run the installer and at the end of the process enter your registration info. If you do not have a serial number and simply want to test the product select Evaluate Product then click Finish. To register via the graphic interface right click on PDFmerge.exe select Run as administrator, click About -> Register -> copy and paste your licensing info.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

PDFmerge command line interface (CLmerge.exe)

By default, PDFmerge command line executable (CLmerge.exe) is located in the C:\program files (x86)\ neeviaPDF.com\PDFmerge\cmdLine folder.

 

Usage: CLmerge.exe "<inputfile1 + ... + inputfileN>" "<outputfile>" [options]

 

        "<inputfile1(pages) + ... + inputfileN(pages)>"   PDF files to merge

                (pages)    Page(s) to be merged - can be a number or several numbers divided by comma.  Use 0 (zero) to merge from current to last page.

 

        <outputfile>        Output (merged) PDF file

 

Example:   CLmerge.exe "c:\file1.pdf(4,6,1,10,0)+c:\file2.pdf" c:\merged.pdf

 

 Returns:

    0    success

   -1    unspecified error

   -2    invalid input file/options

Supported Options

 

-u <password>         open password to input PDF file

 

-ver <value>             2,...,7. Output PDF file version

 

-v                                verbose (output more details)

 

-cos                            creates object streams (smaller output PDF)

 

-duplicates               removes duplicate fonts and color profiles

 

-skip                           skips corrupted input files

 

-pdfa                          preserves PDF/A when merging (if possible)

 

 -noportfolio            unpacks PDF portfolio(s) and merge the files

 

-createportfolio      creates PDF portfolio instead of merging

 

-forms                       removes forms from output PDF file

 

-layers                       removes layers from output PDF file

 

-labels                        removes page labels from output PDF file

 

-annotations            removes text annotations from output PDF file

 

-createnew               creates bookmarks from input file names

 

-createpage              creates pages level bookmarks

 

-noorig                       does not import the original bookmarks

 

-bookmarks          creates bookmarks in the merged PDF by importing them from a text file.

   Example:

       CLmerge.exe "c:\file1.pdf+c:\file2.pdf" c:\out.pdf -createnew -forms

 

 -lin                          linearizes (Optimize for Fast Web View) output PDF file

  Example:

       CLmerge.exe "c:\file1.pdf+c:\file2.pdf" c:\out.pdf -lin

 

        -dests                    removes named destinations from output PDF

 

        -forms                   removes forms from output PDF

 

        -layers                   removes layers from output PDF

 

        -labels                   removes page labels from output PDF

 

        -annotations       removes annotations from output PDF

 

        -articlethreads    removes article threads from output PDF

 

        -embeddedfiles  removes embedded files (attachments) from output PDF

 

        -taggedinfo          removes tagged info from output PDF

   Example:

       CLmerge.exe "c:\file1.pdf+c:\file2.pdf" c:\out.pdf –forms -taggedinfo

 

 

 

Encryption settings

 

 -owner <value>   owner password to use for encrypting output PDF file

 

 -user <value>       user password to use for encrypting output PDF file

 

 -rc4                        uses 128 bits RC4 encryption for encrypting output file

 

 -aes                        uses 128 bits AES encryption for encrypting output file

 

-aes256                  uses 256 bits AES encryption for encrypting output file

 

-aes256v2              uses 256 bits AES R6 encryption

 

 -onlyattach           encrypts only attachments

 

 -nometa                does not encrypt PDF Metadata

 

 

 

 

 

 

 

 -perms <value>    PDF security permissions to use for encrypting output file flags:  

                           p - document printing is denied

                           c - changing the document is denied

                           s - selection and copying of text and graphics is denied

                           a - adding or changing annotations or form fields is denied

                     The following flags are defined for 128 bits encryption:

                           i - disables editing of form fields

                          e - disables extraction of text and graphics

                          d - disables document assembly

                          q - disables high quality printing

 

Example:

     CLmerge.exe "c:\file1.pdf+c:\file2.pdf" c:\out.pdf -owner test –aes256 -perms pcs

 

 

Document Info settings

 

-title <value>              sets output PDF file title to <value>

 

 -author <value>          sets output PDF file author to <value>

 

 -creator <value>         sets output PDF file creator to <value>

 

 -subject <value>         sets output PDF file subject to <value>

 

 -keywords <value>    sets output PDF file keywords to <value>

 

Example:

     CLmerge.exe "c:\file1.pdf+c:\file2.pdf" c:\out.pdf -title "Daily Report"

 

-openmagn <value>    sets open magnification (in %) for output PDF file

                        Possible values:

                                   0  - Default

                                   1  - Actual size

                                   2  - Fit Page

                                   3  - Fit Width

                                   4  - Fit Height

                                   5  - Fit Visible

 

      -openpage <value>     sets open page for output PDF file

     

        Example:

     CLmerge.exe "c:\file1.pdf+c:\file2.pdf" c:\out.pdf -openmagn 50 -openpage 1

     

      -pm <value>     specifies how output file should be displayed when opened in PDF viewer.

              Possible values:

0 - Default view

                       1 - Page only

                       2 - Outlines (bookmarks) visible

                       3 - Thumbnail images visible

                       4 - Optional content group panel visible

                       5 - Attachments panel visible

                       6 - Full screen mode

 

 

-pl <value>     specifies page layout to use when output file is opened in PDF viewer.

              Possible values:

                       1 - displays one page at a time (default)

                       2 - displays the pages in one column

                       3 - displays the pages in two columns, with odd numbered pages on the left

                       4 - displays the pages in two columns, with odd numbered pages on the right

                       5 - displays the pages two at a time, with odd numbered pages on the left

                       6 - displays the pages two at a time, with odd numbered pages on the right

 

   Example:

     CLmerge.exe "c:\file1.pdf+c:\file2.pdf" c:\out.pdf -pm 2 -pl 1

 

 

        -hidemenubar     specifies if PDF viewer should hide menu bar when output file is displayed

 

-hidetoolbar         specifies if PDF viewer should hide toolbar when output file is displayed

 

-hidewindowui    specifies if PDF viewer should hide user interface elements when output file is displayed

 

-fitwindow            specifies if PDF viewer should resize the document's window to fit the size of the first displayed page

 

-centerwindow   specifies if PDF viewer should position the document's window in the center of the screen 

Example:

     CLmerge.exe "c:\file1.pdf+c:\file2.pdf" c:\out.pdf -hidetoolbar -hidemenubar

 

 

 

 

 

 

 


 

PDFsplit command line interface (CLsplit.exe)

By default, the PDFsplit command line executable (CLsplit.exe) is located under C:\program files (x86)\ neeviaPDF.com\PDFmerge\cmdLine .

 

Usage: CLsplit.exe <inputfile> <outputpath> [options]

 

<inputfile(pages)>    PDF file to split

 

(pages)                        Page(s) to be split - can be a number or several numbers

                                     divided by comma. Use 0 to split from current to last page

 

[outputpath]              Folder to save the output PDF(s)

                                      If left blank then it will be the same as input folder

 

Returns:

    0   success

  -1    unspecified error

  -2    invalid input file/options

  -3    no pages to split

  -4    input file has no bookmarks (-b option)

  -5    there was an error fixing PDF links

 

Supported Options

 

-u <password>     open password to input PDF file

         

        -v                             verbose (output more details)

 

        -ver<value>           2,...,7. Output PDF file(s) version

 

        -lin                           linearizes output PDF(s) (optimize for Fast Web View)

 

        -cos                          creates object streams (smaller output PDF(s))

 

-p <value>               splits PDF by every <value> pages

                                         <value> can be a number or a list of numbers (ex. 5,1,3)

Example:

     CLsplit.exe "c:\input.pdf" c:\ -p 2

 

-b                               splits PDF based on bookmarks ( if present )

 

-bl <value>               restricts processing to a specific bookmark level

                                    (-bl option can only be used in combination with -b option)

 

-bn                             names output files according to bookmark titles

                                   (-bn option can only be used in combination with -b option)

                                   -b{:title[=file]}  Extract a chapter according to the bookmark title and store it                  

                                    in the specified file.

                                    ex: -b:Contents

                                    ex: -b:Contents=out.pdf

Example:

     CLsplit.exe "c:\input.pdf" c:\ -b -bl 1

 

       -replchar <val>           replaces invalid chars /\:*?<> with <val> in output filenames

 

       -fixlinks                         fixes links in output PDF(s) to point to the correct file

 

        -linkformat <value>  specifies the link format to use in output PDF(s)

                                                ex: - linkformat http://neevia.com/test.pdf?page=%d

                                                ex: - linkformat http://neevia.com/%fn?page=%d

 

        -pdfa                              preserves PDF/A  (if possible)

     

        -keepmoddate             keeps Modified Date unchanged

 

        -dests                            removes named destinations from output PDF(s)

 

-forms                            removes forms from output PDF files

 

-layers                            removes layers from output PDF files

 

-labels                            removes page labels from output PDF files

 

-articlethreads             removes article threads from output PDF(s)

 

-bookmarks                  removes bookmarks from output PDF(s)

 

-embeddedfiles           removes embedded files from output PDF(s)

 

-addtaggedinfo            adds tagged info (if present) to output PDF(s)

  

-annotations                 removes annotations from output PDF files

Example:

     CLsplit.exe "c:\input.pdf" c:\ -bookmarks - annotations

 

Encryption settings

 

 -owner <value>     owner password to use for encrypting output PDF file

 

 -user <value>         user password to use for encrypting output PDF file

 

  -rc4                         uses 128 bits RC4 encryption

 

  -aes                         uses 128 bits AES encryption

 

 -aes256                   uses 256 bits AES encryption

 

 -aes256v2               uses 256 bits AES R6 encryption

 

 -onlyattach            encrypts only attachments

 

 -nometa                  does not encrypt PDF Metadata

 

 -perms <value>     PDF security permissions to use for encrypting output file

     flags:

           p - document printing is denied

           c - changing the document is denied

           s - selection and copying of text and graphics is denied

           a - adding or changing annotations or form fields is denied

   The following flags are defined for 128 bits encryption:

           i - disables editing of form fields

          e - disables extraction of text and graphics

          d - disables document assembly

          q - disables high quality printing

Example:

     CLsplit.exe "c:\input.pdf" c:\ -owner test -aes -perms pcs

 

Document Info settings

 

-title <value>              sets output PDF file title to <value>

 

 -author <value>         sets output PDF file author to <value>

 

 -creator <value>        sets output PDF file creator to <value>

 

 -subject <value>        sets output PDF file subject to <value>

 

 -keywords <value>   sets output PDF file keywords to <value>

Example:

     CLsplit.exe "c:\input.pdf" c:\ -title "Daily Report"

 

-openmagn <value>   sets open magnification (in %) for output PDF file

                                  0  - Default

                                  1  - Actual size

                                  2  - Fit Page

                                  3  - Fit Width

                                  4  - Fit Height

                                  5  - Fit Visible

 

      -openpage <value>    sets open page for output PDF file

 

      Example:

     CLsplit.exe "c:\input.pdf" c:\ -openmagn 50 -openpage 1

 

 

      -pm <value>     specifies how output file should be displayed when opened in PDF viewer.

              Possible values:

0 - Default view

                       1 - Page only

                       2 - Outlines (bookmarks) visible

                       3 - Thumbnail images visible

                       4 - Optional content group panel visible

                       5 - Attachments panel visible

                       6 - Full screen mode

 

 

-pl <value>     specifies page layout to use when output file is opened in PDF viewer.

              Possible values:

                       1 - displays one page at a time (default)

                       2 - displays the pages in one column

                       3 - displays the pages in two columns, with odd numbered pages on the left

                       4 - displays the pages in two columns, with odd numbered pages on the right

                       5 - displays the pages two at a time, with odd numbered pages on the left

                       6 - displays the pages two at a time, with odd numbered pages on the right

Example:

     CLsplit.exe "c:\input.pdf" c:\ -pm 2 -pl 1

 

        -hidemenubar     specifies if PDF viewer should hide menu bar when output file is displayed

 

-hidetoolbar         specifies if PDF viewer should hide toolbar when output file is displayed

 

-hidewindowui    specifies if PDF viewer should hide user interface elements when output file is displayed

 

-fitwindow            specifies if PDF viewer should resize the document's window to fit the size of the first displayed page

 

-centerwindow    specifies if PDF viewer should position the document's window in the center of the screen 

Example:

     CLsplit.exe "c:\input.pdf" c:\ -hidetoolbar -hidemenubar

 


 

Using the COM interface to merge PDF files

 

Class ID

      PDFmerge.Neevia

 

Example:

      Visual Basic:  Set NVmerge = CreateObject("PDFmerge.Neevia")

                Delphi:  NVmerge := CreateOLEObject("PDFmerge.Neevia")

 

 

 

Using the .NET assembly to merge PDF files

 

To use the PDFmerge .NET interface for merging PDF files, in Visual Studio go Project -> Add Reference ->.NET and select PDFmergeNET from the list. After this:

                Visual Basic:   Dim NVmerge As New PDFmerge.Neevia

                   Visual C#:   PDFmerge.Neevia NVmerge = new PDFmerge.Neevia();

 

Properties:

 

version

Returns the PDFmerge version.

Syntax

   value = NVmerge.version

Data Type: String

 

Linearize

Specifies whether the merged PDF file should be linearized (Optimized for fast Web View).

Possible values: true, false (Default value: false)

Syntax

   NVmerge.Linearize = value

Data Type: Boolean

 

CreateNewBookmarks

Specifies whether to create a bookmark entry for each input file name. 

Possible values: true, false (Default value: false)

Syntax

   NVmerge.CreateNewBookmarks = value

Data Type: Boolean

 

CreatePageBookmarks

Specifies whether to create a bookmark entry for each page in the merging files.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.CreatePageBookmarks = value

Data Type: Boolean


 

BookmarksFile

Specifies whether to create bookmarks in the merged PDF by importing them from a text file.

Syntax

   NVmerge.BookmarksFile = value

Data Type: String

 

NoOriginalBookmarks

Specifies whether to remove the original bookmarks during merging.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.NoOriginalBookmarks = value

Data Type: Boolean

 

removeAnnotations

Specifies whether to remove text annotations from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.removeAnnotations = value

Data Type: Boolean

 

removeAcroForms

Specifies whether to remove PDF forms from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.removeAcroForms = value

Data Type: Boolean

 

removePageLabels

Specifies whether to remove page labels from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.removePageLabels = value

Data Type: Boolean

 

removeLayers

Specifies whether to remove layers from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.removeLayers = value

Data Type: Boolean

 

 removeArticleThreads

Specifies whether to remove article threads from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.removeArticleThreads = value

Data Type: Boolean

 

removeTaggedInfo

Specifies whether to remove tagged information from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.removeTaggedInfo = value

Data Type: Boolean

 

removeNamedDestinations

Specifies whether to remove named destinations from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.removeNamedDestinations = value

Data Type: Boolean

 

removeEmbeddedFiles

Specifies whether to remove embedded files (attachments) from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.removeEmbeddedFiles = value

Data Type: Boolean

 

removeDuplicates

Specifies whether to remove duplicate objects (like fonts and color profiles) from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.removeDuplicates = value

Data Type: Boolean

 

CreatePortfolio

Creates a PDF collection also known as portfolio instead of merging the input files .

Possible values: true, false (Default value: false)

 Syntax

   NVmerge.CreatePortfolio = value

Data Type: Boolean

 

NoPortfolio

Unpacks PDF portfolio and merges the files .

Possible values: true, false (Default value: false)

 Syntax

   NVmerge.NoPortfolio = value

Data Type: Boolean

 

 

PreservePDFA

Specifies whether to preserve the PDF/A standard when merging the PDF files.

Possible values: true, false (Default value: false)

 Syntax

   NVmerge.PreservePDFA = value

Data Type: Boolean

 

 

SkipPDFonError

Specifies whether to skip damaged files when merging.

Possible values: true, false (Default value: false)

 Syntax

   NVmerge.SkipPDFonError = value

Data Type: Boolean

 

 

KeepModifiedDate

Specifies whether to keep the modified date unchanged when merging.

Possible values: true, false (Default value: false)

 Syntax

   NVmerge.KeepModifiedDate = value

Data Type: Boolean

 

 

CreateObjectStreams

Specifies whether to create object streams when merging the PDF files.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.CreateObjectStreams = value

Data Type: Boolean

Note: An object stream represents a stream that contains a sequence of PDF objects. This allows a greater number of PDF objects to be compressed.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

PDF Encryption related properties

 

 

PDFEncrypt

Specifies whether the output PDF file should be encrypted.

Possible values: true, false (Default value: false)

Syntax

   NVmerge.PDFEncrypt = value

 

 

PDFEncryptMetaData

Specifies whether the metadata in the output PDF file should be encrypted.

Possible values: true, false (Default value: true)

Syntax

   NVmerge.PDFEncrypt = value

 

 

PDFEncryptionType

Specifies the encryption algorithm

Possible values:   "rc4" (high - 128 bits RC4 encryption - Acrobat 5-and-later compatible)

"aes" (high - 128 bits AES encryption - Acrobat 6-and-later compatible)

"aes256" (high - 256 bits AES encryption - Acrobat 9-and-later compatible)

"aes256v2" (high - 256 bits AES R6 encryption - Acrobat X-and-later compatible)

 

Syntax

   NVmerge.PDFEncryptionType = value

Data Type: String

Note: Will have effect only if PDFEncrypt = true.

 

PDFUserPassword

Sets the user password in the output document. Users will be asked to enter this password before Acrobat Reader allows them to view the document.

Syntax

   NVmerge.PDFUserPassword = value

Data Type: String

Note: Will have effect only if PDFEncrypt = true.

 

PDFOwnerPassword

Sets the output document owner password. This option will force the user of the PDF to enter a password before Acrobat Reader allows them to change the user password and security permissions.

Syntax

   NVmerge.PDFOwnerPassword = value

Data Type: String

Note: Will have effect only if PDFEncrypt = true.

 

 

 

 

 

 

 

PDFPermissions

PDF security permissions to use for encrypting output file. Possible values:

       p - document printing is denied

       c - changing the document is denied

       s - selection and copying of text and graphics is denied

       a - adding or changing annotations or form fields is denied

  The following flags are defined for 128 bits encryptions:

       i -  disables editing of form fields

       e - disables extraction of text and graphics

       d - disables document assembly

       q - disables high quality printing

 

Syntax

   NVmerge.PDFPermissions = value

Data Type: String

 

Example:

   NVmerge.PDFPermissions = "pcsaiedq"

PDF Initial View & Metadata related properties

DocumentTitle

Sets the output document Title field.

Syntax

   NVmerge.DocumentTitle = value

Data Type: String

 

DocumentSubject

Sets the output document Subject field.

Syntax

   NVmerge.DocumentSubject = value

Data Type: String

 

DocumentAuthor

Sets the output document author field.

Syntax

   NVmerge.DocumentAuthor = value

Data Type: String

 

DocumentKeywords

Sets the output document keywords field.

Syntax

   NVmerge.DocumentKeywords = value

Data Type: String

 

PageMode

Specifies how output file should be displayed when opened in PDF viewer. Possible values:

0 - Default view

1 - Page only

2 - Outlines (bookmarks) visible

3 - Thumbnail images visible

4 - Optional content group panel visible

5 - Attachments panel visible

6 - Full screen mode

Syntax

   NVmerge.PageMode = value

Data Type: Long

 

PageLayout

Specifies page layout to use when output file is opened in PDF viewer. Possible values:

       1 - Displays one page at a time (default)

       2 - Displays the pages in one column

       3 - Displays the pages in two columns, with odd numbered pages on the left

       4 - Displays the pages in two columns, with odd numbered pages on the right

       5 - Displays the pages two at a time, with odd numbered pages on the left

       6 - Displays the pages two at a time, with odd numbered pages on the right

Syntax

   NVmerge.PageLayout = value

Data Type: Long

OpenMagnification

Specifies the open magnification (in %) for output PDF file. Default value: 100

Syntax

   NVmerge.OpenMagnification = value

Data Type: Long

 

OpenAtPage

Specifies the open page for output PDF file. Default value: 1  (first page)

Syntax

   NVmerge.OpenAtPage = value

Data Type: Long

 

FitWindow

Specifies if PDF viewer should resize the document's window to fit the size of the first displayed page.

Possible values: true, false

Syntax

   NVmerge.FitWindow = value

Data Type: Boolean

 

CenterWindow

Specifies if PDF viewer should position the document's window in the center of the screen. 

Possible values: true, false

Syntax

   NVmerge.CenterWindow = value

Data Type: Boolean

 

HideMenuBar

Specifies if Acrobat Reader should hide the menu bar when displaying the output PDF document.

Possible values: true, false

Syntax

   NVmerge.HideMenuBar = value

Data Type: Boolean

 

HideToolbar

Specifies if Acrobat Reader should hide the toolbar when displaying the output PDF document.

Possible values: true, false

Syntax

   NVmerge.HideToolbar = value

Data Type: Boolean

 

HideWindowUI

Specifies if Acrobat Reader should hide the user interface when displaying the output PDF document.

Possible values: true, false

Syntax

   NVmerge.HideWindowUI = value

Data Type: Boolean

Methods

 

MergePDF

Merges the specified PDF files.

 

Syntax

   Res = NVmerge.MergePDF( filesToMerge, outputFile )

 

Parameters

     filesToMerge - input PDF files (PDF files to merge) - file names must be separated by +.

     outputFile - output PDF file name.

 

 Example

    Res = NVmerge.MergePDF("c:\file1.pdf+c:\file2.pdf", "c:\out.pdf")

 

Remarks

   Res<>0 on error


 

Using the COM interface to split PDF files

 

Class ID

       PDFsplit.Neevia

 

Example:

      Visual Basic:  Set NVsplit = CreateObject("PDFsplit.Neevia")

                Delphi:  NVsplit := CreateOLEObject("PDFsplit.Neevia")

 

 

Using the .NET assembly to split PDF files

To use the PDFsplit .NET interface for splitting PDF files, in Visual Studio go Project -> Add Reference ->.NET and select PDFmergeNET from the list (PDFsplit.NET and PDFmerge.NET intrerfaces are located in the same file). After this:

                Visual Basic:   Dim NVsplit As New PDFsplit.Neevia

                   Visual C#:   PDFsplit.Neevia NVmerge = new PDFsplit.Neevia();

 

Properties

version

Returns the PDFsplit version

 

Syntax

   value = NVsplit.version

Data Type: String

 

PDFPassword

Specifies the open password to use when splitting an encrypted PDF file.

Syntax

   NVsplit.PDFPassword = value

Data Type: String

 

Linearize

Specifies whether the split PDF file(s) should be linearized (Optimized for fast Web View).

Possible values: true, false (Default value: false)

Syntax

   NVsplit.Linearize = value

Data Type: Boolean

 

pages

Splits PDF by every <value> pages. Can be a number or a list of numbers separated by comma (ex. 5,1,3) 

Syntax

   NVsplit.pages = value

Data Type: String

 

splitByBookmarks

Specifies whether to split the input PDF according to bookmarks.

Syntax

   NVsplit.splitByBookmarks = value

Data Type: Boolean

BkLevel

Specifies the lowest bookmark level to split by. Default value: 1

Syntax

   NVsplit.BkLevel = value

Data Type: Integer

Note: will have effect only if splitByBookmarks = true

 

nameByBk

Specifies whether to name output PDF file(s) according to bookmark titles.

Possible values: true, false (Default value: false)

Syntax

   NVsplit.nameByBk = value

Data Type: Boolean

Note: will have effect only if splitByBookmarks = true

 

removeBookmarks

Specifies whether to remove bookmarks from the output PDF file(s).

Possible values: true, false (Default value: false)

Syntax

   NVsplit.removeBookmarks = value

Data Type: Boolean

 

removeAnnotations

Specifies whether to remove text annotations from the output PDF file(s).

Possible values: true, false (Default value: false)

Syntax

   NVsplit.removeAnnotations = value

Data Type: Boolean

 

removeAcroForms

Specifies whether to remove PDF forms from the output PDF file(s).

Possible values: true, false (Default value: false)

Syntax

   NVsplit.removeAcroForms = value

Data Type: Boolean

 

removePageLabels

Specifies whether to remove page labels from the output PDF file(s).

Possible values: true, false (Default value: false)

Syntax

   NVsplit.removePageLabels = value

Data Type: Boolean

 

removeLayers

Specifies whether to remove layers from the output PDF file(s).

Possible values: true, false (Default value: false)

Syntax

   NVsplit.removeLayers = value

Data Type: Boolean

 

removeArticleThreads

Specifies whether to remove article threads from the output PDF file(s).

Possible values: true, false (Default value: false)

Syntax

   NVsplit.removeArticleThreads = value

Data Type: Boolean

 

removeNamedDestinations

Specifies whether to remove named destinations from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVsplit.removeNamedDestinations = value

Data Type: Boolean

 

removeEmbeddedFiles

Specifies whether to remove embedded files (attachments) from the output PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVsplit.removeEmbeddedFiles = value

Data Type: Boolean

 

RemoveTaggedInfo

Specifies whether to remove tagged information from the output PDF file.

Possible values: true, false (Default value: true)

Syntax

   NVsplit.addTaggedInfo = value

Data Type: Boolean

 

PreservePDFA

Specifies whether to preserve the PDF/A standard when splitting the PDF file.

Possible values: true, false (Default value: false)

 Syntax

   NVsplit.PreservePDFA = value

Data Type: Boolean

 

 

KeepModifiedDate

Specifies whether to keep the modified date unchanged when splitting.

Possible values: true, false (Default value: false)

 Syntax

   NVsplit.KeepModifiedDate = value

Data Type: Boolean

 

 

FixLinks

Specifies whether to fix the links in the output PDF(s) so they point to the correct file.

Possible values: true, false (Default value: false)

 Syntax

   NVsplit.FixLinks = value

Data Type: Boolean

 

LinkFormat

Specifies the link format to use in the output PDF(s)

                       ex: - linkformat http://neevia.com/test.pdf?page=%d

                       ex: - linkformat http://neevia.com/%fn?page=%d

 Syntax

   NVsplit.LinkFormat = value

Data Type: String

 

ReplChar

Replaces invalid chars /\:*?<> with <value> in output filenames

Syntax

   NVsplit.ReplChar = value

Data Type: String

 

 

CreateObjectStreams

Specifies whether to create object streams when splitting the PDF file.

Possible values: true, false (Default value: false)

Syntax

   NVsplit.CreateObjectStreams = value

Data Type: Boolean

Note: An object stream represents a stream that contains a sequence of PDF objects. This allows a greater number of PDF objects to be compressed.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

PDF Encryption related properties

PDFEncrypt

Specifies whether the split PDF file(s) should be encrypted.

Possible values: true, false (Default value: false)

Syntax

   NVsplit.PDFEncrypt = value

 

PDFEncryptionType

Specifies the encryption algorithm.

Possible values:   "rc4" (high - 128 bits RC4 encryption - Acrobat 5-and-later compatible)

"aes" (high - 128 bits AES encryption - Acrobat 6-and-later compatible)

"aes256" (high - 256 bits AES encryption - Acrobat 9-and-later compatible)

"aes256v2" (high - 256 bits AES R6 encryption - Acrobat X-and-later compatible)

 

Syntax

   NVsplit.PDFEncryptionType = value

Data Type: String

Note: Will have effect only if PDFEncrypt = true.

 

 

PDFEncryptMetaData

Specifies whether the metadata in the output PDF file(s) should be encrypted.

Possible values: true, false (Default value: true)

Syntax

   NVsplit.PDFEncrypt = value

Data Type: Boolean

 

PDFUserPassword

Set the user password in the output document(s). Users will be asked to enter this password before Acrobat Reader will allow them to view the document.

Syntax

   NVsplit.PDFUserPassword = value

Data Type: String

Note: Will have effect only if PDFEncrypt = true.

 

PDFOwnerPassword

Set the output document(s) owner password. This option will force the user of the PDF to enter a password before Acrobat Reader allows them to change the user password and security permissions.

Syntax

   NVsplit.PDFOwnerPassword = value

Data Type: String

Note: Will have effect only if PDFEncrypt = true.

 

 

 

 

 

 

 

 

PDFPermissions

PDF security permissions to use for encrypting output file(s). Possible values:

       p - document printing is denied

       c - changing the document is denied

       s - selection and copying of text and graphics is denied

       a - adding or changing annotations or form fields is denied

 The following flags are defined for 128 bits encryptions:

       i -  disables editing of form fields

       e - disables extraction of text and graphics

       d - disables document assembly

       q - disables high quality printing

Syntax

   NVsplit.PDFPermissions = value

Data Type: String

 

Example:

   NVsplit.PDFPermissions = "pcsaiedq"

 

 

 

PDF Initial View & Metadata related properties

 

 

DocumentTitle

Sets the output document(s) Title field.

Syntax

   NVsplit.DocumentTitle = value

Data Type: String

 

DocumentSubject

Sets the output document(s) Subject field.

Syntax

   NVsplit.DocumentSubject = value

Data Type: String

 

DocumentAuthor

Sets the output document(s) Author field.

Syntax

   NVsplit.DocumentAuthor = value

Data Type: String

 

DocumentKeywords

Sets the output document(s) Keywords field.

Syntax

   NVsplit.DocumentKeywords = value

Data Type: String

 


 

PageMode

Specifies how output file(s) should be displayed when opened in PDF viewer. Possible values:

0 - Default view

1 - Page only

2 - Outlines (bookmarks) visible

3 - Thumbnail images visible

4 - Optional content group panel visible

5 - Attachments panel visible

6 - Full screen mode

Syntax

   NVsplit.PageMode = value

Data Type: Long

 

PageLayout

Specifies page layout to use when output file is opened in PDF viewer. Possible values:

     1 - Display one page at a time (default)

     2 - Display the pages in one column

     3 - Display the pages in two columns, with odd numbered pages on the left

     4 - Display the pages in two columns, with odd numbered pages on the right

     5 - Display the pages two at a time, with odd numbered pages on the left

     6 - Display the pages two at a time, with odd numbered pages on the right

Syntax

   NVsplit.PageLayout = value

Data Type: Long

 

OpenMagnification

Specifies the open magnification (in %) for output PDF file(s). Default value: 100

Syntax

   NVsplit.OpenMagnification = value

Data Type: Long

 

OpenAtPage

Specifies the open page for output PDF file(s). Default value: 1 (first page)

Syntax

   NVsplit.OpenAtPage = value

Data Type: Long

 

 

FitWindow

Specifies if PDF viewer should resize the document's window to fit the size of the first displayed page.

Possible values: true, false

Syntax

   NVsplit.FitWindow = value

Data Type: Boolean

 

CenterWindow

Specifies if PDF viewer should position the document's window in the center of the screen. 

Possible values: true, false

Syntax

   NVsplit.CenterWindow = value

Data Type: Boolean

HideMenuBar

Specifies if Acrobat Reader should hide the menu bar when displaying the output PDF document.

Possible values: true, false

Syntax

   NVsplit.HideMenuBar = value

Data Type: Boolean

 

HideToolbar

Specifies if Acrobat Reader should hide the toolbar when displaying the output PDF document(s).

Possible values: true, false

Syntax

   NVsplit.HideToolbar = value

Data Type: Boolean

 

HideWindowUI

Specifies if Acrobat Reader should hide the user interface when displaying the output PDF document.

Possible values: true, false

Syntax

   NVsplit.HideWindowUI = value

Data Type: Boolean

 

 

 

Methods

SplitPDF

Splits the specified PDF file.

 

Syntax

   Res = NVsplit.SplitPDF( fileToSplit, outputPath )

 

Parameters

     fileToSplit - PDF file to split.

     outputPath - output folder.

 

Example

    Res = NVsplit.SplitPDF("c:\input.pdf", "c:\")

 

Remarks

   Res<>0 on error

 

 


 

Using the graphic interface to merge PDF files

In order to merge files using the graphic interface you need to execute PDFmerge.exe located, by default, in the c:\program files (x86)\neeviaPDF.com\PDFmerge\apps  folder.

 

PDFmerge.png

 

Click Add files to select the PDF files to be merged. In case you want to merge all PDF files in a  folder simply click the Add folder button to select the folder. For multiple folders click Add Folders.

 

To specify the merging order, select your files and use the UP, DOWN buttons. In case you want to remove a file from the merging list select the file and click Remove.

 

You also have the option to specify which pages to be merged from one or more files by clicking the Choose Pages button and selecting either All Pages  or page numbers and/or page ranges separated by commas.

                                                      

PDFmerge1.png

 

 

 


 

Output Settings

 

Before merging PDF files you need to specify the output settings. To do that click on the Settings button. The interface below will be displayed.

 

PDFmerge2.png

                                          

Merging Settings

 

Preserve PDF/A (if possbile)  -  use this option in case you need to merge PDF/A files.

 

Optimize output file for Fast Web viewing  -  this option restructures the resulting PDF document

for page-at-a-time downloading (byte-serving). This is especially important with large documents

that can take a long time to download from a server.

 

Create object streams  -  select this option if you need your output file to contain object streams which basically means multiple PDF objects inside a compressed binary stream. This will create smaller files.

 

Do not import original bookmarks  -  use this to remove the original bookmarks.

 

 

Create bookmarks from input file names - when this option is checked the application will add a

bookmark entry for each input file name. 

 

Create page level bookmarks – resulting PDF will contain a bookmark entry for each page in the 

 merging files.

 

To remove forms,  layers,  page labels, annotations, article threads, attachments, named destination,

tagged info, duplicate fonts and color profiles from the output file simply check the corresponding

option(s) in the Merging Settings interface.

 

PDF Information

In this window  you can specify  Title, Author,  Subject  and Keywords  for the merged file.

 

PDF Security

 

To encrypt the output PDF file, check Encrypt Document then select the encryption level from the Compatibility drop down box. There are 6 options:

  1. Acrobat 3.0 and later (PDF 1.2)  enables 40 bit RC4 encryption (weak - not recommended)
  2. Acrobat 5.0 and later (PDF 1.4) enables 128 bit RC4 encryption
  3. Acrobat 6.0 and later (PDF 1.5) enables 128 bit RC4 encryption
  4. Acrobat 7.0 and later (PDF 1.6) enables 128 bit AES encryption
  5. Acrobat 9.0 and later (PDF 1.7) enables 256 bit AES encryption
  6. Acrobat X and later (PDF 1.7 ext3) enables 256 bit AES R6 encryption

 

Encrypt All Document Contents

When you select this option both the document and document metadata will be encrypted. Search engines will not be able to access the document metadata when this option is used.

 

Encrypt All Document Contents Except Metadata

It is valid for Acrobat 6 and later. Only the content of a PDF document will be encrypted. Metadata remains fully accesible for search engines.

 

Require a Password to Open the Document

This allows you to set a password for opening the encrypted PDF.

 

Change Permissions Password

This password prevents users from changing the permission settings. The user can view the file in Acrobat Reader but must enter the specified Permissions password in order to change the file’s Security and Permissions settings.

 

Permissions

 

Printing Allowed - Specifies the level of printing that users are allowed for the PDF document.

Possible values:

None - disables printing.

Low Resolution (150 dpi) - users can print but the resolution will not be higher than 150-dpi. Each page is printed as a bitmap image which may cause files to print at a slower speed. To make this option available set the Compatibility option to Acrobat 5 (PDF 1.4) or later.

High Resolution - allows users to print at any resolution. PostScript and other printers that come with high-quality printing features can be used.

 

Changes Allowed - Enables the editing actions that are allowed in the PDF document. Possible values:

 

None - when selected none of the changes listed in Changes Allowed drop down box, such as filling in form fields and adding comments are permitted.

 

Inserting, Deleting, And Rotating Pages - allows users to insert, delete, and rotate pages. Also bookmarks and thumbnails creation are permitted. This option works only for high (128‑bit RC4, AES or AES256) encryption.

 

Filling in Form Fields and Signing Existing Signature Fields - when selected users can fill in forms and add digital signatures. Adding comments or creating form fields is not permitted. This option works only for high (128‑bit RC4, AES or AES256) encryption.

 

Commenting, Filling In Form Fields and Signing Existing Signature Fields - users are allowed to add comments, digital signatures and fill in forms. Moving page objects or create form fields is not permitted.

 

Page Layout, Filling in Form Fields and Signing - users can insert, rotate or delete pages and create bookmarks or thumbnail images, fill out forms, and add digital signatures. Creating form fields is not permitted. This option works only for low (40‑bit RC4) encryption.

 

Any Except Extracting Pages - allows users to edit the document, create and fill in form fields, add comments and digital signatures.

 

Enable Copying of Text, Images, and Other Content - allows users to select and copy the contents of   

                          a PDF.

 

Enable Text Access For Screen Reader Devices For The Visually Impaired - when selected visually impaired users can read the document with screen readers.  It doesn’t allow users to copy or extract the document’s contents. This option works only for high (128-bit RC4, AES or AES256) encryption.

 


 

PDF Initial View

In this window you can set the PDF Initial View options:

 

PDFmerge3.png

 

Navigation Tab - specifies which panels are displayed in the PDF viewer navigation pane.

Page Layout - specifies how document pages are arranged.

Magnification - use this to select at what zoom level the document will appear when opened.

Open To Page - specifies the page that appears when the PDF document opens.

 

Window Options - these options allow you to specify how the PDF viewer window adjusts in the screen area when a PDF document is opened.

 

Resize Window To Initial Page - adjusts the document window to fit snugly around the opening page, taking into account the options that you selected under Document Options.

 

Center Window On Screen - instructs the PDF viewer to position the window in the center of the screen area.

 

Open In Full Screen Mode -  maximizes the document window and displays the document

                                                    without the menu bar, toolbar, or window controls.

User Interface Options

These options allow you to specify which parts of the PDF viewer interface - the menu bar, the toolbars, and the window controls - are hidden.

Note: take into account that If you hide the menu bar and toolbars users cannot apply commands and select tools unless they know the keyboard shortcuts.

 

 

GUI - Graphic User Interface

 

PDFmerge4.png

 

In this window you can select the Graphic User Interface themes. Check Use GUI Themes to enable the Color Scheme. Once that is enabled check either Gradient fill or Solid fill to specify how the color will be displayed.

 


 

Using the graphic interface to split PDF files

In order to split files using the graphic interface you need to execute PDFsplit.exe located, by default,  under C:\program files(x86)\neeviaPDF.com\PDFmerge\apps.

 

PDFsplit.png

 

Click Add files to select the PDF file(s) to be split. In case you want to split all PDF files in a folder simply click the Add folder. For multiple folders click Add Folders. To remove a file from the splitting list, select the file and click Remove.  To select an output folder for the split files  click the Browse button in the  interface above.

 

After you add your path to the destination folder the following file naming variables can be used:

 

%fname% - uses the original file name.

%xd            - adds numbers to the resulting file name – e.g. %3d% will force PDFsplit to produce files

                     with names like this: 'filename001.pdf', ... , 'filename010.pdf', ... 

                     %4d will produce:  'filename0001.jpg', ... , 'filename0010.jpg', ...

%bktitle% -  uses bookmarks as file names;  works only if Split by Bookmarks  in the Splitting settings   

                      window is enabled.

                     

Example:  C:\MySplitFiles\%fname%3d%.pdf


 

Output Settings

 

Before splitting PDF files you need to specify the output settings. To do that click on the Settings button. The interface below will be displayed:

 

PDFsplit1.png

  

                                       

Splitting Settings

This is the window in which you can specify what options to be used during the splitting process.

The followind options are available:

·         Split by page;

·         Split by page range:  you can enter page numbers and/or page ranges separated by commas;

·         Split by bookmarks: you can select to name output files according to bookmark titles;

·         Extract specified pages: type in the page number(s) you want to extract from the input file

·         Extract specified bookmark: type in the bookmark name you want to extract.

 

When either Split by Page range or Extract specified pages is selected you will have to insert page numbers and/or page ranges separated by commas in the Pages textbox.

The difference between these two options is that Extract specified pages will output one file that contains all pages you specified in the Pages textbox.

 

Example1:  1-6, 7, 8, 9 - this splits the input PDF into one file containing the first 6 pages and three  other files each having one page.   

Example2:  1-4, {2} - this extracts the first 4 pages but creates  2 PDF files with 2 pages each.

Example3:  1-4, {3,1} - this splits the input PDF into a 3 page file followed by a 1 page file.  

 

Preserve PDF/A  - use this option if the input file is a PDF/a and you need to preserve the standard after splitting.

 

Optimize output file for Fast Web Viewing  - this option restructures a PDF document for page-at-a-time downloading (byte-serving). This is especially important with large documents that can take a long time to download from a server.

 

Create object streams  - use this option if you need your output file to contain object streams which basically means multiple PDF objects inside a compressed binary stream. This will create smaller files.

 

Keep modified date unchanged  - select this option to make the output file keep the same modified date as the input file.

 

To remove forms,  layers,  page labels, annotations, article threads, bookmarks, attachments, named

destinations, tagged info from the output file simply check the corresponding option(s) in the

Splitting Settings interface.

 

 

PDF Information

In this window you can specify  Title, Author, Subject and Keywords for the PDF files that result after the splitting process.

 

 

PDF Security

 

To encrypt the output PDF file(s), check Encrypt Document then select the encryption level from the Compatibility drop down box. There are 6 options:

  1. Acrobat 3.0 and later (PDF 1.2)  enables 40 bit RC4 encryption (weak - not recommended)
  2. Acrobat 5.0 and later (PDF 1.4) enables 128 bit RC4 encryption
  3. Acrobat 6.0 and later (PDF 1.5) enables 128 bit RC4 encryption
  4. Acrobat 7.0 and later (PDF 1.6) enables 128 bit AES encryption
  5. Acrobat 9.0 and later (PDF 1.7) enables 256 bit AES encryption
  6. Acrobat X and later (PDF 1.7 ext3) enables 256 bit AES R6 encryption

 

 

Encrypt All Document Contents

When you select this option both the document and document metadata will be encrypted. Search engines will not be able to access the document metadata when this option is used.

 

Encrypt All Document Contents Except Metadata

It is valid for Acrobat 6 and later. Only the content of a PDF document will be encrypted. Metadata remains fully accesible for search engines.

 

Require a Password to Open the Document

This allows you to set a password for opening the encrypted PDF.

 

Change Permissions Password

This password prevents users from changing the permission settings. The user can view the file in Acrobat Reader but must enter the specified Permissions password in order to change the file’s Security and Permissions settings.

 

Permissions

 

Printing Allowed - Specifies the level of printing that users are allowed for the PDF document.

Possible values:

None - Disables printing.

Low Resolution (150 dpi) - Users can print but the resolution will not be higher than 150-dpi. Each page is printed as a bitmap image which may cause files to print at a slower speed. To make this option available set the Compatibility option to Acrobat 5 (PDF 1.4) or later.

High Resolution - Allow users to print at any resolution. PostScript and other printers that come with high-quality printing features can be used.

 

Changes Allowed - Enables the editing actions that are allowed in the PDF document. Possible values:

 

None - when selected none of the changes listed in Changes Allowed drop down box, such as filling in form fields and adding comments are permitted.

 

Inserting, Deleting, And Rotating Pages - allows users to insert, delete, and rotate pages. Also bookmarks and thumbnails creation are permitted. This option works only for high  encryption (128‑bit RC4, AES, AES256 or AES256v2).

 

Filling in Form Fields and Signing Existing Signature Fields - when selected users can fill in forms and add digital signatures. Adding comments or creating form fields is not permitted. This option works only for high (128‑bit RC4, AES or AES256) encryption.

 

Commenting, Filling In Form Fields and Signing Existing Signature Fields - users are allowed to add comments, digital signatures and fill in forms. Moving page objects or create form fields is not permitted.

 

Page Layout, Filling in Form Fields and Signing - users can insert, rotate or delete pages and create bookmarks or thumbnail images, fill out forms, and add digital signatures. Creating form fields is not permitted. This option works only for low (40‑bit RC4) encryption.

 

Any Except Extracting Pages - allows users to edit the document, create and fill in form fields, add comments and digital signatures.

 

Enable Copying of Text, Images, and Other Content - allows users to select and copy the contents of a PDF.

 

Enable Text Access For Screen Reader Devices For The Visually Impaired - when selected visually impaired users can read the document with screen readers.  It doesn’t allow users to copy or extract the document’s contents. This option works only for high (128-bit RC4, AES or AES256) encryption.

 


 

PDF Initial View

In this window you can set the PDF Initial View options:

 

PDFmerge3.png

 

Navigation Tab - specifies which panels are displayed in the PDF viewer navigation pane.

Page Layout - specifies how document pages are arranged.

Magnification - use this to select at what zoom level the document will appear when opened.

Open To Page - specifies the page that appears when the PDF document opens.

 

Window Options - these options allow you to specify how the PDF viewer window adjusts in the screen area when a PDF document is opened.

 

Resize Window To Initial Page - adjusts the document window to fit snugly around the opening

page, taking into account the options that you selected under Document Options.

 

Center Window On Screen - instructs the PDF viewer to position the window in the center of

the screen area.

 

Open In Full Screen Mode - maximizes the document window and displays the document

without the menu bar, toolbar, or window controls.

 

 

 

User Interface Options

These options allow you to specify which parts of the PDF viewer interface - the menu bar, the toolbars, and the window controls - are hidden.

Note: take into account that If you hide the menu bar and toolbars users cannot apply commands and select tools unless they know the keyboard shortcuts.

 

 

GUI - Graphic User Interface

 

PDFmerge4.png

 

In this window you can select the Graphic User Interface themes. Check Use GUI Themes to enable the Color Scheme. Once that is enabled check either Gradient fill or Solid fill to specify how the color will be displayed.


 

CODE SAMPLES

For a full and updated list of PDFmerge code samples please visit http://neeviaPDF.com/support/examples/pdfmerge/

Example 1vb. Merge 2 PDF files (Visual Basic)

 

Dim NVmerge : Set NVmerge = CreateObject("PDFmerge.Neevia")

MsgBox NVmerge.MergePDF("c:\file1.pdf+c:\file2.pdf", "c:\out.pdf")

Example 1delphi. Merge 2 PDF files (Delphi)

 

Uses ComObj;

...

var

   NVmerge: Variant;

   retVal : String;

begin

  NVmerge := CreateOLEObject('PDFmerge.Neevia');

  retVal := IntToStr( NVmerge.MergePDF('c:\file1.pdf+c:\file2.pdf', 'c:\out.pdf'));

  Application.MessageBox( PChar( retVal ), 'Done merging', MB_OK);

Example 1c#. Merge 2 PDF files (Visual C#)

In Visual Studio go Project->Add Reference->.NET and select PDFmergeNET from the list.

 

PDFmerge.Neevia NVmerge = new PDFmerge.Neevia();

int rVal = 0;

rVal = NVmerge.MergePDF(@"c:\file1.pdf+c:\file2.pdf", @"c:\outC#.pdf");

MessageBox.Show( rVal.ToString() );

 

For a full and updated list of PDFsplit code samples please visit http://neeviaPDF.com/support/examples/pdfsplit/

Example 2vb. Split an existing PDF file into single pages (Visual Basic)

 

Dim NVsplit : Set NVsplit = CreateObject("PDFsplit.Neevia")

MsgBox NVsplit.SplitPDF("c:\input.pdf", "c:\")

Example 2delphi. Split an existing PDF file into single pages (Delphi)

 

Uses ComObj;

...

var

   NVsplit: Variant;

   retVal : String;

begin

  NVsplit := CreateOLEObject('PDFsplit.Neevia');

  retVal := IntToStr( NVsplit.SplitPDF('c:\input.pdf', 'c:\'));

  Application.MessageBox( PChar( retVal ), 'Done splitting', MB_OK);

 

Example 2c#. Split an existing PDF file into single pages (Visual C#)

In Visual Studio go Project->Add Reference->.NET and select PDFmergeNET from the list.

 

PDFsplit.Neevia NVsplit = new PDFsplit.Neevia();

int rVal = 0;

rVal = NVsplit.SplitPDF(@"c:\input.pdf", @"c:\");

MessageBox.Show( rVal.ToString() );