Get Started with the Apryse Server SDK C++ PDF Library Integration

This section helps you get started with one of our samples to see the output you can create when you integrate the Apryse Server SDK into your application. It also includes instructions on how to create a C++ project, then integrate Server SDK into the project. In the end, you’ll create and open a blank PDF within your project.

Before you start:

• Install Visual Studio 2022  (during installation, select the “Desktop Development for C++ workload” to ensure Windows SDK is included) to write, build, test, and deploy your application.
• Download Apryse’s C++ PDF Library for Windows zip file: Apryse Server SDK 64-bit.
• Get your Apryse trial key.

In this section, you will download and run the OfficeToPDFTest PDFNet sample module, which demonstrates the SDK's document-conversion capabilities. Upon successful completion, you will have converted a DOCX document to a PDF file while leveraging the MS Office-to-PDF conversion API. You can use this module as a reference implementation when integrating similar document-conversion functionality into your own applications. By running the sample, you can quickly:

• Verify the capabilities.
• Understand how to interact with the MS Office to Conversion PDF API.
• Use it as a reference for integrating similar functionality into your own application.

1. Download the PDFNetC64.zip file.
2. Extract the PDFNetC64.zip file to the following location: C:\Users\YourName\PDFNetC64\PDFNetC64\Samples. Replace YourName with your user name.

3. Before running the sample, you need to add your license key to the LicenseKey.h file. Open Visual Studio, select File > Open > File... and navigate to: C:\Users\Your Name\PDFNetC64\PDFNetC64\Samples\LicenseKey\CPP (CPP or CPPS folder, depending on your distribution).

4. Select the LicenseKey.h file and click Open.

5. In the LicenseKey.h file, scroll down to the line containing //#define LicenseKey “YOUR_PDFTRON_LICENSE_KEY”. Uncomment this line (remove the // ) and replace the words in quotes with the copy of your trial license key you generated when you completed the Prerequisites instructions above. Do not change any other information in this file.

6. Save your changes and close the LicenseKey.h file.

7. In Visual Studio, select File > Open > Project/Solution and navigate to: C:\Users\Your Name\PDFNetC64\PDFNetC64\Samples\OfficeToPDFTest\CPP (CPP or CPPS folder, depending on your distribution).

8. Select the OfficeToPDFTestVC2019.vcxproj file and click Open. If a Retarget Projects dialog displays, click OK.

9. From the Main menu, select Build > Build Solution. After building, the output pane shows Build Completed.

10. From the Main menu, select Debug > Start Without Debugging.

11. The sample code loads an Office document, converts the Office document to PDF, saves the resulting PDF, and outputs status messages to the console. For more details, you can look at additional OfficeToPDF sample code and the Convert MS Office (Word, Excel, PowerPoint) to PDF overview.

Once the sample has finished running, a command line window opens showing the demo mode is Done. Press any key to close the command line window.

12. Go to your File Explorer and navigate to:  C:\Users\YourName\PDFNetC64\PDFNetC64\Samples\TestFiles\Output. You will see three output PDF files (Fishermen.pdf, the_rime_of_the_ancient_mariner.pdf, and the factsheet_Arabic.pdf).

13. Open the PDF files to see the converted output. You have successfully run the OfficeToPDFTest conversion sample!

14. Close the output PDF files.

This section provides steps to create a simple C++ project that uses the Apryse SDK and the PDFNet library to programmatically generate a blank PDF document. With these steps, you can learn how to set up your environment, import the required libraries, and run a script that produces a valid PDF file—all without manual intervention. This example provides a practical foundation for more advanced document‑generation workflows.

1. Open Visual Studio.
2. Select Create a new project and select C++Console App, then click Next.
3. In the Project name field, enter a name for your project. For this guide, we’ll name it ApryseGetStarted.
4. Under Location, enter the file location for your new project. For this guide, we’ll use C:\Users\YourName\source\repos.
5. Click Create and your new project opens.

Before running the application, configure the following dependencies:

1. In the Visual Studio > Solution Explorer pane, right-click on the ApryseGetStarted project.
2. Select Properties and the Property Pages dialog opens.
3. At the top of the Property Pages dialog, under Configuration, select Debug and under Platform, select x64.
4. In the Configuration Properties pane, select Debugging. In the Working Directory field, enter: $(OutDir).
5. In the Configuration Properties pane, select C/C++ > General. In the Additional Include Directories field, enter: C:\Users\YourName\PDFNetC64\PDFNetC64\Headers and then click Apply.
6. In the Configuration Properties pane, select Linker > General. In the Additional Directories field, enter:  C:\Users\YourName\PDFNetC64\PDFNetC64\Lib and then click Apply.
7. In the Configuration Properties pane, select Linker > Input. In the Additional Dependencies field, enter: PDFNetC.lib, click Apply and then click OK.

This section helps you build a simple PDF-generation application.

1. In File Explorer, navigate to: C:\Users\YourName\PDFNetC64\PDFNetC64\Lib and copy the PDFNetC.dll file.
2. In File Explorer, navigate to your new project directory: C:\Users\YourName\source\repos\ApryseGetStarted\x64\Debug and paste the PDFNetC.dll file in this folder.
3. In Visual Studio, open ApryseGetStarted.cpp. Copy the following code and replace the default contents in the ApryseGetStarted.cpp file:

