بهینهسازی عملکرد
بهینهسازی رندرینگ و حافظه
پروفایل منابع Doconut توسط سه مورد حاکم است: render DPI، what stays cached، و how long sessions live. این راهنما اهرمها را به ترتیب تأثیرشان بررسی میکند.
وضوح — بزرگترین اهرم
ImageResolution (۲۵–۳۰۰ DPI) هر دو زمان رندر و اندازه تصویر را تعیین میکند. اکثر فرمتها بهصورت پیشفرض ۲۰۰ DPI دارند؛ تصاویر و PSD بهصورت پیشفرض ۱۰۰.
// پیشنمایش فهرست اسناد نیازی به کیفیت چاپ ندارد
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });نصف کردن DPI تقریباً تعداد پیکسلها در هر صفحه را بهیکچهارم کاهش میدهد — رندرهای سریعتر، انتقالهای کوچکتر، حافظه کش کمتر. برای مواردی که زوم زیاد دارند (CAD، نقشههای مهندسی) ۲۵۰–۳۰۰ DPI را رزرو کنید.
برای PDFهایی که دارای تصاویر جاسازیشده سنگین هستند، PdfConfig تنظیمات دقیقتری اضافه میکند: CompressImages + CompressQuality، ResizeImages + ResizeResolution، و CompressFast. برای تصاویر ساده، ImageConfig.MaxImagePixelSize (پیشفرض ۳۰۰۰ پیکسل) حداکثر اندازه خروجی را تعیین میکند.
کش صفحه — حافظه در مقابل رندر مجدد
BaseConfig.CachePages (پیشفرض true) هر صفحه رندر شده را در حافظه برای طول عمر نشست نگه میدارد. این پیشفرض صحیح برای مشاهده تعاملی است — کاربران بهصورت عقب و جلو اسکرول میکنند. آن را خاموش کنید وقتی:
- اسناد بسیار بزرگ هستند و یکبار از ابتدا تا انتها مشاهده میشوند،
- تعداد زیادی نشست همزمان باعث میشود صفحات کششده چند برابر شوند،
- ترجیح میدهید بهازای هر مشاهده CPU مصرف کنید تا RAM را نگه دارید.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });در سمت کلاینت، ViewerConfig.CacheEnabled = true یک پنجره کوچک متحرک از تصاویر صفحات آینده را در حافظه مرورگر پیشبارگذاری میکند. این یک کش پیشدریافت برای هر مشاهده است، نه یک localStorage دائم.
نشستها — حافظهای که نمیبینید
هر نشست باز مدل سند تجزیهشده را بههمراه (با CachePages) صفحات رندر شدهاش نگه میدارد، تا زمانی که TimeOut متغیر (پیشفرض ۶۰ دقیقه) پس از آخرین درخواست منقضی شود. دو عادت این را تحت کنترل نگه میدارند:
- آنچه کارتان تمام شده است را ببندید.
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رندر را به آنچه مهم است محدود میکند. - حالت تغییر مسیر هزینه اولیه دارد:
DefaultRender = falseکل سند را هنگام باز کردن به PDF تبدیل میکند. این امکان جستجوی بومی مبتنی بر متن را فراهم میکند، اما برای سند ۵۰۰ صفحهای، فراخوانی باز کردن شامل این تبدیل میشود — آن را بهصورت reflexively فعال نکنید. - Word/PPT روی Linux/Docker: نبود فونتها باعث بررسی بازگشتی کند و معیارهای نادرست میشود؛
FontFoldersرا به دایرکتوری حاوی فونتهای خود اشاره دهید. - ارائهها روی Linux: نیازی به سوئیچ
libgdiplusیاSystem.Drawing.EnableUnixSupportنیست — ببینید فونتها روی Linux.
استراتژیهای سمت کلاینت
LargeDoc = true— استراتژی بارگذاری تنبل برای اسناد بسیار بزرگ؛ صفحات همانطور که کاربر به آنها نزدیک میشود بارگذاری میشوند.AutoLoad = false(پیشفرض) — تا زمانی که واقعاًView(token)را صدا نزنید رندر نکنید.ShowThumbs = false— تولید/درخواست تصویر بندانگشتی برای پیشنمایشهای تکصفحه یا توکار را نادیده بگیرید.- فعالسازی
FixedZoomاز تغییرات زوم آزاد جلوگیری میکند؛ وقتی یک C#ViewerConfigرا نگاشت میکنید،FixedZoomPercentMobile(پیشفرض C# ۷۵) را برای صفحهنمایشهای کوچک تنظیم کنید.
یکبار راهاندازی، نه بهازای هر درخواست
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) در Program.cs قرار میگیرد — ثبت رمزگذاریها بهازای هر درخواست کار هدر رفتهای است؛ فراموش کردن کامل آن اسناد کدصفحهی قدیمی را خراب میکند.
توزیع کار بین گرهها
همه موارد بالا رندر یک گره را بهصورت درخواستمحور تنظیم میکند. وقتی یک گره واحد نتواند بار را جذب کند، اهرم بعدی یک دایال بزرگتر نیست — بلکه انتشار یکبار آثار سند در ذخیرهسازی مشترک و اجازه دادن به هر گره برای سرو کردن آنهاست. این مدل هزینه را تغییر میدهد: رندر یکبار برای هر سند انجام میشود نه یکبار برای هر نشست، و درخواستهای صفحه به خواندن فایل تبدیل میشوند. ببینید استقرارهای توزیعشده.
فهرست بررسی تنظیمات
- کمترین
ImageResolutionکه تجربه کاربری شما میپذیرد را تنظیم کنید. - برای مشاهده تعاملی
CachePagesرا فعال نگه دارید؛ برای سناریوهای یکبار یا همزمانی بالا آن را غیرفعال کنید. - نشستها را بهصورت صریح ببندید؛
TimeOutرا در مواردی که استفاده پیکدار است کوتاه کنید. - برای اسناد بزرگ، در کلاینت از
LargeDocبههمراه پیشفرضAutoLoad = falseاستفاده کنید. - فقط زمانی که به یک پروجکشن PDF حاوی متن نیاز دارید از
DefaultRender = falseاستفاده کنید.
آیا این صفحه مفید بود؟