Aspose.PDF.Cpp 24.12.0

Efficient PDF Document Handling C++ API

Aspose.PDF for C++ is a versatile library for creating, manipulating, and converting PDF documents without the need for Adobe Acrobat. It offers developers comprehensive tools to compress PDFs, split and merge documents, insert or remove pages, and manage annotations. Aspose.PDF also supports adding text, images, tables, and forms to PDFs, as well as handling metadata, encrypting files, and applying digital signatures. With its support for low-level PDF operators, it enables precise control over document content, including image placements and custom graphical shapes. Ideal for developers looking to automate complex PDF workflows in their applications.

Working with Documents

Compress PDF documents

Reduce file size by compressing images, removing unused objects, and optimizing resources.

Split PDF documents

Divide a PDF into smaller documents.

Merge PDF documents

Combine multiple PDFs into one document.

Insert pages

Add pages from another document or new pages to an existing PDF.

Linearization

Optimize PDF for fast web view.

Validation

Ensure PDF compliance with standards like PDF/A.

Working with PDF Pages

Add pages

Add new pages to an existing PDF document.

Move or remove pages

Rearrange or delete specific pages within a PDF.

Crop pages

Adjust the visible area of a PDF page by cropping it.

Add watermarks

Insert watermarks to pages using text or images.

Add stamps

Apply stamps to pages for validation or marking.

Working with PDF Text

Add text

Insert new text into a PDF document.

Format text

Change font type, size, color, and alignment of text in the PDF.

Search and replace text

Locate specific text and replace it programmatically.

Extract text

Programmatically extract text from PDF documents.

Replace text using regular expressions

Perform advanced text replacements using regex patterns.

Working with PDF Images

Insert images

Add images to a PDF document at a specified location.

Remove images

Programmatically delete images from a PDF.

Extract images

Extract embedded images from a PDF document.

Replace images

Swap existing images with new ones in a PDF.

Working with PDF Tables

Insert tables

Create and add tables to a PDF document.

Decorate tables

Apply styles, borders, and colors to enhance table presentation.

Extract tabular data

Programmatically extract table data from a PDF document.

Create or Add Table in PDF

Add new tables to existing PDFs with control over columns, rows, borders, and margins.

Extract Table from PDF

Extract tabular data from PDF files or convert table borders into an image.

Manipulate Table Content

Modify cell content in tables within a PDF using TableAbsorber.

Remove Tables from PDF

Remove entire tables from a PDF document using the Remove method.

Insert Page Break in Table Rows

Add a page break between rows of a table to manage large datasets across multiple pages.

Working with PDF Forms

Add form fields

Insert various types of interactive form fields (e.g., text boxes, radio buttons).

Fill form fields

Programmatically populate form fields in a PDF.

Extract form data

Retrieve data entered into form fields.

Support for XFA and AcroForms

Work with both XML-based and standard forms.

Working with PDF Graphs

Add shapes

Insert graphical shapes like lines, circles, and rectangles.

Manipulate shapes

Modify shape properties such as color, size, and positioning.

Arc

Add an arc object to PDF files with support for filling colors.

Circle

Display data using a circle graph, or pie chart, with support for filled circles.

Curve

Add Bézier curves to model smooth curves in PDFs, with intuitive manipulation of control points.

Line

Add line graphs to display continuous data and track trends over time.

Rectangle

Use rectangle shapes in graphs to solve layout or graphical problems.

Ellipse

Add an ellipse, which creates an oval shape, to PDFs for specific graphical needs .

Working with PDF Annotations

Add annotations

Insert annotations like text, highlights, and multimedia.

Delete annotations

Remove unwanted annotations from a PDF document.

Modify annotations

Change properties of existing annotations.

Metadata in PDFs

Get and set metadata

Access and modify document metadata such as author, title, and keywords.

Work with XMP data

Programmatically manage embedded XMP metadata.

Get/Set PDF Metadata

Retrieve and modify PDF metadata, such as XMP data.

