포맷 구성

포맷별 전체 렌더링 옵션

모든 문서는 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 뷰어를 사용합니다.
boolAllowSearchfalsePDF 텍스트 검색 인덱스를 구축/사용합니다. 요청에 대해 Search 라이선스 기능이 필요합니다.
boolAllowCopyfalse텍스트 선택/복사 작업을 허용합니다.
boolExtractHyperlinksfalse클라이언트 오버레이를 위해 링크 사각형을 추출합니다.
intHyperlinksPageCount0링크를 스캔하는 최대 페이지 수; 0는 모든 페이지를 의미합니다.
boolCompressImagesfalse렌더링 전에 삽입된 이미지를 압축합니다.
intCompressQuality100압축이 활성화된 경우 사용되는 JPEG 품질입니다.
boolResizeImagesfalse렌더링 전에 삽입된 이미지를 크기 조정합니다.
intResizeResolution300크기 조정된 이미지의 목표 DPI입니다.
boolCompressFastfalse더 빠르고 낮은 품질의 압축 경로를 선호합니다.
boolFixInvalidImagesfalse잘못된 삽입 이미지를 복구하려 시도합니다.
boolSplitSegmentsfalse검색/복사를 개선하기 위해 줄 구간에 걸쳐 분리된 단어를 다시 합칩니다.

showHyperlinks는 ViewerConfig에서 클라이언트 오버레이를 제어하고, ExtractHyperlinks는 서버 추출을 제어합니다. 둘 모두 활성화하세요.

WordConfig

포맷: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, ODT, OTT, XML. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 Word 렌더링; false는 PDF 리다이렉트를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF/검색 경로에서 사용되는 설정입니다.
DocPaperSizePaperSizeA4출력 용지 크기. 너비/높이와 함께 Custom를 사용하세요.
intPaperWidth595포인트 단위의 사용자 정의 너비.
intPaperHeight841포인트 단위의 사용자 정의 높이.
boolRemovePaperMarginfalse문서 페이지 여백을 제거합니다.
boolRenderPageColortrueWord에서 설정된 페이지 색상을 유지합니다; false는 흰색 페이지를 렌더링합니다.
boolExportPdfAfalsePDF 경로에서 보관용 PDF/A를 사용합니다.
Encoding?FileEncodingnull소스 인코딩을 재정의합니다.
stringFontInfo""글꼴 대체 정보.
string[]?FontFoldersnull추가 글꼴 디렉터리, 특히 Linux/컨테이너에서 유용합니다.
boolAllowSearchfalsePdfConfig.AllowSearch에 위임합니다.
boolAllowCopyfalsePdfConfig.AllowCopy에 위임합니다.
TableAutoFitBehaviorAutoFitAllTablesNoneNone, AutoFitToContents, 또는 AutoFitToWindow.

Excel 구성

포맷: XLS, XLSX, XLSM, XLSB, XLTX, XLTM, ODS, CSV. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 시트 렌더링; false 은 PDF 리다이렉트를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF/검색 경로 설정.
ExcelPaperSizePaperSizePaperA4출력 용지 크기.
doublePaperMargins0.25인치 단위 페이지 여백.
boolPaperLandscapetrue가로 방향 시트 렌더링.
boolAutoFitContentsfalse행 높이와 열 너비를 자동 맞춤.
boolRemoveEmptyContenttrue빈 콘텐츠를 제외하여 출력 압축.
boolCalculateFormulatrue렌더링 전에 수식 재계산.
boolShowRowColumnHeaderstrue스프레드시트 헤더 포함.
boolExportPdfAfalsePDF 경로에 PDF/A 사용.
boolSplitWorksheetsfalse워크시트를 별도 페이지 그룹으로 유지.
boolShowEmptyWorkSheetsfalse빈 워크시트 포함.
boolExportLandscapefalse가로 방향 내보내기 강제.
boolExportOnePagePerSheetfalse각 워크시트를 하나의 출력 페이지에 맞춤.
boolMemoryOptimizationPreferencetrue피크 메모리 감소, 일부 속도 저하 가능.
boolAutoTrimWorksheetRenderRangetrue명시적 인쇄 영역이 없을 때 사용된 범위만 렌더링.
boolAutoTrimPreserveExistingPrintAreatrue자동 트림 중 워크북 정의 인쇄 영역 보존.
string?PrintAreanull예: "A1:Z100" 와 같은 명시적 범위.
boolPrintGridlinesfalse워크시트 격자선 인쇄.
boolPrintHeadingsfalse행/열 헤더 인쇄.
List<string>SheetNames비어 있음지정된 워크시트만 렌더링 제한.
CustomStyleCell?CustomStylesnull선택적 날짜/소수/정수 형식 재정의.
boolAllowSearchfalsePdfConfig.AllowSearch 에 위임.
boolAllowCopyfalsePdfConfig.AllowCopy 에 위임.

