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. Scroll down to the line containing PDFNet::Initialize(“YOUR_PDFTRON_LICENSE_KEY”); and replace the words in quotes with the copy of your trial license key. Save your changes and close the ApryseGetStarted.cpp file.

5. 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.

6. 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.

7. 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.

8. 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).

9. 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.

10. 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 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 Code to write, build, test, and deploy your application.
• Install GCC (GNU Compiler Collection) to build and compile C++ into executable programs.
• Download Apryse’s C++ PDF Library for macOS 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 PDFNetCMac.zip file.
2. Double-click the PDFNetCMac.zip file to unzip it.
3. In your Documents folder, create a new ApryseSamples folder for the sample files.

4. Move the unzipped PDFNetCMac folder to the new ApryseSamples folder.

5. In your terminal, go to the Documents/ApryseSamples directory and remove the quarantine attribute from all files so the sample can run:

1cd Documents/ApryseSamples
2sudo xattr -dr com.apple.quarantine .

6. Open the Documents/ApryseSamples/PDFNetCMac/Samples/LicenseKey/CPP/LicenseKey.h file in Visual Studio Code. (Note that the folder may be named CPP or CPPS, depending on your distribution.)

7. Scroll down to the line containing //#define LicenseKey “YOUR_PDF_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.

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

9. To run the sample, navigate to: /Documents/ApryseSamples/PDFNetCMac/Samples/OfficeToPDFTest/CPP, right-click on the CPP folder, then select New Terminal at Folder (CPP or CPPS folder, depending on your distribution).

10. The terminal opens the OfficeToPDFTest sample. From the project directory, in the terminal, enter the following, then press Enter:

1Make

Then enter the following and press Enter:

1./OfficeToPDFTest

11. When you run the ./OfficeToPDFTest command, 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, you’ll see the status Done in the terminal.

12. In the terminal, type exit, then press Enter.

13. Navigate to: /Documents/ApryseSamples/PDFNetCMac/Samples/TestFiles/Output. You will see three output PDF files (Fishermen.pdf, the_rime_of_the_ancient_mariner.pdf, and the factsheet_Arabic.pdf).

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

15. Close the output PDF files.

This section provides steps to create a simple C++ project that you can, later, integrate with the Server SDK.

1. Open Visual Studio Code and select File > Open Folder...
2. Navigate to: /Documents/ApryseSamples/PDFNetCMac/Samples.
3. Create a new folder named myApp.
4. Inside myApp, create a folder named CPP (or CPPS depending on your distribution).
5. Open the CPP folder.
6. Create a new file named myApp.cpp.

This section integrates the Apryse Server SDK and the PDFNet library to programmatically generate a blank PDF document. With these steps, you can learn how to set up your environment and import the required libraries.

1. In Visual Studio Code, copy the following code and paste it into the myApp.cpp file:

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_PDFTRON_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}

2. Scroll down to the line containing PDFNet::Initialize(“YOUR_PDFTRON_LICENSE_KEY”); and replace the words in quotes with the copy of your trial license key. Save your changes and close the myApp.cpp file.

You’ll run the project to get a blank PDF as your output.

1. Navigate to: /Documents/ApryseSamples/PDFNetCMac/Samples/myApp/CPP, right-click on the CPP folder and select NewTerminal at Folder.
2. To build the project, enter the following and press Enter:

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

To run the application, enter the following and press Enter:

1./myApp

You will see a message in the terminal: 

1PDFNet is running in demo mode. 
2
3PackageV2: base  
4
5Hello World!

The sample code you just ran performs the following actions:

• Includes the required Apryse (PDFNet) header files.
• Initializes the PDFNet SDK 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 SDK.
• Outputs any runtime errors to the console.

3. Navigate to: /Documents/ApryseSamples/PDFNetCMac/Samples/myApp/CPP.

4. Open the 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.

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