PDFium Delphi Component Docs

יחידת FPdfCache

Unit: FPdfCache
מספקת מושל תקציב-בתים משותף לנתוני PDF שנשמרו, שבעליהם יכולים לשחרר רשומות לפי דרישה

Types

TypeDescription
EPdfCacheErrorמדווח תקציבים, גדלי רשומות ומשתתפים לא תקינים
TPdfCacheKindמסווג סצנות עמוד (pckPageScene), אריחים (pckTile), תמונות ממוזערות (pckThumbnail), גופנים מערכתיים (pckSystemFont), נתוני מבנה (pckStructure), תמונות מצב של טקסט (pckTextSnapshot), תמונות מצב של אובייקטי עמוד (pckPageObjectSnapshot), זרמים מפוענחים (pckDecodedStream), ורשומות יישום (pckApplication)
TPdfCacheGovernorStatisticsמדווח את התקציב, הבתים השמורים הנוכחיים ובשיא, בתים נעוצים (pinned), מספר רשומות, הזמנות, מגעים, פינויים ודחיות; השדות כוללים MaxBytes, StoredBytes, PeakStoredBytes, PinnedBytes, EntryCount, ReservationCount, TouchCount, EvictionCount, RejectionCount
TPdfCacheParticipantמקבל קריאות חוזרות סינכרוניות של EvictCacheEntry לאחר שהמושל הסיר אסימון מהחשבונאות שלו
TPdfCacheGovernorEntryרשומת חשבונאות פנימית שנחשפת לתאימות קומפיילר; השדות כוללים Token, Participant, Kind, StoredBytes, LastUsed ו-Pinned
TPdfCacheGovernorרישום אסימונים בטוח-לתהליכונים עם סדר least-recently-used גלובלי אחד על פני משתתפים וסוגי מטמון

TPdfCacheGovernor members

MemberDescription
Create(AMaxBytes: Int64)יוצר מושל עם תקציב בתים לא-שלילי
Destroyמנקה רשומות רשומות לפני שחרור מצב הסנכרון
Reserveמזמין בתים ומחזיר אסימון חיובי, מפנה רשומות LRU גלובליות כשאפשר או מחזיר אפס כאשר הרשומה אינה נכנסת
Touchמעביר אסימון קיים למיקום החדש ביותר
Releaseמסיר את החשבונאות של אסימון מבלי להפעיל את קריאת החזרה לפינוי שלו
SetPinnedמגן על רשומה בשימוש או מבטל את ההגנה, ומצמצם אחרי ביטול הנעיצה
Clearמסיר את כל האסימונים ומבקש מכל משתתף לשחרר את הרשומה שנשמרה אצלו
Containsבודק אם אסימון עדיין רשום
UsageForKindמחזיר את הבתים השמורים עבור TPdfCacheKind אחד
EntryCountForKindמחזיר את מספר הרשומות הרשומות עבור TPdfCacheKind אחד
Statisticsמחזיר תמונת מצב טלמטריה מוגנת מנעילה
MaxBytesקורא או משנה את התקציב הכולל, ומצמצם מיד רשומות לא-נעוצות לאחר צמצום

Ownership and callback contract

המושל לעולם אינו הבעלים של המשתתפים או של הנתונים שהם משמרים

כל משתתף חייב לשרוד את כל האסימונים שרשם אצלו, ואסור שיעלה חריגה מתוך EvictCacheEntry

הקריאות החוזרות רצות באופן סינכרוני בלי שהמנעול של המושל מוחזק, כך שמשתתפים יכולים לקרוא בבטחה ל-Release עבור אסימונים קשורים

רשומות נעוצות עשויות להחזיק זמנית את StoredBytes מעל ערך MaxBytes שצומצם, עד שהמשתמש האחרון מבטל את הנעיצה

PDFium boundary

FPDF_RENDER_LIMITEDIMAGECACHE נותר זמין דרך reLimitCache ומחיל את מגבלת מטמון התמונות המקורית הקבועה של PDFium לכל עמוד

PDFium אינו חושף ABI ציבורי לתקציב בתים של מטמון ברמת-התהליך שניתן להגדרה או לשאילתה

המושל לפיכך מודד אובייקטים שנשמרו בבעלות PDFiumPas ומשתמש בהערכה מפורשת עבור סצנות עמוד מפוענחות אטומות

See Also

TPdf cache governor, TPdfTileCache, ConfigureSystemFontCacheGovernor