Render İşlem Hattı

Belgeden sayfa görüntülerine

OpenDocumentAsync ile tarayıcıya ulaşan PNG arasında iki ayrı aşama bulunur: görüntüleyici çözümlemesi (belgeyi hangi motorun yüklediği, her açılışta bir kez karar verilir) ve sayfa işleme (her istekte her sayfa görüntüsüyle ne olduğunun). İkisini de bilmek, bir formatın neden bu şekilde render edildiğini ve DefaultRender'nin gerçekte neyi değiştirdiğini açıklar.

Aşama 1 — Format görüntüleyicisinin çözülmesi

Fabrika, dosya uzantısını format kataloğu aracılığıyla bir görüntüleyiciye eşler ve üç öncelik seviyesine sahiptir:

  1. Özel görüntüleyiciler önce. DoconutOptions.RegisterViewer(extension, factory, defaultConfig?) ile kaydettiğiniz her şey yerleşik olanların tümüne üstün gelir.
  2. Yerleşik aile görüntüleyicileri. Katalog, her görüntülenebilir uzantıyı bir görüntüleyici ailesine eşler — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — her biri kendi motor adaptörüne sahiptir. Aynı uzantı için lisanslı bir eklenti bir görüntüleyici sağlarsa, eklenti görüntüleyicisi yerleşik olanı değiştirir. AddDoconut(), kayıtlı eklenti haklarını başlangıçta doğrular; fabrikanın yerleşik görüntüleyiciye geri dönmesi savunmacı bir çalışma zamanı kuralıdır.
  3. Yalnızca eklenti formatları. Bazı uzantıların hiç yerleşik görüntüleyicisi yoktur — DICOM (.dcm) yalnızca DICOM eklentisi aracılığıyla bulunur. Gerekli yetenek olmadan birini açmak şu hatayı verir:
text
LicenseException: This document type requires the 'Dicom' plugin license.

Hiçbir görüntüleyicinin talep etmediği bir uzantı şu hatayı verir:

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

Çözümlemeden sonra yapılandırma belirlenir: eğer bir tane gönderdiyseniz açık yapılandırma nesneniz, aksi takdirde katalogdan formatın varsayılan yapılandırması. DocOptions.Password, korumalı belgeler için yapılandırmaya kopyalanır.

Aşama 1b — Yönlendirme modu (DefaultRender = false)

Çoğu format bazlı yapılandırma, bir DefaultRender bayrağı ortaya çıkarır. Bu bayrak iki temelde farklı yolu seçer:

  • DefaultRender = true — belge yerel olarak render edilir, doğrudan sayfa görüntülerine.
  • DefaultRender = false — belge önce bellekte bir PDF'ye dönüştürülür, kaynak motor serbest bırakılır ve bir PDF görüntüleyici devralır. Oluşturulan PDF gerçek metni gömerek, tam metin aramanın piksel‑doğru yerel vurgular almasını sağlar; işlem hattı yönlendirilmiş PDF için AllowSearch ve AllowCopy'yi etkinleştirir çünkü dönüşüm kullanıcıya görünmez.

XPS ve katalogun MHT için varsayılanı yönlendirme yolunu kullanır. PDF projeksiyonu, HTML ve Microsoft Project gibi formatlar için yerel arama sağlayabilir. Oluşan PDF bir metin katmanı olmadan görüntüler içeriyorsa, standart görüntüleyici bu pikselleri arayamaz.

Belge açıldığında önceden bir dönüşüm maliyetiyle metin içeren bir PDF projeksiyonuna ihtiyacınız olduğunda yönlendirme modunu kullanın.

Aşama 2 — Sayfa‑görüntü işlem hattı

Render edilen sayfalar, her istek başına sabit bir sıra ile işlenir:

