כוונון ביצועים

אופטימיזציית רינדור וזיכרון

פרופיל המשאבים של Doconut נשלט על ידי שלושה גורמים: רזולוציית רינדור, מה נשמר במטמון, ו-כמה זמן חיי הסשנים. מדריך זה מציג את המנופים לפי סדר החשיבות.

רזולוציה — המנוף הגדול ביותר

ImageResolution (25–300 DPI) מניע גם את זמן הרינדור וגם את גודל התמונה. רוב הפורמטים משתמשים ב‑200 DPI כברירת מחדל; תמונות ו‑PSD משתמשים ב‑100.

csharp
// תצוגה מקדימה של רשימת מסמכים אינה דורשת איכות הדפסה
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

חציית ה‑DPI מקצרת בקירוב את מספר הפיקסלים בעמוד לרבע — רינדורים מהירים יותר, העברות קטנות יותר, פחות זיכרון קאש. שמור על 250–300 DPI למקרים שבהם יש הרבה זום (CAD, שרטוטים הנדסיים).

ל‑PDFים עם תמונות משובצות רבות, PdfConfig מוסיף מכוונים מדויקים יותר: CompressImages + CompressQuality, ResizeImages + ResizeResolution, ו‑CompressFast. לתמונות רגילות, ImageConfig.MaxImagePixelSize (ברירת מחדל 3000 פיקסלים) מגביל את גודל הפלט.

קאשינג של דפים — זיכרון מול רינדור מחדש

BaseConfig.CachePages (ברירת מחדל true) שומר כל דף מרונדר בזיכרון לכל אורך חיי הסשן. זהו ברירת המחדל הנכונה לצפייה אינטראקטיבית — משתמשים גוללים קדימה ואחורה. כבה זאת כאשר:

  • המסמכים גדולים ונצפים פעם אחת, מההתחלה עד הסוף,
  • ריבוי סשנים מקביליים יגדיל את מספר הדפים המוקשיים,
  • עדיף לשלם על CPU לכל צפייה מאשר להחזיק RAM.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

בצד הלקוח, ViewerConfig.CacheEnabled = true טוען מראש חלון קטן נע של תמונות דפים קרובות בזיכרון הדפדפן. זהו קאש קדם-טעינה לכל צפייה, ולא localStorage קבוע.

סשנים — הזיכרון שאינך רואה

כל סשן פתוח מחזיק את מודל המסמך המפוענח בנוסף (עם CachePages) לדפים המרונדרים שלו, עד שה‑TimeOut הזזוג (ברירת מחדל 60 דקות) מתפוגג מאז הבקשה האחרונה. שני הרגלים משמרים זאת תחת שליטה:

  • סגור את מה שסיימת להשתמש בו. viewer.CloseDocument(token) משחרר את המנוע מיידית במקום לחכות לחלון ההמתנה.
  • התאם את משך זמן ההמתנה. תצוגה מקדימה שמשתמשים מביטים בה למשך שתי דקות אינה זקוקה לסשן של שעה:
csharp
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

זכור את הפשרה: לאחר הפקיעה הווידג'ט מציג Document session not found. Please re-open document. — בחר משך זמן שמותאם לסשנים אמיתיים של קריאה.

מתגים ייחודיים לפורמט

  • Excel: MemoryOptimizationPreference הוא פעיל כברירת מחדל ומפחית את טביעת הרגל הזיכרונית בעת רינדור חוברות גדולות מאוד — השאר אותו פעיל, או הגדר אותו ל‑false אם אתה מוכן להחליף זיכרון בתמורה לשיפור מהירות קטן; SheetNames / PrintArea מגבילים את הרינדור למה שחשוב.
  • מצב הפנייה דורש עלות מקדימה: DefaultRender = false ממיר את כל המסמך ל‑PDF בזמן הפתיחה. זה מאפשר חיפוש טקסטואלי מובנה, אך במסמך של 500 עמודים קריאת הפתיחה כוללת המרה זו — אל תפעיל זאת באופן אוטומטי.
  • Word/PowerPoint על שרת ללא הגופנים של המסמכים: Windows Server ללא Office מכיל פחות גופנים מאשר מכונת פיתוח. חוסר גופנים גורם לבדיקות חלופה איטיות ולמדדים שגויים; התקן את הגופנים, או הפנה את FontFolders לתיקייה שמכילה אותם.

אסטרטגיות בצד הלקוח

  • LargeDoc = true — אסטרטגיית טעינה עצלה למסמכים גדולים מאוד; דפים נטענים כאשר המשתמש מתקרב אליהם.
  • AutoLoad = false (ברירת מחדל) — אל תבצע רינדור עד שאתה קורא בפועל ל‑View(token).
  • ShowThumbs = false — דלג על יצירת תמונות ממוזערות/בקשות עבור תצוגות מקדימות של עמוד יחיד או משובצות.
  • הפעלת FixedZoom מונעת שינויי זום חופשיים; כאשר ממפים C# ViewerConfig, כוונן את FixedZoomPercentMobile (ברירת מחדל C# 75) למסכים קטנים.

אתחול פעם אחת, לא לכל בקשה

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) שייך ב‑Program.cs — רישום קידודים לכל בקשה הוא עבודה מבוזבזת; שכחתו לחלוטין משבשת מסמכי קוד-דף ישנים.

פיזור העבודה על פני צמתים

כל האמור למעלה מכוונן רינדור של צומת יחיד לפי דרישה. כאשר צומת יחיד אינו יכול לספוג את העומס, המנוף הבא אינו סיבוב גדול יותר — אלא פרסום של תוצרי המסמך פעם אחת לאחסון משותף ומתן אפשרות לכל צומת לשרת אותם. זה משנה את מודל העלות: רינדור מתבצע פעם אחת לכל מסמך במקום פעם אחת לכל סשן, ובקשות דפים הופכות לקריאות קובץ. ראה פריסות מבוזרות.

רשימת בדיקה לכוונון

  1. קבע את ה‑ImageResolution הנמוך ביותר שה‑UX שלך מקבל.
  2. שמור את CachePages פעיל לצפייה אינטראקטיבית; כבה עבור תרחישים של מעבר חד-פעמי או ריבוי גבוה.
  3. סגור סשנים במפורש; קצץ את TimeOut במקרים של שימוש מתפרץ.
  4. השתמש ב‑LargeDoc + ברירת המחדל AutoLoad = false בצד הלקוח למסמכים גדולים.
  5. השתמש ב‑DefaultRender = false רק כאשר אתה זקוק להקרנת PDF עם טקסט.

האם דף זה היה מועיל?