Cmdlet

Add-OfficePowerPointImage

Aliases: PowerPointImage

Module: PSWriteOffice
Aliases: PowerPointImage
Inputs: PSWriteOffice.Foundation.PowerPointSlideSelector System.Object
Outputs: OfficeIMO.PowerPoint.PowerPointImage
Source: AddOfficePowerPointImageCommand.cs:22 Edit on GitHub

Adds a native picture from a local image, SVG or reusable visual, using the slide layout or explicit lengths.

Syntax

Add-OfficePowerPointImage
[-AlternativeText <String>]
[-Column <Int32>]
[-FocalPoint <PowerPointFocalPoint>]
[-Height <OfficeLength>]
[-PassThru]
[-Path] <String>
[-Slide <PowerPointSlideSelector>]
[-Span <Int32>]
[-Title <String>]
[-Width <OfficeLength>]
[-X <OfficeLength>]
[-Y <OfficeLength>]
[<CommonParameters>]

Parameter set: Path

Add-OfficePowerPointImage
[-AlternativeText <String>]
[-Column <Int32>]
[-FocalPoint <PowerPointFocalPoint>]
[-Height <OfficeLength>]
[-Id <String>]
-InputObject <Object>
[-MaximumSvgElements <Int32>]
[-MaximumSvgViewportDimension <Double>]
[-MaximumSvgViewportPixelCount <Int64>]
[-PassThru]
[-PointsPerPixel <Double>]
[-Slide <PowerPointSlideSelector>]
[-Span <Int32>]
[-SvgPolicy <PreserveVector|RasterizeWhenNeeded|RequireVector>]
[-Title <String>]
[-Width <OfficeLength>]
[-X <OfficeLength>]
[-Y <OfficeLength>]
[<CommonParameters>]

Parameter set: Visual

Description

Coordinates use points or unit suffixes. Explicit coordinates, dimensions, grid columns or Slide select fixed placement. Otherwise the image flows through the shared slide layout. FocalPoint controls cover crops.

Examples

Place a local image on the slide grid.

PowerPointSlide -Title 'Evidence' {
    PowerPointImage -Path ./evidence.png -Column 2 -Span 5 -Y 3cm -Height 5cm -AlternativeText 'Deployment health'
}

Reuse a converted visual without converting it again.

$visual | PowerPointImage -Slide $slide -X 36 -Y 54 -PassThru

Parameters

-AlternativeText String optional: Accessible description for the visual or placed image.
-Column Int32 optional: One-based starting column in the native twelve-column slide grid.
-FocalPoint PowerPointFocalPoint optional: Center, Top, Bottom, Left, Right or fractional x,y coordinates kept in view by a cover crop.
-Height OfficeLength optional: Optional output height; numbers mean points and unit suffixes are accepted.
-PassThru SwitchParameter optional: Return the native editable picture.
-Path String requiredposition: 0sets: Path: Literal local image path.
-Slide PowerPointSlideSelector optionalpipeline: True (ByValue): Native slide or a one-based position in the current document; omitted inside PowerPointSlide.
-Span Int32 optional: Number of grid columns occupied by the frame; defaults to twelve with Column.
-Title String optional: Optional title for an SVG file input.
-Width OfficeLength optional: Optional output width; numbers mean points and unit suffixes are accepted.
-X OfficeLength optional: Left position; numbers mean points.
-Y OfficeLength optional: Top position; numbers mean points.
-Id String optionalsets: Visual: Optional stable identifier for an SVG file input.
-InputObject Object requiredpipeline: True (ByValue)sets: Visual: Visual artifact, OfficeVisualSource, prepared conversion or SVG path.
-MaximumSvgElements Int32 optionalsets: Visual: Optional OfficeIMO SVG import element limit.
-MaximumSvgViewportDimension Double optionalsets: Visual: Optional maximum SVG viewport width or height. Increase the safe default only for trusted input.
-MaximumSvgViewportPixelCount Int64 optionalsets: Visual: Optional maximum SVG viewport area in pixels. Increase the safe default only for trusted input.
-PointsPerPixel Double optionalsets: Visual: Conversion factor from ChartForgeX pixels to Office points.
-SvgPolicy OfficeVisualSvgPolicy optionalsets: Visual: SVG fidelity policy used by OfficeIMO.ChartForgeX.; Possible values: PreserveVector, RasterizeWhenNeeded, RequireVector

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.