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

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

Between OpenDocumentAsync and the PNG that reaches the browser there are two distinct stages: حل‌کنندهٔ نمایشگر (موتوری که سند را بارگذاری می‌کند، یک‌بار برای هر باز کردن تصمیم‌گیری می‌شود) and پردازش صفحه (آنچه برای هر تصویر صفحه در هر درخواست رخ می‌دهد). Knowing both explains why a format renders the way it does — and what DefaultRender really switches.

مرحله 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 تولید شده متن واقعی را در خود جای می‌دهد، بنابراین جستجوی تمام متن، هایلایت‌های بومی دقیق به‌پیکسل را دریافت می‌کند؛ خط لوله AllowSearch و AllowCopy را برای PDF تغییر مسیر فعال می‌کند چون تبدیل برای کاربر نامرئی است.

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

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