תצורות פורמט

אפשרויות רינדור מלאות לכל פורמט

כל מסמך נפתח עם יישום של BaseConfig. העבר אחד ל‑OpenDocumentAsync או תן לקטלוג הפורמטים ליצור את ברירת המחדל שלו. כל המחלקות שלהלן נמצאות במרחב השמות Doconut.

csharp
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

סוגמאפייןברירת מחדלהתנהגות
intImageResolution00 משתמש בברירת המחדל של הפורמט. טווח מפורש תקף הוא 25-300 DPI; הקצאות לא חוקיות מתעלמות.
stringDocumentCulture""מיקום לתאריכים ולמספרים. ערכים שאינם ריקים נחתכים; הקצאות ריקות מתעלמות.
stringPassword""סיסמת מסמך מוגן. DocOptions.Password מועתקת כאן אוטומטית.
boolShowUItrueמאפיין תאימות; הרנדרר הנוכחי אינו משתמש בו כדי לשלוט בסרגל הכלים של הדפדפן.
boolCachePagestrueשמור במטמון תמונות דפים מרונדרים עבור סשן המסמך.

PdfConfig

פורמטים: PDF. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueמתג תאימות. המפעל הנוכחי משתמש במציג PDF הטבעי.
boolAllowSearchfalseבנה/השתמש באינדקס חיפוש טקסט ב‑PDF. דורש את יכולת רישיון החיפוש לבקשות.
boolAllowCopyfalseאפשר פעולות בחירת/העתקת טקסט.
boolExtractHyperlinksfalseחלץ ריבועי קישורים עבור שכבות לקוח.
intHyperlinksPageCount0מספר מקסימלי של דפים שנסרקו עבור קישורים; 0 משמעותו כל הדף.
boolCompressImagesfalseדחוס תמונות משובצות לפני הרינדור.
intCompressQuality100איכות JPEG המשמשת כאשר הדחיסה מופעלת.
boolResizeImagesfalseשנה גודל של תמונות משובצות לפני הרינדור.
intResizeResolution300DPI יעד לתמונות משנות גודל.
boolCompressFastfalseהעדף את נתיב הדחיסה המהיר, באיכות נמוכה יותר.
boolFixInvalidImagesfalseנסה לתקן תמונות משובצות לא תקינות.
boolSplitSegmentsfalseאחד מילים שנפצלות בין מקטעי שורה כדי לשפר חיפוש/העתקה.

showHyperlinks ב‑ViewerConfig שולט בשכבת הלקוח, בעוד ExtractHyperlinks שולט בחילוץ השרת. אפשר את שניהם.

WordConfig

פורמטים: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueרינדור Word טבעי; false משתמש בהפנייה ל‑PDF.
PdfConfigPdfConfignew instanceהגדרות המשמשות את נתיב ה‑PDF/חיפוש.
DocPaperSizePaperSizeA4גודל נייר פלט. השתמש ב‑Custom עם רוחב/גובה.
intPaperWidth595רוחב מותאם אישית בנקודות.
intPaperHeight841גובה מותאם אישית בנקודות.
boolRemovePaperMarginfalseהסר מרווחי עמוד של המסמך.
boolRenderPageColortrueשמור על צבע העמוד המוגדר ב‑Word; false מציג דפים לבנים.
boolExportPdfAfalseהשתמש ב‑PDF/A ארכיוני בנתיב ה‑PDF.
Encoding?FileEncodingnullעקוף קידוד מקור.
stringFontInfo""מידע על החלפת גופנים.
string[]?FontFoldersnullספריות גופנים נוספות, שימושיות במיוחד בלינוקס/קונטיינרים.
boolAllowSearchfalseמופעל על ידי PdfConfig.AllowSearch.
boolAllowCopyfalseמופעל על ידי PdfConfig.AllowCopy.
TableAutoFitBehaviorAutoFitAllTablesNoneNone, AutoFitToContents, או AutoFitToWindow.

ExcelConfig

