wehub-resource-sync
8cb1f9f479
Publish SDK (PyPI) / publish (push) Has been cancelled
Publish SDK (npm) / publish (@aionui/officecli-sdk) (push) Has been cancelled
SDK smoke / smoke (windows-latest) (push) Has been cancelled
Publish SDK (npm) / publish (@officecli/officecli-sdk) (push) Has been cancelled
Publish SDK (npm) / publish (@officecli/sdk) (push) Has been cancelled
Publish SDK (npm) / publish (officecli-sdk) (push) Has been cancelled
SDK smoke / smoke (macos-latest) (push) Has been cancelled
SDK smoke / smoke (ubuntu-latest) (push) Has been cancelled
Skill parity / diff (push) Has been cancelled
197 lines
8.1 KiB
Markdown
197 lines
8.1 KiB
Markdown
# 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
|
||
|
||
```bash
|
||
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.
|
||
|
||
```bash
|
||
# 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.
|
||
|
||
```bash
|
||
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`.
|
||
|
||
```bash
|
||
# 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.
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
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]"
|
||
```
|