צינור רינדור
מתיעוד לתמונות עמודים
בין OpenDocumentAsync ל‑PNG שמגיע לדפדפן יש שני שלבים מובחנים: פתרון מציג (איזה מנוע טוען את המסמך, נבחר פעם אחת לכל פתיחה) ועיבוד עמוד (מה קורה לכל תמונת עמוד בכל בקשה). הידיעה של שניהם מסבירה מדוע פורמט מציג את עצמו כך — ומה 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()מאמת זכויות תוסף רשומות בעת ההפעלה; fallback של המפעל למציג המובנה הוא כלל ריצה מגן. - פורמטים של תוסף בלבד. חלק מהסיומות אין להן מציג מובנה בכלל — DICOM (
.dcm) קיימת רק דרך תוסף DICOM. פתיחה של קובץ ללא היכולת הנדרשת גוררת שגיאה:
LicenseException: This document type requires the 'Dicom' plugin license.סיומת שאין לה מציג גוררת שגיאה:
FormatNotSupportedException: Document format '<extension>' is not supported.לאחר הפתרון, ההגדרה מתייצבת: אובייקט ההגדרה המפורש שלך אם העברת אחד, אחרת ההגדרה ברירת המחדל של הפורמט מהקטלוג. DocOptions.Password מועתק לתוך ההגדרה עבור מסמכים מוגנים.
שלב 1ב — מצב הפנייה (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 באמצעות זרמי זיכרון משותפים ונכתבת ישירות לתשובת HTTP.
שגיאות בתוך המידלוור מוחזרות כתמונות שגיאת PNG (טקסט אדום על לבן) במקום דפי שגיאת HTTP, כך שהווידג'ט יכול להציג אותן באזור העמוד.
שמירת עמודים במטמון
BaseConfig.CachePages (ברירת מחדל true) שומר תמונות עמוד מעובדות בזיכרון לכל משך משך משך של סשן המסמך, כך שביקור חוזר בעמוד אינו מרנדר אותו מחדש. BaseConfig.ImageResolution (25–300 DPI, 0 = ברירת המחדל של הפורמט) הוא המדד העיקרי לאיכות/זיכרון; ברירת המחדל של כל פורמט מתועדת בדף ההגדרות שלו.
רינדור על צומת אחד מול רבים
כל האמור למעלה מתאר רינדור של צומת יחיד לפי דרישה עבור הסשן שפתח את המסמך. פריסה שבה צומת אחד מרנדר ומפרסם את כל סט הארטיפקטים, וצמתים אחרים מגישים את העמודים מאחסון משותף, משתמשת במסלול קריאה שונה — ראה פריסות מבוזרות.
גופנים בלינוקס
עמודים מצוירים עם הגופנים המותקנים על השרת. בלינוקס, התקן את ספריית תצורת הגופנים לפני שהמסמך הראשון נפתח (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 בתמונת לינוקס טיפוסית — מקבל את הגופן המותקן הקרוב ביותר, ולכן הטקסט עלול לקבל רוחב שונה ושבירות שורה שונות מ‑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 בתצורת הפורמט |
| חיפוש טקסט מדויק ב‑HTML/EPUB/email/MHT/MPP | DefaultRender = false בתצורת הפורמט |
| זיכרון נמוך במסמכים גדולים | CachePages = false, סגור סשנים במפורש |
| חותמת אישית על כל עמוד | DocOptions.Watermark |
האם דף זה היה מועיל?