Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Class

WordImageOptimizationOptions

OfficeIMO.Word

Namespace
OfficeIMO.Word
Assembly
OfficeIMO.Word
Source revision
ba882f6b0d07 with working tree changes
Modifiers
sealed

Managed embedded-media optimization settings. Changes remain in memory until a normal save.

Inheritance

  • object
  • WordImageOptimizationOptions

Usage

Explore 3 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 1

Accepted by parameters 2

Constructors

public WordImageOptimizationOptions() #

Methods

public WordImageOptimizationOptions Clone() #

Creates an independently validated copy of these settings.

Properties

public OfficeImageOptimizationMode Mode { get; set; } #

Defaults to placement-aware downsampling without same-size JPEG recompression.

public double TargetDpi { get; set; } #

Required pixels per displayed inch, between 36 and 1200. Defaults to 144.

public int JpegQuality { get; set; } #

JPEG encoding quality, from 1 through 100. Defaults to 85.

public bool KeepOriginalWhenNotSmaller { get; set; } #

Preserves original bytes when the candidate is not smaller.

public OfficeRasterResamplingMode ResamplingMode { get; set; } #

Filtering used for pixel reduction.

public OfficeImageMetadataPolicy MetadataPolicy { get; set; } #

Metadata policy. Metadata loss blocks replacement unless explicitly allowed.

public OfficeImageMetadataKinds MetadataSelection { get; set; } #

Categories retained by the selective metadata policy.

public bool AllowMetadataLoss { get; set; } #

Allows reported metadata loss, including intentional stripping. Defaults to false.

public long MaxImageBytes { get; set; } #

Maximum encoded bytes read from one image part. Defaults to 32 MiB.

public long MaxStagedBytes { get; set; } #

Maximum combined original and candidate bytes retained for transactional replacement. Defaults to 128 MiB.

public int MaxPackageParts { get; set; } #

Maximum package parts visited. Defaults to 10000.

public OfficeSignatureMutationPolicy SignatureMutationPolicy { get; set; } #

How optimization handles digital signatures that replacing images would invalidate. The default blocks optimization of a signed document; pass the same policy to the save that persists the result.