Skip to content

ppt picture set

goworm edited this page Jul 7, 2026 · 55 revisions

PowerPoint: Picture - Set

Modify picture properties including position, size, alt text, cropping, and image replacement.

Path: /slide[N]/picture[M]

Properties

Property Accepted Values Description
alt text Alt text
path file path Replace image source
x, y EMU or units Position
width, height EMU or units Size
crop percentage (0-100) Crop all sides
cropLeft percentage Crop left
cropTop percentage Crop top
cropRight percentage Crop right
cropBottom percentage Crop bottom
rotation degrees Rotation angle (supports decimal)
opacity 0.0-1.0 or 0-100 Picture opacity (auto-scales)
name text Picture name
brightness -100..100 Brightness adjustment (a:lum mod)
contrast -100..100 Contrast adjustment
glow hex/scheme color, or color-radius-opacity (hyphen-delimited, not colon) Picture glow effect. radius in points, opacity 0-100. E.g. FF0000-12-75.
shadow hex/scheme color, or color-blur-angle-dist-opacity (hyphen-delimited, not colon) Picture drop shadow. blur/dist in points, angle in degrees, opacity 0-100. E.g. 000000-10-45-6-50. Readback is always #RRGGBB-blur-angle-dist-opacity.
link URL or slide[N] Hyperlink — accepts URL or in-presentation slide jump
tooltip text Hyperlink tooltip (requires link)
compressionState email, print, hqprint, screen, none Blip compression target (a:blip cstate). Mirrors PowerPoint's Compress Pictures target use.

Examples

# Update alt text and position
officecli set slides.pptx /slide[1]/picture[1] --prop alt="Updated alt text" --prop width=10cm

# Crop image
officecli set slides.pptx /slide[1]/picture[1] --prop cropLeft=10 --prop cropRight=10

# Replace image source
officecli set slides.pptx /slide[1]/picture[1] --prop src=/tmp/updated-photo.png

# Reposition
officecli set slides.pptx /slide[1]/picture[1] --prop x=5cm --prop y=3cm --prop width=15cm --prop height=10cm

Based on OfficeCLI v1.0.97

Clone this wiki locally