FAQ
Find answers to common questions about Aspose.PDF for C++. Each answer links to the relevant C++ guide or official resource.
Does Aspose.PDF for C++ require Adobe Acrobat?
No. Aspose.PDF for C++ is a native library for creating, reading, and processing PDF documents without Adobe Acrobat. See the C++ documentation for the available workflows.
How do I install the C++ library?
Add the native Aspose.PDF.Cpp package to your C++ project. In Visual Studio Package Manager Console, run Install-Package Aspose.PDF.Cpp. Check the official package page for available releases and package details.
Which formats can I convert to PDF?
The C++ examples cover BMP, JPEG, PNG, EMF, DICOM, TIFF, CGM, SVG, text, Markdown, LaTeX, PostScript, XPS, and XML with an XSL-FO stylesheet. Input and output support are separate capabilities. Start with Converting documents.
How do I create a PDF document?
Create a Document, add a page, add content such as a TextFragment, and call Save(). See Create PDF documents for an example.
Can I open a PDF from a stream or with a password?
Yes. The document-loading examples show file paths, streams, memory, and password-protected input. Provide the password when opening an encrypted document. See Open PDF document.
How many PDFs can I merge in one operation?
The multiple-document example accepts a list of input files and appends their pages in order. Practical limits depend on memory, file size, document complexity, and the execution environment. See Merge PDF documents for multiple files, selected ranges, alternating pages, and section bookmarks.
Can I split a PDF into ranges or separate pages?
Yes. The examples split PDFs into individual pages, balanced parts, consecutive ranges, custom page groups, or odd and even pages. See Split PDF documents and adjust the sample page selections for your input.
Will optimization always make my PDF smaller?
No. Results depend on the input and the selected options; an output file can be the same size or larger. Image compression and font changes can also affect appearance. Compare file sizes and inspect the saved result. See Optimize PDF documents.
How do I add or replace an image in a PDF?
Add an image to a page using the document APIs or drawing operators. To replace an image, update the selected page image resource. The Working with Images section includes insertion, extraction, replacement, and deletion examples.
Can I convert a multipage TIFF into one PDF page per frame?
The supplied TIFF conversion example creates one PDF page and does not iterate over frames. It should not be treated as an all-frame conversion example. See the TIFF explanation in Convert Images to PDF before adapting it for multipage input.
How do I extract text, images, tables, or form values?
Use the extraction APIs for the content type you need. The Parsing PDF documents section covers text, image resources, table data, AcroForm values, font information, and vector graphics.
Why does text extraction return no text from a scanned PDF?
A scanned page may contain only an image and no searchable text layer. The searchable-PDF example uses an external Tesseract OCR callback to generate hOCR. Tesseract and its language data must be installed separately. See Create a searchable PDF.
How do I manage fonts in generated or edited PDFs?
Make the required fonts available to the application. The formatting examples demonstrate embedding fonts, setting a default font for saving, listing fonts, and subsetting embedded fonts. See Format PDF documents.
How do I fill existing PDF form fields?
Match the field names in the input PDF and assign values to the corresponding fields. Use names and values appropriate for your form rather than copying the fixture values unchanged. See Fill PDF form fields.
Can I import and export PDF form data?
Yes. The form-data examples exchange FDF, XFDF, and XML data with an existing PDF form. The data file and destination fields must be compatible. See Import and Export Form Data.
How do I add page numbers, headers, or footers?
Use the page-numbering and header/footer APIs and configure the target pages, text, position, and margins. See Add Page Number and Add Headers and Footers.
How do I rotate or crop PDF pages?
Select the pages to modify, configure rotation or page boxes, and save the document. The Working with Pages guides cover rotation, cropping, resizing, insertion, deletion, extraction, and moving pages.
How do I read or update PDF metadata?
Use the document information and metadata APIs to inspect or update properties and XMP entries. See PDF File Metadata for the available C++ examples.
How do I encrypt a PDF and configure permissions?
Open the document with the appropriate credentials, set user and owner passwords and the desired permissions, then save the result. The examples also cover decryption. See Set privileges, encrypt, and decrypt PDF files.
How do I digitally sign a PDF?
Use a signing certificate and the signature APIs to create a signature with the required appearance and signing details. Supply your certificate path and password rather than the sample values. See Digitally sign PDF files.
Does successful completion of signature verification mean the PDF is signed?
Not necessarily. A loop over signature names can finish without checking anything when no signatures are returned. Check that signatures exist and inspect each verification result. See Verify Digital Signatures for verification and certificate-validation examples.
Does PDF/A validation convert a document to PDF/A?
No. Validation checks compliance and produces a report; it does not perform conversion. The C++ examples validate PDF/A-1a and PDF/A-1b and inspect the Boolean result. See Manipulate PDF documents.
What does removing PDF/A compliance information do?
RemovePdfaCompliance() removes the document's PDF/A compliance information before it is saved as a regular PDF. This operation does not convert it to another archival standard. See Convert PDF/A to PDF.
Can I create and validate tagged PDFs?
Yes. The accessibility examples create logical structure, set language and title metadata, add tagged content, and validate PDF/UA-1. See Create Tagged PDF and Accessibility and tagged PDFs.
Can I compare two PDFs?
Yes. The comparison examples produce marked page pairs, graphical PDF reports, and PNG difference images. Choose the comparison method and pages appropriate for your task. See Compare PDF documents.
Where can I find the C++ examples and get help?
The documentation links to the official C++ examples repository. For help, use the Aspose.PDF support forum and include a minimal example, input documents, SDK version, and environment details.