กระบวนการเรนเดอร์

จากเอกสารสู่ภาพหน้า

ระหว่าง OpenDocumentAsync กับ PNG ที่ส่งถึงเบราว์เซอร์มีสองขั้นตอนที่แตกต่างกัน: viewer resolution (เครื่องยนต์ใดโหลดเอกสาร, ตัดสินใจครั้งเดียวต่อการเปิด) และ page processing (สิ่งที่เกิดขึ้นกับภาพแต่ละหน้าต่อแต่ละคำขอ). การเข้าใจทั้งสองช่วยอธิบายว่าทำไมรูปแบบหนึ่งจึงเรนเดอร์แบบนั้น — และอะไรที่ DefaultRender จริงๆ แล้วสลับ.

ขั้นที่ 1 — การแก้ไขผู้ดูรูปแบบ

โรงงานแมปส่วนขยายไฟล์ไปยังผู้ดูผ่านแคตาล็อกรูปแบบ, โดยมีระดับความสำคัญสามระดับ:

  1. ผู้ดูแบบกำหนดเองเป็นอันดับแรก. สิ่งใดที่คุณลงทะเบียนกับ DoconutOptions.RegisterViewer(extension, factory, defaultConfig?) จะชนะเหนือทุกแบบในตัว.
  2. ผู้ดูแบบในตัวของตระกูล. แคตาล็อกแมปส่วนขยายที่สามารถดูได้แต่ละอันไปยังตระกูลผู้ดู — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — แต่ละอันมีอะแดปเตอร์เครื่องยนต์ของตนเอง. หากปลั๊กอินที่มีลิขสิทธิ์ให้ผู้ดูสำหรับส่วนขยายเดียวกัน, ผู้ดูจากปลั๊กอินจะแทนที่ผู้ดูในตัว. AddDoconut() ตรวจสอบสิทธิ์ปลั๊กอินที่ลงทะเบียนขณะเริ่มต้น; การสำรองของโรงงานไปยังผู้ดูในตัวเป็นกฎการทำงานแบบป้องกัน.
  3. รูปแบบเฉพาะปลั๊กอิน. ส่วนขยายบางอย่างไม่มีผู้ดูในตัวเลย — DICOM (.dcm) มีอยู่เฉพาะผ่านปลั๊กอิน DICOM. การเปิดไฟล์ที่ไม่มีความสามารถที่ต้องการจะทำให้เกิดข้อผิดพลาด:
text
LicenseException: This document type requires the 'Dicom' plugin license.

ส่วนขยายที่ไม่มีผู้ดูอ้างสิทธิ์จะทำให้เกิดข้อผิดพลาด:

text
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 — กระบวนการภาพหน้า

หน้าที่เรนเดอร์จะถูกประมวลผลต่อคำขอผ่านลำดับที่กำหนดไว้:

text
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):

bash
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/MPPDefaultRender = false on the format config
ใช้หน่วยความจำน้อยลงบนเอกสารขนาดใหญ่CachePages = false, close sessions explicitly
ตราของคุณเองบนทุกหน้าDocOptions.Watermark

หน้านี้เป็นประโยชน์หรือไม่?