Pipeline de rendu
Du document aux images de pages
Entre OpenDocumentAsync et le PNG qui atteint le navigateur, il y a deux étapes distinctes : résolution du visionneur (quel moteur charge le document, décidé une fois par ouverture) et traitement de la page (ce qui arrive à chaque image de page à chaque requête). Connaître les deux explique pourquoi un format s'affiche de telle manière — et ce que DefaultRender change réellement.
Étape 1 — Résolution du visionneur de format
La fabrique associe l'extension de fichier à un visionneur via le catalogue de formats, avec trois niveaux de priorité :
- Visionneurs personnalisés d'abord. Tout ce que vous avez enregistré avec
DoconutOptions.RegisterViewer(extension, factory, defaultConfig?)l'emporte sur tous les intégrés. - Visionneurs de famille intégrés. Le catalogue associe chaque extension affichable à une famille de visionneurs — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — chacune avec son propre adaptateur de moteur. Si un plugin sous licence fournit un visionneur pour la même extension, le visionneur du plugin remplace celui intégré.
AddDoconut()valide les droits du plugin enregistrés au démarrage ; le recours du fabriquant au visionneur intégré est une règle défensive d'exécution. - Formats uniquement via plugin. Certaines extensions n'ont aucun visionneur intégré — DICOM (
.dcm) n'existe que via le plugin DICOM. Ouvrir l'une d'elles sans la capacité requise génère :
LicenseException: This document type requires the 'Dicom' plugin license.Une extension non revendiquée par un visionneur déclenche :
FormatNotSupportedException: Document format '<extension>' is not supported.Après résolution, la configuration est fixée : votre objet de configuration explicite si vous en avez fourni un, sinon la configuration par défaut du format provenant du catalogue. DocOptions.Password est copié dans la configuration pour les documents protégés.
Étape 1b — Mode de redirection (DefaultRender = false)
La plupart des configurations par format exposent un drapeau DefaultRender. Il sélectionne entre deux chemins fondamentalement différents :
DefaultRender = true— le document s'affiche nativement, directement en images de pages.DefaultRender = false— le document est d'abord converti en PDF en mémoire, le moteur source est libéré, et un visionneur PDF prend le relais. Le PDF généré intègre du texte réel, ainsi la recherche en texte intégral obtient des surlignages natifs pixel-perfect ; le pipeline forceAllowSearchetAllowCopyactivés pour le PDF redirigé puisque la conversion est invisible pour l'utilisateur.
XPS et la valeur par défaut du catalogue pour MHT utilisent le chemin de redirection. Une projection PDF peut fournir une recherche native pour des formats tels que HTML et Microsoft Project. Si le PDF résultant contient des images sans couche de texte, le visionneur standard ne peut pas rechercher ces pixels.
Utilisez le mode de redirection lorsque vous avez besoin d'une projection PDF contenant du texte — au prix d'une conversion initiale lors de l'ouverture du document.
Étape 2 — Le pipeline d'images de pages
Les pages rendues sont traitées à chaque requête selon une séquence fixe :
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response- Filigrane — appliqué à partir de l'état de la licence (licence manquante, temporaire ou d'abonnement expirée, domaine invalide, mauvaise version) et depuis
DocOptions.Watermarkpour votre texte personnalisé. Une application correctement licenciée — ou une licence Temporaire active — sans filigrane personnalisé saute cette étape. - Rotation/retournement — l'état par page que l'utilisateur définit dans le widget (90°/180°/270°, retournements horizontaux/verticaux) est stocké dans la session et appliqué à chaque rendu ultérieur de cette page.
- Échelle — les miniatures et niveaux de zoom sont produits en redimensionnant la page rendue à la taille cible demandée ;
0signifie servir à la taille originale. - Gravure d'annotation — les annotations sauvegardées sont dessinées sur le bitmap afin que les exportations et images de pages les affichent.
- Encodage — le résultat est encodé en PNG en utilisant des flux mémoire mis en commun et écrit directement dans la réponse HTTP.
Les erreurs à l'intérieur du middleware sont renvoyées sous forme d'images d'erreur PNG (texte rouge sur fond blanc) plutôt que des pages d'erreur HTTP, afin que le widget puisse les afficher dans la zone de la page.
Mise en cache des pages
BaseConfig.CachePages (par défaut true) conserve les images de pages rendues en mémoire pendant toute la durée de la session du document, de sorte que revisiter une page ne la rend pas à nouveau. BaseConfig.ImageResolution (25–300 DPI, 0 = valeur par défaut du format) est le principal réglage qualité/mémoire ; la valeur par défaut de chaque format est documentée sur sa page de configuration.
Rendu sur un nœud vs. plusieurs
Tout ce qui précède décrit un rendu sur un seul nœud à la demande pour la session qui a ouvert le document. Un déploiement où un nœud rend et publie l'ensemble complet des artefacts, et d'autres nœuds servent ces pages depuis un stockage partagé, utilise un chemin de lecture différent — voir Déploiements distribués.
Polices sous Linux
Les pages sont dessinées avec les polices installées sur le serveur. Sous Linux, installez la bibliothèque de configuration des polices avant que le premier document ne s'ouvre (fontconfig sur RHEL et Fedora) :
apt-get update && apt-get install -y libfontconfig1Sans cela, l'ouverture d'un document échoue avec The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. C'est le seul paquet système dont Doconut a besoin ; libgdiplus n'est pas requis.
Ses dépendances apportent un jeu de polices de base (DejaVu), de sorte que les documents s'affichent immédiatement. Un document qui demande une police que le serveur ne possède pas — Calibri, Arial ou Times New Roman sur une image Linux typique — obtient la police installée la plus proche, ainsi le texte peut avoir une largeur différente et les sauts de ligne peuvent différer de Windows. Pour un rendu plus proche de Windows, installez les substituts métriquement compatibles fonts-liberation, fonts-crosextra-carlito et fonts-crosextra-caladea ; ajoutez fonts-noto-core ou fonts-noto-cjk pour d'autres scripts, ou copiez vos propres fichiers .ttf/.otf dans /usr/share/fonts/ et exécutez fc-cache -f.
Alpine et les autres distributions basées sur musl ne sont pas prises en charge.
Où ajuster quoi
| Vous voulez | Ajuster |
|---|---|
| Pages plus nettes | ImageResolution sur la configuration du format |
| Recherche de texte précise sur HTML/EPUB/email/MHT/MPP | DefaultRender = false sur la configuration du format |
| Moindre consommation de mémoire sur de gros documents | CachePages = false, fermer les sessions explicitement |
| Votre propre tampon sur chaque page | DocOptions.Watermark |
Cette page était-elle utile ?