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

ระหว่าง 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. การเปิดไฟล์ที่ไม่มีความสามารถที่จำเป็นจะทำให้เกิดข้อยกเว้น:

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

• ลายน้ำ — ถูกนำไปใช้จากสถานะลิขสิทธิ์ (ลิขสิทธิ์หาย, ลิขสิทธิ์ชั่วคราวหรือการสมัครสมาชิกหมดอายุ, โดเมนไม่ถูกต้อง, เวอร์ชันผิด) และจาก DocOptions.Watermark สำหรับข้อความกำหนดเองของคุณ. แอปที่มีลิขสิทธิ์ถูกต้อง — หรือมีลิขสิทธิ์ชั่วคราวที่ใช้งานอยู่ — โดยไม่มีลายน้ำกำหนดเองจะข้ามขั้นตอนนี้.
• หมุน/พลิก — สถานะต่อหน้า ที่ผู้ใช้ตั้งค่าในวิดเจ็ต (90°/180°/270°, การพลิกแนวนอน/แนวตั้ง) จะถูกเก็บในเซสชันและนำไปใช้ในการเรนเดอร์ต่อไปของหน้านั้น.
• ปรับขนาด — รูปย่อและระดับการซูมถูกสร้างโดยการปรับขนาดหน้าที่เรนเดอร์ให้ตรงกับขนาดเป้าหมายที่ร้องขอ; 0 หมายถึงให้บริการที่ขนาดต้นฉบับ.
• การฝังคำอธิบาย — คำอธิบายที่บันทึกไว้จะถูกวาดลงบนบิตแมพเพื่อให้การส่งออกและภาพหน้าจอแสดงออกมา.
• การเข้ารหัส — ผลลัพธ์จะถูกเข้ารหัสเป็น PNG โดยใช้สตรีมหน่วยความจำแบบ pool แล้วเขียนโดยตรงไปยังการตอบสนอง HTTP.

ข้อผิดพลาดภายในมิดเดิลแวร์จะถูกส่งกลับเป็น ภาพข้อผิดพลาด PNG (ข้อความสีแดงบนพื้นขาว) แทนหน้าข้อผิดพลาด HTTP, เพื่อให้วิดเจ็ตสามารถแสดงในพื้นที่หน้าได้.

การแคชหน้า

BaseConfig.CachePages (ค่าเริ่มต้น true) เก็บภาพหน้าที่เรนเดอร์ไว้ในหน่วยความจำตลอดอายุของเซสชันเอกสาร, ดังนั้นการเยี่ยมชมหน้าซ้ำจะไม่ต้องเรนเดอร์ใหม่. BaseConfig.ImageResolution (25–300 DPI, 0 = ค่าเริ่มต้นของรูปแบบ) เป็นการปรับคุณภาพ/หน่วยความจำหลัก; ค่าเริ่มต้นของแต่ละรูปแบบถูกบันทึกในหน้าการตั้งค่าของมัน.

ที่ไหนที่ควรปรับอะไร