خط لولهٔ رندرینگ

از سند تا تصاویر صفحه

بین OpenDocumentAsync و PNGی که به مرورگر می‌رسد دو مرحلهٔ متمایز وجود دارد: حل‌کنندهٔ نمایشگر (که کدام موتور سند را بارگذاری می‌کند، یک‌بار برای هر باز کردن تصمیم‌گیری می‌شود) و پردازش صفحه (آنچه برای هر تصویر صفحه در هر درخواست رخ می‌دهد). دانستن هر دو توضیح می‌دهد چرا یک فرمت به‌این شکل رندر می‌شود — و چه چیزی توسط DefaultRender واقعاً تغییر می‌کند.

مرحله 1 — حل‌کنندهٔ نمایشگر فرمت

کارخانه پسوند فایل را از طریق کاتالوگ فرمت به یک نمایشگر نگاشت می‌کند، با سه سطح اولویت:

  1. نمایشگرهای سفارشی ابتدا. هر چیزی که با DoconutOptions.RegisterViewer(extension, factory, defaultConfig?) ثبت کرده‌اید بر تمام نمایشگرهای پیش‌فرض برتری دارد.
  2. نمایشگرهای خانوادهٔ پیش‌فرض. کاتالوگ هر پسوند قابل نمایش را به یک خانوادهٔ نمایشگر نگاشت می‌کند — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — که هر کدام آداپتور موتور خود را دارند. اگر یک افزونهٔ دارای مجوز برای همان پسوند یک نمایشگر ارائه دهد، نمایشگر افزونه جایگزین نمایشگر پیش‌فرض می‌شود. AddDoconut() در زمان راه‌اندازی اعتبارهای ثبت‌شدهٔ افزونه را اعتبارسنجی می‌کند؛ بازگشت کارخانه به نمایشگر پیش‌فرض یک قانون دفاعی زمان اجرا است.
  3. فرمت‌های فقط افزونه‌ای. برخی پسوندها اصلاً نمایشگر پیش‌فرض ندارند — DICOM (.dcm) فقط از طریق افزونهٔ DICOM موجود است.

باز کردن یکی بدون قابلیت مورد نیاز خطایی می‌اندازد:

text
LicenseException: This document type requires the 'Dicom' plugin license.

یک پسوند که هیچ نمایشگری آن را ادعا نکند خطا می‌دهد:

text
FormatNotSupportedException: Document format '<extension>' is not supported.

پس از حل، پیکربندی تثبیت می‌شود: شیء پیکربندی صریح شما اگر ارائه داده‌اید، در غیر این صورت پیکربندی پیش‌فرض فرمت از کاتالوگ. DocOptions.Password در پیکربندی اسناد محافظت‌شده کپی می‌شود.

مرحله 1b — حالت تغییر مسیر (DefaultRender = false)

اکثر پیکربندی‌های هر فرمت یک پرچم DefaultRender را نشان می‌دهند. این پرچم بین دو مسیر اساسی متفاوت انتخاب می‌کند:

  • DefaultRender = true — سند به‌صورت بومی رندر می‌شود، مستقیم به تصاویر صفحه.
  • DefaultRender = false — ابتدا سند به یک PDF در حافظه تبدیل می‌شود، موتور منبع آزاد می‌گردد و یک نمایشگر PDF بر عهده می‌گیرد. PDF تولید شده متن واقعی را در خود جای می‌دهد، بنابراین جستجوی تمام متن هایلایت‌های بومی با دقت پیکسل را دریافت می‌کند؛ این خط لوله برای PDF تغییر مسیر شده AllowSearch و AllowCopy را فعال می‌کند چون تبدیل برای کاربر نامرئی است.

XPS و پیش‌فرض کاتالوگ برای MHT از مسیر تغییر مسیر استفاده می‌کنند. یک پروجکشن PDF می‌تواند جستجوی بومی برای فرمت‌هایی مانند HTML و Microsoft Project فراهم کند. اگر PDF حاصل شامل تصاویری بدون لایهٔ متن باشد، نمایشگر استاندارد نمی‌تواند آن پیکسل‌ها را جستجو کند.

از حالت تغییر مسیر استفاده کنید وقتی به یک پروجکشن PDF حاوی متن نیاز دارید — به‌قیمت تبدیل اولیه هنگام باز شدن سند.

مرحله 2 — خط لولهٔ تصویر‑صفحه

صفحات رندر شده برای هر درخواست از طریق یک توالی ثابت پردازش می‌شوند:

