כיוונון ביצועים
אופטימיזציה של רינדור וזיכרון
פרופיל המשאבים של Doconut נשלט על ידי שלושה גורמים: רזולוציית DPI, מה נשמר במטמון, ו-משך חיי הסשנים. מדריך זה מסביר את המנופים לפי סדר ההשפעה.
רזולוציה — המנוף הגדול ביותר
ImageResolution (25–300 DPI) מניע הן את זמן הרינדור והן את גודל התמונה. רוב הפורמטים בברירת מחדל הם 200 DPI; תמונות ו‑PSD בברירת מחדל הן 100.
// תצוגה מקדימה של רשימת מסמכים אינה דורשת איכות הדפסה
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.
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: אין צורך במתגים
libgdiplusאוSystem.Drawing.EnableUnixSupport— ראה גופנים על Linux.
אסטרטגיות בצד הלקוח
LargeDoc = true— אסטרטגיית טעינה עצלה למסמכים גדולים מאוד; דפים נטענים כאשר המשתמש מתקרב אליהם.AutoLoad = false(ברירת מחדל) — אל תבצע רינדור עד שאתה קורא בפועל ל‑View(token).ShowThumbs = false— דלג על יצירת תמונות ממוזערות/בקשות עבור תצוגות מקדימות של דף יחיד או משובצות.- הפעלת
FixedZoomמונעת שינויי זום חופשיים; כאשר אתה ממפה C#ViewerConfig, כוונן אתFixedZoomPercentMobile(ברירת מחדל C# 75) למסכים קטנים.
אתחול חד פעמי, לא לכל בקשה
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) שייך ב‑Program.cs — רישום קידודים לכל בקשה הוא עבודה מבוזבזת; שכחתו לחלוטין שוברת מסמכי קוד-דף ישנים.
פיזור העבודה על פני צמתים
כל מה שלמעלה מכוונן רינדור של צומת יחיד לפי דרישה. כאשר צומת יחיד אינו יכול לספוג את העומס, המנוף הבא אינו סיבוב גדול יותר — אלא פרסום של תוצרי המסמך פעם אחת באחסון משותף ומתן אפשרות לכל צומת לשרת אותם. זה משנה את מודל העלות: הרינדור מתבצע פעם אחת לכל מסמך במקום פעם אחת לכל סשן, ובקשות הדפים הופכות לקריאות קובץ. ראה פריסות מבוזרות.
רשימת בדיקת כיוונון
- קבע את ה‑
ImageResolutionהנמוך ביותר שה‑UX שלך מקבל. - השאר את
CachePagesפעיל לצפייה אינטראקטיבית; כבה אותו לתרחישים של מעבר חד או קונקורנטיות גבוהה. - סגור סשנים במפורש; קצץ את
TimeOutבמקרים שבהם השימוש מתפרץ. - השתמש ב‑
LargeDoc+ ברירת המחדלAutoLoad = falseבצד הלקוח למסמכים גדולים. - השתמש ב‑
DefaultRender = falseרק כאשר אתה זקוק להקרנת PDF עם טקסט.
האם דף זה היה מועיל?