Renderleme Boru Hattı

Belgeden sayfa görüntülerine

OpenDocumentAsync ile tarayıcıya ulaşan PNG arasında iki ayrı aşama vardır: görüntüleyici çözümlemesi (belgeyi hangi motorun yüklediği, her açılışta bir kez belirlenir) ve sayfa işleme (her istekte her sayfa görüntüsüyle ne olduğu). İ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 üzerine çıkar.
  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 — ve her birinin kendi motor adaptörü vardır. Aynı uzantı için lisanslı bir eklenti bir görüntüleyici sağlarsa, eklenti görüntüleyicisi yerleşik olanın yerini alır. AddDoconut(), kayıtlı eklenti haklarını başlangıçta doğrular; fabrikanın yerleşik görüntüleyiciye geri dönmesi savunma amaçlı 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 açmaya çalışmak şu hatayı verir:
text
LicenseException: This document type requires the 'Dicom' plugin license.

Bir uzantı için hiçbir görüntüleyici bulunamadığında şu hata ortaya çıkar:

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

Çözümleme sonrası yapılandırma belirlenir: eğer bir yapılandırma nesnesi sağladıysanız o nesne, 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ğı sunar. 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 devreye girer. Oluşturulan PDF gerçek metni gömerek, tam metin aramasının piksel‑doğru yerel vurgular almasını sağlar; boru hattı, dönüşüm kullanıcıya görünmediği için yönlendirilmiş PDF'de AllowSearch ve AllowCopy'yi etkinleştirir.

XPS ve katalogdaki MHT 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 ihtiyaç duyduğunuzda yönlendirme modunu kullanın.

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

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

text
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response
  • Watermark — 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 lisansa sahip bir uygulama — ya da aktif bir Geçici lisans — özel bir filigran yoksa bu adımı atlar.
  • Rotate/flip — kullanıcı widget içinde ayarladığı sayfa başına durum (90°/180°/270°, yatay/dikey çevirme) oturumda saklanır ve o sayfanın sonraki her render'ında uygulanır.
  • Scale — küçük resimler ve yakınlaştırma seviyeleri, render edilen sayfa istenen hedef boyuta ölçeklenerek üretilir; 0, orijinal boyutta sunulması anlamına gelir.
  • Annotation burn — kaydedilmiş açıklamalar bitmap üzerine çizilir, böylece dışa aktarımlar ve sayfa görüntüleri bunları gösterir.
  • Encoding — 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 belgelenmiştir.

Tek bir düğümde renderleme vs. birden çok düğümde

Yukarıdakilerin tümü, belgeyi açan oturum için talep üzerine tek bir düğümün render etmesini açıklar. Bir düğümün tüm artefakt setini render edip yayımladığı 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 (fontconfig RHEL ve Fedora için):

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

Bu olmadan, 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ıyla başarısız olur. 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ı tipi 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ıp 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 sayfalarformat yapılandırmasında ImageResolution
HTML/EPUB/e-posta/MHT/MPP'de doğru metin aramaformat yapılandırmasında DefaultRender = false
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?