iofficeai--officecli/examples/ppt/3d-model.md

3D Model Showcase — "The Sun"

This demo consists of three files that work together:

• 3d-model.sh — Shell script that builds an 8-slide morph presentation embedding a GLB 3D model of the Sun on every slide, with different positions and rotations so PowerPoint's Morph transition animates it cinematically.
• 3d-model.pptx — The generated 8-slide deck: each slide advances the 3D model's position and rotation, creating an orbit animation through morph transitions.
• 3d-model.md — This file. Documents the 3dmodel element properties and morph-based rotation technique.

Regenerate

cd examples/ppt
bash 3d-model.sh
# → 3d-model.pptx
# Requires: models/sun.glb in the same directory

Slides

All 8 Slides — 3D Model Setup

Every slide shares the same structure: a jet-black background, a morph transition, and a 3dmodel element. The GLB model has the same name=sun on every slide so PowerPoint pairs and tweens it across transitions.

# Create all 8 slides with matching dark background + morph transition
for i in $(seq 1 8); do
  officecli add 3d-model.pptx / --type slide \
    --prop background=0A0A0A \
    --prop transition=morph
done

# Slide 1 — model at right, slight downward tilt
officecli add 3d-model.pptx '/slide[1]' --type 3dmodel \
  --prop path="models/sun.glb" \
  --prop name=sun \
  --prop x=15cm --prop y=0.5cm --prop width=18cm --prop height=18cm \
  --prop rotx=10

# Slide 2 — model moves left, rotated 50° around Y
officecli add 3d-model.pptx '/slide[2]' --type 3dmodel \
  --prop path="models/sun.glb" \
  --prop name=sun \
  --prop x=0.5cm --prop y=0.5cm --prop width=16cm --prop height=16cm \
  --prop roty=50

# Slide 3 — model back right, 100° Y + 15° X tilt
officecli add 3d-model.pptx '/slide[3]' --type 3dmodel \
  --prop path="models/sun.glb" \
  --prop name=sun \
  --prop x=18cm --prop y=3cm --prop width=16cm --prop height=16cm \
  --prop roty=100 --prop rotx=15

# Slides 4–8 follow the same pattern, advancing roty by ~50° each slide
# and alternating left/right position to create an orbit path
officecli add 3d-model.pptx '/slide[4]' --type 3dmodel \
  --prop path="models/sun.glb" --prop name=sun \
  --prop x=0.5cm --prop y=1cm --prop width=18cm --prop height=18cm \
  --prop roty=150

officecli add 3d-model.pptx '/slide[5]' --type 3dmodel \
  --prop path="models/sun.glb" --prop name=sun \
  --prop x=17cm --prop y=0.5cm --prop width=18cm --prop height=18cm \
  --prop roty=200 --prop rotx=20

officecli add 3d-model.pptx '/slide[6]' --type 3dmodel \
  --prop path="models/sun.glb" --prop name=sun \
  --prop x=0.5cm --prop y=2cm --prop width=17cm --prop height=17cm \
  --prop roty=250

officecli add 3d-model.pptx '/slide[7]' --type 3dmodel \
  --prop path="models/sun.glb" --prop name=sun \
  --prop x=16cm --prop y=1cm --prop width=17cm --prop height=17cm \
  --prop roty=310 --prop rotx=10

officecli add 3d-model.pptx '/slide[8]' --type 3dmodel \
  --prop path="models/sun.glb" --prop name=sun \
  --prop x=15cm --prop y=0.5cm --prop width=18cm --prop height=18cm \
  --prop roty=360 --prop rotx=10

Features: --type 3dmodel, path= (GLB file to embed), name= (shape name — must match across slides for morph pairing), x=/y=/width=/height= in cm, rotx= (X-axis tilt degrees), roty= (Y-axis orbit degrees), background= hex, transition=morph

Slide 1 — Title Text

Text labels overlapping the 3D model on the left side of the slide.

officecli add 3d-model.pptx '/slide[1]' --type shape \
  --prop text='THE SUN' \
  --prop x=1cm --prop y=2cm --prop w=13cm --prop h=3.5cm \
  --prop size=64 --prop bold=true --prop color=FF6F00 --prop fill=00000000 \
  --prop font='Arial Black'

officecli add 3d-model.pptx '/slide[1]' --type shape \
  --prop text='Our Star' \
  --prop x=1cm --prop y=6cm --prop w=13cm --prop h=2cm \
  --prop size=26 --prop color=FFB74D --prop fill=00000000 \
  --prop font=Calibri

