Loaded Document Toolkit

HotPDF can open an existing PDF, apply page and form operations, inspect typed document state, render or search pages, print with device capabilities, and save the result without moving the workflow to another library

Page operations and merging

• THotPDF.DeletePages accepts the standard one-based page-range syntax, removes duplicate selections once, and preserves a valid page tree
• Deleting loaded pages detaches widget annotations and empty AcroForm field branches that belonged only to the deleted pages
• THotPDF.InsertPagesFromDocument and THotPDF.AppendPagesFromDocument accept THPDFMergeOptions
• Form-name conflicts are checked before page insertion when automatic renaming is disabled, so a rejected merge leaves the destination page count unchanged
• THPDFMergeOption values are moIncludeOutlines, moIncludeFormFields, and moRenameConflictingFormFields
• Outline destinations are remapped through the selected source-to-destination page map, while imported form roots are registered in the destination AcroForm
• THotPDF.InsertLoadedBlankPage inserts a caller-sized blank page at an exact zero-based position
• THPDFWatermarkTemplate.MakeCurve adds a cubic Bezier curve to ordered composite loaded-page watermarks
• THPDFPage.AddCurveWatermark provides the same cubic Bezier primitive during new-document authoring
• Loaded document metadata setters mark the Info dictionary dirty so incremental saves retain edited fields
• ExtractLoadedPagesTextToStream writes UTF-8 page text directly to a caller-owned stream with range, separator, and BOM controls
• THPDFViewerModel exposes page form-field hit testing and deterministic top-to-bottom keyboard navigation without creating a window
• THPDFSignatureInfo.CertificateTimeValidity classifies certificate bounds and signed-time consistency without changing cryptographic svValid semantics
• SetDocumentAttachmentMetadata renames an embedded file and updates its description before the document is saved
• THPDFLoadedFormField exposes flags, MaxLen, page index, bounds, and common text-field behaviours for property inspectors
• THPDFViewerModel creates caller-owned page snapshots and writes the current page directly as BMP while reusing the loaded render cache
• THPDFViewerModel rotates the current view and generated snapshots in 90-degree steps without modifying the loaded PDF page
• THPDFViewer.ResetView restores presentation defaults without unloading the document or changing the current page

Forms and search

• THotPDF.AddLoadedRadioButton creates a parent radio field with child widgets, shared export values, and valid on/off appearance states
• GetLoadedFormFieldNameValuePairs and SetLoadedFormFieldNameValuePairs exchange lightweight name=value batches through TStrings
• ExtractLoadedPagesText aggregates a one-based page range with a caller-selected separator
• CMapResourcePath overrides automatic CMap discovery with a caller-selected root containing the standard collection folders
• THotPDF.SearchLoadedNext is a stateless page-local search primitive that moves forward from a previous THPDFTextMatch
• THPDFLoadedDocumentFacade groups loaded forms, annotations, outlines, fonts, and images into typed collection objects
• THPDFLoadedFormInfo includes the current and default value, field type, description, read-only flag, and choice options

Outlines and resources

• THotPDF.GetLoadedOutlineEntries returns a complete preorder snapshot as THPDFLoadedOutlineEntryArray
• Each THPDFLoadedOutlineEntry has an index, parent index, level, title, and resolved destination page index
• THPDFLoadedOutlineInfo exposes the same hierarchy through THPDFLoadedOutlineCollection
• THPDFLoadedResourceCollection enumerates fonts and loaded images and can extract supported images as caller-owned bitmaps

System certificate signing

• THotPDF.SignPDFWithSystemCertificate signs file or stream input through a Windows certificate-store private key
• THPDFCertificateStoreSelector selects current-user or local-machine scope, store name, SHA-1 thumbprint, and whether key-provider UI is allowed
• THPDFCMSSignDigestCallback and HPDFCMSSignPDFStreamWithExternalSigner provide the underlying external-digest signer hook
• CNG keys use RSA PKCS#1 SHA-256 signing and legacy CSP keys use the equivalent CryptoAPI path

Printing

• THPDFPrintOptions supports collated copies, paper code, custom paper width and length, orientation, duplex, bin, and quality
• THPDFPrinterCapabilities reports parallel paper codes, names, and physical sizes alongside bins, resolutions, duplex, colour, and maximum copies
• HPDFBuildPrintPageSequence exposes the deterministic physical page sequence used for collated and uncollated jobs

VCL viewer components

• THPDFViewerModel owns navigation, zoom state, text-search results, wrapping, and change notifications without creating a window
• THPDFViewer renders the selected page into a scrollable cached bitmap, supports actual size, fit page, fit width, custom zoom, and view rotation, and draws current search hits over the rendered page
• THPDFSearchPanel connects search text, case sensitivity, whole-word matching, and next or previous navigation to a viewer
• THPDFOutlineViewer displays the full recursive bookmark tree, follows document changes from the linked viewer, and navigates the linked viewer
• THPDFViewerAction descendants provide first, prior, next, last, zoom, fit, rotation, reset, find-next, and clear-search actions

Minimal viewer setup

PDF.LoadFromFile('input.pdf');
PDFViewer.PDFDocument := PDF;
OutlineViewer.Viewer := PDFViewer;
SearchPanel.Viewer := PDFViewer;
PDFViewer.ZoomMode := vzmFitWidth;

Ownership and indexing

• Loaded page indexes and destination page indexes are zero-based
• Page-range strings are one-based and use the same parser as extraction and printing
• Facade records are snapshots and collection mutation methods operate on the current loaded document
• Extracted bitmaps are owned by the caller

Related typed inspection and placement records

• THPDFPageElementKind, THPDFPageElement, and THPDFBaselineRole describe text, image, path, and baseline results returned by loaded page-element inspection
• THPDFWatermarkKind, THPDFWatermarkHorizPos, and THPDFWatermarkVertPos select the content and placement of loaded-document watermarks