mvc open pdf file in new window : Converting pdf to editable text for software SDK cloud windows .net azure class mspa0-part1889

User Manual
3-Heights™
PDF Merge Split API
Version 4.6
Converting pdf to editable text for - application control tool:C# PDF Convert to Text SDK: Convert PDF to txt files in C#.net, ASP.NET MVC, WinForms, WPF application
C# PDF to Text (TXT) Converting Library to Convert PDF to Text
www.rasteredge.com
Converting pdf to editable text for - application control tool:VB.NET PDF Convert to Text SDK: Convert PDF to txt files in vb.net, ASP.NET MVC, WinForms, WPF application
VB.NET Guide and Sample Codes to Convert PDF to Text in .NET Project
www.rasteredge.com
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF Merge Split API, March 24, 2016 1/43
Contents
1
Introduction ........................................................................ 4
2
Installation and Deployment .......................................................... 4
2.1
Windows ........................................................................... 4
2.2
Unix ............................................................................... 4
2.2.1
All Unix Platforms ................................................................ 5
2.2.2
Mac OS X ....................................................................... 5
2.3
Interfaces ........................................................................... 5
2.3.1
Development .................................................................... 6
2.3.2
Deployment ..................................................................... 7
2.4
Interface Specific Installation Steps ...................................................... 8
2.4.1
COM Interface ................................................................... 8
2.4.2
Java Interface .................................................................... 9
2.4.3
.NET Interface .................................................................... 9
2.4.4
C Interface ..................................................................... 10
2.5
Uninstall, Install a New Version ......................................................... 10
2.6
Note about the Evaluation License ...................................................... 10
3
License Management ............................................................... 10
3.1
Graphical License Manager Tool ........................................................ 10
3.1.1
List all installed license keys ....................................................... 11
3.1.2
Add and delete license keys ....................................................... 11
3.1.3
Display the properties of a license .................................................. 11
3.1.4
Select between different license keys for a single product ............................... 11
3.2
Command Line License Manager Tool ................................................... 11
3.3
License Key Storage ................................................................. 12
3.3.1
Windows ...................................................................... 12
3.3.2
Mac OS X ...................................................................... 12
3.3.3
Unix/Linux ..................................................................... 13
4
Programming Interfaces ............................................................ 13
4.1
Visual Basic 6 ....................................................................... 13
4.2
.NET .............................................................................. 14
4.2.1
Visual Basic ..................................................................... 15
4.2.2
C# ............................................................................ 16
4.2.3
Deployment .................................................................... 16
Detailed description ......................................................... 16
Simplified description ........................................................ 16
4.2.4
Troubleshooting: TypeInitializationException ......................................... 17
Troubleshooting: DllNotFoundException ........................................ 17
Troubleshooting: BadImageFormatException ..................................... 17
5
User’s Guide ....................................................................... 18
5.1
Basics ............................................................................. 18
5.2
How to Create PDF/A Compliant Documents ............................................. 18
5.3
How to Efficiently Use the API .......................................................... 19
5.3.1
How to Copy Pages .............................................................. 19
5.3.2
Operation on Multiple Documents ................................................. 19
5.3.3
Features and their Impact on Performance ........................................... 20
application control tool:C# PDF Convert to Word SDK: Convert PDF to Word library in C#.net
Powerful components for batch converting PDF documents in C#.NET Convert PDF to multiple MS Word formats such as Create editable Word file online without email.
www.rasteredge.com
application control tool:Online Convert PDF to Text file. Best free online PDF txt
Professional PDF to text converting library from RasterEdge PDF document for Visual C# developers to convert PDF document to editable & searchable
www.rasteredge.com
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF Merge Split API, March 24, 2016 2/43
6
Programmer’s Reference ............................................................ 20
6.1
InDoc 
Interface .................................................................... 20
6.1.1
Close
........................................................................ 20
6.1.2
CropBox
...................................................................... 21
6.1.3
ErrorCode
................................................................... 21
6.1.4
ErrorMessage
................................................................ 21
6.1.5
GetXMPMetadata
............................................................. 21
6.1.6
GetXMPMetadataMem
.......................................................... 21
6.1.7
InfoEntry
................................................................... 22
6.1.8
MediaBox
..................................................................... 22
6.1.9
Open
......................................................................... 23
6.1.10
OpenMem
...................................................................... 23
6.1.11
Page
......................................................................... 24
6.1.12
PageCount
................................................................... 24
6.1.13
Rotate
....................................................................... 24
6.2
OutDoc 
Interface ................................................................... 24
6.2.1
AddAssociatedFile
.......................................................... 24
6.2.2
AddEmbeddedFile
............................................................ 25
6.2.3
AddOutlineItem
............................................................. 25
6.2.4
AddOutlineItem2
............................................................ 26
6.2.5
Author
....................................................................... 27
6.2.6
Close
........................................................................ 27
6.2.7
CopyAssociatedFiles
....................................................... 28
6.2.8
CopyAttributes
............................................................. 28
6.2.9
CopyEmbeddedFiles
.......................................................... 28
6.2.10
CopyForms
................................................................... 28
6.2.11
CopyLogicalStructure
...................................................... 28
6.2.12
CopyMetadata
................................................................ 29
6.2.13
CopyOptionalContent
....................................................... 29
6.2.14
CopyOutlines
................................................................ 29
6.2.15
CopyOutlineItems
........................................................... 29
6.2.16
CopyOutputIntent
........................................................... 30
6.2.17
CopyPages
................................................................... 30
6.2.18
CopyViewerProperties
...................................................... 30
6.2.19
Create
....................................................................... 31
6.2.20
CreateInMemory
............................................................. 32
6.2.21
ErrorCode
................................................................... 32
6.2.22
ErrorMessage
................................................................ 33
6.2.23
FlattenFormFields
.......................................................... 33
6.2.24
FlattenSigAppearance
...................................................... 33
6.2.25
GetPdf
....................................................................... 34
6.2.26
InfoEntry
................................................................... 34
6.2.27
Keywords
..................................................................... 35
6.2.28
LicenseIsValid
............................................................. 35
6.2.29
Linearize
................................................................... 35
6.2.30
MergeOptionalContent
...................................................... 36
6.2.31
OptimizeResources
.......................................................... 36
6.2.32
OutputIntent
................................................................ 36
6.2.33
PageLayout
.................................................................. 36
6.2.34
PageMode
..................................................................... 36
6.2.35
RemoveNamedDests
........................................................... 37
6.2.36
Rotate
....................................................................... 37
application control tool:VB.NET PDF Convert to Word SDK: Convert PDF to Word library in vb.
Create editable Word file online without email. Supports transfer from password protected PDF. The PDF to Word converting toolkit is a thread-safe VB.NET
www.rasteredge.com
application control tool:VB.NET Create PDF from Excel Library to convert xlsx, xls to PDF
VB.NET Tutorial for Converting PDF from Microsoft Office spreadsheet into high quality PDF without losing Create fillable and editable PDF documents from Excel
www.rasteredge.com
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF Merge Split API, March 24, 2016 3/43
6.2.37
SetLicenseKey
............................................................... 37
6.2.38
SetOpenAction
............................................................... 37
6.2.39
SetViewerPreference
....................................................... 38
6.2.40
SetXMPMetadata
............................................................. 38
6.2.41
SetXMPMetadataMem
.......................................................... 38
6.2.42
Subject
...................................................................... 39
6.2.43
Title
........................................................................ 39
6.3
Enumerations ...................................................................... 39
6.3.1
TPDFErrorCode
............................................................... 39
6.3.2
TPDFPermission
............................................................. 40
6.3.3
TPDFDestMode
................................................................ 41
6.3.4
TPDFPageLayout
............................................................. 42
6.3.5
TPDFPageMode
................................................................ 43
7
Examples ......................................................................... 43
8
Licensing and Copyright ............................................................ 43
9
Contact ........................................................................... 43
application control tool:C# Create PDF from Text to convert txt files to PDF in C#.net, ASP
Visual Studio .NET project. .NET control for batch converting text formats to editable & searchable PDF document. Free .NET library for
www.rasteredge.com
application control tool:VB.NET Image: Add Callout Annotation on Document and Image in VB.
mainly contains two parts-that are editable text area and PDF document, image to pdf files and for capturing, viewing, processing, converting, compressing and
www.rasteredge.com
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF Merge Split API, March 24, 2016 4/43
1Introduction
The purpose of the 3-Heights™ PDF Merge Split API is to read PDF files and rearrange any of the pages in an arbitrary
order. The component provides COM interfaces that can be used in any programming language that supports the 
COM technology such as C++, Visual Basic, ASP and many more.
2Installation and Deployment
2.1 Windows
The 3-Heights™ PDF Merge Split API comes as a ZIP archive containing various files including runtime binary exe­
cutable code, files required for the developer, documentation and license terms.
1. Download the ZIP archive of the product from your download account at
https://www.pdf-tools.com
.
2. Unzip the file using a tool like WinZip available from WinZip Computing, Inc. at
http://www.winzip.com
to 
a directory on your hard disk where your program files reside (e.g.
C:\Program Files\PDF Tools AG
)
3. Check the appropriate option to preserve file paths (folder names). The unzip process now creates the following 
subdirectories:
bin
Contains the runtime executable binary code.
doc
Contains documentation files.
include
Contains header files to in include in your C / C++ project.
jar
Contains java archive files for java components.
lib
Contains the object file library to include in your C / C++ project.
samples
Contains sample programs in various programming languages
There is the option to download the software as MSI file, which makes the installation easier. Only one version 
(32 or 64bit) can be installed using the MSI file. In order to install both versions the ZIP file should be used.
4. Optionally register your license key using theLicense Management
.
5. Identify which interface you are using. Perform the specific installation steps for that interface described in 
chapterInterface Specific Installation Steps
2.2 Unix
This section describes installation steps required on all Unix platforms, which includes Linux, Mac OS X, Sun Solaris,
IBM AIX, HP-UX, FreeBSD and others.
The Unix version of the 3-Heights™ PDF Merge Split API provides two interfaces:
Java interface
Native C interface
Here is an overview of the shared libraries and other files that come with the 3-Heights™ PDF Merge Split API:
application control tool:VB.NET Create PDF from PowerPoint Library to convert pptx, ppt to
multiple pages PowerPoint to fillable and editable PDF documents. Create PDF file from PowerPoint free online without NET Demo Code for Converting PowerPoint to
www.rasteredge.com
application control tool:VB.NET TIFF: TIFF Imaging SDK, Insert & Add New TIFF Page Using VB
be easily populated with editable text and images & profession imaging controls, PDF document, tiff capturing, viewing, processing, converting, compressing and
www.rasteredge.com
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF Merge Split API, March 24, 2016 5/43
File Description
Name
Description
bin/libPdfSplMrgAPI.so
This is the shared library that contains the main functionality. The file
extension varies depending on the UNIX platform.
doc/*.*
Documentation
jar/MSPA.jar
Java API archive.
include/*.h
Contains files to include in your C/C++ Project.
Example code written in different programming languages are available at product page of thePDF Tools AG web­
site
.
2.2.1 All Unix Platforms
1. Unpack the archive in an installation directory, e.g.
/opt/pdf-tools.com/
2. Copy or link the shared object into one of the standard library directories, e.g:
ln -s /opt/pdf-tools.com/bin/libPdfSplMrgAPI.so /usr/lib
3. Verify that the GNU shared libraries required by the product are available on your system:
On Linux:
ldd libPdfSplMrgAPI.so
On AIX:
dump -H libPdfSplMrgAPI.so
In case you have not installed the GNU shared libraries yet, proceed as follows:
a. Go to
http://www.pdf-tools.com
and navigate to“Support”→“Resources”.
b. Download the GNU shared libraries for your platform.
c. Extract the archive and copy or link the libraries into your library directory, e.g
/usr/lib
or
/usr/lib64
.
d. Verify that the GNU shared libraries required by the product are available on your system now.
4. Optionally register your license key using theCommand Line License Manager Tool
.
5. Identify which interface you are using. Perform the specific installation steps for that interface described in 
chapterInterface Specific Installation Steps
2.2.2 Mac OS X
The shared library must have the extension
.jnilib
for use with Java. We suggest that you create a file link for
this purpose by using the following command:
ln libPdfSplMrgAPI.dylib libPdfSplMrgAPI.jnilib
2.3 Interfaces
The 3-Heights™ PDF Merge Split API provides four different interfaces. The installation and deployment of the soft­
ware depend on the interface you are using. The table below shows the supported interfaces and examples with 
which programming languages they can be used.
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF Merge Split API, March 24, 2016 6/43
Interface
Programming Languages
.NET
The MS software platform .NET can be used with any .NET capable programming language such
as:
C#
VB .NET
J#
others
This interface is available in the Windows version only.
Java
The Java interface is available on all platforms.
COM
The component object model (COM) interface can be used with any COM-capable programming
language, such as:
MS Visual Basic
MS Office Products such as Access or Excel (VBA)
C++
VBScript
others
This interface is available in the Windows version only.
C
The native C interface is for use with C and C++. This interface is available on all platforms.
2.3.1 Development
The software developer kit (SDK) contains all files that are used for developing the software. The role of each file with 
respect to the four different interfaces is shown in tableFiles for Development
. The files are split in four categories:
Req This file is required for this interface.
Opt This file is optional. See also tableFile Description
to identify which files are required for your application.
Doc This file is for documentation only.
Empty field An empty field indicates this file is not used at all for this particular interface.
Files for Development
Name
.NET
Java
COM
C
bin\PdfSplMrgAPI.dll
Req.
Req.
Req.
Req.
bin\pdcjk.dll
Opt.
Opt.
Opt.
Opt.
bin\*NET.dll
Req.
bin\*NET.xml
Doc.
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF Merge Split API, March 24, 2016 7/43
Files for Development
doc\*.pdf
Doc.
Doc.
Doc.
Doc.
doc\PdfSplMrgAPI.idl
Doc.
doc\javadoc\*.*
Doc.
include\pdfsplmrgapi_c.h
Req.
include\*.*
Opt.
lib\PdfSplMrgAPI.lib
Req.
samples\*.*
Doc.
Doc.
Doc.
Doc.
The purpose of the most important distributed files of is described in tableFile Description
.
File Description
Name
Description
bin\PdfSplMrgAPI.dll
This is the DLL that contains the main functionality (required).
bin\pdcjk.dll
This DLL contains support for Asian languages. It is loaded from the module
path.
bin\*NET.dll
The .NET assemblies are required when using the .NET interface. The files
bin\*NET.xml
contain the corresponding XML documentation for MS
Visual Studio.
doc\*.*
Various documentations.
include\*.*
Contains files to include in your C / C++ project.
jar\MSPA.jar
The Java API archive.
lib\PdfSplMrgAPI.lib
The object file library needs to be linked to the C/C++ project.
samples\*.*
Contains sample programs in different programming languages.
2.3.2 Deployment
For the deployment of the software only a subset of the files are required. Which files are required (Req.), optional 
(Opt.) or not used (empty field) for the four different interfaces is shown in the table below.
1
These files must reside in the same directory as PdfSplMrgAPI.dll.
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF Merge Split API, March 24, 2016 8/43
Files for Deployment
Name
.NET
Java
COM
C
bin\PdfSplMrgAPI.dll
Req.
Req.
Req.
Req.
bin\pdcjk.dll
Opt.
Opt.
Opt.
Opt.
bin\*NET.dll
Req.
jar\MSPA.jar
Req.
The deployment of an application works as described below:
1. Identify the required files from your developed application (this may also include color profiles).
2. Identify all files that are required by your developed application.
3. Include all these files into an installation routine such as an MSI file or simple batch script.
4. Perform any interface-specific actions (e.g. registering when using the COM interface).
Example: This is a very simple example of how a COM application written in Visual Basic6 could be deployed.
1. The developed and compiled application consists of the file
application.exe
. Color profiles are not used.
2. The application uses the COM interface and is distributed on Windows only.
The main DLL
PdfSplMrgAPI.dll
must be distributed.
Asian text should be supported, thus
pdcjk.dll
is distributed.
3. All files are copied to the target location using a batch script. This script contains the following commands:
COPY application.exe %targetlocation%\.
COPY PdfSplMrgAPI.dll %targetlocation%\.
COPY pdcjk.dll %targetlocation%\.
4. For COM, the main DLL needs to be registered in silent mode (
/s
) on the target system. This step requires 
Power-User privileges and is added to the batch script.
REGSVR32 /s %targetlocation%\PdfSplMrgAPI.dll.
2.4 Interface Specific Installation Steps
2.4.1 COM Interface
Registration Before you can use the 3-Heights™ PDF Merge Split API component in your COM application program 
you have to register the component using the
regsvr32.exe
program that is provided with the Windows oper­
ating system. The following command shows the registration of PdfSplMrgAPI.dll. Note that in Windows Vista and 
later, the command needs to be executed from an administrator shell.
regsvr32 "C:\Program Files\PDF Tools AG\bin\PdfSplMrgAPI.dll"
© PDF Tools AG – Premium PDF Technology 
3-Heights™ PDF Merge Split API, March 24, 2016 9/43
If you are using a 64 bit operating system and would like to register the 32 bit version of the 3-Heights™ PDF Merge 
Split API, you need to use the
regsvr32
from the directory
%SystemRoot%\SysWOW64
instead of
%System-
Root%\System32
.
2
If the registration process succeeds, a corresponding dialog window is displayed. The registration can also be done 
silently (e.g. for deployment) using the switch
/s
.
Other Files The other DLLs do not need to be registered, but for simplicity it is suggested that they reside in the 
same directory as the
PdfSplMrgAPI.dll
.
2.4.2 Java Interface
For compilation and execution When using the Java interface, the Java wrapper
jar\MSPA.jar
needs to be on 
the
CLASSPATH
. This can be done by either adding it to the environment variable
CLASSPATH
, or by specifying it
using the switch
-classpath
:
javac -classpath ".;C:\pdf-tools\jar\MSPA.jar" sample.java
For execution Additionally the library
PdfSplMrgAPI.dll
needs be in one of the system’s library directories
3
or
added to the Java system property
java.library.path
. This can be achieved by either adding it dynamically at
program startup before using the API, or by specifying it using the switch
-Djava.library.path
when starting 
the Java VM.
java -classpath ".;C:\pdf-tools\jar\MSPA.jar" ^
-Djava.library.path=C:\pdf-tools\bin sample
2.4.3 .NET Interface
The 3-Heights™ PDF Merge Split API does not provide a pure .NET solution. Instead, it consists of .NET assemblies,
which are added to the project and a native DLL, which is called by the .NET assemblies. This has to be accounted 
for when installing and deploying the tool.
The .NET assemblies (
*NET.dll
) are to be added as references to the project. They are required at compilation 
time.
PdfSplMrgAPI.dll
is not a .NET assembly, but a native DLL. It is not to be added as a reference in the project.
The native DLL
PdfSplMrgAPI.dll
is called by the .NET assembly
PdfSplMrgNET.dll
.
PdfSplMrgAPI.dll
must be found at execution time by the Windows operating system. The common way to 
do this is adding
PdfSplMrgAPI.dll
as an existing item to the project and set its property“Copy to output
directory”to“Copy if newer”.
Alternatively the directory where
PdfSplMrgAPI.dll
resides can be added to the environment variable
PATH
or it can simply be copied manually to the output directory.
2
Otherwise you get the following message:
LoadLibrary("PdfSplMrgAPI.dll") failed - The specified module could not be found.
3
On Windows defined by the environment variablePathand e.g. on Linux defined byLD_LIBRARY_PATH.
Documents you may be interested
Documents you may be interested