Insert Metadata with Prefix

Add metadata with a specific namespace URI, for better organization and tracking of document information.

Set Custom Metadata

Add custom properties to PDF documents for personalized metadata.

Securing and Signing PDF

Encrypt PDF documents

Apply password protection and encryption to secure a PDF.

Sign PDF documents

Digitally sign PDFs to verify their authenticity.

Decrypt PDF documents

Remove encryption from password-protected PDFs.

Working with Artifacts

Set Watermark

Add watermarks to a PDF file using the WatermarkArtifact class, allowing you to customize the text, font size, color, rotation, and opacity of the watermark.

Set Background

Add a background image to the page using the BackgroundArtifact class, inserting an image from the file system as the background.

Get Watermark

Retrieve watermarks from a PDF file, displaying the subtype, text, and location of each watermark.

Count Artifacts

Count the number of artifacts of a particular subtype, such as watermarks, on a specific page.

Manage watermarks

Insert, replace, or remove watermarks from a PDF.

Handle special objects

Work with other non-standard objects in a PDF.

Working with Operators

Add operators

Work with low-level PDF operators for drawing, such as text and graphics operators.

GSave

Saves the current graphical state of the PDF page, allowing subsequent operations to modify the graphics while keeping a backup of the original state.

ConcatenateMatrix

Defines how to place an image or graphical object on a PDF page by specifying the transformation matrix.

Do

Draws the image or form on the page at the specified location using the previously defined operators.

GRestore

Restores the previously saved graphical state, undoing any modifications made after the GSave operator.

Remove Graphics Objects

Removes graphics from a PDF page using operators like Stroke, ClosePathStroke, and Fill, providing a low-level approach for manipulating the contents of a PDF.

Draw XForm on Page

Positions and draws an XForm (external form) on a PDF page using GSave, ConcatenateMatrix, Do, and GRestore operators.

System Requirements for Aspose.PDF for C++

Supported File Formats C++

Installing Aspose.PDF for C++ via NuGet

1. Package Manager Console

• Open Visual Studio and go to Tools > NuGet Package Manager > Package Manager Console.
• To install the latest release, run:

    Install-Package Aspose.PDF.Cpp

2. Update Aspose.PDF

• To update to the latest version, use:

Update-Package Aspose.PDF.Cpp

3. Package Manager GUI

• Open your project and go to Project > Manage NuGet Packages.
• Search for "Aspose.PDF" under the Browse tab and click Install or Update.

Extract Highlighted Text from PDF Document

This code snippet demonstrates how to extract only the highlighted text from a PDF document using Aspose.PDF for C++. By filtering text markup annotations, you can retrieve the specific text highlighted within a document.

void ExtractHighlightedText() {

    // Start logging
    std::clog << __func__ << ": Start" << std::endl;

    // Define the file paths
    String _dataDir("C:\\Samples\\Parsing\\");
    String infilename("sample-highlight.pdf");
    String outfilename("extracted-text.txt");

    // Open the PDF document
    auto document = MakeObject<Document>(_dataDir + infilename);

    // Loop through all annotations on the first page
    for (auto annotation : document->get_Pages()->idx_get(1)->get_Annotations())
    {
        // Check if the annotation is a highlight annotation
        if (annotation->get_AnnotationType() == Aspose::Pdf::Annotations::AnnotationType::Highlight)
        {
            // Cast annotation to HighlightAnnotation
            auto highlightedAnnotation = System::DynamicCast<Aspose::Pdf::Annotations::HighlightAnnotation>(annotation);

            // Retrieve the highlighted text fragments
            auto collection = highlightedAnnotation->GetMarkedTextFragments();
            
            // Loop through the text fragments and print the highlighted text
            for (auto tf : collection)
            {
                String s = tf->get_Text();
                std::cout << s << std::endl; // Display highlighted text
            }
        }
    }

    // Finish logging
    std::clog << __func__ << ": Finish" << std::endl;
}

Add Image to Existing PDF File

