PDF Merge
PDF Merge
Neevia
PDFmerge/split
user’s manual
version 4.4
[Link]
License Agreement
ELECTRONIC END USER LICENSE AGREEMENT
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.
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.
(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.
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.
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
[Link]
Tel: (954) 893.9343
Email: info@[Link]
Web: [Link]
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 ([Link]) .................................................................. 11
Supported Options....................................................................................................................... 11
PDFsplit command line interface ([Link]) ........................................................................ 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
Introduction
Neevia PDFmerge/split is a software product that can be used to merge/split PDF files.
It comes as a command line tool, graphic interface application, COM object and .NET assembly.
Supported platforms are: Windows 2003, Vista, 7, 2008, 2012, 8, 10, 2016, 2019, 11 - 32 and 64 bit.
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.
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 [Link] 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.
Returns:
0 success
-1 unspecified error
-2 invalid input file/options
Supported Options
-u <password> open password to input PDF file
-bookmarks creates bookmarks in the merged PDF by importing them from a text file.
Example:
[Link] "c:\[Link]+c:\[Link]" c:\[Link] -createnew -forms
-lin linearizes (Optimize for Fast Web View) output PDF file
Example:
[Link] "c:\[Link]+c:\[Link]" c:\[Link] -lin
Example:
[Link] "c:\[Link]+c:\[Link]" c:\[Link] –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
-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
Example:
[Link] "c:\[Link]+c:\[Link]" c:\[Link] -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
Example:
[Link] "c:\[Link]+c:\[Link]" c:\[Link] -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:
[Link] "c:\[Link]+c:\[Link]" c:\[Link] -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:
[Link] "c:\[Link]+c:\[Link]" c:\[Link] -hidetoolbar -hidemenubar
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
-replchar <val> replaces invalid chars /\:*?<> with <val> in output filenames
Example:
[Link] "c:\[Link]" 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
-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:
[Link] "c:\[Link]" c:\ -owner test -aes -perms pcs
Example:
[Link] "c:\[Link]" 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
Example:
[Link] "c:\[Link]" 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:
[Link] "c:\[Link]" 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:
[Link] "c:\[Link]" c:\ -hidetoolbar -hidemenubar
Properties:
version
Returns the PDFmerge version.
Syntax
value = [Link]
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
[Link] = 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
[Link] = 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
[Link] = value
Data Type: Boolean
BookmarksFile
Specifies whether to create bookmarks in the merged PDF by importing them from a text file.
Syntax
[Link] = value
Data Type: String
NoOriginalBookmarks
Specifies whether to remove the original bookmarks during merging.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
Data Type: Boolean
removeAnnotations
Specifies whether to remove text annotations from the output PDF file.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
Data Type: Boolean
removeAcroForms
Specifies whether to remove PDF forms from the output PDF file.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
Data Type: Boolean
removePageLabels
Specifies whether to remove page labels from the output PDF file.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
Data Type: Boolean
removeLayers
Specifies whether to remove layers from the output PDF file.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
Data Type: Boolean
removeArticleThreads
Specifies whether to remove article threads from the output PDF file.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
Data Type: Boolean
removeTaggedInfo
Specifies whether to remove tagged information from the output PDF file.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
Data Type: Boolean
removeNamedDestinations
Specifies whether to remove named destinations from the output PDF file.
Possible values: true, false (Default value: false)
Syntax
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = value
Data Type: Boolean
NoPortfolio
Unpacks PDF portfolio and merges the files .
Possible values: true, false (Default value: false)
Syntax
[Link] = 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
[Link] = value
Data Type: Boolean
SkipPDFonError
Specifies whether to skip damaged files when merging.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
Data Type: Boolean
KeepModifiedDate
Specifies whether to keep the modified date unchanged when merging.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
Data Type: Boolean
CreateObjectStreams
Specifies whether to create object streams when merging the PDF files.
Possible values: true, false (Default value: false)
Syntax
[Link] = 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.
PDFEncrypt
Specifies whether the output PDF file should be encrypted.
Possible values: true, false (Default value: false)
Syntax
[Link] = value
PDFEncryptMetaData
Specifies whether the metadata in the output PDF file should be encrypted.
Possible values: true, false (Default value: true)
Syntax
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = value
Data Type: String
Example:
[Link] = "pcsaiedq"
DocumentSubject
Sets the output document Subject field.
Syntax
[Link] = value
Data Type: String
DocumentAuthor
Sets the output document author field.
Syntax
[Link] = value
Data Type: String
DocumentKeywords
Sets the output document keywords field.
Syntax
[Link] = 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
[Link] = 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
[Link] = value
Data Type: Long
OpenMagnification
Specifies the open magnification (in %) for output PDF file. Default value: 100
Syntax
[Link] = value
Data Type: Long
OpenAtPage
Specifies the open page for output PDF file. Default value: 1 (first page)
Syntax
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = value
Data Type: Boolean
HideToolbar
Specifies if Acrobat Reader should hide the toolbar when displaying the output PDF document.
Possible values: true, false
Syntax
[Link] = 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
[Link] = value
Data Type: Boolean
Methods
MergePDF
Merges the specified PDF files.
Syntax
Res = [Link]( filesToMerge, outputFile )
Parameters
filesToMerge - input PDF files (PDF files to merge) - file names must be separated by +.
outputFile - output PDF file name.
Example
Res = [Link]("c:\[Link]+c:\[Link]", "c:\[Link]")
Remarks
Res<>0 on error
Properties
version
Returns the PDFsplit version
Syntax
value = [Link]
Data Type: String
PDFPassword
Specifies the open password to use when splitting an encrypted PDF file.
Syntax
[Link] = 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
[Link] = 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
[Link] = value
Data Type: String
splitByBookmarks
Specifies whether to split the input PDF according to bookmarks.
Syntax
[Link] = value
Data Type: Boolean
BkLevel
Specifies the lowest bookmark level to split by. Default value: 1
Syntax
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = value
Data Type: Boolean
removeLayers
Specifies whether to remove layers from the output PDF file(s).
Possible values: true, false (Default value: false)
Syntax
[Link] = 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
[Link] = value
Data Type: Boolean
removeNamedDestinations
Specifies whether to remove named destinations from the output PDF file.
Possible values: true, false (Default value: false)
Syntax
[Link] = 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
[Link] = value
Data Type: Boolean
RemoveTaggedInfo
Specifies whether to remove tagged information from the output PDF file.
Possible values: true, false (Default value: true)
Syntax
[Link] = 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
[Link] = value
Data Type: Boolean
KeepModifiedDate
Specifies whether to keep the modified date unchanged when splitting.
Possible values: true, false (Default value: false)
Syntax
[Link] = 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
[Link] = value
Data Type: Boolean
LinkFormat
Specifies the link format to use in the output PDF(s)
ex: - linkformat [Link]
ex: - linkformat [Link]
Syntax
[Link] = value
Data Type: String
ReplChar
Replaces invalid chars /\:*?<> with <value> in output filenames
Syntax
[Link] = value
Data Type: String
CreateObjectStreams
Specifies whether to create object streams when splitting the PDF file.
Possible values: true, false (Default value: false)
Syntax
[Link] = 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.
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
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = value
Data Type: String
Example:
[Link] = "pcsaiedq"
DocumentTitle
Sets the output document(s) Title field.
Syntax
[Link] = value
Data Type: String
DocumentSubject
Sets the output document(s) Subject field.
Syntax
[Link] = value
Data Type: String
DocumentAuthor
Sets the output document(s) Author field.
Syntax
[Link] = value
Data Type: String
DocumentKeywords
Sets the output document(s) Keywords field.
Syntax
[Link] = 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
[Link] = 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
[Link] = value
Data Type: Long
OpenMagnification
Specifies the open magnification (in %) for output PDF file(s). Default value: 100
Syntax
[Link] = value
Data Type: Long
OpenAtPage
Specifies the open page for output PDF file(s). Default value: 1 (first page)
Syntax
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = 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
[Link] = value
Data Type: Boolean
Methods
SplitPDF
Splits the specified PDF file.
Syntax
Res = [Link]( fileToSplit, outputPath )
Parameters
fileToSplit - PDF file to split.
outputPath - output folder.
Example
Res = [Link]("c:\[Link]", "c:\")
Remarks
Res<>0 on error
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.
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.
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
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:
a. Acrobat 3.0 and later (PDF 1.2) enables 40 bit RC4 encryption (weak - not recommended)
b. Acrobat 5.0 and later (PDF 1.4) enables 128 bit RC4 encryption
c. Acrobat 6.0 and later (PDF 1.5) enables 128 bit RC4 encryption
d. Acrobat 7.0 and later (PDF 1.6) enables 128 bit AES encryption
e. Acrobat 9.0 and later (PDF 1.7) enables 256 bit AES encryption
f. Acrobat X and later (PDF 1.7 ext3) enables 256 bit AES R6 encryption
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.
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.
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.
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.
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:
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:
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:
a. Acrobat 3.0 and later (PDF 1.2) enables 40 bit RC4 encryption (weak - not recommended)
b. Acrobat 5.0 and later (PDF 1.4) enables 128 bit RC4 encryption
c. Acrobat 6.0 and later (PDF 1.5) enables 128 bit RC4 encryption
d. Acrobat 7.0 and later (PDF 1.6) enables 128 bit AES encryption
e. Acrobat 9.0 and later (PDF 1.7) enables 256 bit AES encryption
f. Acrobat X and later (PDF 1.7 ext3) enables 256 bit AES R6 encryption
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.
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.
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
[Link]
For a full and updated list of PDFsplit code samples please visit
[Link]
Example 2vb. Split an existing PDF file into single pages (Visual Basic)
Dim NVsplit : Set NVsplit = CreateObject("[Link]")
MsgBox [Link]("c:\[Link]", "c:\")
Example 2delphi. Split an existing PDF file into single pages (Delphi)
Uses ComObj;
...
var
NVsplit: Variant;
retVal : String;
begin
NVsplit := CreateOLEObject('[Link]');
retVal := IntToStr( [Link]('c:\[Link]', 'c:\'));
[Link]( 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.