Performance-Optimierung

Rendern und Speicher optimieren

Das Ressourcenprofil von Doconut wird von drei Dingen dominiert: Render-DPI, was im Cache bleibt und wie lange Sitzungen leben. Dieser Leitfaden führt die Stellschrauben in Reihenfolge ihrer Wirkung.

Auflösung — die größte Stellschraube

ImageResolution (25–300 DPI) bestimmt sowohl die Renderzeit als auch die Bildgröße. Die meisten Formate haben standardmäßig 200 DPI; Bilder und PSD haben standardmäßig 100.

csharp
// Eine Vorschau der Dokumentenliste benötigt keine Druckqualität
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

Eine Halbierung des DPI reduziert ungefähr die Pixelanzahl pro Seite auf ein Viertel — schnellere Renderings, kleinere Übertragungen, weniger Cache‑Speicher. Reservieren Sie 250–300 DPI für stark zoom‑intensive Anwendungsfälle (CAD, technische Zeichnungen).

Bei PDFs mit umfangreichen eingebetteten Bildern fügt PdfConfig feinere Stellschrauben hinzu: CompressImages + CompressQuality, ResizeImages + ResizeResolution und CompressFast. Für reine Bilder begrenzt ImageConfig.MaxImagePixelSize (Standard 3000 px) die Ausgabengröße.

Seiten‑Caching — Speicher vs. Neu‑Rendern

BaseConfig.CachePages (Standard true) hält jede gerenderte Seite für die gesamte Sitzungsdauer im Speicher. Das ist die richtige Voreinstellung für interaktives Betrachten — Nutzer scrollen hin und her. Deaktivieren Sie es, wenn:

  • Dokumente sind riesig und werden einmalig von vorne bis hinten betrachtet,
  • Viele gleichzeitige Sitzungen würden die gecachten Seiten vervielfachen,
  • Sie lieber CPU pro Ansicht bezahlen möchten, anstatt RAM zu belegen.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

Auf dem Client lädt ViewerConfig.CacheEnabled = true ein kleines, sich bewegendes Fenster mit kommenden Seitenbildern im Browser‑Speicher vor. Es ist ein per‑View‑Prefetch‑Cache, kein permanenter localStorage.

Sitzungen — der Speicher, den Sie nicht sehen

Jede offene Sitzung hält das geparste Dokumentenmodell plus (mit CachePages) seine gerenderten Seiten, bis das gleitende TimeOut (Standard 60 Minuten) seit der letzten Anforderung abläuft. Zwei Gewohnheiten halten dies unter Kontrolle:

  • Schließen Sie, was Sie nicht mehr benötigen. viewer.CloseDocument(token) gibt die Engine sofort frei, anstatt das Leerlauffenster abzuwarten.
  • Passen Sie die Zeitüberschreitung an. Eine Vorschau, die Nutzer für zwei Minuten ansehen, benötigt keine einstündige Sitzung:
csharp
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

Beachten Sie den Kompromiss: Nach Ablauf zeigt das Widget Document session not found. Please re-open document. — wählen Sie eine Zeitüberschreitung, die zu echten Lesesitzungen passt.

Format‑spezifische Schalter

  • Excel: MemoryOptimizationPreference ist standardmäßig aktiviert und reduziert den Speicherverbrauch beim Rendern sehr großer Arbeitsmappen — lassen Sie es aktiviert, oder setzen Sie es auf false, wenn Sie Speicher für einen kleinen Geschwindigkeitsgewinn eintauschen möchten; SheetNames / PrintArea beschränken das Rendern auf das Wesentliche.
  • Redirect‑Modus hat eine Vorabkosten: DefaultRender = false konvertiert das gesamte Dokument beim Öffnen in PDF. Das ermöglicht native textbasierte Suche, aber bei einem 500‑Seiten‑Dokument trägt der Öffnungsaufruf diese Konvertierung — aktivieren Sie es nicht reflexartig.
  • Word/PPT unter Linux/Docker: Fehlende Schriften verursachen langsames Fallback‑Probing und falsche Metriken; verweisen Sie FontFolders auf ein Verzeichnis mit Ihren Schriften.
  • Präsentationen unter Linux: kein libgdiplus‑ oder System.Drawing.EnableUnixSupport‑Schalter ist nötig — siehe Schriften unter Linux.

Client‑seitige Strategien

  • LargeDoc = true — Lazy‑Load‑Strategie für sehr große Dokumente; Seiten werden geladen, wenn der Nutzer sich ihnen nähert.
  • AutoLoad = false (Standard) — nicht rendern, bis Sie tatsächlich View(token) aufrufen.
  • ShowThumbs = false — Thumbnail‑Erstellung/Anfragen für einseitige oder eingebettete Vorschauen überspringen.
  • Das Aktivieren von FixedZoom verhindert freie Zoom‑Änderungen; wenn Sie ein C#‑ViewerConfig zuordnen, stellen Sie FixedZoomPercentMobile (C#‑Standard 75) für kleine Bildschirme ein.

Einmal starten, nicht pro Anfrage

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) gehört zu Program.cs — das Registrieren von Codierungen pro Anfrage ist unnötige Arbeit; das komplette Vergessen führt zu Problemen mit alten Code‑Page‑Dokumenten.

Arbeit über Knoten verteilen

Alles oben stellt das Rendering eines einzelnen Knotens bei Bedarf ein. Wenn ein einzelner Knoten die Last nicht bewältigen kann, ist die nächste Stellschraube kein größerer Drehregler — sondern das einmalige Veröffentlichen der Dokumentartefakte in gemeinsam genutztem Speicher und das Bereitstellen durch jeden Knoten. Das ändert das Kostenmodell: Rendering erfolgt einmal pro Dokument statt einmal pro Sitzung, und Seitenanfragen werden zu Dateizugriffen. Siehe Verteilte Bereitstellungen.

Eine Optimierungs‑Checkliste

  1. Setzen Sie das niedrigste ImageResolution, das Ihre UX akzeptiert.
  2. Lassen Sie CachePages für interaktives Betrachten aktiviert; deaktivieren Sie es für Einmal‑Durchläufe oder Szenarien mit hoher Parallelität.
  3. Schließen Sie Sitzungen explizit; verkürzen Sie TimeOut, wenn die Nutzung sprunghaft ist.
  4. Verwenden Sie LargeDoc + den Standard‑AutoLoad = false auf dem Client für große Dokumente.
  5. Nutzen Sie DefaultRender = false nur, wenn Sie eine textbasierte PDF‑Projektion benötigen.

War diese Seite hilfreich?