Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/

API Reference

Class

PdfImageOptimizationOptions

Namespace OfficeIMO.Pdf
Assembly OfficeIMO.Pdf
Source revision 804a7612eee4 with working tree changes
Modifiers sealed

Controls optional placement-aware image downsampling during PDF generation.

Inheritance

  • Object
  • PdfImageOptimizationOptions

Usage

Explore 2 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.

Constructors

public PdfImageOptimizationOptions() #

Methods

public PdfImageOptimizationOptions Clone() #
Returns: PdfImageOptimizationOptions

Creates an independent copy of these options.

Properties

public Boolean Enabled { get; set; } #

Enables managed placement-aware image optimization. Disabled by default.

public OfficeImageOptimizationMode Mode { get; set; } #

Selects placement downsampling, same-size JPEG recompression, or both. Defaults to downsampling.

public Double TargetDpi { get; set; } #

Target image resolution in pixels per inch. Defaults to 144.

public Double DownsampleThreshold { get; set; } #

Minimum ratio between source pixels and placement-required pixels before downsampling. Defaults to 1.1 to avoid re-encoding for negligible reductions.

public OfficeRasterResamplingMode ResamplingMode { get; set; } #

Sampling mode used when source pixels are reduced.

public Int32 JpegQuality { get; set; } #

Quality used when a JPEG source is downsampled or recompressed. Defaults to 85.

public Boolean KeepOriginalWhenNotSmaller { get; set; } #

Keeps the original encoded payload when optimized bytes are not smaller.

public OfficeImageMetadataPolicy MetadataPolicy { get; set; } #

Metadata behavior for rewritten images. Defaults to preservation.

public OfficeImageMetadataKinds MetadataSelection { get; set; } #

Metadata categories retained by selective copying.

public Boolean AllowMetadataLoss { get; set; } #

Permits reported metadata loss or deliberate stripping. False preserves the original image if metadata would be removed.