1#include <iostream>
2
3// Important for PDF related manipulations
4#include <PDF/PDFNet.h>
5#include <PDF/PDFDoc.h>
6
7// Important for document filesystem interaction and more
8#include <SDF/ObjSet.h>
9
10using namespace pdftron;
11using namespace PDF;
12using namespace SDF;
13
14
15int main()
16{
17    
18    try
19    {
20        // This is required before any Apryse related
21        // classes and methods can be properly used
22        PDFNet::Initialize("YOUR_PDFTRON_LICENSE_KEY");
23
24        PDFDoc doc;
25
26        // Create a new page and push it into
27        // the page sequence of the document.
28        Page page = doc.PageCreate();
29        doc.PagePushBack(page);
30
31        // Save the document as a linearized PDF which is the most
32        // popular and effective fast viewing format
33        doc.Save("linearized_output.pdf", SDFDoc::e_linearized);
34    }
35    catch (pdftron::Common::Exception& ex)
36    {
37        std::cout << ex.GetMessage() << std::endl;
38    }
39    return 0;
40
41    
42}
43

4. From the Main toolbar in Visual Studio, click on Build > Build Solution to compile the program. In the Output pane you will see Build: 1 succeeded.

5. Under the Main toolbar in Visual Studio, click on Debug > Start Without Debugging. The program runs and a command line window displays PDFNet is running in demo mode.

6. Press any key to close the command line window.

The sample code you just ran performs the following actions:

• Includes the required Apryse (PDFNet) header files.
• Initializes the PDFNet engine using the provided license key.
• Creates a new PDF document in memory.
• Adds a blank page to the document.
• Saves the document as a linearized PDF file.
• Terminates the PDFNet engine.
• Writes any runtime errors to the console.

7. In File Explorer, navigate to the project’s output directory where the PDF file has been saved (this is the location you specified in section 2. Create a new PDFNet C++ project, step 4 above: C:\Users\YourName\source\repos\ApryseGetStarted\x64\Debug).

8. Open the linearized_output.pdf which you created by integrating the Apryse Server SDK!

Now that you have successfully run the OfficeToPDFTest sample (in section 1) and integrated the Apryse Server SDK C++ PDF Library into your application, you can try out 50+ samples depending on your needs.

9. To try additional samples, go to section 1. Run a PDFNet sample project > step 2 above and choose another sample to run.

Older versions of Visual Studio
Find out more about the Visual Studio versions we support.

Trouble setting dependencies
Set dependencies for the Apryse SDK in a startup project with Visual Studio.

This guide will help you run Apryse samples and integrate a free trial of the Apryse SDK into C++ applications on macOS. Your free trial includes unlimited trial usage and support from solution engineers.

• GCC ≥ 4.2.1
• Apryse's C++ PDF library for macOS:

Download the SDK

1. Download the Apryse SDK. (above)
2. Extract the downloaded zip file and navigate to it.
3. Get your Apryse trial key.

Run a specific sample

1. Navigate to the CPP folder in the sample you want to run and make the project by calling make. Then run the test by executing

1./TEST_NAME

For example to run AddImageTest, navigate to /Samples/AddImageTest/CPP and execute ./AddImageTest.

Run all samples

1. Navigate to /Samples and execute

1./runall.sh

The tests will run one by one.

This section will show you how to use our SDK to create a simple Apryse "Hello World!" application. It will create a document with one blank page and save it as a linearized PDF in its running directory.

1. Navigate to the /Samples directory and create a new directory called myApp if it does not exist already. This guide will assume your project is named myApp. Enter your myApp directory and create a CPP directory for organization. Then create a myApp.cpp file in the CPP directory.
2. Open myApp.cpp with your favorite text editor and paste this inside:

1#include <iostream>
2#include <PDF/PDFNet.h>
3#include <PDF/PDFDoc.h>
4#include <SDF/ObjSet.h> 
5
6using namespace pdftron;
7using namespace PDF;
8using namespace SDF;
9
10int main(int argc, char** argv)
11{
12 try
13    {
14    PDFNet::Initialize("YOUR_LICENSE_KEY");  // PDFNet must be initialized before accessing any Apryse API. This line should only be called once in your main function.
15    PDFDoc doc;
16    Page page = doc.PageCreate(); // Start a new page
17    doc.PagePushBack(page);       // Add the page to the document
18    doc.Save("output.pdf", SDFDoc::e_linearized);  // Save the document as a linearized PDF
19    std::cout << "Hello World!" << std::endl;
20    }
21   catch(pdftron::Common::Exception& ex)
22    {
23        std::cout << ex << std::endl;
24    }
25    return 0;
26}

1. Build the project using this line:

1g++ myApp.cpp -I../../../Headers -L../../../Lib -lPDFNetC -lstdc++ -lpthread -lm -lc -Wl,-rpath,../../../Lib -Wl,-rpath$ORIGIN -o myApp

1. Run the application via ./myApp. The output should read:

1PDFNet is running in demo mode.
2Permission: write
3Hello World!

Check the output.pdf that the program output in the same directory. It should be a PDF with one blank page.