פורמטים: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueרינדור גיליון מקורי; false משתמש בהפנייה ל‑PDF.
PdfConfigPdfConfignew instanceהגדרות לנתיב PDF/חיפוש.
ExcelPaperSizePaperSizePaperA4גודל נייר פלט.
doublePaperMargins0.25שולשי עמוד באינצ'ים.
boolPaperLandscapetrueרינדור גיליון באופק.
boolAutoFitContentsfalseהתאמה אוטומטית של גובה השורות ורוחב העמודות.
boolRemoveEmptyContenttrueצמצום הפלט על‑ידי הוצאת תוכן ריק.
boolCalculateFormulatrueחישוב מחדש של נוסחאות לפני הרינדור.
boolShowRowColumnHeaderstrueהכללת כותרות הגיליון.
boolExportPdfAfalseשימוש ב‑PDF/A בנתיב ה‑PDF.
boolSplitWorksheetsfalseשמירת גיליונות כקבוצות עמודים נפרדות.
boolShowEmptyWorkSheetsfalseהכללת גיליונות ריקים.
boolExportLandscapefalseאילוץ ייצוא באופק.
boolExportOnePagePerSheetfalseהתאמת כל גיליון לעמוד פלט אחד.
boolMemoryOptimizationPreferencetrueהפחתת זיכרון שיא, ייתכן במחיר של ירידה קלה במהירות.
boolAutoTrimWorksheetRenderRangetrueרינדור רק של הטווח המשמש הגלוי כאשר אין תחום הדפסה מפורש.
boolAutoTrimPreserveExistingPrintAreatrueשמירת תחומי הדפסה שהוגדרו במחברת במהלך קיצוץ אוטומטי.
string?PrintAreanullטווח מפורש כגון "A1:Z100".
boolPrintGridlinesfalseהדפסת קווי רשת של הגיליון.
boolPrintHeadingsfalseהדפסת כותרות שורה/עמודה.
List<string>SheetNamesemptyהגבלת הרינדור לגיליונות בשם.
CustomStyleCell?CustomStylesnullשכתוב פורמט אופציונלי לתאריכים/דצימלים/שלמים.
boolAllowSearchfalseמופנה ל‑PdfConfig.AllowSearch.
boolAllowCopyfalseמופנה ל‑PdfConfig.AllowCopy.

CustomStyleCell מציג את CustomStyleDateTime, CustomStyleNumberDecimal ו‑CustomStyleNumberInteger, כולם מחרוזות ניתנות לאפס.

new ExcelConfig() מגדיר את SplitWorksheets ל‑false; פתיחת קובץ Excel ללא תצורה מפורשת משתמשת בקטלוג הפורמטים, שמגדיר אותו ל‑true.

PptConfig

פורמטים: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueרינדור שקופית מקורי; false משתמש בהפנייה ל‑PDF.
boolFastLoadfalseהימנעות מרינדור השקופית הראשונה בעת פתיחה; שימוש במטא‑נתונים ורינדור לפי דרישה.
PdfConfigPdfConfignew instanceהגדרות להתנהגות PDF/חיפוש.
stringFontInfo""מידע על החלפת גופנים.
string[]?FontFoldersnullספריות גופנים נוספות.
boolAllowSearchfalseמופנה ל‑PdfConfig.AllowSearch.
boolAllowCopyfalseמופנה ל‑PdfConfig.AllowCopy.

הדפים מצוירים עם הגופנים המותקנים על השרת. בלינוקס, התקינו את הגופנים שהמצגות משתמשות בהם או הפנו את FontFolders אליהם: גופן חסר מוחלף ללא שגיאה, ולכן שבירת השורות יכולה להיות שונה מ‑Windows. fonts-liberation, fonts-crosextra-carlito ו‑fonts-crosextra-caladea מספקים תחליפים תואמי מדד לגופנים הנפוצים ב‑Windows. בלינוקס נדרש רק libfontconfig1 (‏libgdiplus אינו נדרש).

CadConfig

פורמטים: DWG, DXF, DGN. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueרינדור CAD מקורי; false משתמש בהפנייה ל‑PDF.
PdfConfigPdfConfignew instanceהגדרות נתיב PDF.
boolExportPdfAfalseפלט PDF/A ארכיוני.
boolShowColortrueצבע במקום שחור‑לבן.
boolWhiteBackgroundtrueרקע לבן במקום שחור.
shortLineWidth25רוחב קו CAD.
boolShowLayoutsfalseרינדור לשוניות פריסה.
boolShowModeltrueרינדור מרחב מודל.
boolCheck3DSolidtrueעיבוד מוצקים תלת‑ממדיים.
boolExportAllLayoutsfalseייצוא כל הפריסות, תוך עקיפת בחירת מודל/פריסה.
boolLimitMinimumSizefalseהחלת MinimumSize.
intMinimumSize700גודל פלט מינימלי בפיקסלים.
boolLimitMaximumSizefalseהחלת MaximumSize.
intMaximumSize700גודל פלט מרבי בפיקסלים.
boolShowAllLayoutsDgnfalseהכללת כל פריסות DGN.
boolAutomaticLayoutScalingtrueשינוי גודל פריסות באופן אוטומטי.
floatPdfMargins0.5שוליים של PDF באינצ'ים.
RenderQualityQualityImageLowאיכות רסטר: Low, Medium או High.
RenderQualityQualityTextMediumאיכות טקסט: Low, Medium או High.

תצורת דוא"ל

פורמטים: EML, EMLX, MSG. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueהצגה מקומית של דוא"ל; false משתמש בהפנייה ל‑PDF.
PdfConfigPdfConfigמופע חדשהגדרות נתיב PDF.
Encoding?EmailEncodingnullהחלפת קידוד ההודעה.
Encoding?SubjectEncodingnullהחלפת קידוד הנושא.
Encoding?BodyEncodingnullהחלפת קידוד הגוף.
boolSkipExternalImagesfalseלא לטעון תמונות שמקושרות מרחוק. מומלץ לדוא"ל בלתי מהימן.
boolRemoveLastWhitePagefalseהסרת דף ריק סופי.
boolUseAntiAliasingfalseהפעלת אנטי‑אלייזינג.
boolUseHighQualityRenderingfalseהעדפת רינדור נקי יותר, אך איטי יותר.
TimeSpan?TimeZoneOffsetnullהחלפת אזור הזמן המשמש לתאריכים.
boolForcePageSizefalseאילוץ ממדי דף קבועים.

