Skip to footer content
PDF TOOLS

How to Create PDF Files in C++

PDF (Portable Document Format) files are widely used for sharing and preserving documents in a consistent format across different platforms. In this article, we will explore how to generate PDF files in C++ using the wkhtmltopdf library. It is an open-source command-line tool, which is used to convert HTML content into PDF files. By leveraging the power of this library, we can programmatically create PDF documents from HTML content in our C++ applications.

WkhtmltoPdf Library

wkhtmltopdf is an open-source command-line tool and rendering engine that converts HTML web pages or HTML content into PDF documents. It utilizes the WebKit rendering engine to parse and render HTML, CSS, and JavaScript, and then generates a PDF file based on the rendered content.

"wkhtmltopdf C++ Library" (also known as "wkhtmltopdf C API"). This library provides a C++ interface to the wkhtmltopdf command-line tool, allowing you to create PDF files from HTML content directly in your C++ applications. Let's dig into the step-by-step process of HTML to PDF conversion in C++ using the Wkhtmltopdf library.

Prerequisites

To create PDF files in C++, we need the following:

  1. A C++ compiler such as GCC or Clang installed on your system. You can use any IDE that supports C++ programming.
  2. wkhtmltopdf library downloaded and installed. You can download the latest version from the official wkhtmltopdf website and install it according to your operating system's instructions.
  3. Basic knowledge of C++ programming.

C++ Create PDF project in Code::Blocks

Create a project in Code::Blocks and then follow the steps below to link the library folder and file. If you are using another IDE, the options might be different, but you need to reference the downloaded library in your project to make it work.

1. Adding include folder in Search Directories

To ensure that Code::Blocks can find the necessary header files, we need to set up the search directories.

  1. Click the "Project" menu in the menu bar and select "Build options". Make sure you select "Debug".
  2. In the "Build options" dialog-box, select the "Search directories" tab.
  3. Under the "Compiler" tab, click on the "Add" button.
  4. Browse to the directory where the wkhtmltox header files are located (e.g., C:\Program Files\wkhtmltopdf\include), and select it.
  5. Finally, click "OK" to close the dialog-box.

How to Create PDF Files in C++: Figure 1

2. Linking the Libraries in Linker Settings

To link against the wkhtmltox library, follow these steps:

  1. Again, click the "Project" menu in the menu bar and select "Build options". Make sure you select "Debug".
  2. In the "Build options" dialog-box, select the "Linker settings" tab.
  3. Under the "Link libraries" tab, click the "Add" button.
  4. Browse to the directory where the wkhtmltox library files are located (e.g., C:\Program Files\wkhtmltopdf\lib), and select the appropriate library file.
  5. Click "Open" to add the library to your project.
  6. Finally, click "OK" to close the dialog-box.

How to Create PDF Files in C++: Figure 2

Steps to Create a PDF in C++ using Wkhtmltopdf

1. Include Necessary Libraries

To get started, first, we will include the necessary header files to utilize the functionalities of the wkhtmltopdf library in our C++ program. Include the following header files at the beginning of your main.cpp source code file:

#include <iostream>
#include <fstream>
#include <string>
#include <wkhtmltox/pdf.h> // Include wkhtmltopdf library headers
#include <iostream>
#include <fstream>
#include <string>
#include <wkhtmltox/pdf.h> // Include wkhtmltopdf library headers
C++

2. Disable the GUI Component

If you are not working with a GUI, then you need to disable it to avoid errors. The code goes as follows:

wkhtmltopdf_init(false); // Initialize the wkhtmltopdf library in non-GUI mode
wkhtmltopdf_init(false); // Initialize the wkhtmltopdf library in non-GUI mode
C++

3. Initialize Settings and Converter

Next, we need to initialize global and object settings pointers, and then the wkhtmltopdf converter.

wkhtmltopdf_global_settings* gs = wkhtmltopdf_create_global_settings();
wkhtmltopdf_object_settings* os = wkhtmltopdf_create_object_settings();
wkhtmltopdf_converter* converter = wkhtmltopdf_create_converter(gs);
wkhtmltopdf_global_settings* gs = wkhtmltopdf_create_global_settings();
wkhtmltopdf_object_settings* os = wkhtmltopdf_create_object_settings();
wkhtmltopdf_converter* converter = wkhtmltopdf_create_converter(gs);
C++

4. Adding PDF Content

Now, let's create an HTML string to fill some content into our newly created PDF document. The code goes as follows:

std::string htmlString = "<html><body><h1>Create a PDF in C++ using WKHTMLTOPDF Library</h1></body></html>";
wkhtmltopdf_add_object(converter, os, htmlString.c_str());
std::string htmlString = "<html><body><h1>Create a PDF in C++ using WKHTMLTOPDF Library</h1></body></html>";
wkhtmltopdf_add_object(converter, os, htmlString.c_str());
C++

5. Convert HTML String to PDF File

