# ReaderPdfOptions

Options for PDF ingestion through the OfficeIMO.Reader adapter.

Class 

`OfficeIMO.Reader.Pdf`

**Namespace**

`OfficeIMO.Reader.Pdf`

**Assembly**

`OfficeIMO.Reader.Pdf`

**Source revision**

`ba882f6b0d07` with working tree changes

**Source**

[ReaderPdfOptions.cs:43](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L43)

**Modifiers**

sealed

Options for PDF ingestion through the OfficeIMO.Reader adapter.

## Inheritance

- object
- ReaderPdfOptions

## Usage

Explore 4 API references to this type

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

### Returned or exposed by 2

- Method [ReaderPdfOptions.Clone](/api/reader-pdf/officeimo-reader-pdf-readerpdfoptions/#method-clone)
- Method [ReaderPdfOptions.CreateOfficeIMOProfile](/api/reader-pdf/officeimo-reader-pdf-readerpdfoptions/#method-createofficeimoprofile)

### Accepted by parameters 2

- Method [OfficeDocumentReaderBuilderPdfExtensions.AddPdfHandler](/api/reader-pdf/officeimo-reader-pdf-officedocumentreaderbuilderpdfextensions/#method-addpdfhandler-officeimo-reader-officedocumentreaderbuilder-officeimo-reader-pdf-readerpdfoptions-boolean) parameter `pdfOptions`
- Method [PdfDocumentReaderExtensions.ReadDocument](/api/reader-pdf/officeimo-reader-pdf-pdfdocumentreaderextensions/#method-readdocument-officeimo-pdf-pdfdocumentreadresult-string-officeimo-reader-readeroptions-officeimo-reader-pdf-readerpdfoptions-threading-cancellationtoken) parameter `pdfOptions`

Filter members 

Show inherited

## Constructors

`public ReaderPdfOptions()` [#](#constructor-ctor)

[ReaderPdfOptions.cs:43](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L43)

## Methods

`public ReaderPdfOptions Clone()` [#](#method-clone)

[ReaderPdfOptions.cs:69](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L69)

Creates a defensive copy for handler registration reuse.

Returns

`ReaderPdfOptions`

`public static ReaderPdfOptions CreateOfficeIMOProfile()` [#](#method-createofficeimoprofile)

[ReaderPdfOptions.cs:19](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L19)

Creates the default PDF reader profile with page-level chunks and wrapper-friendly Markdown.

Returns

`ReaderPdfOptions`

## Inherited Methods

`public virtual bool Equals(object? obj)` [#](#method-equals-object)

Inherited from object

Parameters

**obj object? required**

Returns

`bool`

`public virtual int GetHashCode()` [#](#method-gethashcode)

Inherited from object

Returns

`int`

`public Type GetType()` [#](#method-gettype)

Inherited from object

Returns

`Type`

`public virtual string? ToString()` [#](#method-tostring)

Inherited from object

Returns

`string?`

## Properties

`public string? Password { get; set; }` [#](#property-password)

[ReaderPdfOptions.cs:10](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L10)

Optional password used locally to open an encrypted PDF. It is not included in extracted content or metadata.

`public PdfLoadOptions? LoadOptions { get; set; }` [#](#property-loadoptions)

[ReaderPdfOptions.cs:14](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L14)

Full canonical parser, security and stream budgets. Registration and each read snapshot these settings. ReaderOptions.MaxInputBytes further restricts the input limit; Password overrides this password when non-null.

`public PdfLoadOptions? ReadOptions { get; set; }` [#](#property-readoptions)

[ReaderPdfOptions.cs:32](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L32)

Canonical semantic read settings. Null uses PdfLoadOptions. When the adapter receives an already reconstructed PDF result, only its page selection is applied.

`public PdfLogicalMarkdownOptions? MarkdownOptions { get; set; }` [#](#property-markdownoptions)

[ReaderPdfOptions.cs:37](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L37)

Markdown rendering options used for page chunk content.

`public bool IncludeParagraphContinuationMetadata { get; set; }` [#](#property-includeparagraphcontinuationmetadata)

[ReaderPdfOptions.cs:43](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L43)

When true, projects conservative cross-page paragraph continuation evidence into document metadata. Page-local text and chunks remain unchanged. Default: true.

`public PdfLogicalParagraphContinuationOptions? ParagraphContinuationOptions { get; set; }` [#](#property-paragraphcontinuationoptions)

[ReaderPdfOptions.cs:46](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L46)

Optional confidence and soft-hyphen policy for paragraph continuation metadata.

`public bool ChunkByPage { get; set; }` [#](#property-chunkbypage)

[ReaderPdfOptions.cs:51](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L51)

When true, emits one or more chunks per logical source page. Default: true.

`public bool IncludeMixedPageOcrCandidates { get; set; }` [#](#property-includemixedpageocrcandidates)

[ReaderPdfOptions.cs:57](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L57)

Includes substantial image content on pages that also contain native text in OCR candidate discovery. Default: false. A candidate is a review signal, not proof that an image contains text.

`public double MinimumMixedPageImageAreaRatio { get; set; }` [#](#property-minimummixedpageimagearearatio)

[ReaderPdfOptions.cs:63](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Reader.Pdf/ReaderPdfOptions.cs#L63)

Minimum combined visible image area as a fraction of page area for mixed-page OCR candidates. Defaults to 0.25. Zero considers every mixed image page; values must be finite and between zero and one.

<!-- PowerForge markdown artifact sha256:6DE6F4A949A577DD5D6944318DB4092BA8DD5C9F000BBFA80AF12551396CE846 -->
