Pipeline Rendering
Dari dokumen ke gambar halaman
Antara OpenDocumentAsync dan PNG yang sampai ke browser terdapat dua tahap yang berbeda: viewer resolution (mesin mana yang memuat dokumen, diputuskan sekali per pembukaan) dan page processing (apa yang terjadi pada setiap gambar halaman pada setiap permintaan). Mengetahui keduanya menjelaskan mengapa sebuah format dirender seperti itu — dan apa yang sebenarnya diubah oleh DefaultRender.
Tahap 1 — Menyelesaikan penampil format
Pabrik memetakan ekstensi file ke penampil melalui katalog format, dengan tiga tingkat prioritas:
- Penampil khusus terlebih dahulu. Apa pun yang Anda daftarkan dengan
DoconutOptions.RegisterViewer(extension, factory, defaultConfig?)mengalahkan semua penampil bawaan. - Penampil keluarga bawaan. Katalog memetakan setiap ekstensi yang dapat dilihat ke keluarga penampil — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — masing‑masing dengan adaptor mesin sendiri. Jika plugin berlisensi menyumbangkan penampil untuk ekstensi yang sama, penampil plugin menggantikan yang bawaan.
AddDoconut()memvalidasi hak plugin yang terdaftar saat startup; fallback pabrik ke penampil bawaan adalah aturan runtime defensif. - Format hanya plugin. Beberapa ekstensi tidak memiliki penampil bawaan sama sekali — DICOM (
.dcm) hanya tersedia melalui plugin DICOM. Membuka satu tanpa kemampuan yang diperlukan akan melempar:
LicenseException: This document type requires the 'Dicom' plugin license.Ekstensi yang tidak memiliki penampil akan menimbulkan:
FormatNotSupportedException: Document format '<extension>' is not supported.Setelah penyelesaian, konfigurasi ditetapkan: objek konfigurasi eksplisit Anda jika Anda menyediakannya, jika tidak konfigurasi default format dari katalog. DocOptions.Password disalin ke dalam konfigurasi untuk dokumen yang dilindungi.
Tahap 1b — Mode pengalihan (DefaultRender = false)
Sebagian besar konfigurasi per‑format mengekspos flag DefaultRender. Flag ini memilih antara dua jalur yang secara fundamental berbeda:
DefaultRender = true— dokumen dirender secara native, langsung ke gambar halaman.DefaultRender = false— dokumen pertama kali diubah menjadi PDF dalam memori, mesin sumber dilepaskan, dan penampil PDF mengambil alih. PDF yang dihasilkan menyertakan teks asli, sehingga pencarian full‑text mendapatkan sorotan native yang akurat piksel; pipeline memaksaAllowSearchdanAllowCopyaktif untuk PDF yang dialihkan karena konversi tidak terlihat oleh pengguna.
XPS dan default katalog untuk MHT menggunakan jalur pengalihan. Proyeksi PDF dapat menyediakan pencarian native untuk format seperti HTML dan Microsoft Project. Jika PDF yang dihasilkan berisi gambar tanpa lapisan teks, penampil standar tidak dapat mencari piksel tersebut.
Gunakan mode pengalihan ketika Anda memerlukan proyeksi PDF yang berisi teks — dengan biaya konversi awal saat dokumen dibuka.
Tahap 2 — Pipeline gambar‑halaman
Halaman yang dirender diproses per permintaan melalui urutan tetap:
raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response- Watermark — diterapkan berdasarkan status lisensi (lisensi hilang, lisensi sementara atau berlangganan yang kedaluwarsa, domain tidak valid, versi salah) dan dari
DocOptions.Watermarkuntuk teks khusus Anda sendiri. Aplikasi yang berlisensi dengan benar — atau lisensi Temporary yang aktif — tanpa watermark khusus akan melewati langkah ini. - Rotate/flip — status per halaman yang pengguna atur di widget (90°/180°/270°, flip horizontal/vertikal) disimpan dalam sesi dan diterapkan pada setiap render berikutnya dari halaman tersebut.
- Scale — thumbnail dan tingkat zoom dihasilkan dengan menskalakan halaman yang dirender ke ukuran target yang diminta;
0berarti menyajikan pada ukuran asli. - Annotation burn — anotasi yang disimpan digambar ke bitmap sehingga ekspor dan gambar halaman menampilkannya.
- Encoding — hasilnya dikodekan ke PNG menggunakan aliran memori yang dipool dan ditulis langsung ke respons HTTP.
Kesalahan di dalam middleware dikembalikan sebagai gambar kesalahan PNG (teks merah di atas putih) alih‑alih halaman kesalahan HTTP, sehingga widget dapat menampilkannya di area halaman.
Penyimpanan cache halaman
BaseConfig.CachePages (default true) menyimpan gambar halaman yang dirender dalam memori selama masa sesi dokumen, sehingga mengunjungi kembali sebuah halaman tidak merender ulang. BaseConfig.ImageResolution (25–300 DPI, 0 = default format) adalah pengatur utama kualitas/memori; default setiap format didokumentasikan pada halaman konfigurasinya.
Rendering pada satu node vs. banyak
Semua di atas menggambarkan rendering pada satu node secara permintaan untuk sesi yang membuka dokumen. Penyebaran di mana satu node merender dan menerbitkan seluruh set artefak, dan node lain melayani halaman‑halaman tersebut dari penyimpanan bersama, menggunakan jalur baca yang berbeda — lihat Penyebaran Terdistribusi.
Font di Linux
Halaman digambar dengan font yang terpasang di server. Di Linux, instal pustaka konfigurasi font sebelum dokumen pertama dibuka (fontconfig pada RHEL dan Fedora):
apt-get update && apt-get install -y libfontconfig1Tanpa itu, membuka dokumen gagal dengan The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.. Itu satu‑satunya paket sistem yang dibutuhkan Doconut; libgdiplus tidak diperlukan.
Dependensinya membawa set font dasar (DejaVu), sehingga dokumen dapat dirender langsung. Dokumen yang meminta font yang tidak ada di server — Calibri, Arial, atau Times New Roman pada image Linux tipikal — akan mendapatkan font terdekat yang terpasang, sehingga teks dapat memiliki lebar berbeda dan pemenggalan baris dapat berbeda dari Windows. Untuk output yang lebih mirip Windows, instal pengganti yang kompatibel metrik fonts-liberation, fonts-crosextra-carlito, dan fonts-crosextra-caladea; tambahkan fonts-noto-core atau fonts-noto-cjk untuk skrip lain, atau salin file .ttf/.otf Anda sendiri ke dalam /usr/share/fonts/ dan jalankan fc-cache -f.
Alpine dan distribusi berbasis musl lainnya tidak didukung.
Di mana menyesuaikan apa
| Anda ingin | Sesuaikan |
|---|---|
| Halaman lebih tajam | ImageResolution pada konfigurasi format |
| Pencarian teks akurat pada HTML/EPUB/email/MHT/MPP | DefaultRender = false pada konfigurasi format |
| Memori lebih rendah pada dokumen besar | CachePages = false, tutup sesi secara eksplisit |
| Stempel Anda sendiri pada setiap halaman | DocOptions.Watermark |
Apakah halaman ini membantu?