ppt 3dmodel add

PowerPoint: 3D Model - add

Insert a 3D model (.glb file) into a slide.

Path: /slide[N] (parent)

Properties

Property	Default	Description
path / src	(required)	Model source: local file path, https://... HTTP URL, or data: URI. Only .glb (glTF Binary) format.
name	3DModel {N}	Display name
x / left	centered	X position (EMU or units: cm, in, pt, px; negative values allowed)
y / top	centered	Y position (EMU or units; negative values allowed)
width	10cm	Width (EMU or units)
height	10cm	Height (EMU or units)
rotx	0	X-axis rotation in degrees (negative values normalized to positive equivalent)
roty	0	Y-axis rotation in degrees
rotz	0	Z-axis rotation in degrees

Camera Properties

Property	Default	Description
camerax	0	Camera X offset
cameray	0	Camera Y offset

Notes

• Only .glb (glTF Binary) format is supported. .gltf is not supported.
• PowerPoint automatically embeds a PNG fallback image for older viewers that don't support 3D models.
• Returns path /slide[N]/model3d[M] on success.
• On morph slides, the model name automatically gets the !! prefix for morph compatibility.
• Negative rotation values are normalized: -20° → 340°.

Examples

# Insert 3D model centered on slide
officecli add slides.pptx /slide[1] --type 3dmodel --prop src=model.glb

# Insert with position and size
officecli add slides.pptx /slide[1] --type 3dmodel --prop src=model.glb --prop x=2cm --prop y=1cm --prop width=12cm --prop height=12cm

# Insert with initial rotation
officecli add slides.pptx /slide[1] --type 3dmodel --prop src=model.glb --prop rotx=30 --prop roty=45

# Insert with name (for morph animation)
officecli add slides.pptx /slide[1] --type 3dmodel --prop src=model.glb --prop name="MyModel" --prop x=5cm --prop y=3cm

# Insert from HTTP URL
officecli add slides.pptx /slide[1] --type 3dmodel --prop src=https://example.com/assets/model.glb --prop width=12cm --prop height=12cm

---

Based on OfficeCLI v1.0.64