Διαδικασία Απόδοσης
Από το έγγραφο στις εικόνες σελίδας
Μεταξύ OpenDocumentAsync και του PNG που φθάνει στον περιηγητή υπάρχουν δύο διακριτά στάδια: viewer resolution (ποιος κινητήρας φορτώνει το έγγραφο, αποφασίζεται μία φορά ανά άνοιγμα) και page processing (τι συμβαίνει σε κάθε εικόνα σελίδας σε κάθε αίτηση). Η γνώση και των δύο εξηγεί γιατί ένα μορφότυπο αποδίδει όπως αποδίδει — και τι DefaultRender πραγματικά αλλάζει.
Στάδιο 1 — Επίλυση του προβολέα μορφότυπου
Το εργοστάσιο αντιστοιχίζει την επέκταση αρχείου σε έναν προβολέα μέσω του καταλόγου μορφότυπων, με τρία επίπεδα προτεραιότητας:
- Προσαρμοσμένοι προβολείς πρώτα. Οτιδήποτε καταχωρίσατε με
DoconutOptions.RegisterViewer(extension, factory, defaultConfig?)υπερισχύει όλων των ενσωματωμένων. - Ενσωματωμένοι προβολείς οικογένειας. Ο κατάλογος αντιστοιχίζει κάθε επεκτάσιμη επέκταση σε μια οικογένεια προβολέα — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — καθεμία με τον δικό της προσαρμογέα κινητήρα. Εάν ένα αδειοδοτημένο πρόσθετο προσφέρει έναν προβολέα για την ίδια επέκταση, ο προβολέας του πρόσθετου αντικαθιστά τον ενσωματωμένο.
AddDoconut()επικυρώνει τις εγγεγραμμένες δικαιοδοσίες πρόσθετου κατά την εκκίνηση· η εναλλακτική του εργοστασίου προς τον ενσωματωμένο προβολέα είναι ένας αμυντικός κανόνας χρόνου εκτέλεσης. - Μορφότυποι μόνο με πρόσθετο. Ορισμένες επεκτάσεις δεν έχουν καθόλου ενσωματωμένο προβολέα — DICOM (
.dcm) υπάρχει μόνο μέσω του πρόσθετου DICOM. Το άνοιγμα ενός χωρίς την απαιτούμενη δυνατότητα ρίχνει:
LicenseException: This document type requires the 'Dicom' plugin license.Μια επέκταση που δεν διεκδικεί προβολέας προκαλεί:
FormatNotSupportedException: Document format '<extension>' is not supported.Μετά την επίλυση, η διαμόρφωση καθορίζεται: το ρητό αντικείμενο διαμόρφωσης εάν το περάσατε, αλλιώς η προεπιλεγμένη διαμόρφωση του μορφότυπου από τον κατάλογο. DocOptions.Password αντιγράφεται στη διαμόρφωση για προστατευμένα έγγραφα.
Στάδιο 1β — Λειτουργία Ανακατεύθυνσης (DefaultRender = false)
Οι περισσότερες διαμορφώσεις ανά μορφότυπο εκθέτουν μια σημαία DefaultRender. Επιλέγει μεταξύ δύο θεμελιωδώς διαφορετικών διαδρομών:
DefaultRender = true— το έγγραφο αποδίδει εγγενώς, απευθείας σε εικόνες σελίδας.DefaultRender = false— το έγγραφο πρώτα μετατρέπεται σε PDF στη μνήμη, η πηγή κινητήρα απελευθερώνεται, και ένας προβολέας PDF παίρνει τον έλεγχο. Το παραγόμενο PDF ενσωματώνει πραγματικό κείμενο, έτσι η αναζήτηση πλήρους κειμένου λαμβάνει εικονοστοιχειώδεις εγγενείς επισημάνσεις· η γραμμή εξαναγκάζει την ενεργοποίηση τωνAllowSearchκαιAllowCopyγια το ανακατευθυνόμενο PDF επειδή η μετατροπή είναι αόρατη στον χρήστη.
Το XPS και η προεπιλογή του καταλόγου για MHT χρησιμοποιούν τη διαδρομή ανακατεύθυνσης. Μια προβολή PDF μπορεί να προσφέρει εγγενή αναζήτηση για μορφότυπους όπως HTML και Microsoft Project. Εάν το παραγόμενο PDF περιέχει εικόνες χωρίς στρώση κειμένου, ο τυπικός προβολέας δεν μπορεί να αναζητήσει αυτά τα εικονοστοιχεία.
Χρησιμοποιήστε τη λειτουργία ανακατεύθυνσης όταν χρειάζεστε μια προβολή PDF με κείμενο — με κόστος μια προκαταρκτική μετατροπή όταν το έγγραφο ανοίγει.
Στάδιο 2 — Η γραμμή επεξεργασίας εικόνας σελίδας
Οι αποδοθείσες σελίδες επεξεργάζονται ανά αίτηση μέσω μιας σταθερής ακολουθίας:
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response- Υδατογράφημα — εφαρμόζεται από την κατάσταση άδειας (έλλειψη άδειας, ληγμένη προσωρινή ή συνδρομητική, μη έγκυρος τομέας, λάθος έκδοση) και από
DocOptions.Watermarkγια το δικό σας προσαρμοσμένο κείμενο. Μια σωστά αδειοδοτημένη εφαρμογή — ή ενεργή προσωρινή άδεια — χωρίς προσαρμοσμένο υδατογράφημα παραλείπει αυτό το βήμα. - Περιστροφή/αναστροφή — η κατάσταση ανά σελίδα που ο χρήστης ορίζει στο widget (90°/180°/270°, οριζόντιες/κατακόρυφες αντιστροφές) αποθηκεύεται στη συνεδρία και εφαρμόζεται σε κάθε επόμενη απόδοση εκείνης της σελίδας.
- Κλιμάκωση — μικρογραφίες και επίπεδα ζουμ παράγονται κλιμακώνοντας την αποδοθείσα σελίδα στο ζητούμενο μέγεθος στόχο·
0σημαίνει εξυπηρέτηση στο αρχικό μέγεθος. - Καψίματος σημειώσεων — αποθηκευμένες σημειώσεις σχεδιάζονται πάνω στο bitmap ώστε οι εξαγωγές και οι εικόνες σελίδας τις εμφανίζουν.
- Κωδικοποίηση — το αποτέλεσμα κωδικοποιείται σε PNG χρησιμοποιώντας δεσμευμένες ροές μνήμης και γράφεται απευθείας στην απόκριση HTTP.
Σφάλματα μέσα στο middleware επιστρέφονται ως PNG εικόνες σφάλματος (κόκκινο κείμενο σε λευκό) αντί για σελίδες σφάλματος HTTP, ώστε το widget να μπορεί να τις εμφανίσει στην περιοχή της σελίδας.
Κρυφή μνήμη σελίδων
BaseConfig.CachePages (προεπιλογή true) διατηρεί τις αποδοθείσες εικόνες σελίδας στη μνήμη για τη διάρκεια της συνεδρίας εγγράφου, ώστε η επανεπίσκεψη μιας σελίδας να μην την αποδίδει ξανά. BaseConfig.ImageResolution (25–300 DPI, 0 = προεπιλογή μορφότυπου) είναι ο κύριος ρυθμιστής ποιότητας/μνήμης· η προεπιλογή κάθε μορφότυπου τεκμηριώνεται στη σελίδα διαμόρφωσής του.
Απόδοση σε έναν κόμβο vs. πολλούς
Όλα τα παραπάνω περιγράφουν την απόδοση σε έναν μόνο κόμβο κατ' απαίτηση για τη συνεδρία που άνοιξε το έγγραφο. Μια ανάπτυξη όπου ένας κόμβος αποδίδει και δημοσιεύει ολόκληρο το σύνολο των τεχνουργημάτων, και άλλοι κόμβοι εξυπηρετούν αυτές τις σελίδες από κοινόχρηστη αποθήκευση, χρησιμοποιεί διαφορετική διαδρομή ανάγνωσης — δείτε Κατανεμημένες Αναπτύξεις.
Γραμματοσειρές σε Linux
Οι σελίδες σχεδιάζονται με τις γραμματοσειρές που είναι εγκατεστημένες στον διακομιστή. Σε Linux, εγκαταστήστε τη βιβλιοθήκη ρύθμισης γραμματοσειρών πριν ανοίξει το πρώτο έγγραφο (fontconfig σε RHEL και Fedora):
apt-get update && apt-get install -y libfontconfig1Χωρίς αυτήν, το άνοιγμα ενός εγγράφου αποτυγχάνει με The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. Είναι το μόνο σύστημα πακέτο που χρειάζεται το Doconut· το libgdiplus δεν απαιτείται.
Οι εξαρτήσεις του φέρνουν ένα βασικό σύνολο γραμματοσειρών (DejaVu), έτσι τα έγγραφα αποδίδονται αμέσως. Ένα έγγραφο που ζητά μια γραμματοσειρά που δεν υπάρχει στον διακομιστή — Calibri, Arial ή Times New Roman σε τυπική εικόνα Linux — λαμβάνει την πλησιέστερη εγκατεστημένη γραμματοσειρά, έτσι το κείμενο μπορεί να έχει διαφορετικό πλάτος και οι αλλαγές γραμμής μπορεί να διαφέρουν από τα Windows. Για έξοδο πιο κοντά στα Windows, εγκαταστήστε τις μετρικά συμβατές εναλλακτικές fonts-liberation, fonts-crosextra-carlito, και fonts-crosextra-caladea· προσθέστε fonts-noto-core ή fonts-noto-cjk για άλλα σενάρια, ή αντιγράψτε τα δικά σας αρχεία .ttf/.otf στο /usr/share/fonts/ και εκτελέστε fc-cache -f.
Οι διανομές Alpine και άλλες βασισμένες σε musl δεν υποστηρίζονται.
Πού να ρυθμίσετε τι
| Θέλετε | Ρύθμιση |
|---|---|
| Κορεσμένες σελίδες | ImageResolution στη διαμόρφωση μορφότυπου |
| Ακριβής αναζήτηση κειμένου σε HTML/EPUB/email/MHT/MPP | DefaultRender = false στη διαμόρφωση μορφότυπου |
| Μειωμένη μνήμη σε τεράστια έγγραφα | CachePages = false, κλείστε τις συνεδρίες ρητά |
| Η δική σας σφραγίδα σε κάθε σελίδα | DocOptions.Watermark |
Ήταν αυτή η σελίδα χρήσιμη;