กระบวนการเรนเดอร์
จากเอกสารสู่ภาพหน้า
ระหว่าง 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 ถูกคัดลอกเข้าไปในการกำหนดค่าสำหรับเอกสารที่ได้รับการปกป้อง.
ขั้นที่ 1b — โหมดเปลี่ยนเส้นทาง (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- Watermark — ถูกนำไปใช้จากสถานะลิขสิทธิ์ (ไม่มีลิขสิทธิ์, ลิขสิทธิ์ชั่วคราวหรือการสมัครสมาชิกหมดอายุ, โดเมนไม่ถูกต้อง, เวอร์ชันผิด) และจาก
DocOptions.Watermarkสำหรับข้อความกำหนดเองของคุณ. แอปที่มีลิขสิทธิ์อย่างถูกต้อง — หรือลิขสิทธิ์ชั่วคราวที่ใช้งานอยู่ — ที่ไม่มีลายน้ำกำหนดเองจะข้ามขั้นตอนนี้. - Rotate/flip — สถานะต่อหน้า ที่ผู้ใช้ตั้งค่าในวิดเจ็ต (90°/180°/270°, การพลิกแนวนอน/แนวตั้ง) จะถูกเก็บในเซสชันและนำไปใช้ในการเรนเดอร์ต่อไปของหน้านั้น.
- Scale — ภาพย่อและระดับการซูมถูกสร้างโดยการสเกลหน้าที่เรนเดอร์ไปยังขนาดเป้าหมายที่ร้องขอ;
0หมายถึงให้บริการที่ขนาดต้นฉบับ. - Annotation burn — คำอธิบายที่บันทึกไว้จะถูกวาดลงบนบิตแมพเพื่อให้การส่งออกและภาพหน้าจอแสดงผล.
- Encoding — ผลลัพธ์จะถูกเข้ารหัสเป็น PNG โดยใช้สตรีมหน่วยความจำแบบรวมกลุ่มและเขียนโดยตรงไปยังการตอบสนอง HTTP.
ข้อผิดพลาดภายในมิดเดิลแวร์จะถูกส่งกลับเป็น PNG error images (ข้อความสีแดงบนพื้นสีขาว) แทนหน้าข้อผิดพลาด HTTP, เพื่อให้วิดเจ็ตสามารถแสดงในพื้นที่หน้าได้.
แคชหน้า
BaseConfig.CachePages (ค่าเริ่มต้น true) เก็บภาพหน้าที่เรนเดอร์ไว้ในหน่วยความจำตลอดอายุของเซสชันเอกสาร, ดังนั้นการเยี่ยมชมหน้าซ้ำจะไม่ต้องเรนเดอร์ใหม่. BaseConfig.ImageResolution (25–300 DPI, 0 = ค่าเริ่มต้นของรูปแบบ) เป็นการปรับคุณภาพ/หน่วยความจำหลัก; ค่าดีฟอลต์ของแต่ละรูปแบบถูกบันทึกในหน้าการกำหนดค่า.
การเรนเดอร์บนโหนดเดียวเทียบกับหลายโหนด
ทุกอย่างข้างต้นอธิบายการเรนเดอร์บนโหนดเดียวตามความต้องการสำหรับเซสชันที่เปิดเอกสาร. การปรับใช้ที่โหนดหนึ่งเรนเดอร์และเผยแพร่ชุดศิลปวัตถุตทั้งหมด, และโหนดอื่นให้บริการหน้าต่างๆ จากที่เก็บข้อมูลร่วม, ใช้เส้นทางการอ่านที่แตกต่าง — ดู การปรับใช้แบบกระจาย.
ฟอนต์บน 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 on the format config |
| การค้นหาข้อความที่แม่นยำบน HTML/EPUB/email/MHT/MPP | DefaultRender = false on the format config |
| ใช้หน่วยความจำน้อยลงบนเอกสารขนาดใหญ่ | CachePages = false, close sessions explicitly |
| ตราของคุณเองบนทุกหน้า | DocOptions.Watermark |
หน้านี้เป็นประโยชน์หรือไม่?