צינור רינדור
מתוך מסמך לתמונות עמוד
בהפרש בין 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()מאמת זכויות תוסף רשומות בעת ההפעלה; הפנייה חזרה של המפעל לצופה המובנה היא כלל ריצה מגן. - פורמטים רק של תוסף. חלק מהסיומות אין להן צופה מובנה כלל — 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/דוא"ל/MHT/MPP | DefaultRender = false בהגדרת הפורמט |
| זיכרון נמוך יותר במסמכים גדולים | CachePages = false, סגור מושבים במפורש |
| חותמת אישית על כל עמוד | DocOptions.Watermark |
האם דף זה היה מועיל?