מדריך מפתחים של PDFium Delphi Component

Component: TPdf · Unit: PDFium

מרנדר מספר בקשות עמודים במקביל, כאשר כל worker מחזיק מסמך PDFium מבודד ו-handle של עמוד משלו

Syntax

function RenderPagesParallel(
  const PageNumbers : array of Integer;
  const Options : TPdfParallelRenderOptions;
  const CancellationToken: IPdfCancellationToken = nil): TPdfParallelRenderReport;

Description

RenderPagesParallel לוכד את המסמך הנוכחי פעם אחת אל TPdfRandomAccessStore, מסיר את הצפנת ה-snapshot, ושומר על המקור כבלתי ניתן לשינוי עד שכל מסמך ה-worker נסגר

לכידה בזיכרון משותפת ישירות בלי העתקה שנייה של מערך הבייטים, לכידה שנשפכה לדיסק נחשפת דרך מיפוי קובץ אחד לקריאה בלבד, וכישלון מיפוי חוזר לקריאות block של FPDF_LoadCustomDocument מאותו מאגר thread-safe

כל worker טוען עותק זמני פרטי של הבינארי הפעיל של PDFium כמודול עצמאי, מאתחל את המודול ב-thread שלו, ומשתמש שוב ב-FPDF_DOCUMENT משלו בזמן טעינה וסגירה של העמודים שהוקצו לו

מצב של מודול, מסמך, עמוד, רינדור הדרגתי ומפת סיביות לעולם אינו חוצה גבולות של worker, מה שמונע קריאות בו-זמניות לא בטוחות למודול PDFium אחד

PageNumbers עוקב אחר ההוסכמה הציבורית של מספור עמודים החל מ-1, והמערך Results שמוחזר תואם תמיד לסדר הבקשה, גם אם ה-workers מסיימים שלא לפי הסדר או שעמוד בודד נכשל

כל תוצאה מוצלחת מחזיקה חוצץ פיקסלים 32-bit מלמעלה למטה עם Stride = Width * 4, בסדר בייטים BGRA אלא אם reReverseByteOrder מבקש RGBA

Options

שדה	ברירת מחדל	משמעות
`Dpi`	96	רזולוציית יעד מ-0 מעלה ועד 2400 DPI
`MaxWorkers`	0	0 בוחר עד ארבעה workers, אחרת 1 עד 64 בתחום שמטיל מספר הבקשות
`MaxPixelsPerPage`	64 MiPixels	דוחה עמוד לפני הקצאת חוצץ תוצאה בגודל חריג
`MaxTotalOutputBytes`	512 MiB	תוחם את הסכום של חוצצי הפיקסלים המוצלחים שנשמרו
`Rotation`	`ro0`	מחיל את אותו סיבוב על כל בקשה ומחליף את ממדי הפלט עבור 90 או 270 מעלות
`RenderOptions`	`[]`	דגלי רינדור native של PDFium, כולל הערות, גווני אפור, הדפסה, החלקה וסדר בייטים הפוך
`BackgroundColor`	`clWhite`	רקע הפיקסלים ההתחלתי לפני ש-PDFium צובע את תוכן העמוד

Results

pprsSucceeded מחזיר ממדים, stride, פורמט פיקסלים, פיקסלים וזמן שחלף
pprsCancelled אינו מחזיר פיקסלים כאשר ביטול נצפה לפני הלולאה ההדרגתית או במהלכה
pprsFailed מבודד עמוד לא תקף, כישלון טעינה או רינדור native, או דחייה עקב תקציב משאבים, בתוך ErrorMessage
הדוח מצרף את מספר ה-workers, את ספירות המצב הסופיות, את בייטי הפלט שנשמרו ב-TotalOutputBytes, ואת הזמן שחלף מקצה לקצה
SourceSize, SourcePeakMemoryBytes ו-SourceStorageBackend חושפים את עלות הלכידה המתוחמת
SourceBackingKind הוא ppsbSharedMemory, ppsbMemoryMappedFile או ppsbRandomAccessStore לאחר לכידת המקור

Remarks

המתודה סינכרונית מבחינת הקורא וחוזרת לאחר שכל ה-workers עצרו
תיקיית הזמני של התהליך חייבת להיות ניתנת לכתיבה וחייבת לאפשר טעינת DLL; כל עותק מודול פרטי נפרק ונמחק כאשר ה-worker שלו מסתיים
אסימון הביטול נבדק בין מקטעי הרינדור ההדרגתי של PDFium ובין הקצאות עמודים
reInvert ו-reNightDuotone הן טרנספורמציות מפת סיביות שלאחר רינדור וה-API הזה של חוצץ גולמי דוחה אותן
SaveMemoryLimit ו-SaveTemporaryDirectory שולטים במקור הנלכד, בעוד שתקציב הפלט מכסה חוצצי תוצאות שנשמרו ולא הקצאות פנימיות של PDFium
תוכן עמוד סטטי ורינדור הערות native נתמכים, ואילו שכבות-על של טפסים אינטראקטיביים ויצירת עמודי XFA דינמית מחוץ להיקף של המתודה הזאת
אל תשנו, תפרקו או תשמרו את אותו מופע TPdf במקביל בזמן לכידת ה-snapshot הראשוני
שחררו זיכרון פלט על ידי ניקוי הדוח או מערכי ה-Pixels הבודדים לאחר השימוש בהם

Example

uses FPdfAsync;

var
  Options: TPdfParallelRenderOptions;
  Report: TPdfParallelRenderReport;
  I: Integer;
begin
  Options := TPdfParallelRenderOptions.Default;
  Options.Dpi := 150;
  Options.MaxWorkers := 4;
  Options.RenderOptions := [reAnnotations];

  Report := Pdf1.RenderPagesParallel([1, 3, 5, 7], Options, CancelToken);
  for I := 0 to High(Report.Results) do
    if Report.Results[I].Status = pprsSucceeded then
      ConsumeTopDownPixels(Report.Results[I]);
end;

מתודת RenderPagesParallel