Files
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
chore: import upstream snapshot with attribution
2026-07-13 13:09:29 +08:00

107 lines
5.2 KiB
Python

#!/usr/bin/env python3
"""
Transition Timing — generates transitions-timing.pptx demonstrating the
slide-transition timing knobs: speed token vs millisecond duration, plus the
auto-advance / click-to-advance controls.
Speed token (legacy CT_SlideTransition @spd, PowerPoint 97+):
fast / medium|med / slow (e.g. fade-slow)
Duration in ms (CT_TransitionStartSoundAction @dur extLst, Office 2010+):
integer ms (e.g. fade-1500 -> 1.5 seconds)
Auto-advance:
advanceTime=<ms> auto-advance after N milliseconds (or 'none' to clear)
advanceClick=false disable click-to-advance (default true, stripped from XML when true)
SDK twin of transitions-timing.sh (officecli CLI). Both produce an equivalent
transitions-timing.pptx. This one drives the **officecli Python SDK**
(`pip install officecli-sdk`): one resident is started and every slide, shape,
and transition is shipped over the named pipe in a single `doc.batch(...)`
round-trip. Each item is the same `{"command","parent","type","props"}` /
`{"command","path","props"}` dict you'd put in an `officecli batch` list.
Usage:
pip install officecli-sdk # plus the `officecli` binary on PATH
python3 transitions-timing.py
"""
import os
import sys
# --- locate the SDK: prefer an installed `officecli-sdk`, else the in-repo copy
try:
import officecli # pip install officecli-sdk
except ImportError:
sys.path.insert(0, os.path.join(os.path.dirname(os.path.abspath(__file__)),
"..", "..", "..", "sdk", "python"))
import officecli
FILE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "transitions-timing.pptx")
def demo_slide(n, items, trans, title, bg):
"""Append one demo slide: full-bleed background shape + centred title shape,
then (optionally) set the slide's transition. Mirrors add_demo_slide() in
the .sh — same shape geometry, fills, and transition token."""
items.append({"command": "add", "parent": "/", "type": "slide", "props": {}})
items.append({"command": "add", "parent": f"/slide[{n}]", "type": "shape",
"props": {"x": "0", "y": "0", "width": "33.87cm", "height": "19.05cm",
"fill": bg}})
items.append({"command": "add", "parent": f"/slide[{n}]", "type": "shape",
"props": {"text": title, "size": "40", "bold": "true", "color": "FFFFFF",
"align": "center", "x": "2cm", "y": "7cm",
"width": "29.87cm", "height": "4cm"}})
if trans:
items.append({"command": "set", "path": f"/slide[{n}]", "props": {"transition": trans}})
print(f"Building {FILE} ...")
with officecli.create(FILE, "--force") as doc:
items = []
demo_slide(1, items, "", "Transition Timing", "1F3864")
# Legacy speed tokens
demo_slide(2, items, "fade-fast", "fade-fast (legacy @spd)", "C00000")
demo_slide(3, items, "fade-med", "fade-med (legacy @spd)", "2E75B6")
demo_slide(4, items, "fade-slow", "fade-slow (legacy @spd)", "7030A0")
# Office 2010+ duration in ms
demo_slide(5, items, "fade-500", "fade-500ms", "4F7C3A")
demo_slide(6, items, "fade-1500", "fade-1500ms", "8A5A2B")
demo_slide(7, items, "fade-3000", "fade-3000ms", "404040")
# Auto-advance: slide stays for 2 seconds then advances on its own
items.append({"command": "add", "parent": "/", "type": "slide", "props": {}})
items.append({"command": "add", "parent": "/slide[8]", "type": "shape",
"props": {"x": "0", "y": "0", "width": "33.87cm", "height": "19.05cm",
"fill": "BF8F00"}})
items.append({"command": "add", "parent": "/slide[8]", "type": "shape",
"props": {"text": "advanceTime=2000 (auto-advance after 2s)", "size": "36",
"bold": "true", "color": "FFFFFF", "align": "center",
"x": "2cm", "y": "7cm", "width": "29.87cm", "height": "4cm"}})
items.append({"command": "set", "path": "/slide[8]",
"props": {"transition": "fade", "advanceTime": "2000"}})
# Disable click-to-advance: this slide will only advance via auto-time or arrow keys
items.append({"command": "add", "parent": "/", "type": "slide", "props": {}})
items.append({"command": "add", "parent": "/slide[9]", "type": "shape",
"props": {"x": "0", "y": "0", "width": "33.87cm", "height": "19.05cm",
"fill": "2E5C8A"}})
items.append({"command": "add", "parent": "/slide[9]", "type": "shape",
"props": {"text": "advanceClick=false (no click advance)", "size": "36",
"bold": "true", "color": "FFFFFF", "align": "center",
"x": "2cm", "y": "7cm", "width": "29.87cm", "height": "4cm"}})
items.append({"command": "set", "path": "/slide[9]",
"props": {"transition": "fade", "advanceClick": "false"}})
doc.batch(items)
print(f" added 9 slides ({len(items)} commands)")
doc.send({"command": "save"})
# context exit closes the resident, flushing the presentation to disk.
print(f"Generated: {FILE}")