CustomStyleCell 은 CustomStyleDateTime, CustomStyleNumberDecimal, 그리고 CustomStyleNumberInteger 를 노출하며, 모두 nullable 문자열입니다.

new ExcelConfig() 은 SplitWorksheets 을 false 로 설정합니다; 명시적 구성이 없는 Excel 파일을 열면 포맷 카탈로그를 사용하며, 이는 true 로 설정합니다.

Ppt 구성

포맷: PPT, PPTX, PPTM, PPSX, PPSM, POT, POTX, POTM, ODP. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 슬라이드 렌더링; false 은 PDF 리다이렉트를 사용합니다.
boolFastLoadfalse열 때 첫 슬라이드 렌더링을 피하고 메타데이터 사용 및 필요 시 렌더링.
PdfConfigPdfConfig새 인스턴스PDF/검색 동작 설정.
stringFontInfo""글꼴 대체 정보.
string[]?FontFoldersnull추가 글꼴 디렉터리.
boolAllowSearchfalsePdfConfig.AllowSearch 에 위임.
boolAllowCopyfalsePdfConfig.AllowCopy 에 위임.

페이지는 서버에 설치된 글꼴로 그려집니다. Linux에서는 프레젠테이션이 사용하는 글꼴을 설치하거나 FontFolders 를 해당 위치에 지정하십시오: 누락된 글꼴은 오류 없이 대체되며, 이로 인해 줄 바꿈이 Windows와 다를 수 있습니다. fonts-liberation, fonts-crosextra-carlito, 그리고 fonts-crosextra-caladea 은 일반 Windows 글꼴에 대한 메트릭 호환 대체 글꼴을 제공합니다. Linux에서는 libfontconfig1 만 필요합니다 (libgdiplus 은 필요하지 않음).

Cad 구성

포맷: DWG, DXF, DGN. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 CAD 렌더링; false 은 PDF 리다이렉트를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF 경로 설정.
boolExportPdfAfalse보관용 PDF/A 출력.
boolShowColortrue흑백이 아닌 색상 출력.
boolWhiteBackgroundtrue배경을 검은색 대신 흰색으로.
shortLineWidth25CAD 스트로크 두께.
boolShowLayoutsfalse레이아웃 탭 렌더링.
boolShowModeltrue모델 공간 렌더링.
boolCheck3DSolidtrue3D 솔리드 처리.
boolExportAllLayoutsfalse모델/레이아웃 선택을 무시하고 모든 레이아웃 내보내기.
boolLimitMinimumSizefalseMinimumSize 적용.
intMinimumSize700최소 출력 크기(픽셀).
boolLimitMaximumSizefalseMaximumSize 적용.
intMaximumSize700최대 출력 크기(픽셀).
boolShowAllLayoutsDgnfalse모든 DGN 레이아웃 포함.
boolAutomaticLayoutScalingtrue레이아웃 자동 스케일링.
floatPdfMargins0.5PDF 여백(인치).
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고정 페이지 차원을 강제합니다.

이미지 구성, Tiff 구성 및 Psd 구성

