Quy trình Kết xuất

Giữa OpenDocumentAsync và PNG đến trình duyệt có hai giai đoạn riêng biệt: viewer resolution (động cơ nào tải tài liệu, được quyết định một lần mỗi lần mở) và page processing (những gì xảy ra với mỗi ảnh trang trong mỗi yêu cầu). Hiểu cả hai giải thích tại sao một định dạng hiển thị như vậy — và DefaultRender thực sự chuyển đổi gì.

Giai đoạn 1 — Xác định viewer cho định dạng

Nhà máy ánh xạ phần mở rộng tệp tới một viewer thông qua danh mục định dạng, với ba mức ưu tiên:

1. Trình xem tùy chỉnh trước. Bất kỳ thứ gì bạn đăng ký với DoconutOptions.RegisterViewer(extension, factory, defaultConfig?) sẽ thắng mọi trình xem tích hợp sẵn.
2. Trình xem gia đình tích hợp sẵn. Danh mục ánh xạ mỗi phần mở rộng có thể xem được tới một gia đình trình xem — Word, Excel, PowerPoint, Pdf, Cad, Dgn, Image, Tiff, Psd, Email, Visio, Project, Xps, Epub, Txt, Html, Mht, Dcn — mỗi gia đình có bộ chuyển đổi động cơ riêng. Nếu một plugin có giấy phép cung cấp trình xem cho cùng một phần mở rộng, trình xem plugin sẽ thay thế trình xem tích hợp sẵn. AddDoconut() xác thực các quyền plugin đã đăng ký khi khởi động; việc quay lại trình xem tích hợp sẵn của nhà máy là một quy tắc thời gian chạy phòng thủ.
3. Định dạng chỉ có plugin. Một số phần mở rộng không có trình xem tích hợp sẵn — DICOM (.dcm) chỉ tồn tại thông qua plugin DICOM. Mở một tệp mà không có khả năng cần thiết sẽ ném ra:

LicenseException: This document type requires the 'Dicom' plugin license.

Một phần mở rộng không có trình xem nào sẽ gây ra:

FormatNotSupportedException: Document format '<extension>' is not supported.

Sau khi xác định, cấu hình được thiết lập: đối tượng cấu hình rõ ràng của bạn nếu bạn đã truyền vào, nếu không thì cấu hình mặc định của định dạng từ danh mục. DocOptions.Password được sao chép vào cấu hình cho các tài liệu được bảo vệ.

Giai đoạn 1b — Chế độ chuyển hướng (DefaultRender = false)

Hầu hết các cấu hình theo định dạng đều cung cấp cờ DefaultRender. Nó chọn giữa hai con đường cơ bản khác nhau:

• DefaultRender = true — tài liệu được kết xuất một cách tự nhiên, trực tiếp thành ảnh trang.
• DefaultRender = false — tài liệu đầu tiên được chuyển đổi thành PDF trong bộ nhớ, động cơ nguồn được giải phóng, và một trình xem PDF tiếp quản. PDF được tạo nhúng văn bản thực, vì vậy tìm kiếm toàn văn nhận được các đánh dấu nổi bật chính xác từng pixel; quy trình buộc AllowSearch và AllowCopy bật cho PDF chuyển hướng vì việc chuyển đổi không hiển thị với người dùng.

XPS và mặc định danh mục cho MHT sử dụng đường chuyển hướng. Một phép chiếu PDF có thể cung cấp tìm kiếm tự nhiên cho các định dạng như HTML và Microsoft Project. Nếu PDF kết quả chứa hình ảnh mà không có lớp văn bản, trình xem tiêu chuẩn không thể tìm kiếm các pixel đó.

Sử dụng chế độ chuyển hướng khi bạn cần một phép chiếu PDF có chứa văn bản — với chi phí là việc chuyển đổi ngay khi tài liệu mở.

Giai đoạn 2 — Quy trình ảnh trang

Các trang đã kết xuất được xử lý theo yêu cầu qua một chuỗi cố định:

raw page PNG → watermark → rotate/flip → scale → annotation burn → PNG to the response

• Watermark — được áp dụng dựa trên trạng thái giấy phép (thiếu giấy phép, tạm thời hoặc đăng ký đã hết hạn, miền không hợp lệ, phiên bản sai) và từ DocOptions.Watermark cho văn bản tùy chỉnh của bạn. Ứng dụng có giấy phép hợp lệ — hoặc giấy phép Temporary đang hoạt động — nếu không có watermark tùy chỉnh sẽ bỏ qua bước này.
• Rotate/flip — trạng thái mỗi trang mà người dùng đặt trong widget (90°/180°/270°, lật ngang/dọc) được lưu trong phiên và áp dụng trên mỗi lần kết xuất tiếp theo của trang đó.
• Scale — các hình thu nhỏ và mức thu phóng được tạo bằng cách thay đổi kích thước trang đã kết xuất tới kích thước mục tiêu yêu cầu; 0 có nghĩa là phục vụ ở kích thước gốc.
• Annotation burn — các chú thích đã lưu được vẽ lên bitmap để các xuất khẩu và ảnh trang hiển thị chúng.
• Encoding — kết quả được mã hoá thành PNG bằng cách sử dụng các luồng bộ nhớ chung và ghi trực tiếp vào phản hồi HTTP.

Các lỗi trong middleware được trả về dưới dạng hình ảnh lỗi PNG (văn bản đỏ trên nền trắng) thay vì các trang lỗi HTTP, để widget có thể hiển thị chúng trong khu vực trang.

Bộ nhớ đệm trang

BaseConfig.CachePages (mặc định true) giữ các ảnh trang đã kết xuất trong bộ nhớ suốt thời gian phiên tài liệu, vì vậy việc truy cập lại một trang sẽ không cần kết xuất lại. BaseConfig.ImageResolution (25–300 DPI, 0 = mặc định định dạng) là công tắc chính về chất lượng/bộ nhớ; mặc định của mỗi định dạng được ghi chép trên trang cấu hình của nó.

Nơi để điều chỉnh gì