Configurations de format

Chaque document s'ouvre avec une implémentation BaseConfig. Passez‑en une à OpenDocumentAsync ou laissez le catalogue de formats créer sa valeur par défaut. Toutes les classes ci‑dessous résident dans l'espace de noms Doconut.

var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
    AllowSearch = true,
    AllowCopy   = true,
    ImageResolution = 150
});

Héritage et paramètres PDF imbriqués

Chaque format hérite des cinq propriétés BaseConfig. Les formats pouvant rediriger via PDF exposent un PdfConfig imbriqué. Dans WordConfig, ExcelConfig et PptConfig, AllowSearch et AllowCopy sont des propriétés pratiques qui lisent et écrivent le PdfConfig imbriqué.

DefaultRender = true sélectionne le moteur de rendu natif du format. Sur les formats avec une redirection PDF, false convertit d'abord en PDF en mémoire puis utilise le visualiseur PDF. Cette voie est souvent utile pour la recherche par coordonnées de texte, mais entraîne une conversion supplémentaire.

Sauf indication contraire, les tableaux affichent les valeurs par défaut des constructeurs/propriétés. Le catalogue de formats automatique remplace délibérément deux d'entre elles : il crée ExcelConfig avec SplitWorksheets = true, et MhtConfig avec DefaultRender = false.

BaseConfig

PdfConfig

Formats : PDF. DPI par défaut : 200.

showHyperlinks dans ViewerConfig contrôle la superposition client, tandis que ExtractHyperlinks contrôle l'extraction serveur. Activez les deux.

WordConfig

Formats : DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. DPI par défaut : 200.

ConfigurationExcel

Formats : XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. DPI par défaut : 200.

CustomStyleCell expose CustomStyleDateTime, CustomStyleNumberDecimal et CustomStyleNumberInteger, toutes des chaînes nullables.

new ExcelConfig() définit SplitWorksheets à false ; l'ouverture d'un fichier Excel sans configuration explicite utilise le catalogue de formats, qui le définit à true.

ConfigurationPpt

Formats : PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. DPI par défaut : 200.

Sur Linux et macOS, le rendu des présentations avec le moteur actuel nécessite libgdiplus et System.Drawing.EnableUnixSupport=true. Installez les polices utilisées par la présentation ou fournissez FontFolders.

ConfigurationCad

Formats : DWG, DXF, DGN. DPI par défaut : 200.

ConfigurationEmail

Formats : EML, EMLX, MSG. DPI par défaut : 200.

ConfigurationImage, ConfigurationTiff et ConfigurationPsd

ImageConfig couvre JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF et SVG. Son DPI par défaut est 100.

ConfigurationDicom

Formats : DCM, IMA. DPI effectif par défaut : 100. Nécessite le plugin DICOM.

ConfigurationTxt

Format : TXT. DPI par défaut : 200.

Utilisez WordConfig lorsque le texte brut nécessite un comportement de mise en page plus riche.

ConfigurationProjet

Formats : MPP, MPPX, MPX. DPI par défaut : 200.

Pour une recherche exacte par coordonnées de texte, utilisez DefaultRender = false.

ConfigurationVisio

Formats : VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. DPI par défaut : 200.

ConfigurationHtml, ConfigurationEpub, ConfigurationMht et ConfigurationXps

Les quatre utilisent par défaut le DPI 200 et exposent un PdfConfig imbriqué.

Exemples de configuration par famille

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

Sélection par extension

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 → redirection PDF → recherche de texte native précise au pixel
    ".HTML" or ".HTM" => new HtmlConfig { DefaultRender = false },
    ".EML" or ".EMLX" or ".MSG" => new EmailConfig { DefaultRender = false },
    _ => null // revenir à la config par défaut du format
};