תצורות פורמט
אפשרויות רינדור מלאות לכל פורמט
כל מסמך נפתח עם מימוש של BaseConfig. העבירו אחד ל-OpenDocumentAsync או תנו לקטלוג הפורמט ליצור ברירת מחדל משלו. כל המחלקות שלהלן נמצאות במרחב השמות Doconut.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
AllowSearch = true,
AllowCopy = true,
ImageResolution = 150
});ירושה והגדרות PDF מקוננות
כל פורמט יורש את חמשת המאפיינים BaseConfig. פורמטים שיכולים להפנות דרך PDF מציגים PdfConfig מקונן. ב-WordConfig, ExcelConfig ו-PptConfig, AllowSearch ו-AllowCopy הם מאפיינים נוחות שקוראים וכותבים את PdfConfig המקונן.
DefaultRender = true בוחר את מנגנון הרינדור של הפורמט הטבעי. בפורמטים עם הפנייה ל-PDF, false ממיר תחילה ל-PDF בזיכרון ולאחר מכן משתמש במציג ה-PDF. נתיב זה לעיתים קרובות שימושי לחיפוש לפי קואורדינטות טקסט, אך דורש המרה נוספת.
אלא אם צוין אחרת, הטבלאות מציגות ערכי ברירת מחדל של קונסטרוקטורים/מאפיינים. קטלוג הפורמט האוטומטי מתעלם במכוון משניים מהם: הוא יוצר ExcelConfig עם SplitWorksheets = true, ו-MhtConfig עם DefaultRender = false.
BaseConfig
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
int | ImageResolution | 0 | 0 משתמש בברירת המחדל של הפורמט. טווח תקף מפורש הוא 25-300 DPI; הקצאות לא תקינות מתעלמים. |
string | DocumentCulture | "" | אזור עבור תאריכים ומספרים. ערכים שאינם ריקים נחתכים; הקצאות ריקות מתעלמים. |
string | Password | "" | סיסמת מסמך מוגן. DocOptions.Password מועתקת לכאן באופן אוטומטי. |
bool | ShowUI | true | מאפיין התאמה; המנוע הנוכחי אינו משתמש בו לשליטה בסרגל הכלים של הדפדפן. |
bool | CachePages | true | מאגר תמונות דפים מרונדרים עבור סשן המסמך. |
PdfConfig
פורמטים: PDF. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | מתג התאמה. המפעל הנוכחי משתמש במציג ה-PDF הטבעי. |
bool | AllowSearch | false | בנה/השתמש באינדקס חיפוש טקסט ב-PDF. דורש את יכולת הרישיון Search לבקשות. |
bool | AllowCopy | false | מאפשר פעולות בחירת/העתקת טקסט. |
bool | ExtractHyperlinks | false | מחלץ ריבועי קישורים עבור שכבות לקוח. |
int | HyperlinksPageCount | 0 | מספר מקסימלי של דפים שנסרקים לקישורים; 0 משמעותו כל הדף. |
bool | CompressImages | false | דוחס תמונות משובצות לפני הרינדור. |
int | CompressQuality | 100 | איכות JPEG המשמשת כאשר הדחיסה מופעלת. |
bool | ResizeImages | false | שנה גודל של תמונות משובצות לפני הרינדור. |
int | ResizeResolution | 300 | DPI יעד לתמונות משוכתבות. |
bool | CompressFast | false | העדף את נתיב הדחיסה המהיר, באיכות נמוכה יותר. |
bool | FixInvalidImages | false | נסה לתקן תמונות משובצות לא תקינות. |
bool | SplitSegments | false | אחד מילים שנפצלות על פני קטעי שורה כדי לשפר חיפוש/העתקה. |
showHyperlinks ב-ViewerConfig שולט בשכבת הלקוח, בעוד ExtractHyperlinks שולט בחילוץ בצד השרת. אפשר לשניהם.
WordConfig
פורמטים: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | רינדור Word טבעי; false משתמש בהפנייה ל-PDF. |
PdfConfig | PdfConfig | new instance | הגדרות המשמשות בנתיב PDF/חיפוש. |
DocPaperSize | PaperSize | A4 | גודל נייר פלט. השתמש ב-Custom עם רוחב/גובה. |
int | PaperWidth | 595 | רוחב מותאם אישית בנקודות. |
int | PaperHeight | 841 | גובה מותאם אישית בנקודות. |
bool | RemovePaperMargin | false | הסר שוליים של דפי המסמך. |
bool | RenderPageColor | true | שמר את צבע העמוד המוגדר ב-Word; false מציג דפים לבנים. |
bool | ExportPdfA | false | השתמש ב-PDF/A ארכיוני בנתיב ה-PDF. |
Encoding? | FileEncoding | null | עקוף קידוד מקור. |
string | FontInfo | "" | מידע על החלפת גופנים. |
string[]? | FontFolders | null | ספריות גופנים נוספות, במיוחד שימושיות ב-Linux/מכולות. |
bool | AllowSearch | false | מופנה ל-PdfConfig.AllowSearch. |
bool | AllowCopy | false | מופנה ל-PdfConfig.AllowCopy. |
TableAutoFitBehavior | AutoFitAllTables | None | None, AutoFitToContents, או AutoFitToWindow. |
תצורת Excel
פורמטים: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | הצגת גיליון מקומית; false משתמש בהפנייה ל‑PDF. |
PdfConfig | PdfConfig | מופע חדש | הגדרות לנתיב PDF/חיפוש. |
ExcelPaperSize | PaperSize | PaperA4 | גודל נייר הפלט. |
double | PaperMargins | 0.25 | שולשי עמוד באינצ'ים. |
bool | PaperLandscape | true | הצגת גיליון במצב אופקי. |
bool | AutoFitContents | false | התאמה אוטומטית של גובה השורות ורוחב העמודות. |
bool | RemoveEmptyContent | true | צמצום הפלט על ידי הוצאת תוכן ריק. |
bool | CalculateFormula | true | חישוב מחדש של נוסחאות לפני ההצגה. |
bool | ShowRowColumnHeaders | true | הכללת כותרות הגיליון. |
bool | ExportPdfA | false | שימוש ב‑PDF/A בנתיב ה‑PDF. |
bool | SplitWorksheets | false | שמירת גיליונות כקבוצות עמודים נפרדות. |
bool | ShowEmptyWorkSheets | false | הכללת גיליונות ריקים. |
bool | ExportLandscape | false | אילוץ יצוא במצב אופקי. |
bool | ExportOnePagePerSheet | false | התאמת כל גיליון לעמוד פלט אחד. |
bool | MemoryOptimizationPreference | true | הפחתת זיכרון קצה, יתכן במחיר של ירידה קלה במהירות. |
bool | AutoTrimWorksheetRenderRange | true | הצגת רק את הטווח המשמש הגלוי כאשר אין תחום הדפסה מפורש. |
bool | AutoTrimPreserveExistingPrintArea | true | שמירת תחומי הדפסה שהוגדרו בחוברת העבודה במהלך חיתוך אוטומטי. |
string? | PrintArea | null | טווח מפורש כגון "A1:Z100". |
bool | PrintGridlines | false | הדפסת קווי רשת של הגיליון. |
bool | PrintHeadings | false | הדפסת כותרות שורות/עמודות. |
List<string> | SheetNames | empty | הגבלת ההצגה לגיליונות בעלי שם. |
CustomStyleCell? | CustomStyles | null | שכתוב פורמט תאריך/דצימלי/שלם אופציונלי. |
bool | AllowSearch | false | מועבר ל‑PdfConfig.AllowSearch. |
bool | AllowCopy | false | מועבר ל‑PdfConfig.AllowCopy. |
CustomStyleCell חשוף את CustomStyleDateTime, CustomStyleNumberDecimal ו‑CustomStyleNumberInteger, כולם מחרוזות ניתנות לאפס.
new ExcelConfig() מגדיר את SplitWorksheets לfalse; פתיחת קובץ Excel ללא תצורה מפורשת משתמשת בקטלוג הפורמטים, שמגדיר אותו לtrue.
תצורת PPT
פורמטים: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | הצגת שקופית מקומית; false משתמש בהפנייה ל‑PDF. |
bool | FastLoad | false | הימנעות מהצגת השקופית הראשונה בעת הפתיחה; שימוש במטא‑נתונים והצגה לפי דרישה. |
PdfConfig | PdfConfig | מופע חדש | הגדרות להתנהגות PDF/חיפוש. |
string | FontInfo | "" | מידע על החלפת גופנים. |
string[]? | FontFolders | null | ספריות גופנים נוספות. |
bool | AllowSearch | false | מועבר ל‑PdfConfig.AllowSearch. |
bool | AllowCopy | false | מועבר ל‑PdfConfig.AllowCopy. |
הדפים מצוירים עם הגופנים המותקנים בשרת. ב‑Linux, התקינו את הגופנים שהמצגות משתמשות בהם או הפנו את FontFolders אליהם: גופן חסר מוחלף ללא שגיאה, ולכן שבירות שורה יכולות להיות שונות מ‑Windows. fonts-liberation, fonts-crosextra-carlito ו‑fonts-crosextra-caladea מספקים תחליפים תואמי‑מטריקה לגופנים נפוצים ב‑Windows. Linux צריך רק את libfontconfig1 (libgdiplus אינו נדרש).
תצורת CAD
פורמטים: DWG, DXF, DGN. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | הצגת CAD מקומית; false משתמש בהפנייה ל‑PDF. |
PdfConfig | PdfConfig | מופע חדש | הגדרות נתיב PDF. |
bool | ExportPdfA | false | פלט PDF/A ארכיוני. |
bool | ShowColor | true | צבע במקום שחור‑לבן. |
bool | WhiteBackground | true | רקע לבן במקום שחור. |
short | LineWidth | 25 | רוחב קו CAD. |
bool | ShowLayouts | false | הצגת לשוניות פריסה. |
bool | ShowModel | true | הצגת מרחב מודל. |
bool | Check3DSolid | true | עיבוד מוצקים תלת‑ממדיים. |
bool | ExportAllLayouts | false | ייצוא כל הפריסות, תוך התעלמות מבחירת מודל/פריסה. |
bool | LimitMinimumSize | false | החלת MinimumSize. |
int | MinimumSize | 700 | גודל פלט מינימלי בפיקסלים. |
bool | LimitMaximumSize | false | החלת MaximumSize. |
int | MaximumSize | 700 | גודל פלט מרבי בפיקסלים. |
bool | ShowAllLayoutsDgn | false | הכללת כל פריסות DGN. |
bool | AutomaticLayoutScaling | true | קנה מידה אוטומטי של פריסות. |
float | PdfMargins | 0.5 | שוליים של PDF באינצ'ים. |
RenderQuality | QualityImage | Low | איכות רסטר: Low, Medium או High. |
RenderQuality | QualityText | Medium | איכות טקסט: Low, Medium או High. |
תצורת דוא"ל
פורמטים: EML, EMLX, MSG. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | הצגה מקומית של אימייל; false משתמשת בהפניה ל-PDF. |
PdfConfig | PdfConfig | מופע חדש | הגדרות נתיב PDF. |
Encoding? | EmailEncoding | null | עקיפת קידוד ההודעה. |
Encoding? | SubjectEncoding | null | עקיפת קידוד הנושא. |
Encoding? | BodyEncoding | null | עקיפת קידוד הגוף. |
bool | SkipExternalImages | false | אל תטען תמונות שמופנות מרחוק. מומלץ עבור אימייל לא מהימן. |
bool | RemoveLastWhitePage | false | הסר דף ריק סופי. |
bool | UseAntiAliasing | false | הפעל אנטי-אליאסינג. |
bool | UseHighQualityRendering | false | העדף רינדור נקי יותר, איטי יותר. |
TimeSpan? | TimeZoneOffset | null | עקיפת אזור הזמן המשמש לתאריכים. |
bool | ForcePageSize | false | הכרח ממדים קבועים לדף. |
ImageConfig, TiffConfig, ו-PsdConfig
ImageConfig מכסה JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF, ו-SVG. DPI ברירת המחדל שלו הוא 100.
| תצורה | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
ImageConfig | MaxImagePixelSize | 3000 | רוחב/גובה מרבי. 0 משמעותו ללא הגבלה; ערכים שונים מאפס מתחת ל-50 מתעלמים. |
ImageConfig | TransparentPng | true | שמור על שקיפות PNG; false משתמש ברקע לבן. |
TiffConfig | אין מאפיינים נוספים | DPI 200 | משתמש רק ב-BaseConfig; תומך ב-TIFF מרובה דפים. |
PsdConfig | MaxImagePixelSize | 3000 | אותה 0/אימות מינימום-50 כמו ImageConfig; DPI ברירת המחדל הוא 100. |
DicomConfig
פורמטים: DCM, IMA. DPI אפקטיבי ברירת מחדל: 100. דורש את תוסף DICOM.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
int | HorizontalResolution | 100 אפקטיבי | DPI אופקי מפורש; אחרת ImageResolution, ואז 100. |
int | VerticalResolution | 100 אפקטיבי | DPI אנכי מפורש; אחרת ImageResolution, ואז 100. |
int | AnimationFrameDelayMs | 100 | השהיית אנימציה מרובת פריימים; תזמון GIF משתמש ביחידות של 10 מ״ש. |
ushort | LoopCount | 0 | 0 חוזר לנצח; ערכים חיוביים נעצרים לאחר ספירה זו. |
DicomDisplayMode | DisplayMode | AnimationAndFrames | AnimationOnly, FramesOnly, או תצוגה משולבת עם פריימים סטטיים. |
TxtConfig
פורמט: TXT. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
DocPaperSize | PaperSize | A4 | גודל נייר פלט. |
Encoding? | FileEncoding | null | null משתמש ב-UTF-8. |
string | FontInformation | "" | מידע גופן עבור רינדור טקסט. |
השתמש ב-WordConfig כאשר טקסט פשוט דורש התנהגות פריסת עמוד עשירה יותר.
ProjectConfig
פורמטים: MPP, MPPX, MPX. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | תמונה מקומית של Gantt; false משתמשת בנתיב PDF מבוסס טקסט. |
PdfConfig | PdfConfig | מופע חדש | הגדרות נתיב PDF. |
bool | ExportPdfA | true | פלט PDF/A ארכיוני. |
MppPaperSize | PaperSize | Ledger | גודל נייר פלט של הפרויקט. |
MppTimeScale | TimeScale | Months | Days או Months. |
MppFormat | PresentationFormat | GanttChart | GanttChart, TaskUsage, ResourceUsage, ResourceSheet, או TaskSheet. |
לחיפוש מדויק לפי קואורדינטות טקסט, השתמש ב-DefaultRender = false.
VisioConfig
פורמטים: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | רינדור תרשים מקורי; false משתמש בהפניה ל-PDF. |
PdfConfig | PdfConfig | מופע חדש | הגדרות נתיב PDF. |
bool | ExportPdfA | true | פלט PDF/A ארכיוני. |
HtmlConfig, EpubConfig, MhtConfig, ו-XpsConfig
כל הארבעה משתמשים ב-DPI של 200 כברירת מחדל ומחשפים PdfConfig מקונן.
| תצורה | פורמטים | DefaultRender | מאפיינים/התנהגות נוספים |
|---|---|---|---|
HtmlConfig | HTML, HTM | true | רינדור מקורי; השתמש ב-false בשביל נתיב חיפוש PDF מבוסס טקסט. |
EpubConfig | EPUB | true | רינדור מקורי; false משתמש ב-PDF. |
MhtConfig | MHT, MHTML | true במחלקה; false בקטלוג האוטומטי | הפתיחה הרגילה ללא תצורה משתמשת בהפניה ל-PDF שניתן לחיפוש. מופע ברירת מחדל שנבנה במפורש רינדור מקורי. |
XpsConfig | XPS | false | משתמש בנתיב PDF כברירת מחדל; הגדר true לרינדור תמונה מקורי. |
דוגמאות תצורה לפי משפחה
BaseConfig[] configs =
[
new PdfConfig
{
AllowSearch = true,
ExtractHyperlinks = true,
HyperlinksPageCount = 0
},
new WordConfig
{
PaperSize = DocPaperSize.A4,
RemovePaperMargin = false,
FontFolders = ["/usr/share/fonts/truetype"],
AllowSearch = true
},
new ExcelConfig
{
PaperLandscape = true,
AutoFitContents = true,
CalculateFormula = true,
SplitWorksheets = false,
PrintGridlines = false
},
new PptConfig
{
FastLoad = true,
FontFolders = ["/usr/share/fonts/truetype"],
AllowSearch = true
},
new CadConfig
{
ShowColor = true,
WhiteBackground = true,
ShowModel = true,
ShowLayouts = false,
QualityText = CadConfig.RenderQuality.High
},
new EmailConfig
{
SkipExternalImages = true,
RemoveLastWhitePage = true,
TimeZoneOffset = TimeSpan.Zero
},
new ImageConfig
{
MaxImagePixelSize = 3000,
TransparentPng = true
},
new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames,
AnimationFrameDelayMs = 100,
LoopCount = 0
}
];בחירה לפי סיומת
static BaseConfig? ConfigForExtension(string extUpper) => extUpper switch
{
".DOC" or ".DOCX" or ".DOT" or ".DOTX" or ".ODT" => new WordConfig
{
AutoFitAllTables = WordConfig.TableAutoFitBehavior.AutoFitToWindow,
PaperSize = DocPaperSize.Tabloid,
PdfConfig = new PdfConfig { ExtractHyperlinks = true, HyperlinksPageCount = 5, AllowCopy = true }
},
".PDF" => new PdfConfig { AllowSearch = true, AllowCopy = true },
".XLS" or ".XLSX" or ".ODS" or ".CSV" => new ExcelConfig { AllowSearch = true, AllowCopy = true },
".DCM" or ".IMA" => new DicomConfig { DisplayMode = DicomDisplayMode.AnimationAndFrames },
// DefaultRender = false → הפנייה ל‑PDF → חיפוש טקסט מקורי מדויק בפיקסלים
".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
_ => null // חזור לתצורת ברירת המחדל של הפורמט
};האם דף זה היה מועיל?