Performans Ayarlaması

Render ve belleği optimize edin

Doconut'un kaynak profili üç şey tarafından hâkimdir: render DPI, önbellekte ne kalır ve oturumların ne kadar uzun yaşadığı. Bu kılavuz, etkileri sırasına göre kaldıraçları anlatır.

Çözünürlük — en büyük kaldıraç

ImageResolution (25–300 DPI) hem render süresini hem de görüntü boyutunu belirler. Çoğu format varsayılan olarak 200 DPI; görüntüler ve PSD varsayılan olarak 100 DPI kullanır.

csharp
// Bir belge listesi önizlemesi baskı kalitesine ihtiyaç duymaz
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

DPI'yi yarıya indirmek, sayfa başına piksel sayısını yaklaşık olarak dörde indirir — daha hızlı renderlar, daha küçük transferler, daha az önbellek belleği. Yakınlaştırma yoğun kullanım durumları (CAD, mühendislik çizimleri) için 250–300 DPI ayırın.

Ağır gömülü görseller içeren PDF'lerde, PdfConfig daha ince ayarlar ekler: CompressImages + CompressQuality, ResizeImages + ResizeResolution ve CompressFast. Düz görüntüler için, ImageConfig.MaxImagePixelSize (varsayılan 3000 px) çıkış boyutunu sınırlar.

Sayfa önbellekleme — bellek vs. yeniden render

BaseConfig.CachePages (varsayılan true) oturum süresi boyunca her renderlanmış sayfayı bellekte tutar. Etkileşimli görüntüleme için doğru varsayılandır — kullanıcılar ileri geri kaydırır. Şu durumlarda kapatın:

  • belgeler çok büyük ve bir kez, baştan sona görüntüleniyor,
  • çok sayıda eşzamanlı oturum önbellekli sayfaları katlayacaktır,
  • RAM tutmak yerine görüntü başına CPU ödemeyi tercih edersiniz.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

İstemci tarafında, ViewerConfig.CacheEnabled = true tarayıcı belleğinde yaklaşan sayfa görüntülerinin küçük bir hareketli penceresini önceden yükler. Bu, per-view önceden getirme önbelleğidir, kalıcı localStorage değildir.

Oturumlar — görmediğiniz bellek

Açık her oturum, ayrıştırılmış belge modelini ve (CachePages ile) renderlanmış sayfalarını, kayar TimeOut (varsayılan 60 dakika) son istekten itibaren dolana kadar tutar. Bu durumu kontrol altında tutan iki alışkanlık:

  • İşiniz bittiğinde kapatın. viewer.CloseDocument(token) motoru hemen serbest bırakır, boş bekleme penceresini beklemek yerine.
  • Zaman aşımını uygun boyuta ayarlayın. Kullanıcıların iki dakika baktığı bir önizleme bir saatlik oturuma ihtiyaç duymaz:
csharp
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

Değiş tokuşu unutmayın: süresi dolduktan sonra widget Document session not found. Please re-open document. gösterir — gerçek okuma oturumlarıyla eşleşen bir zaman aşımı seçin.

Formata özgü ayarlar

  • Excel: MemoryOptimizationPreference varsayılan olarak açıktır ve çok büyük çalışma kitaplarını render ederken bellek ayak izini azaltır — açık bırakın, ya da bellek karşılığında küçük bir hız artışı istiyorsanız false olarak ayarlayın; SheetNames / PrintArea renderı sadece önemli olana sınırlayarak.
  • Yönlendirme modu önceden bir maliyet gerektirir: DefaultRender = false belgeyi tamamen açılışta PDF'ye dönüştürür. Yerel metin tabanlı arama sağlar, ancak 500 sayfalık bir belgede açma çağrısı bu dönüşümü taşır — otomatik olarak etkinleştirmeyin.
  • Linux/Docker'da Word/PPT: eksik yazı tipleri yavaş geri dönüş denemelerine ve hatalı ölçümlere neden olur; FontFolders'i yazı tiplerinizin bulunduğu bir dizine yönlendirin.
  • Linux'ta Sunumlar: libgdiplus veya System.Drawing.EnableUnixSupport anahtarı gerekmez — bakınız Linux'ta Yazı Tipleri.

İstemci tarafı stratejileri

  • LargeDoc = true — çok büyük belgeler için tembel yükleme stratejisi; sayfalar kullanıcı yaklaştıkça yüklenir.
  • AutoLoad = false (varsayılan) — View(token)'ı gerçekten çağırana kadar renderlamayın.
  • ShowThumbs = false — tek sayfalı veya gömülü önizlemeler için küçük resim oluşturmayı/isteklerini atlayın.
  • FixedZoom'ı etkinleştirmek serbest biçimli yakınlaştırma değişikliklerini önler; bir C# ViewerConfig eşlediğinizde, küçük ekranlar için FixedZoomPercentMobile'ı (C# varsayılanı 75) ayarlayın.

Tek seferlik başlangıç, istek başına değil

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance), Program.cs içinde bulunmalıdır — kodlamaları istek başına kaydetmek boşa harcanan bir iştir; tamamen unutmak eski kod sayfası belgelerini bozar.

İş yükünü düğümler arasında dağıtma

Yukarıdakiler, talep üzerine tek bir düğümün renderını ayarlar. Tek bir düğüm yükü kaldıramadığında, bir sonraki kaldıraç daha büyük bir ayar değildir — bir belgenin artefaktlarını bir kez ortak depolamaya yayınlamak ve her düğümün bunları sunmasını sağlamaktır. Bu, maliyet modelini değiştirir: renderlama belge başına bir kez, oturum başına bir kez yerine gerçekleşir ve sayfa istekleri dosya okuma haline gelir. Bkz. Dağıtık Dağıtımlar.

Bir ayarlama kontrol listesi

  1. UX'inizin kabul edebileceği en düşük ImageResolution ayarlayın.
  2. Etkileşimli görüntüleme için CachePages'ı açık tutun; tek geçiş veya yüksek eşzamanlılık senaryoları için kapalı.
  3. Oturumları açıkça kapatın; kullanım patlamalı olduğunda TimeOut'ı kısaltın.
  4. Büyük belgeler için istemci tarafında LargeDoc + varsayılan AutoLoad = false kullanın.
  5. Metin içeren PDF projeksiyonu gerektiğinde sadece DefaultRender = false kullanın.

Bu sayfa yardımcı oldu mu?