PdfNativeRendererType - PDFium Delphi Component

單元: PDFium

回報指定的算繪器偏好在一個 PDFium 建置上會選用的原生算繪器

Syntax

function PdfNativeRendererType(Preference: TPdfRendererPreference; SkiaBuild: Boolean): FPDF_RENDERER_TYPE;

Parameters

Preference	`TPdfRendererPreference`。`TPdfLibraryConfiguration` 的 `Renderer` 值
SkiaBuild	`Boolean`。若為 True，表示這是編譯時啟用 Skia 的 PDFium 建置，也就是會匯出 `FPDF_RenderPageSkia` 的那種

Return Value

FPDF_RENDERER_TYPE：FPDF_RENDERERTYPE_AGG 或 FPDF_RENDERERTYPE_SKIA

Description

當設定結構到達第 4 版以上時，LoadLibrary 就是用 PdfNativeRendererType 這個對應來填 FPDF_LIBRARY_CONFIG.m_RendererType；指定明確的算繪器或字型後端會到達這個版本，啟用 BrotliEnabled 或 IsolatePerDocument 也一樣

prpAgg 與 prpSkia 對應到相符的原生值；prpDefault 則保留建置本身的預設，啟用 Skia 的建置用 Skia，其他用 AGG，因此開啟無關的選項永遠不會改變算繪器

隨附的 pdfium.dll 與 pdfium.v8.dll 都是啟用 Skia 的建置

Remarks

此函式是純函式，不會載入程式庫；LoadLibrary 之後傳入 Assigned(FPDF_RenderPageSkia) 即可評估已載入的執行階段
只有 AGG 的建置跑不動 Skia 算繪器；對這種建置要求 prpSkia 會讓 LoadLibrary 引發 EPdfError，見 PdfLibraryConfigurationSupportError

Example

LoadLibrary;
if PdfNativeRendererType(GetPdfLibraryConfiguration.Renderer, Assigned(FPDF_RenderPageSkia)) = FPDF_RENDERERTYPE_SKIA then
Writeln('Rendering with Skia');

PdfNativeRendererType 函式