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

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

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

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

// A document list preview doesn't need print quality
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) שומר כל דף מרונדר בזיכרון לכל אורך חיי הסשן. זהו ברירת המחדל הנכונה לצפייה אינטראקטיבית — משתמשים גוללים קדימה ואחורה. כבה זאת כאשר:

• המסמכים גדולים ונצפים פעם אחת, מקצה לקצה,
• ריבוי סשנים במקביל יגדיל את מספר הדפים המוקשיים,
• אתה מעדיף לשלם במעבד לכל צפייה במקום להחזיק RAM.

var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

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

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

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

• סגור את מה שסיימת להשתמש בו. viewer.CloseDocument(token) משחרר את המנוע מיד במקום לחכות לחלון הממתין.
• התאם את משך הזמן. תצוגה מקדימה שמשתמשים מביטים בה למשך שתי דקות אינה זקוקה לסשן של שעה:

var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

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

מתגים ספציפיים לפורמט

• Excel: MemoryOptimizationPreference הוא פעיל כברירת מחדל ומקטין את טביעת הרגל בזיכרון בעת רינדור חוברות גדולות מאוד — השאר אותו פעיל, או הגדר אותו ל‑false אם אתה מוכן להחליף זיכרון בתמורה לשיפור מהירות קטן; SheetNames / PrintArea מגבילים את הרינדור למה שחשוב.
• מצב הפנייה (Redirect) בעל עלות מקדימה: DefaultRender = false ממיר את כל המסמך ל‑PDF בזמן הפתיחה. זה מאפשר חיפוש טקסטואלי מקורי, אך במסמך של 500 עמודים קריאת הפתיחה נושאת המרה זו — אל תפעיל זאת באופן אוטומטי.
• Word/PPT על Linux/Docker: חוסר בגופנים גורם לבדיקות חלופה איטיות ולמדדים שגויים; הפנה את FontFolders לתיקייה עם הגופנים שלך.
• מצגות על Linux/macOS: קבצי PPT/PPTX/PPS/POT/ODP יכולים להיפתח, אך רינדור עם מנוע המצגות הנוכחי דורש libgdiplus מקורי ואת המתג בזמן ריצה System.Drawing.EnableUnixSupport=true. משפחות פורמט אחרות משתמשות בנתיב הרינדור הרגיל חוצה‑פלטפורמות.

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

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

אתחול חד‑פעמי, לא לכל בקשה

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

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

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