officecli add 3d-model.pptx '/slide[1]' --type shape \
  --prop text='149.6 million km from Earth · Light takes 8 min 20 sec' \
  --prop x=1cm --prop y=8.5cm --prop w=13cm --prop h=2cm \
  --prop size=18 --prop color=9E9E9E --prop fill=00000000 \
  --prop font=Calibri

Features: fill=00000000 (fully transparent fill = no background behind text), font=Arial Black, bold=, color= (amber/orange palette), w=/h= as aliases for width=/height=

Slides 2–7 — Content Slides (Alternating Left/Right)

Each content slide adds two shapes: a right-aligned or left-aligned headline plus a multi-line body with lineSpacing=2x.

# Slide 2 — right-aligned (model on left)
officecli add 3d-model.pptx '/slide[2]' --type shape \
  --prop text='Star Profile' \
  --prop x=18cm --prop y=1cm --prop w=15cm --prop h=2.5cm \
  --prop size=40 --prop bold=true --prop color=FF6F00 --prop fill=00000000 \
  --prop font=Calibri --prop align=right

officecli add 3d-model.pptx '/slide[2]' --type shape \
  --prop text='Spectral type  G2V yellow dwarf\nDiameter  1.392 million km\nMass  330,000x Earth\nSurface temp  5,778 K\nCore temp  15 million K\nAge  4.6 billion years' \
  --prop x=18cm --prop y=4cm --prop w=15cm --prop h=14cm \
  --prop size=22 --prop color=E0E0E0 --prop fill=00000000 \
  --prop font=Calibri --prop align=right --prop lineSpacing=2x

# Slide 3 — left-aligned (model on right)
officecli add 3d-model.pptx '/slide[3]' --type shape \
  --prop text='Internal Structure' \
  --prop x=1cm --prop y=1cm --prop w=15cm --prop h=2.5cm \
  --prop size=40 --prop bold=true --prop color=FF6F00 --prop fill=00000000 \
  --prop font=Calibri

# ... slides 4–7 follow the same pattern, alternating align=right/left

Features: align=right / align=left paragraph alignment, lineSpacing=2x (2× line height multiplier), \n literal newline in text=, multi-line factoid layout

Slide 8 — Closing Latin Quote

Bold italic quote in Georgia, grey translation beneath.

officecli add 3d-model.pptx '/slide[8]' --type shape \
  --prop text='Per Aspera Ad Astra' \
  --prop x=1cm --prop y=7cm --prop w=13cm --prop h=3cm \
  --prop size=48 --prop bold=true --prop italic=true \
  --prop color=FF6F00 --prop fill=00000000 \
  --prop font=Georgia

officecli add 3d-model.pptx '/slide[8]' --type shape \
  --prop text='Through hardships to the stars' \
  --prop x=1cm --prop y=11cm --prop w=13cm --prop h=2cm \
  --prop size=24 --prop color=9E9E9E --prop fill=00000000 \
  --prop font=Calibri

Features: italic=true, font=Georgia, contrasting size pair (48pt / 24pt), color=9E9E9E (muted grey)

Complete Feature Coverage

Feature	Slides
--type 3dmodel GLB embedding	1–8
path= (GLB file path)	1–8
name= (morph pairing key)	1–8
rotx= (X-axis tilt degrees)	1, 3, 5, 7, 8
roty= (Y-axis orbit degrees)	2–8
x=/y=/width=/height= in cm (model placement)	1–8
transition=morph	1–8
background= hex	1–8
fill=00000000 (transparent — no shape background)	1–8
font=Arial Black / Georgia / Calibri	1, 8
bold= / italic=	1, 8
align=right / align=left	2, 4, 6
lineSpacing=2x (line height multiplier)	2–7
text= with \n multi-line	2–7
w=/h= aliases	1
officecli validate post-generation check	final

Morph Technique

PowerPoint's Morph transition tweens shapes that share the same name between adjacent slides. The key rule: name=sun must appear on both the outgoing and incoming slide for morph to pair them.

The rotation values advance ~50° per slide around the Y axis (roty=0→50→100→150→200→250→310→360), producing a smooth orbital animation. The X-axis tilt (rotx=) varies slightly to add dimensional interest.

Position also shifts left/right each slide (x=15cm→0.5cm→18cm→0.5cm→17cm→...), so the model appears to orbit across the slide while rotating — all interpolated smoothly by Morph.

Inspect the Generated File

officecli query 3d-model.pptx slide
officecli get 3d-model.pptx /slide[1]
officecli get 3d-model.pptx "/slide[1]/3dmodel[1]"
officecli get 3d-model.pptx "/slide[2]/3dmodel[1]"