THotPDF Advanced Published Properties

หน้านี้รวบรวม published properties ใหม่หรือเฉพาะ workflow ของ THotPDF ที่ยังไม่มี topic page แยก เป็นส่วนหนึ่งของ component surface และสามารถกำหนดค่าจาก Delphi, C++Builder หรือ Object Inspector ได้เมื่อเกี่ยวข้อง

Encryption and Version Control

Property Type Default คำอธิบาย
UseAES256R6 Boolean false Selects the PDF 2.0 R=6 AES-256 security-handler algorithm when CryptKeyLength is aes256. Leave it off for the broader Acrobat 9+ R=5 compatibility path; turn it on for workflows that require the R=6 algorithm
StrictVersionLock Boolean false Controls feature version gating. With the default value, HotPDF can raise Version automatically when a feature needs a newer PDF version. When set to true, feature methods that would require a newer PDF version refuse to emit instead of promoting the file

Metadata, Tagged PDF, and Standards

Property Type Default คำอธิบาย
EnableXMPMetadata Boolean false Writes a PDF 1.4+ XMP /Metadata stream during EndDoc. The generated packet is built from the document information fields unless CustomXMP supplies a caller-authored packet
CustomXMP AnsiString empty Provides a verbatim XMP packet for the Catalog metadata stream. Use it only when EnableXMPMetadata is enabled or when a conformance property enables XMP output automatically
Lang AnsiString empty Sets the Catalog /Lang natural-language tag, such as en-US, de, or zh-CN. It is also used by PDF/UA and tagged-PDF workflows
EnableTaggedPDF Boolean false Enables the tagged-PDF wrapper entries, including /MarkInfo and /StructTreeRoot. Actual semantic content still comes from structure-element and marked-content calls such as AddStructureElement and page marked-content helpers
PDFUACompliance Boolean false Turns on HotPDF's high-level PDF/UA-1 producer-side defaults, including tagged PDF, XMP metadata, a document language default, and display-title viewer preference handling
PDFACompliance AnsiString empty Selects PDF/A conformance handling. Supported values include A, B, 2A, 2B, 2U, 3A, 3B, and 3U. Empty disables PDF/A enforcement
PDFXCompliance AnsiString empty Selects PDF/X prepress handling. Supported values are X-1a, X-3, and X-4. The property enables matching metadata, version requirements, encryption restrictions, and Trapped validation
Trapped AnsiString empty Writes the PDF/X DocInfo trapped state. Use True, False, or Unknown when PDFXCompliance is enabled

Compression and Copy Handling

Property Type Default คำอธิบาย
CompressionLevel TPDFCompressionLevel clDefault Selects the zlib-backed Flate compression level used by enhanced compression paths. Valid values are clNone, clFastest, clDefault, and clMaximum
EnableStructuredContent Boolean true Controls whether the version-manager enhanced mode keeps structured-content support enabled for the current PDF version. Older document modes can turn it off automatically
EnableTransparency Boolean true Controls whether transparency-capable output paths stay enabled for the current document mode and PDF version
EnableOptionalContent Boolean false Controls optional-content support for PDF 1.5+ workflows. Version switching can update it through the document feature manager
DecompressForCopy Boolean true When copying from loaded documents, allows HotPDF to decompress source object streams as needed so page-copy and extraction operations can materialize reusable objects
OriginallyCompressed Boolean false Read-only flag set by the loader when source content was originally compressed and had to be decompressed for copy or analysis

Document Information

Property Type Default คำอธิบาย
Information Boolean true Controls whether HotPDF writes the document information dictionary during save. Page extraction and split workflows turn it off on generated output documents when they need a content-only copy

PDF/A Default Color Spaces

RegisterDefaultColorSpace - Maps DefaultGray, DefaultRGB, or DefaultCMYK to an ICCBased color space registered by RegisterICCProfile, so Device color use can be made explicit before PDF/A color checks

UsedDeviceGray, UsedDeviceRGB, UsedDeviceCMYK - flags แบบ read-only ที่แสดงว่ามีการใช้เนื้อหา DeviceGray, DeviceRGB หรือ DeviceCMYK ระหว่างสร้างเอกสารหรือไม่

Text shaping and compact font output

ShapingFeatures documents the current GSUB/GPOS shaping flags, including typographic feature flags, figure-style flags, complex-script preprocess flags, sfKerning, sfMarkPositioning, sfTibetanShaping, sfMongolianShaping, and sfIndicGSUB

SimpleLatinFonts documents the compact Base14 / WinAnsi path for printable ASCII text

script shaping preprocess methods ครอบคลุม AutoShapeNko, AutoShapeAdlam, AutoShapeHanifiRohingya และ preprocess flags สำหรับ Thai/Lao, Hebrew, Javanese, Tai Viet, Meetei Mayek, Khmer และ Myanmar; หน้า GPOS ตอนนี้ครอบคลุม contextual และ vertical kerning รวมถึง mark-to-ligature placement

Runtime State

AutoShapeArabic เปิด producer-side Arabic shaping ก่อน text output IsHaveSimpleText และ IsEncrypted เปิดสถานะ simple-text และ encryption สำหรับเอกสารปัจจุบันหรือเอกสารที่โหลดมา

Prepress and Graphics-State Helpers

RegisterSoftMaskState, RegisterTransferFunctionState, RegisterHalftoneType1, RegisterHalftoneState, and RegisterPrintControlState register specialised ExtGState or halftone resources for transparency, transfer-function, screening, overprint, stroke-adjustment, rendering-intent, and flatness workflows

OutputIntent Helpers

AddPDFAOutputIntent และ AddPDFXOutputIntent ห่อการลงทะเบียน ICC profile พร้อมการสร้าง Catalog /OutputIntents สำหรับการผลิต PDF/A และ PDF/X ใช้ก่อน EndDoc ทุกครั้งเมื่อเปิด property compliance ที่สอดคล้องกัน

Type 3 Font Glyphs

RegisterType3Font สร้าง resource font Type 3 ที่ caller กำหนดเอง และ AddType3Glyph เพิ่ม content streams ของ glyph แต่ละตัว เลือก resource บน page ด้วย THPDFPage.SetType3Font ก่อนเขียนข้อความ

PDF/A Convenience and Associated Files

PDFAConformanceLevel, IsPDFA1Strict, and IsPDFA2OrLater expose the active PDF/A part and conformance branch for caller logic. EnsurePDFAImplementationLimits checks PDF/A-2 and PDF/A-3 implementation limits for metadata strings, /Lang, and page boxes before EndDoc. AddPDFA3AssociatedFile attaches PDF/A-3 Annex E associated files with /AFRelationship; AddFacturXAssociatedFile adds the Factur-X invoice XML, EmbeddedFiles name-tree entry, and XMP metadata for PDF/A-3 invoice workflows; FacturXWarnings reports non-fatal supporting-attachment warnings for those workflows; AddXAdESAssociatedFile embeds caller-generated XAdES XML as an associated file for XAdES-in-PDF workflows

See Also