text
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response
  • Filigran — lisans durumundan (eksik lisans, süresi dolmuş geçici veya abonelik, geçersiz domain, yanlış sürüm) ve kendi özel metniniz için DocOptions.Watermark'den uygulanır. Uygun şekilde lisanslı bir uygulama — ya da aktif bir Geçici lisans — özel bir filigran içermiyorsa bu adımı atlar.
  • Döndür/çevir — kullanıcının widget'ta ayarladığı sayfa bazlı durum (90°/180°/270°, yatay/dikey çevirme) oturumda saklanır ve o sayfanın sonraki her render'ında uygulanır.
  • Ölçek — küçük resimler ve yakınlaştırma seviyeleri, render edilen sayfanın istenen hedef boyuta ölçeklendirilmesiyle üretilir; 0, orijinal boyutta sunulması anlamına gelir.
  • Açıklama yakma — kaydedilmiş açıklamalar bitmap üzerine çizilir, böylece dışa aktarmalar ve sayfa görüntüleri bunları gösterir.
  • Kodlama — sonuç, havuzlanmış bellek akışları kullanılarak PNG'ye kodlanır ve doğrudan HTTP yanıtına yazılır.

Ara katmandaki hatalar, HTTP hata sayfaları yerine PNG hata görüntüleri (beyaz üzerinde kırmızı metin) olarak döndürülür, böylece widget bunları sayfa alanında gösterebilir.

Sayfa önbellekleme

BaseConfig.CachePages (varsayılan true), render edilen sayfa görüntülerini belge oturumu süresince bellekte tutar, böylece bir sayfayı yeniden ziyaret etmek yeniden render edilmez. BaseConfig.ImageResolution (25–300 DPI, 0 = format varsayılanı) ana kalite/bellek ayarıdır; her formatın varsayılanı yapılandırma sayfasında belgelenir.

Tek bir düğümde render etme vs. çoklu düğüm

Yukarıdakilerin tümü, belgeyi açan oturum için isteğe bağlı tek bir düğümde render edilmesini açıklar. Bir düğümün tüm artefakt setini render edip yayınladığı ve diğer düğümlerin bu sayfaları paylaşımlı depolamadan hizmet verdiği bir dağıtım, farklı bir okuma yolu kullanır — bkz. Dağıtık Dağıtımlar.

Linux'ta Yazı Tipleri

Sayfalar, sunucuda yüklü yazı tipleriyle çizilir. Linux'ta, ilk belge açılmadan önce yazı tipi yapılandırma kütüphanesini kurun (RHEL ve Fedora'da fontconfig):

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

Olmazsa, bir belge açma The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation. hatası verir. Bu, Doconut'un ihtiyaç duyduğu tek sistem paketidir; libgdiplus gerekli değildir.

Bağımlılıkları temel bir yazı tipi seti (DejaVu) getirir, böylece belgeler kutudan çıkar çıkmaz render olur. Sunucunun sahip olmadığı bir yazı tipini isteyen bir belge — tipik bir Linux imajında Calibri, Arial veya Times New Roman — bunun yerine en yakın yüklü yazı tipini alır, bu yüzden metin farklı bir genişlik alabilir ve satır sonları Windows'tan farklı olabilir. Windows'a daha yakın çıktı için, metrik‑uyumlu ikameleri fonts-liberation, fonts-crosextra-carlito ve fonts-crosextra-caladea kurun; diğer betikler için fonts-noto-core veya fonts-noto-cjk ekleyin, ya da kendi .ttf/.otf dosyalarınızı /usr/share/fonts/ içine kopyalayın ve fc-cache -f çalıştırın.

Alpine ve diğer musl tabanlı dağıtımlar desteklenmez.

Nerede neyi ayarlamalısınız

İstediğinizAyar
Daha keskin sayfalarImageResolution format yapılandırmasında
HTML/EPUB/e-posta/MHT/MPP'de doğru metin aramaDefaultRender = false format yapılandırmasında
Büyük belgelerde daha az bellekCachePages = false, oturumları açıkça kapatın
Her sayfada kendi damganızDocOptions.Watermark

Bu sayfa yardımcı oldu mu?