ImageConfig는 JPG, JPEG, JPE, PNG, BMP, GIF, ICO, EPS, TGA, WEBP, CDR, CMX, DNG, EMF, WMF, AVIF 및 SVG를 지원합니다. 기본 DPI는 100입니다.

구성속성기본값동작
ImageConfigMaxImagePixelSize3000최대 너비/높이. 0는 무제한을 의미합니다; 50 미만의 0이 아닌 값은 무시됩니다.
ImageConfigTransparentPngtruePNG 투명성을 유지합니다; false는 흰색 배경을 사용합니다.
TiffConfig추가 속성 없음DPI 200오직 BaseConfig만 사용합니다; 다중 페이지 TIFF를 지원합니다.
PsdConfigMaxImagePixelSize3000같은 0/minimum-50 검증을 ImageConfig와 동일하게 적용; 기본 DPI는 100입니다.

Dicom 구성

포맷: DCM, IMA. 기본 유효 DPI: 100. DICOM 플러그인이 필요합니다. 이 패키지에서는 DICOM 파일이 완전히 렌더링되지만 기술 메타데이터는 사용할 수 없습니다 — DICOM 플러그인을 참조하십시오.

유형속성기본값동작
intHorizontalResolution100 effective명시적 가로 DPI; 그렇지 않으면 ImageResolution, 그 다음 100.
intVerticalResolution100 effective명시적 세로 DPI; 그렇지 않으면 ImageResolution, 그 다음 100.
intAnimationFrameDelayMs100다중 프레임 애니메이션 지연; GIF 타이밍은 10 ms 단위를 사용합니다.
ushortLoopCount00는 무한 반복합니다; 양수 값은 해당 횟수 후에 멈춥니다.
DicomDisplayModeDisplayModeAnimationAndFramesAnimationOnly, FramesOnly, 또는 결합된 개요와 정적 프레임.

텍스트 구성

포맷: TXT. 기본 DPI: 200.

유형속성기본값동작
DocPaperSizePaperSizeA4출력 용지 크기.
Encoding?FileEncodingnullnull는 UTF-8을 사용합니다.
stringFontInformation""텍스트 렌더링을 위한 글꼴 정보.

일반 텍스트에 더 풍부한 페이지 레이아웃 동작이 필요할 때 WordConfig를 사용하십시오.

프로젝트 구성

포맷: MPP, MPPX, MPX. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 Gantt 이미지; false는 텍스트 기반 PDF 경로를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF 경로 설정.
boolExportPdfAtrue보관용 PDF/A 출력.
MppPaperSizePaperSizeLedger프로젝트 출력 용지 크기.
MppTimeScaleTimeScaleMonthsDays 또는 Months.
MppFormatPresentationFormatGanttChartGanttChart, TaskUsage, ResourceUsage, ResourceSheet, 또는 TaskSheet.

정확한 텍스트 좌표 검색을 위해 DefaultRender = false를 사용하십시오.

Visio 구성

포맷: VSD, VSDX, VSS, VSSX, VST, VSTX, VDX, VSX, VSDM. 기본 DPI: 200.

유형속성기본값동작
boolDefaultRendertrue네이티브 다이어그램 렌더링; false는 PDF 리다이렉트를 사용합니다.
PdfConfigPdfConfig새 인스턴스PDF 경로 설정.
boolExportPdfAtrue보관용 PDF/A 출력.

Html 구성, Epub 구성, Mht 구성 및 Xps 구성

네 가지 모두 기본 DPI가 200이며 중첩된 PdfConfig를 노출합니다.

구성포맷DefaultRender추가 속성/동작
HtmlConfigHTML, HTMtrue네이티브 렌더링; 텍스트 기반 PDF 검색 경로에 false를 사용하십시오.
EpubConfigEPUBtrue네이티브 렌더링; false는 PDF를 사용합니다.
MhtConfigMHT, MHTML클래스에 true; 자동 카탈로그에 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 // 형식의 기본 구성으로 폴백
};

이 페이지가 도움이 되었나요?