תצורות פורמט
אפשרויות רינדור מלאות לכל פורמט
כל מסמך נפתח עם יישום של 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. דורש את יכולת רישיון החיפוש לבקשות. |
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 | ספריות גופנים נוספות, שימושיות במיוחד בלינוקס/קונטיינרים. |
bool | AllowSearch | false | מופעל על ידי PdfConfig.AllowSearch. |
bool | AllowCopy | false | מופעל על ידי PdfConfig.AllowCopy. |
TableAutoFitBehavior | AutoFitAllTables | None | None, AutoFitToContents, או AutoFitToWindow. |
ExcelConfig
פורמטים: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | רינדור גיליון מקורי; false משתמש בהפנייה ל‑PDF. |
PdfConfig | PdfConfig | new instance | הגדרות לנתיב 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.
PptConfig
פורמטים: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | רינדור שקופית מקורי; false משתמש בהפנייה ל‑PDF. |
bool | FastLoad | false | הימנעות מרינדור השקופית הראשונה בעת פתיחה; שימוש במטא‑נתונים ורינדור לפי דרישה. |
PdfConfig | PdfConfig | new instance | הגדרות להתנהגות PDF/חיפוש. |
string | FontInfo | "" | מידע על החלפת גופנים. |
string[]? | FontFolders | null | ספריות גופנים נוספות. |
bool | AllowSearch | false | מופנה ל‑PdfConfig.AllowSearch. |
bool | AllowCopy | false | מופנה ל‑PdfConfig.AllowCopy. |
הדפים מצוירים עם הגופנים המותקנים על השרת. בלינוקס, התקינו את הגופנים שהמצגות משתמשות בהם או הפנו את FontFolders אליהם: גופן חסר מוחלף ללא שגיאה, ולכן שבירת השורות יכולה להיות שונה מ‑Windows. fonts-liberation, fonts-crosextra-carlito ו‑fonts-crosextra-caladea מספקים תחליפים תואמי מדד לגופנים הנפוצים ב‑Windows. בלינוקס נדרש רק libfontconfig1 (libgdiplus אינו נדרש).
CadConfig
פורמטים: DWG, DXF, DGN. DPI ברירת מחדל: 200.
| סוג | מאפיין | ברירת מחדל | התנהגות |
|---|---|---|---|
bool | DefaultRender | true | רינדור CAD מקורי; false משתמש בהפנייה ל‑PDF. |
PdfConfig | PdfConfig | new instance | הגדרות נתיב 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/minimum-50 כמו ImageConfig; ברירת המחדל של DPI היא 100. |
תצורת DicomConfig
פורמטים: DCM, IMA. DPI אפקטיבי ברירת מחדל: 100. דורש את תוסף DICOM. בחבילה זו קבצי DICOM מוצגים במלואם, אך מטא‑נתונים טכניים אינם זמינים — ראה תוסף 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
הארבעה מקבלים ברירת מחדל של 200 DPI ומחשפים 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 = new[] { "/usr/share/fonts/truetype" },
AllowSearch = true
},
new ExcelConfig
{
PaperLandscape = true,
AutoFitContents = true,
CalculateFormula = true,
SplitWorksheets = false,
PrintGridlines = false
},
new PptConfig
{
FastLoad = true,
FontFolders = new[] { "/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 // חזרה לתצורת ברירת המחדל של הפורמט
};האם דף זה היה מועיל?