Wkhtmltopdf provides a converter method to convert HTML content to PDF. Here's the code snippet:

wkhtmltopdf_convert(converter); // Converts HTML content to PDF
wkhtmltopdf_convert(converter); // Converts HTML content to PDF
C++

6. Getting output as Memory Buffer

With the wkhtmltopdf_get_output function, we can get the PDF data as a memory buffer stream. It also returns the length of the PDF. The following example will perform this task:

const unsigned char* pdfData;
int pdfLength = wkhtmltopdf_get_output(converter, &pdfData); // Get PDF data and length
const unsigned char* pdfData;
int pdfLength = wkhtmltopdf_get_output(converter, &pdfData); // Get PDF data and length
C++

7. Save PDF File

The pdfData pointer will now have the stream of characters from the wkhtmltopdf_converter. To save to a PDF file, first, we will specify the file path where we want to save the PDF. Then, using the output file stream, we open the file in binary mode and write the pdfData to it by type casting it using the reinterpret_cast function. Finally, we close the file.

const char* outputPath = "file.pdf";
std::ofstream outputFile(outputPath, std::ios::binary); // Open file in binary mode
outputFile.write(reinterpret_cast<const char*>(pdfData), pdfLength); // Write PDF data
outputFile.close(); // Close the file
const char* outputPath = "file.pdf";
std::ofstream outputFile(outputPath, std::ios::binary); // Open file in binary mode
outputFile.write(reinterpret_cast<const char*>(pdfData), pdfLength); // Write PDF data
outputFile.close(); // Close the file
C++

8. Freeing up Memory

After successfully creating a PDF file, it's essential to clean up the resources allocated by Wkhtmltopdf, otherwise, it will result in a memory leak.

wkhtmltopdf_destroy_converter(converter); // Destroy the converter
wkhtmltopdf_destroy_object_settings(os);  // Destroy object settings
wkhtmltopdf_destroy_global_settings(gs);  // Destroy global settings
wkhtmltopdf_deinit();                     // Deinitialize the library

std::cout << "PDF created successfully." << std::endl; // Inform the user
wkhtmltopdf_destroy_converter(converter); // Destroy the converter
wkhtmltopdf_destroy_object_settings(os);  // Destroy object settings
wkhtmltopdf_destroy_global_settings(gs);  // Destroy global settings
wkhtmltopdf_deinit();                     // Deinitialize the library

std::cout << "PDF created successfully." << std::endl; // Inform the user
C++

9. Execute the Code and Generate PDF File

Now, build the project and execute the code using F9. The output is generated and saved in the project folder. The resulting PDF is as follows:

How to Create PDF Files in C++: Figure 3

Create PDF File in C#

IronPDF

IronPDF is a .NET C# PDF library that allows developers to create PDF documents from HTML effortlessly. It provides an intuitive API that simplifies the process of creating PDF files from HTML.

IronPDF is robust and versatile when it comes to working with PDFs. It not only creates a PDF from simple HTML documents but also complex web pages with CSS styling, JavaScript interactions, and even dynamic content. Moreover, you can develop different PDF converters with quick access to its conversion methods.

Here's an example code to create PDF with IronPDF using HTML string to PDF conversion:

using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from an HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()

' Create a PDF from an HTML string using C#
Private pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")

' Export to a file or Stream
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

We create an instance of ChromePdfRenderer to render the HTML content as a PDF. We call the RenderHtmlAsPdf method on the renderer object and pass in the HTML string. This generates the PDF document, and then we save the PDF document using the SaveAs method.

How to Create PDF Files in C++: Figure 4

For more details on how to create a PDF from various resources with IronPDF, please visit this IronPDF code examples page.

Conclusion

In this article, we explored PDF generation in C++ using the wkhtmltopdf C++ Library and also learned how to use IronPDF to generate PDF documents in C#.

With IronPDF, generating PDF files from HTML content becomes a straightforward task in .NET Framework languages. Its extensive feature set makes it a valuable tool for developers needing to convert HTML to PDF in their C# projects. Whether it's generating reports, invoices, or any other document that requires precise HTML-to-PDF conversion, IronPDF is a reliable and efficient solution.

IronPDF is free for development purposes but for commercial use, it needs to be licensed. It also provides a free trial for commercial use to test out its complete functionality. Download IronPDF and try it out for yourself.

Chipego
Software Engineer
Chipego has a natural skill for listening that helps him to comprehend customer issues, and offer intelligent solutions. He joined the Iron Software team in 2023, after studying a Bachelor of Science in Information Technology. IronPDF and IronOCR are the two products Chipego has been focusing on, but his knowledge of all products is growing daily, as he finds new ways to support customers. He enjoys how collaborative life is at Iron Software, with team members from across the company bringing their varied experience to contribute to effective, innovative solutions. When Chipego is away from his desk, he can often be found enjoying a good book or playing football.