Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Cmdlet

New-OfficePowerPointImageOptions

Module
PSWriteOffice
Inputs
None
Outputs
OfficeIMO.PowerPoint.PowerPointImageExportOptions

Creates discoverable slide selection and rendering settings for Export-OfficeDocumentImage.

Syntax

New-OfficePowerPointImageOptions
[-ChartFidelity <Strict|BestEffort>]
[-IncludeHiddenShapes]
[-IncludeHiddenSlides]
[-MaximumDegreeOfParallelism <Int32>]
[-MaximumOutputCount <Int32>]
[-MaximumOutputHeight <Int32>]
[-MaximumOutputWidth <Int32>]
[-MaximumRasterPixelCount <Int64>]
[-MaximumTotalEncodedBytes <Int64>]
[-MaximumTotalRasterPixelCount <Int64>]
[-NoAutoShapes]
[-NoCharts]
[-NoPictures]
[-NoSlideBackground]
[-NoSlideContent]
[-NoTables]
[-NoTextBoxes]
[-RasterOverflowBehavior <ReduceScale|Throw>]
[-RenderTimeoutSeconds <Double>]
[-TextShapingLanguage <String>]
[<CommonParameters>]
#
Parameter set: Default

Description

Pass the result to Export-OfficeDocumentImage or ConvertTo-OfficeDocumentImage -Options when rendering slides.

Examples

Render selected slides without pictures.

$options = New-OfficePowerPointImageOptions -NoPictures
Export-OfficeDocumentImage -Path ./Deck.pptx -Page 1,3 -OutputDirectory ./Slides -Options $options

Parameters

-ChartFidelity OfficeChartFidelity optional
Chart handling: Strict (default) skips charts with formatting that cannot be drawn exactly; BestEffort draws the closest approximation and reports chart-approximation warnings.
Possible values: Strict, BestEffort
-IncludeHiddenShapes SwitchParameter optional
Render hidden shapes.
-IncludeHiddenSlides SwitchParameter optional
Include hidden slides.
-MaximumDegreeOfParallelism Int32 optional
Maximum independent renders processed concurrently.
-MaximumOutputCount Int32 optional
Maximum images accepted from one batch export.
-MaximumOutputHeight Int32 optional
Maximum output height in pixels.
-MaximumOutputWidth Int32 optional
Maximum output width in pixels.
-MaximumRasterPixelCount Int64 optional
Maximum pixels allocated for one raster image.
-MaximumTotalEncodedBytes Int64 optional
Maximum aggregate encoded bytes accepted from one batch.
-MaximumTotalRasterPixelCount Int64 optional
Maximum aggregate raster pixels accepted from one batch.
-NoAutoShapes SwitchParameter optional
Omit auto shapes.
-NoCharts SwitchParameter optional
Omit charts.
-NoPictures SwitchParameter optional
Omit pictures.
-NoSlideBackground SwitchParameter optional
Omit slide backgrounds.
-NoSlideContent SwitchParameter optional
Omit slide content.
-NoTables SwitchParameter optional
Omit tables.
-NoTextBoxes SwitchParameter optional
Omit text boxes.
-RasterOverflowBehavior OfficeRasterOverflowBehavior optional
Reduce or reject oversized raster output.
Possible values: ReduceScale, Throw
-RenderTimeoutSeconds Double optional
Maximum seconds allowed for one render.
-TextShapingLanguage String optional
BCP 47 language hint for text shaping.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.