תצורת ImageConfig, TiffConfig ו‑PsdConfig

ImageConfig תומך ב‑JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF ו‑SVG. DPI ברירת המחדל שלו הוא 100.

תצורהמאפייןברירת מחדלהתנהגות
ImageConfigMaxImagePixelSize3000רוחב/גובה מרבי. 0 משמעותו ללא הגבלה; ערכים שונים מאפס מתחת ל‑50 מתעלמים.
ImageConfigTransparentPngtrueשימור שקיפות PNG; false משתמש ברקע לבן.
TiffConfigאין מאפיינים נוספיםDPI 200משתמש רק ב‑BaseConfig; תומך ב‑TIFF מרובה עמודים.
PsdConfigMaxImagePixelSize3000אותה אימות 0/minimum-50 כמו ImageConfig; ברירת המחדל של DPI היא 100.

תצורת DicomConfig

פורמטים: DCM, IMA. DPI אפקטיבי ברירת מחדל: 100. דורש את תוסף DICOM. בחבילה זו קבצי DICOM מוצגים במלואם, אך מטא‑נתונים טכניים אינם זמינים — ראה תוסף DICOM.

סוגמאפייןברירת מחדלהתנהגות
intHorizontalResolution100 אפקטיביDPI אופקי מפורש; אחרת ImageResolution, ואז 100.
intVerticalResolution100 אפקטיביDPI אנכי מפורש; אחרת ImageResolution, ואז 100.
intAnimationFrameDelayMs100השהיית אנימציה מרובת פריימים; תזמון GIF משתמש ביחידות של 10 מ״ש.
ushortLoopCount00 חוזר לנצח; ערכים חיוביים עוצרים לאחר ספירה זו.
DicomDisplayModeDisplayModeAnimationAndFramesAnimationOnly, FramesOnly, או תצוגה משולבת עם פריימים סטטיים.

תצורת TxtConfig

פורמט: TXT. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
DocPaperSizePaperSizeA4גודל נייר פלט.
Encoding?FileEncodingnullnull משתמש ב‑UTF-8.
stringFontInformation""מידע על גופנים עבור רינדור טקסט.

השתמש ב‑WordConfig כאשר טקסט פשוט דורש התנהגות פריסת עמודים עשירה יותר.

תצורת ProjectConfig

פורמטים: MPP, MPPX, MPX. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueתמונת Gantt מקומית; false משתמש בנתיב PDF מבוסס טקסט.
PdfConfigPdfConfigמופע חדשהגדרות נתיב PDF.
boolExportPdfAtrueפלט PDF/A ארכיוני.
MppPaperSizePaperSizeLedgerגודל נייר פלט של הפרויקט.
MppTimeScaleTimeScaleMonthsDays או Months.
MppFormatPresentationFormatGanttChartGanttChart, TaskUsage, ResourceUsage, ResourceSheet, או TaskSheet.

לחיפוש מדויק לפי קואורדינטות טקסט, השתמש ב‑DefaultRender = false.

תצורת VisioConfig

פורמטים: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. DPI ברירת מחדל: 200.

סוגמאפייןברירת מחדלהתנהגות
boolDefaultRendertrueהצגה מקומית של דיאגרמה; false משתמש בהפנייה ל‑PDF.
PdfConfigPdfConfigמופע חדשהגדרות נתיב PDF.
boolExportPdfAtrueפלט PDF/A ארכיוני.

תצורת HtmlConfig, EpubConfig, MhtConfig ו‑XpsConfig

הארבעה מקבלים ברירת מחדל של 200 DPI ומחשפים PdfConfig מקונן.

תצורהפורמטיםDefaultRenderמאפיינים/התנהגות נוספים
HtmlConfigHTML, HTMtrueהצגה מקומית; השתמש ב‑false לנתיב חיפוש PDF מבוסס טקסט.
EpubConfigEPUBtrueהצגה מקומית; false משתמש ב‑PDF.
MhtConfigMHT, MHTMLtrue על המחלקה; false בקטלוג האוטומטיהפתיחה הרגילה ללא תצורה משתמשת בהפנייה ל‑PDF הניתן לחיפוש. מופע ברירת מחדל שנבנה במפורש מציג באופן מקומי.
XpsConfigXPSfalseמשתמש בנתיב PDF כברירת מחדל; הגדר true להצגת תמונה מקומית.

דוגמאות תצורה לפי משפחה

csharp
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
    }
};

בחירה לפי סיומת

csharp
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 // חזרה לתצורת ברירת המחדל של הפורמט
};

האם דף זה היה מועיל?