-
Notifications
You must be signed in to change notification settings - Fork 528
ppt 3dmodel add
zmworm edited this page Apr 29, 2026
·
40 revisions
Insert a 3D model (.glb file) into a slide.
Path: /slide[N] (parent)
| 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 |
| Property | Default | Description |
|---|---|---|
camerax |
0 |
Camera X offset |
cameray |
0 |
Camera Y offset |
- Only
.glb(glTF Binary) format is supported..gltfis 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°.
# 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