THotPDF 進階 published 屬性

本頁彙整較新或特定工作流程的 THotPDF published 屬性,這些項目沒有個別主題頁。它們是元件介面的一部分,適用時可從 Delphi、C++Builder 或 Object Inspector 指派

加密與版本控制

屬性 類型 預設 說明
UseAES256R6 Boolean false 當 CryptKeyLength 為 aes256 時,改用 PDF 2.0 的 R=6 AES-256 安全處理器演算法。想走相容面較廣的 Acrobat 9+ R=5 路徑就保持關閉;工作流程需要 R=6 演算法時才開啟
StrictVersionLock Boolean false 控制功能的版本閘控。使用預設值時,功能需要較新的 PDF 版本,HotPDF 會自動提高 Version。設為 true 時,需要較新 PDF 版本的功能方法會拒絕輸出,而不是提升檔案版本

中繼資料、Tagged PDF 與標準

屬性 類型 預設 說明
EnableXMPMetadata Boolean false 在 EndDoc 期間寫出 PDF 1.4+ 的 XMP /Metadata 串流。除非 CustomXMP 提供呼叫端自備的 packet,否則產生的 packet 會由文件資訊欄位組出
CustomXMP AnsiString empty 為 Catalog 中繼資料串流提供逐字使用的 XMP packet。只在 EnableXMPMetadata 開啟、或某個符合性屬性自動啟用 XMP 輸出時使用
Lang AnsiString empty 設定 Catalog 的 /Lang 自然語言標籤,例如 en-US、de 或 zh-CN。PDF/UA 與 tagged-PDF 工作流程也會用到
EnableTaggedPDF Boolean false 啟用 tagged-PDF 的外層項目,包括 /MarkInfo 與 /StructTreeRoot。實際的語意內容仍來自結構元素與標記內容呼叫,例如 AddStructureElement 與頁面的 marked-content 輔助方法
PDFUACompliance Boolean false 開啟 HotPDF 高階的 PDF/UA-1 產生端預設,包括 tagged PDF、XMP 中繼資料、文件語言預設值,以及顯示標題的 viewer preference 處理
PDFACompliance AnsiString empty 選擇 PDF/A 符合性處理。支援的值包括 A、B、2A、2B、2U、3A、3B 與 3U。留空表示不強制 PDF/A
PDFXCompliance AnsiString empty 選擇 PDF/X 印前處理。支援的值為 X-1a、X-3 與 X-4。此屬性會啟用對應的中繼資料、版本需求、加密限制與 Trapped 驗證
Trapped AnsiString empty 寫入 PDF/X DocInfo 的 trapped 狀態。PDFXCompliance 啟用時可設 True、False 或 Unknown

壓縮與複製處理

屬性 類型 預設 說明
CompressionLevel TPDFCompressionLevel clDefault 選擇增強壓縮路徑所使用、以 zlib 為基礎的 Flate 壓縮層級。有效值為 clNone、clFastest、clDefault 與 clMaximum
EnableStructuredContent Boolean true 控制版本管理員的增強模式在目前 PDF 版本下是否維持結構化內容支援。較舊的文件模式可能會自動關閉它
EnableTransparency Boolean true 控制目前文件模式與 PDF 版本下,支援透明度的輸出路徑是否保持啟用
EnableOptionalContent Boolean false 控制 PDF 1.5+ 工作流程的 optional content 支援。版本切換時可由文件功能管理員更新
DecompressForCopy Boolean true 從已載入文件複製時,允許 HotPDF 視需要解壓縮來源物件串流,讓頁面複製與擷取操作能實體化可重用的物件
OriginallyCompressed Boolean false 唯讀旗標;來源內容原本有壓縮、且為了複製或分析必須解壓縮時,由載入器設定

Document Information

屬性 類型 預設 說明
Information Boolean true 控制 HotPDF 儲存時是否寫入文件資訊字典。頁面擷取與拆分工作流程需要純內容副本時,會在產生的輸出文件上關閉它

PDF/A 預設色彩空間

RegisterDefaultColorSpace - 把 DefaultGray、DefaultRGB 或 DefaultCMYK 映射到 RegisterICCProfile 註冊的 ICCBased 色彩空間,在 PDF/A 色彩檢查前就把 Device 色彩的使用講清楚

UsedDeviceGray、UsedDeviceRGB、UsedDeviceCMYK - 唯讀 flags,顯示建立檔案時是否使用 DeviceGray、DeviceRGB 或 DeviceCMYK content

文字 shaping 與精簡字型輸出

ShapingFeatures 記錄目前的 GSUB/GPOS shaping 旗標,包括排版 feature 旗標、數字樣式旗標、複雜文字前置處理旗標、sfKerning、sfMarkPositioning、sfTibetanShaping、sfMongolianShaping 與 sfIndicGSUB

SimpleLatinFonts 記錄可列印 ASCII 文字的精簡 Base14 / WinAnsi 路徑

script shaping preprocess methods 涵蓋 AutoShapeNko、AutoShapeAdlam、AutoShapeHanifiRohingya,以及 Thai/Lao、Hebrew、Javanese、Tai Viet、Meetei Mayek、Khmer 與 Myanmar preprocess flags;GPOS 頁面現在涵蓋 contextual 與 vertical kerning,以及 mark-to-ligature placement

執行期狀態

AutoShapeArabic 會在文字輸出前啟用 producer-side Arabic shaping。IsHaveSimpleText 與 IsEncrypted 會暴露目前或已載入檔案的 simple-text 與 encryption 狀態

印前與圖形狀態輔助

RegisterSoftMaskState、RegisterTransferFunctionState、RegisterHalftoneType1、RegisterHalftoneState 與 RegisterPrintControlState 會註冊特殊的 ExtGState 或 halftone 資源,涵蓋透明度、transfer function、網屏、疊印、筆畫調整、rendering intent 與 flatness 工作流程

OutputIntent 輔助

AddPDFAOutputIntent 與 AddPDFXOutputIntent 會包裝 ICC profile registration,以及 PDF/A 與 PDF/X production 所需的 Catalog /OutputIntents creation。當對應的 compliance property 已啟用時,請在 EndDoc 前使用它們

Type 3 字型字形

RegisterType3Font 會建立呼叫端自訂的 Type 3 字型資源,AddType3Glyph 則加入個別的 glyph 內容串流。寫入文字前,請使用 THPDFPage.SetType3Font 在頁面上選取該資源

PDF/A 便利方法與關聯檔案

PDFAConformanceLevel、IsPDFA1Strict 與 IsPDFA2OrLater 公開生效中的 PDF/A 部分與符合性分支,供呼叫端邏輯使用。EnsurePDFAImplementationLimits 會在 EndDoc 前檢查 PDF/A-2 與 PDF/A-3 對中繼資料字串、/Lang 與頁面框的實作限制。AddPDFA3AssociatedFile 附加帶 /AFRelationship 的 PDF/A-3 Annex E 關聯檔案;AddFacturXAssociatedFile 加入 Factur-X 發票 XML、EmbeddedFiles 名稱樹項目與 PDF/A-3 發票工作流程所需的 XMP 中繼資料;FacturXWarnings 回報這些工作流程的非致命附件警告;AddXAdESAssociatedFile 把呼叫端產生的 XAdES XML 以關聯檔案嵌入,供 XAdES-in-PDF 工作流程使用

請參閱