text
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response
  • واترمارک — از وضعیت مجوز (مجوز گمشده، موقت یا اشتراک منقضی‌شده، دامنه نامعتبر، نسخه نادرست) و از DocOptions.Watermark برای متن سفارشی شما اعمال می‌شود. یک برنامه با مجوز صحیح — یا یک مجوز موقت فعال — که واترمارک سفارشی ندارد، این مرحله را نادیده می‌گیرد.
  • چرخش/وارونگی — وضعیت هر صفحه که کاربر در ویجت تنظیم می‌کند (90°/180°/270°، وارونگی افقی/عمودی) در جلسه ذخیره می‌شود و در هر رندر بعدی آن صفحه اعمال می‌شود.
  • مقیاس — تصویرهای بندانگشتی و سطوح زوم با مقیاس‌بندی صفحه رندر شده به اندازه هدف درخواست‌شده تولید می‌شوند؛ 0 به این معنی است که با اندازهٔ اصلی سرو شود.
  • سوزاندن حاشیه‌نویسی — حاشیه‌نویسی‌های ذخیره‌شده بر روی بیت‌مپ کشیده می‌شوند تا صادرات و تصاویر صفحه آن‌ها را نشان دهند.
  • رمزگذاری — نتیجه به PNG رمزگذاری می‌شود با استفاده از جریان‌های حافظهٔ مشترک و مستقیماً به پاسخ HTTP نوشته می‌شود.

خطاهای داخل میدل‌ویر به‌صورت تصاویر خطای PNG (متن قرمز روی سفید) برگردانده می‌شوند نه صفحات خطای HTTP، بنابراین ویجت می‌تواند آن‌ها را در ناحیهٔ صفحه نمایش دهد.

کش‌گذاری صفحه

BaseConfig.CachePages (پیش‌فرض true) تصاویر صفحهٔ رندر شده را در حافظه برای طول عمر جلسهٔ سند نگه می‌دارد، بنابراین بازدید دوباره از یک صفحه آن را دوباره رندر نمی‌کند. BaseConfig.ImageResolution (۲۵–۳۰۰ DPI، 0 = پیش‌فرض فرمت) تنظیم اصلی کیفیت/حافظه است؛ پیش‌فرض هر فرمت در صفحهٔ پیکربندی آن مستند شده است.

رندرینگ بر روی یک گره در مقابل چند گره

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

قلم‌ها در لینوکس

صفحات با قلم‌های نصب‌شده بر روی سرور کشیده می‌شوند. در لینوکس، قبل از اولین باز شدن سند کتابخانهٔ پیکربندی قلم را نصب کنید (fontconfig در RHEL و Fedora):

bash
apt-get update && apt-get install -y libfontconfig1

بدون آن، باز کردن سند با The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation. شکست می‌خورد. این تنها بستهٔ سیستمی است که Doconut به آن نیاز دارد؛ libgdiplus لازم نیست.

وابستگی‌های آن یک مجموعهٔ قلم پایه (DejaVu) را می‌آورد، بنابراین اسناد بلافاصله رندر می‌شوند. سندی که قلمی را درخواست می‌کند که سرور آن را ندارد — Calibri، Arial یا Times New Roman در یک تصویر لینوکس معمولی — به‌جای آن نزدیک‌ترین قلم نصب‌شده را دریافت می‌کند، بنابراین متن ممکن است عرض متفاوتی داشته باشد و شکست خطوط می‌تواند با ویندوز متفاوت باشد. برای خروجی نزدیک‌تر به ویندوز، جایگزین‌های سازگار با متریک fonts-liberation، fonts-crosextra-carlito و fonts-crosextra-caladea را نصب کنید؛ برای اسکریپت‌های دیگر fonts-noto-core یا fonts-noto-cjk را اضافه کنید، یا فایل‌های خودتان .ttf/.otf را به داخل /usr/share/fonts/ کپی کنید و fc-cache -f را اجرا کنید.

توزیع‌های Alpine و دیگر توزیع‌های مبتنی بر musl پشتیبانی نمی‌شوند.

کجا چه چیزی را تنظیم کنیم

چه می‌خواهیدتنظیم کنید
صفحات واضح‌ترImageResolution در پیکربندی فرمت
جستجوی دقیق متن در HTML/EPUB/email/MHT/MPPDefaultRender = false در پیکربندی فرمت
حافظه کمتر برای اسناد بزرگCachePages = false, جلسات را به‌صورت صریح ببندید
مهر خودتان بر هر صفحهDocOptions.Watermark

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