بهینه‌سازی عملکرد

بهینه‌سازی رندرینگ و حافظه

پروفایل منابع Doconut توسط سه چیز حاکم است: چگالی DPI رندر, مواردی که در کش می‌مانند, و مدت زمان زندگی جلسات. این راهنما اهرم‌ها را به ترتیب تأثیر مرور می‌کند.

وضوح — بزرگ‌ترین اهرم

ImageResolution (۲۵–۳۰۰ DPI) زمان رندر و اندازه تصویر را تعیین می‌کند. اکثر فرمت‌ها به‌صورت پیش‌فرض ۲۰۰ DPI هستند؛ تصاویر و PSD به‌صورت پیش‌فرض ۱۰۰ هستند.

csharp
// پیشنمایش فهرست اسناد نیازی به کیفیت چاپ ندارد
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 نگه داشته شود.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

در سمت کلاینت، ViewerConfig.CacheEnabled = true یک پنجره کوچک متحرک از تصاویر صفحات آینده را در حافظه مرورگر پیش‌بارگذاری می‌کند. این یک کش پیش‌بارگذاری برای هر مشاهده است، نه یک localStorage دائمی.

جلسات — حافظه‌ای که نمی‌بینید

هر جلسه باز مدل سند تجزیه‌شده را به‌همراه (با CachePages) صفحات رندر شده‌اش نگه می‌دارد، تا زمانی که TimeOut لغزنده (به‌صورت پیش‌فرض ۶۰ دقیقه) پس از آخرین درخواست منقضی شود. دو عادت این را تحت کنترل نگه می‌دارند:

  • آنچه کارتان تمام شده است را ببندید. 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 تبدیل می‌کند. این امکان جستجوی بومی مبتنی بر متن را فراهم می‌کند، اما برای سند ۵۰۰ صفحه‌ای، فراخوانی باز شدن شامل این تبدیل می‌شود — آن را به‌صورت خودکار فعال نکنید.
  • Word/PowerPoint روی سروری که فونت‌های اسناد را ندارد: یک Windows Server بدون Office فونت‌های بسیار کمتری نسبت به یک ماشین توسعه دارد. فونت‌های گمشده باعث بررسی‌های بازگشتی کند و معیارهای نادرست می‌شوند؛ فونت‌ها را نصب کنید، یا FontFolders را به پوشه‌ای که آنها را دارد اشاره دهید.

استراتژی‌های سمت کلاینت

  • LargeDoc = true — استراتژی بارگذاری تنبل برای اسناد بسیار بزرگ؛ صفحات زمانی که کاربر به آنها نزدیک می‌شود بارگذاری می‌شوند.
  • AutoLoad = false (پیش‌فرض) — تا زمانی که واقعا View(token) را صدا نزنید رندر نکنید.
  • ShowThumbs = false — برای پیش‌نمایش‌های تک‌صفحه یا توکار، تولید/درخواست تصویر بندانگشتی را نادیده بگیرید.
  • فعال‌سازی FixedZoom از تغییرات زوم آزاد جلوگیری می‌کند؛ وقتی یک C# ViewerConfig را نگاشت می‌کنید، FixedZoomPercentMobile (پیش‌فرض C# ۷۵) را برای صفحه‌نمایش‌های کوچک تنظیم کنید.

یک‌بار راه‌اندازی، نه به‌ازای هر درخواست

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) در Program.cs قرار می‌گیرد — ثبت‌نام کدگذاری‌ها به‌ازای هر درخواست کار هدر رفته‌ای است؛ فراموش کردن کامل آن اسناد صفحه‌کدهای قدیمی را خراب می‌کند.

توزیع کار بین گره‌ها

همه موارد فوق رندر یک گره را به‌صورت درخواست‌محور تنظیم می‌کنند. وقتی یک گره واحد نتواند بار را جذب کند، اهرم بعدی یک دایال بزرگ‌تر نیست — بلکه انتشار یک‌بار آثار سند در ذخیره‌سازی مشترک و اجازه دادن به هر گره برای سرو کردن آنهاست. این مدل هزینه را تغییر می‌دهد: رندر یک‌بار برای هر سند انجام می‌شود نه یک‌بار برای هر جلسه، و درخواست‌های صفحه به خواندن فایل تبدیل می‌شوند. ببینید استقرارهای توزیع‌شده.

فهرست بررسی تنظیمات

  1. پایین‌ترین ImageResolution که UX شما می‌پذیرد را تنظیم کنید.
  2. CachePages را برای مشاهده تعاملی فعال نگه دارید؛ برای سناریوهای یک‌بار یا همزمانی بالا غیرفعال کنید.
  3. جلسات را به‌صورت صریح ببندید؛ TimeOut را در مواردی که استفاده متناوب است کوتاه کنید.
  4. برای اسناد بزرگ، از LargeDoc به‌اضافه پیش‌فرض AutoLoad = false در کلاینت استفاده کنید.
  5. فقط زمانی که به یک پروجکشن PDF حاوی متن نیاز دارید از DefaultRender = false استفاده کنید.

آیا این صفحه مفید بود؟