กระบวนการเรนเดอร์พายป์ไลน์

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

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

PNG หน้าเดิม → ลายน้ำ → หมุน/พลิก → ปรับขนาด → ฝังคำอธิบาย → PNG ไปยังการตอบสนอง

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

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

การแคชหน้า

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

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