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

Prerequisites

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

Download for macOS

Initial setup

1. Download the PDFTron SDK.
2. Extract the downloaded zip file and navigate to it.
3. Get your PDFTron trial key.

Run the samples

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

./TEST_NAME

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

Run all samples

1. Navigate to /Samples and execute

./runall.sh

The tests will run one by one.

Integrate into your application

This section will show you how to use our SDK to create a simple PDFTron "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 CPP. Navigate into the CPP directory and create a new CPP file called myApp.cpp. This guide will assume your application is named myApp.

2. Open myApp.cpp with your favorite text editor and paste this inside:

//@data {"ga":1101474063}// #include #include <PDF/PDFNet.h> #include <PDF/PDFDoc.h> #include <SDF/ObjSet.h>

using namespace pdftron;
using namespace PDF;
using namespace SDF;

int main(int argc, char** argv)
{
 try
    {
    PDFNet::Initialize();  // PDFNet must be initialized before accessing any PDFTron API. This line should only be called once in your main function.
    PDFDoc doc;
    Page page = doc.PageCreate(); // Start a new page
    doc.PagePushBack(page);       // Add the page to the document
    doc.Save("output.pdf", SDFDoc::e_linearized);  // Save the document as a linearized PDF
    std::cout << "Hello World!" << std::endl;
    }
   catch(pdftron::Common::Exception& ex)
    {
        std::cout << ex << std::endl;
    }
    return 0;
}
```

3. Build the project using this line:

//@data {"ga":6201766680}// g++ myApp.cpp -I../../../Headers -L../../../Lib -lPDFNetC -lstdc++ -lpthread -lm -lc -Wl,-rpath,../../../Lib -Wl,-rpath$ORIGIN -o myApp ```

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

//@data {"ga":1045554101}// PDFNet is running in demo mode. Permission: write Hello World! ```

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

Next step

Guides API docsSamples