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 sürdüğü. Bu kılavuz, etkileri sırasına göre kolları anlatır.
Çözünürlük — en büyük kol
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'dir.
// 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örtte birine düşürür — 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) çıktı boyutunu sınırlar.
Sayfa önbellekleme — bellek vs. yeniden render
BaseConfig.CachePages (varsayılan true) oturum süresi boyunca her render edilmiş sayfayı bellekte tutar. Bu, 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 tutmaktan ziyade görüntü başına CPU ödemeyi tercih edersiniz.
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, görünüm başına bir ö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) render edilmiş sayfalarını, kayar TimeOut (varsayılan 60 dakika) son istekten itibaren geçene 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ı doğru ayarlayın. Kullanıcıların iki dakika göz attığı bir önizleme bir saatlik oturuma ihtiyaç duymaz:
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Değiş tokuşu hatırlayı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:
MemoryOptimizationPreferencevarsayı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 bellekten bir miktar hız kazancı içinfalseolarak ayarlayın;SheetNames/PrintArearender'ı sadece önemli olana sınırlayın. - Yönlendirme modu önceden bir maliyet gerektirir:
DefaultRender = falsebelgeyi tamamen PDF'ye açılışta 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 üzerindeki Word/PPT: eksik fontlar yavaş geri dönüş taramasına ve hatalı ölçümlere neden olur;
FontFolders'ı fontlarınızın bulunduğu bir dizine yönlendirin. - Linux üzerindeki Sunumlar:
libgdiplusveyaSystem.Drawing.EnableUnixSupportanahtarına gerek yok — bkz. Linux'ta Fontlar.
İ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 render etmeyin.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#ViewerConfigeşlediğinizde, küçük ekranlar içinFixedZoomPercentMobile'ı (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 iş; 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 kol daha büyük bir ayar değildir — bir belgenin artefaktlarını bir kez ortak depolamaya yayınlamak ve her düğümün bunları hizmet vermesini sağlamaktır. Bu, maliyet modelini değiştirir: render, oturum başına bir kez yerine belge başına bir kez gerçekleşir ve sayfa istekleri dosya okumasına dönüşür. Bkz. Dağıtık Dağıtımlar.
Bir ayarlama kontrol listesi
- UX'inizin kabul edebileceği en düşük
ImageResolution'yi ayarlayın. CachePages'yi etkileşimli görüntüleme için açık tutun; tek geçiş veya yüksek eşzamanlılık senaryoları için kapatın.- Oturumları açıkça kapatın; kullanım patlamalı olduğunda
TimeOut'yi kısaltın. - Büyük belgeler için istemci tarafında
LargeDoc+ varsayılanAutoLoad = falsekullanın. - Metin içeren PDF projeksiyonuna ihtiyaç duyduğunuzda sadece
DefaultRender = falsekullanın.
Bu sayfa yardımcı oldu mu?