This example demonstrates how to add an image to an existing PDF file using operators in Aspose.PDF for C++. The operators manage the placement and drawing of the image on the PDF page.

void ExampleUsingOperators()
{
    // Define file paths
    String _dataDir("C:\\Samples\\");

    // Open the input PDF document
    auto document = MakeObject<Document>(_dataDir + u"PDFOperators.pdf");

    // Set coordinates for the image placement
    int lowerLeftX = 100;
    int lowerLeftY = 100;
    int upperRightX = 200;
    int upperRightY = 200;

    // Get the page where the image needs to be added
    auto page = document->get_Pages()->idx_get(1);

    // Load the image into a stream
    auto imageStream = System::IO::File::OpenRead(_dataDir + u"PDFOperators.jpg");

    // Add the image to the Resources collection of the page
    page->get_Resources()->get_Images()->Add(imageStream);

    // Save the current graphical state using GSave operator
    page->get_Contents()->Add(MakeObject<Aspose::Pdf::Operators::GSave>());

    // Create a Rectangle and Matrix object for the image placement
    auto rectangle = MakeObject<Rectangle>(lowerLeftX, lowerLeftY, upperRightX, upperRightY);
    auto matrix = MakeObject<Matrix>(
        new double[] {
            rectangle->get_URX() - rectangle->get_LLX(), 0, 0,
            rectangle->get_URY() - rectangle->get_LLY(),
            rectangle->get_LLX(),  rectangle->get_LLY() });

    // Use ConcatenateMatrix to define where the image should be placed
    page->get_Contents()->Add(MakeObject<Aspose::Pdf::Operators::ConcatenateMatrix>(matrix));

    // Use the Do operator to draw the image on the page
    auto ximage = page->get_Resources()->get_Images()->idx_get(page->get_Resources()->get_Images()->get_Count());
    page->get_Contents()->Add(MakeObject<Aspose::Pdf::Operators::Do>(ximage->get_Name()));

    // Restore the graphical state using GRestore operator
    page->get_Contents()->Add(MakeObject<Aspose::Pdf::Operators::GRestore>());

    // Save the updated document
    document->Save(_dataDir + u"PDFOperators_out.pdf");
}

Convert a PDF from RGB Colorspace to Grayscale

This code snippet shows how to convert a PDF document from RGB colorspace to grayscale using Aspose.PDF for C++. This can be useful for reducing the file size or preparing the PDF for printing.

void ConvertPDFfromColorspaceToGrayscale() {
    // Define file paths
    String _dataDir("C:\\Samples\\");
    String infilename("OptimizeDocument.pdf");
    String outfilename("Test-gray_out.pdf");

    // Open the PDF document
    auto document = MakeObject<Document>(_dataDir + infilename);

    // Create a grayscale conversion strategy
    auto strategy = MakeObject<Aspose::Pdf::RgbToDeviceGrayConversionStrategy>();

    // Iterate through all pages and apply the grayscale conversion strategy
    for (int idxPage = 1; idxPage <= document->get_Pages()->get_Count(); idxPage++)
    {
        auto page = document->get_Pages()->idx_get(idxPage); // Get the page
        strategy->Convert(page); // Convert the page to grayscale
    }

    // Save the resultant grayscale PDF file
    document->Save(_dataDir + outfilename);
}

Tags

PDF Creation | PDF Manipulation | PDF Compression | Merge PDF | Split PDF | PDF Forms | PDF Pages | Text Extraction | Image Manipulation | Table Handling | Digital Signatures | PDF Metadata | Watermark PDF | XMP Metadata | Annotations | PDF Operators | AcroForms | XFA Forms | Image Extraction | Text Search | Text Replacement | C++ PDF Library | NuGet PDF | Grayscale PDF | PDF Encryption | PDF Decryption | PDF Annotations | PDF Watermarks | Insert Pages | PDF File Format | PDF to Image | Image to PDF | Multi-page TIFF | Portable Document Format