Rurociąg renderowania
Od dokumentu do obrazów stron
Pomiędzy OpenDocumentAsync a PNG, który dociera do przeglądarki, istnieją dwa odrębne etapy: rozwiązywanie podglądu (który silnik ładuje dokument, ustalane raz przy otwarciu) i przetwarzanie stron (co dzieje się z każdym obrazem strony przy każdym żądaniu). Znajomość obu wyjaśnia, dlaczego format renderuje się w określony sposób — i co naprawdę przełącza DefaultRender.
Etap 1 — Rozwiązywanie podglądu formatu
Fabryka mapuje rozszerzenie pliku na podgląd za pośrednictwem katalogu formatów, z trzema poziomami priorytetu:
- Najpierw własne podglądy. Wszystko, co zarejestrowałeś przy użyciu
DoconutOptions.RegisterViewer(extension, factory, defaultConfig?), ma pierwszeństwo przed wszystkimi wbudowanymi. - Wbudowane podglądy rodzinne. Katalog mapuje każde rozszerzenie, które można wyświetlić, na rodzinę podglądów — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — każda z własnym adapterem silnika. Jeśli licencjonowana wtyczka dostarcza podgląd dla tego samego rozszerzenia, podgląd wtyczki zastępuje wbudowany.
AddDoconut()weryfikuje zarejestrowane uprawnienia wtyczek przy uruchomieniu; awaryjne przejście fabryki do wbudowanego podglądu jest defensywną regułą w czasie wykonywania. - Formaty tylko z wtyczkami. Niektóre rozszerzenia nie mają w ogóle wbudowanego podglądu — DICOM (
.dcm) istnieje wyłącznie poprzez wtyczkę DICOM. Otwarcie takiego bez wymaganego uprawnienia powoduje wyrzucenie:
LicenseException: This document type requires the 'Dicom' plugin license.Rozszerzenie, które nie ma podglądu, podnosi:
FormatNotSupportedException: Document format '<extension>' is not supported.Po rozwiązaniu konfiguracja jest ustalona: twój explicite podany obiekt konfiguracyjny, jeśli go przekazałeś, w przeciwnym razie domyślna konfiguracja formatu z katalogu. DocOptions.Password jest kopiowane do konfiguracji dla chronionych dokumentów.
Etap 1b — Tryb przekierowania (DefaultRender = false)
Większość konfiguracji per-format udostępnia flagę DefaultRender. Wybiera ona pomiędzy dwoma zasadniczo różnymi ścieżkami:
DefaultRender = true— dokument renderuje się natywnie, bezpośrednio do obrazów stron.DefaultRender = false— dokument jest najpierw konwertowany do PDF w pamięci, silnik źródłowy jest zwalniany, a podgląd PDF przejmuje kontrolę. Wygenerowany PDF zawiera prawdziwy tekst, więc pełnotekstowe wyszukiwanie uzyskuje pikselowo dokładne natywne podświetlenia; rurociąg wymusza włączenieAllowSearchiAllowCopydla przekierowanego PDF, ponieważ konwersja jest niewidoczna dla użytkownika.
XPS oraz domyślne ustawienie katalogu dla MHT używają ścieżki przekierowania. Projekcja PDF może zapewnić natywne wyszukiwanie dla formatów takich jak HTML i Microsoft Project. Jeśli wynikowy PDF zawiera obrazy bez warstwy tekstowej, standardowy podgląd nie może przeszukiwać tych pikseli.
Używaj trybu przekierowania, gdy potrzebujesz projekcji PDF zawierającej tekst — kosztem wstępnej konwersji przy otwieraniu dokumentu.
Etap 2 — Rurociąg obrazów stron
Renderowane strony są przetwarzane przy każdym żądaniu według stałej kolejności:
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response- Znak wodny — stosowany w zależności od stanu licencji (brak licencji, wygasła tymczasowa lub subskrypcyjna, nieprawidłowa domena, zła wersja) oraz z
DocOptions.Watermarkdla własnego tekstu. Poprawnie licencjonowana aplikacja — lub aktywna licencja Tymczasowa — bez własnego znaku wodnego pomija ten krok. - Obróć/odwróć — stan per-strona ustawiony przez użytkownika w widżecie (90°/180°/270°, odbicia poziome/pionowe) jest przechowywany w sesji i stosowany przy każdym kolejnym renderowaniu tej strony.
- Skalowanie — miniatury i poziomy powiększenia są tworzone przez skalowanie renderowanej strony do żądanego rozmiaru docelowego;
0oznacza serwowanie w oryginalnym rozmiarze. - Nałożenie adnotacji — zapisane adnotacje są rysowane na bitmapie, tak aby eksporty i obrazy stron je wyświetlały.
- Kodowanie — wynik jest kodowany do PNG przy użyciu puli strumieni pamięci i zapisywany bezpośrednio w odpowiedzi HTTP.
Błędy wewnątrz pośrednika są zwracane jako obrazy błędów PNG (czerwony tekst na białym tle) zamiast stron błędów HTTP, dzięki czemu widżet może je wyświetlić w obszarze strony.
Buforowanie stron
BaseConfig.CachePages (domyślnie true) przechowuje renderowane obrazy stron w pamięci przez cały czas trwania sesji dokumentu, więc ponowne odwiedzenie strony nie powoduje jej ponownego renderowania. BaseConfig.ImageResolution (25–300 DPI, 0 = domyślne dla formatu) jest głównym pokrętłem jakości/pamięci; domyślne wartości każdego formatu są udokumentowane na jego stronie konfiguracyjnej.
Renderowanie na jednym węźle vs. wielu
Wszystko powyższe opisuje renderowanie na pojedynczym węźle na żądanie dla sesji, która otworzyła dokument. Wdrożenie, w którym jeden węzeł renderuje i publikuje cały zestaw artefaktów, a inne węzły serwują te strony z współdzielonego magazynu, używa innej ścieżki odczytu — zobacz Rozproszone wdrożenia.
Czcionki w systemie Linux
Strony są rysowane przy użyciu czcionek zainstalowanych na serwerze. W systemie Linux zainstaluj bibliotekę konfiguracji czcionek przed otwarciem pierwszego dokumentu (fontconfig na RHEL i Fedora):
apt-get update && apt-get install -y libfontconfig1Bez niej otwarcie dokumentu kończy się niepowodzeniem z The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. Jest to jedyny pakiet systemowy, którego potrzebuje Doconut; libgdiplus nie jest wymagany.
Jej zależności dostarczają podstawowy zestaw czcionek (DejaVu), więc dokumenty renderują się od razu. Dokument, który żąda czcionki nieobecnej na serwerze — Calibri, Arial lub Times New Roman w typowym obrazie Linux — otrzymuje najbliższą zainstalowaną czcionkę, więc tekst może mieć inną szerokość, a podziały linii mogą różnić się od Windows. Aby uzyskać wynik bliższy Windows, zainstaluj metrycznie kompatybilne zamienniki fonts-liberation, fonts-crosextra-carlito i fonts-crosextra-caladea; dodaj fonts-noto-core lub fonts-noto-cjk dla innych skryptów, lub skopiuj własne pliki .ttf/.otf do /usr/share/fonts/ i uruchom fc-cache -f.
Alpine i inne dystrybucje oparte na musl nie są wspierane.
Gdzie co dostroić
| Chcesz | Dostosuj |
|---|---|
| Ostrzejsze strony | ImageResolution w konfiguracji formatu |
| Dokładne wyszukiwanie tekstu w HTML/EPUB/email/MHT/MPP | DefaultRender = false w konfiguracji formatu |
| Mniejsze zużycie pamięci przy dużych dokumentach | CachePages = false, zamykaj sesje explicite |
| Własny stempel na każdej stronie | DocOptions.Watermark |
Czy ta strona była pomocna?