תצורות פורמט – Doconut תיעוד

כל מסמך נפתח עם מימוש של 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

סוג	מאפיין	ברירת מחדל	התנהגות
`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`.

ExcelConfig

פורמטים: 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`	ריק	הגבלת הרינדור לגיליונות בשם.
`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`	מופע חדש	הגדרות להתנהגות PDF/חיפוש.
`string`	`FontInfo`	`""`	מידע על החלפת גופנים.
`string[]?`	`FontFolders`	`null`	ספריות גופנים נוספות.
`bool`	`AllowSearch`	`false`	מועבר ל‑`PdfConfig.AllowSearch`.
`bool`	`AllowCopy`	`false`	מועבר ל‑`PdfConfig.AllowCopy`.

ב‑Linux וב‑macOS, רינדור מצגות עם המנוע הנוכחי דורש libgdiplus ו‑System.Drawing.EnableUnixSupport=true. יש להתקין את הגופנים שבהם משתמשת המצגת או לספק FontFolders.

CadConfig

פורמטים: 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`	הכרח ממדי דף קבועים.

תצורת תמונה, תצורת Tiff ותצורת Psd

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`.

תצורת DICOM

פורמטים: DCM, IMA. DPI אפקטיבי ברירת מחדל: 100. דורש את תוסף DICOM.

סוג	מאפיין	ברירת מחדל	התנהגות
`int`	`HorizontalResolution`	`100` effective	DPI אופקי מפורש; אחרת `ImageResolution`, ואז 100.
`int`	`VerticalResolution`	`100` effective	DPI אנכי מפורש; אחרת `ImageResolution`, ואז 100.
`int`	`AnimationFrameDelayMs`	`100`	השהיית אנימציה מרובת מסגרות; תזמון GIF משתמש ביחידות של 10 מ״ש.
`ushort`	`LoopCount`	`0`	`0` חוזר לנצח; ערכים חיוביים נעצרים אחרי ספירה זו.
`DicomDisplayMode`	`DisplayMode`	`AnimationAndFrames`	`AnimationOnly`, `FramesOnly`, או תצוגה משולבת עם מסגרות סטטיות.

תצורת טקסט

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

סוג	מאפיין	ברירת מחדל	התנהגות
`DocPaperSize`	`PaperSize`	`A4`	גודל נייר פלט.
`Encoding?`	`FileEncoding`	`null`	`null` משתמש ב‑UTF-8.
`string`	`FontInformation`	`""`	מידע על גופנים לרינדור טקסט.

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

תצורת פרויקט

פורמטים: 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.

תצורת Visio

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

סוג	מאפיין	ברירת מחדל	התנהגות
`bool`	`DefaultRender`	`true`	רינדור דיאגרמה מקומי; `false` משתמש ב‑הפנייה ל‑PDF.
`PdfConfig`	`PdfConfig`	מופע חדש	הגדרות נתיב PDF.
`bool`	`ExportPdfA`	`true`	פלט PDF/A ארכיוני.

תצורות Html, Epub, Mht ו‑Xps

כל הארבעה משתמשים ב‑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` לרינדור תמונה מקורי.

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

csharp

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

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

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