Optimisation des performances
Optimiser le rendu et la mémoire
Le profil de ressources de Doconut est dominé par trois éléments : DPI de rendu, ce qui reste en cache, et la durée de vie des sessions. Ce guide parcourt les leviers par ordre d'impact.
Résolution — le levier le plus important
ImageResolution (25–300 DPI) influence à la fois le temps de rendu et la taille de l'image. La plupart des formats utilisent 200 DPI par défaut ; les images et les PSD utilisent 100 par défaut.
// Un aperçu de la liste de documents n’a pas besoin de qualité d’impression
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });Diviser le DPI par deux réduit d'environ un facteur quatre le nombre de pixels par page — rendus plus rapides, transferts plus petits, moins de mémoire cache. Réservez 250–300 DPI pour les cas d'utilisation nécessitant un fort zoom (CAO, dessins techniques).
Pour les PDF contenant de nombreuses images intégrées, PdfConfig ajoute des réglages plus fins : CompressImages + CompressQuality, ResizeImages + ResizeResolution, et CompressFast. Pour les images simples, ImageConfig.MaxImagePixelSize (par défaut 3000 px) limite la taille de sortie.
Mise en cache des pages — mémoire vs. nouveau rendu
BaseConfig.CachePages (par défaut true) conserve chaque page rendue en mémoire pendant toute la durée de la session. C'est le réglage par défaut approprié pour la visualisation interactive — les utilisateurs font défiler le document en avant et en arrière. Désactivez-le lorsque :
- les documents sont volumineux et visualisés une seule fois, de la première à la dernière page,
- de nombreuses sessions concurrentes multiplieraient les pages en cache,
- vous préférez consommer du CPU par visualisation plutôt que de retenir de la RAM.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });Côté client, ViewerConfig.CacheEnabled = true précharge une petite fenêtre mobile d'images de pages à venir dans la mémoire du navigateur. Il s'agit d'un cache de prélecture par visualisation, pas d'un localStorage persistant.
Sessions — la mémoire invisible
Chaque session ouverte conserve le modèle de document analysé ainsi que (avec CachePages) ses pages rendues, jusqu'à ce que le TimeOut glissant (par défaut 60 minutes) expire depuis la dernière requête. Deux bonnes pratiques permettent de maîtriser cela :
- Fermez ce dont vous avez fini.
viewer.CloseDocument(token)libère le moteur immédiatement au lieu d'attendre la fenêtre d'inactivité. - Ajustez correctement le délai d'expiration. Un aperçu que les utilisateurs consultent pendant deux minutes n'a pas besoin d'une session d'une heure :
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Gardez à l'esprit le compromis : après expiration le widget affiche Document session not found. Please re-open document. — choisissez un délai qui correspond aux vraies sessions de lecture.
Commutateurs spécifiques aux formats
- Excel :
MemoryOptimizationPreferenceest activé par défaut et réduit l'empreinte mémoire lors du rendu de très grands classeurs — laissez-le activé, ou réglez-le surfalsesi vous êtes prêt à échanger de la mémoire contre un léger gain de vitesse ;SheetNames/PrintArealimitent le rendu à ce qui est pertinent. - Le mode de redirection a un coût initial :
DefaultRender = falseconvertit le document entier en PDF lors de l'ouverture. Cela permet une recherche native basée sur le texte, mais sur un document de 500 pages l'appel d'ouverture implique cette conversion — ne l'activez pas de façon réflexive. - Word/PPT sous Linux/Docker : l'absence de polices entraîne une recherche de secours lente et des métriques incorrectes ; pointez
FontFoldersvers un répertoire contenant vos polices. - Présentations sous Linux : aucun commutateur
libgdiplusouSystem.Drawing.EnableUnixSupportn'est nécessaire — voir Polices sous Linux.
Stratégies côté client
LargeDoc = true— stratégie de chargement paresseux pour les documents très volumineux ; les pages se chargent à mesure que l'utilisateur s'en approche.AutoLoad = false(par défaut) — ne pas rendre tant que vous n'appelez pas réellementView(token).ShowThumbs = false— ignorer la génération/demande de miniatures pour les aperçus d'une seule page ou intégrés.- Activer
FixedZoomévite les changements de zoom libres ; lorsque vous mappez unViewerConfigC#, ajustezFixedZoomPercentMobile(valeur par défaut C# 75) pour les petits écrans.
Démarrage unique, pas par requête
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) appartient à Program.cs — enregistrer les encodages par requête est un travail gaspillé ; l'oublier complètement casse les documents legacy basés sur des pages de code.
Répartition du travail sur plusieurs nœuds
Tout ce qui précède ajuste le rendu d'un nœud à la demande. Lorsqu'un nœud unique ne peut absorber la charge, le levier suivant n'est pas un réglage plus important — il s'agit de publier les artefacts d'un document une fois dans un stockage partagé et de laisser chaque nœud les servir. Cela modifie le modèle de coût : le rendu s'effectue une fois par document au lieu d'une fois par session, et les requêtes de pages deviennent des lectures de fichiers. Voir Déploiements distribués.
Liste de vérification de l'optimisation
- Définissez le plus bas
ImageResolutionque votre UX accepte. - Gardez
CachePagesactivé pour la visualisation interactive ; désactivé pour les scénarios à passage unique ou à forte concurrence. - Fermez les sessions explicitement ; raccourcissez
TimeOutlorsque l'utilisation est ponctuelle. - Utilisez
LargeDoc+ leAutoLoad = falsepar défaut côté client pour les gros documents. - Utilisez
DefaultRender = falseuniquement lorsque vous avez besoin d'une projection PDF contenant du texte.
Cette page était-elle utile ?