Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

feat(svg_to_pptx): enable per-element animation by default

hugohe3f5dadc0a4aa6
diff --git a/README.md b/README.md
index 2a2369b8..19c8242b 100644
--- a/README.md
+++ b/README.md
@@ -38,7 +38,7 @@ English | [中文](./README_CN.md)
Drop in a PDF, DOCX, URL, or Markdown — get back a **natively editable PowerPoint** with real shapes, real text boxes, and real charts. Not images. Click anything and edit it.
-> **Animations** — exported decks support **page transitions** and **per-element entrance animations** as real OOXML, not embedded video. Click-by-click cascade in PowerPoint and Keynote, no extra tooling. See [Animations & Transitions →](./skills/ppt-master/references/animations.md).
+> **Animations** — exported decks support **page transitions** and **per-element entrance animations** as real OOXML, not embedded video. By default, elements cascade in automatically on slide entry — no clicking needed. Plays natively in PowerPoint and Keynote, no extra tooling. See [Animations & Transitions →](./skills/ppt-master/references/animations.md).
> **How it works** — PPT Master is a workflow (a "skill") that works inside AI IDEs like Claude Code, Cursor, VS Code + Copilot, or Codebuddy. You chat with the AI — "make a deck from this PDF" — and it follows the workflow to produce a real editable `.pptx` on your computer. No coding on your side; the IDE is just where the conversation happens.
>
diff --git a/README_CN.md b/README_CN.md
index 9d348da0..f0b39412 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -38,7 +38,7 @@
丢进一份 PDF、DOCX、网址或 Markdown,拿回一份**原生可编辑的 PowerPoint**——真正的形状、真正的文本框、真正的图表,不是图片。点击任何元素即可编辑。
-> **动画** —— 导出的 deck 支持**页间转场**和**页内元素入场动画**,输出为真正的 OOXML 动画(不是嵌入视频),在 PowerPoint 和 Keynote 中按点击逐次播放,无需额外工具。详见 [转场与动画使用指南 →](./docs/zh/animations.md)。
+> **动画** —— 导出的 deck 支持**页间转场**和**页内元素入场动画**,输出为真正的 OOXML 动画(不是嵌入视频)。默认进入页面后元素按顺序自动级联入场,无需点击;在 PowerPoint 和 Keynote 中原生播放,无需额外工具。详见 [转场与动画使用指南 →](./docs/zh/animations.md)。
> **运作方式** —— PPT Master 是一套在 AI IDE(Claude Code / Cursor / VS Code + Copilot / Codebuddy 等)里运行的工作流(一个 "skill")。你在 IDE 的对话框里跟 AI 说"用这份 PDF 做一份 PPT",AI 按这套工作流在你本机生成一个真正可编辑的 `.pptx`。你不写任何代码——IDE 只是你和 AI 对话的地方。
>
diff --git a/docs/faq.md b/docs/faq.md
index f6c441c3..aa4e9f08 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -56,14 +56,14 @@ If your workflow specifically requires Excel-driven data editing, manually creat
## Q: Can I change page transitions and element animations?
-Yes. Page transitions (`fade` 0.4s by default) and per-element entrance animations (off by default) are both controlled by `svg_to_pptx.py` flags — `-t/--transition` for page-level and `-a/--animation` for element-level. Common one-liners:
+Yes. Page transitions (`fade` 0.4s by default) and per-element entrance animations (`mixed` effect with `after-previous` cascade by default) are both controlled by `svg_to_pptx.py` flags — `-t/--transition` for page-level and `-a/--animation` for element-level. Common one-liners:
```bash
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t push # different transition
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t none # disable transitions
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # enable per-element (on-click)
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed # auto-vary effects
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --animation-trigger after-previous # cascade without clicks
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a none # disable per-element animation
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # use a single effect instead of mixed
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger on-click # presenter-paced reveals
```
Full effect list, anchor logic (top-level `<g id="...">`), fallback behavior, and limitations: see [Animations & Transitions](../skills/ppt-master/references/animations.md).
diff --git a/docs/zh/animations.md b/docs/zh/animations.md
index 36e7466d..dce1493b 100644
--- a/docs/zh/animations.md
+++ b/docs/zh/animations.md
@@ -7,9 +7,9 @@ PPT Master 导出的 PPTX 同时支持**页间转场**(page transition)与**
| 层级 | 默认 | 原因 |
|---|---|---|
| 页间转场 | `fade`,0.4 秒 | 适合大多数 deck 的中性基线 |
-| 页内元素动画 | 关闭 | 老用户更新后行为不变 |
+| 页内元素动画 | `mixed` 效果 + `after-previous` 触发 | 进入页面后元素自动按顺序级联入场,零交互即可看到完整动画过程,最能体现 deck 的动画能力 |
-修改设置只需对同一份 `svg_output/`(或 `svg_final/`)重跑 `svg_to_pptx.py`,无需重新跑 LLM。
+修改设置只需对同一份 `svg_output/`(或 `svg_final/`)重跑 `svg_to_pptx.py`,无需重新跑 LLM。如要彻底关闭页内动画,加 `-a none`。
## 页间转场
@@ -34,28 +34,31 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --auto-advance 5
## 页内元素动画
-默认关闭。开启后有三种 Start 模式,**与 PowerPoint 动画窗格的 Start 下拉菜单一一对应**:
+默认开启(`mixed` 效果 + `after-previous` 触发)。共有三种 Start 模式,**与 PowerPoint 动画窗格的 Start 下拉菜单一一对应**:
-- **`on-click`**(默认,单击时)—— 进入页面 → 第一次点击显示第一个语义组,后续每次点击按 z-order 显示下一个组。适合现场演讲,演讲者控制节奏。
+- **`on-click`**(单击时)—— 进入页面 → 第一次点击显示第一个语义组,后续每次点击按 z-order 显示下一个组。适合现场演讲,演讲者控制节奏。
- **`with-previous`**(与上一动画同时)—— 所有组在进入页面时一起入场,并行播放各自的入场动画。`--animation-stagger` 不生效。
-- **`after-previous`**(在上一动画之后)—— 第一组进入页面时入场,后续组在前一个结束后接着出现,并按 `--animation-stagger` 增加额外间隔。适合展厅循环、录屏走查,或者只是想看流动效果不想点击。
+- **`after-previous`**(默认,在上一动画之后)—— 第一组进入页面时入场,后续组在前一个结束后接着出现,并按 `--animation-stagger` 增加额外间隔。适合展厅循环、录屏走查,或者只是想看流动效果不想点击。
```bash
-# 单击触发的 fade 入场(推荐起点)
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade
+# 默认即开启:mixed 效果 + after-previous 触发,无需任何参数
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project>
+
+# 关闭页内动画
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a none
-# 同页自动轮换效果(首组 fade,后续组在精选效果池中轮换)
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed
+# 改用单一效果(仍走默认的 after-previous 自动级联)
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade
-# after-previous 自动级联,组间间隔 0.4 秒(默认 stagger)
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --animation-trigger after-previous
+# 改为单击触发(演讲者控制节奏)
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger on-click
-# after-previous 自定义节奏
+# 自定义节奏
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed \
- --animation-trigger after-previous --animation-stagger 0.6 --animation-duration 0.5
+ --animation-stagger 0.6 --animation-duration 0.5
# 所有组进入页面时同时入场
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --animation-trigger with-previous
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger with-previous
```
22 种单一效果:`appear`、`fade`、`fly`、`cut`、`zoom`、`wipe`、`split`、`blinds`、`checkerboard`、`dissolve`、`random_bars`、`peek`、`wheel`、`box`、`circle`、`diamond`、`plus`、`strips`、`wedge`、`stretch`、`expand`、`swivel`。再加两种自动轮换模式:
@@ -67,8 +70,8 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --an
参数:
-- `-a/--animation` — 效果名、`mixed`、`random` 或 `none`。默认 `none`。
-- `--animation-trigger` — Start 模式(与 PowerPoint 一致):`on-click`(默认)、`with-previous`、`after-previous`。
+- `-a/--animation` — 效果名、`mixed`、`random` 或 `none`。默认 `mixed`。
+- `--animation-trigger` — Start 模式(与 PowerPoint 一致):`on-click`、`with-previous`、`after-previous`(默认)。
- `--animation-duration` — 单个元素入场秒数,默认 `0.3`。
- `--animation-stagger` — `after-previous` 模式下两组之间的额外间隔(秒,默认 `0.4`)。其他模式忽略。
@@ -101,10 +104,10 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --an
| 切换转场效果 | `-t push`(或上文列表中任一) |
| 转场放慢 | `--transition-duration 0.8` |
| 自动播放 | `--auto-advance 5` |
-| 启用元素动画(单击) | `--animation fade` |
-| 自动级联(不需要点击) | `--animation fade --animation-trigger after-previous` |
-| 所有组同时入场 | `--animation fade --animation-trigger with-previous` |
-| 元素动画自动轮换 | `--animation mixed` |
+| 关闭页内动画 | `-a none` |
+| 改为单击触发 | `--animation-trigger on-click` |
+| 切换为单一效果 | `--animation fade` |
+| 所有组同时入场 | `--animation-trigger with-previous` |
| 元素入场放慢 | `--animation-duration 0.5` |
| after-previous 拉大间隔 | `--animation-stagger 0.8` |
diff --git a/docs/zh/faq.md b/docs/zh/faq.md
index 1c4ef7de..79649c7a 100644
--- a/docs/zh/faq.md
+++ b/docs/zh/faq.md
@@ -56,14 +56,14 @@ PPT Master 本身免费开源,唯一的成本来自你自己的 AI 模型用
## Q: 页面切换和元素动画可以调吗?
-可以。页间转场(默认 `fade` 0.4s)和页内元素入场动画(默认关闭)都通过 `svg_to_pptx.py` 的参数控制——`-t/--transition` 控制页级,`-a/--animation` 控制元素级。常用一行命令:
+可以。页间转场(默认 `fade` 0.4s)和页内元素入场动画(默认 `mixed` 效果 + `after-previous` 自动级联)都通过 `svg_to_pptx.py` 的参数控制——`-t/--transition` 控制页级,`-a/--animation` 控制元素级。常用一行命令:
```bash
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t push # 换转场效果
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -t none # 关闭转场
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # 开启页内动画(单击触发)
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed # 自动混搭效果
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --animation-trigger after-previous # 自动级联(不需要点击)
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a none # 关闭页内动画
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade # 改用单一效果(仍是默认级联)
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger on-click # 改为单击触发,演讲者控制节奏
```
完整效果列表、`<g id="...">` 锚点机制、降级行为、限制:见 [转场与动画](./animations.md)。
diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.md
index a9b779ea..be4b5e7f 100644
--- a/skills/ppt-master/SKILL.md
+++ b/skills/ppt-master/SKILL.md
@@ -305,10 +305,10 @@ python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> -s final
# backup/<timestamp>/svg_output/ ← Executor SVG source backup
```
-**Optional animation flags** (add to the command above when the user asks for them; otherwise omit):
+**Optional animation flags** (the defaults already enable rich entrance animations — adjust only when the user asks for something different):
- `-t <effect>` — page transition. Default `fade`. Options: `fade` / `push` / `wipe` / `split` / `strips` / `cover` / `random` / `none`.
-- `-a <effect>` — per-element entrance animation. Default off. Common picks: `fade` (every group fades in), `mixed` (auto-vary across the deck). Requires top-level `<g id="...">` groups (already required by Executor).
-- `--animation-trigger {on-click,with-previous,after-previous}` — Start mode (matches PowerPoint's animation-pane Start dropdown). Default `on-click`. Use `after-previous` (with `--animation-stagger`) for click-free cascade, or `with-previous` for all-at-once.
+- `-a <effect>` — per-element entrance animation. Default `mixed` (auto-vary across the deck). Pass `none` to disable, or pick a specific effect like `fade`. Requires top-level `<g id="...">` groups (already required by Executor).
+- `--animation-trigger {on-click,with-previous,after-previous}` — Start mode (matches PowerPoint's animation-pane Start dropdown). Default `after-previous` (click-free cascade; pace via `--animation-stagger`). Use `on-click` for presenter-paced reveals, or `with-previous` for all-at-once.
- `--auto-advance <seconds>` — kiosk-style auto-play.
Full effect list, anchor logic, and limits: [`references/animations.md`](references/animations.md).
diff --git a/skills/ppt-master/references/animations.md b/skills/ppt-master/references/animations.md
index 13de8264..564a165d 100644
--- a/skills/ppt-master/references/animations.md
+++ b/skills/ppt-master/references/animations.md
@@ -7,9 +7,9 @@ PPT Master's exported PPTX supports **page transitions** (slide-to-slide) and **
| Layer | Default | Why |
|---|---|---|
| Page transition | `fade`, 0.4s | Calm baseline that suits most decks |
-| Per-element animation | off | Existing users see no behavior change |
+| Per-element animation | `mixed` effect + `after-previous` trigger | Groups cascade in automatically on slide entry — zero interaction, the full animation capability is visible the moment a viewer opens the deck |
-To regenerate a deck with different settings, rerun `svg_to_pptx.py` against the same `svg_output/` (or `svg_final/`) — no need to rerun the LLM.
+To regenerate a deck with different settings, rerun `svg_to_pptx.py` against the same `svg_output/` (or `svg_final/`) — no need to rerun the LLM. To turn per-element animation off entirely, pass `-a none`.
## Page Transitions
@@ -34,28 +34,31 @@ Flags:
## Per-Element Animations
-Off by default. When enabled, three Start modes are available — these mirror PowerPoint's animation-pane "Start" dropdown:
+Enabled by default (`mixed` effect + `after-previous` trigger). Three Start modes are available — these mirror PowerPoint's animation-pane "Start" dropdown:
-- **`on-click`** (default) — entering a slide → first click reveals the first semantic group; each subsequent click reveals the next group in z-order. Suits live presentations where the speaker paces reveals.
+- **`on-click`** — entering a slide → first click reveals the first semantic group; each subsequent click reveals the next group in z-order. Suits live presentations where the speaker paces reveals.
- **`with-previous`** — all groups start together on slide entry, playing their entrance animation in parallel. Stagger ignored.
-- **`after-previous`** — first group fires on slide entry, subsequent groups cascade after the previous one finishes, with `--animation-stagger` extra spacing. Suits kiosk playback, recorded walkthroughs, or anyone who wants visual flow without clicking.
+- **`after-previous`** (default) — first group fires on slide entry, subsequent groups cascade after the previous one finishes, with `--animation-stagger` extra spacing. Suits kiosk playback, recorded walkthroughs, or anyone who wants visual flow without clicking.
```bash
-# On-click cascade with fade (recommended starting point)
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade
+# Default behavior (no flags needed): mixed effect + after-previous cascade
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project>
+
+# Disable per-element animation entirely
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a none
-# Auto-vary effects within a slide (title fades; later groups cycle a curated pool)
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed
+# Use a single effect (still cascades via the default after-previous trigger)
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade
-# After-previous cascade on slide entry, 0.4s gap between groups (default stagger)
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --animation-trigger after-previous
+# Switch to on-click for live presentations (presenter controls pacing)
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger on-click
-# After-previous with custom pacing
+# Custom pacing
python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation mixed \
- --animation-trigger after-previous --animation-stagger 0.6 --animation-duration 0.5
+ --animation-stagger 0.6 --animation-duration 0.5
# All groups animate in unison on slide entry
-python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation fade --animation-trigger with-previous
+python3 skills/ppt-master/scripts/svg_to_pptx.py <project> --animation-trigger with-previous
```
22 single effects: `appear`, `fade`, `fly`, `cut`, `zoom`, `wipe`, `split`, `blinds`, `checkerboard`, `dissolve`, `random_bars`, `peek`, `wheel`, `box`, `circle`, `diamond`, `plus`, `strips`, `wedge`, `stretch`, `expand`, `swivel`. Plus two auto-vary modes:
@@ -67,8 +70,8 @@ The pool excludes `appear` because it has no visible motion.
Flags:
-- `-a/--animation` — effect name, `mixed`, `random`, or `none`. Default: `none`.
-- `--animation-trigger` — Start mode (matches PowerPoint): `on-click` (default), `with-previous`, or `after-previous`.
+- `-a/--animation` — effect name, `mixed`, `random`, or `none`. Default: `mixed`.
+- `--animation-trigger` — Start mode (matches PowerPoint): `on-click`, `with-previous`, or `after-previous` (default).
- `--animation-duration` — per-element entrance seconds, default `0.3`.
- `--animation-stagger` — gap between elements in `after-previous` mode (seconds, default `0.4`). Ignored otherwise.
@@ -101,10 +104,10 @@ Executors should wrap logical sections in `<g id>` regardless of whether you pla
| Change transition effect | `-t push` (or any from the list above) |
| Slower transition | `--transition-duration 0.8` |
| Auto-play | `--auto-advance 5` |
-| Enable element animation (on-click) | `--animation fade` |
-| Cascade without clicks | `--animation fade --animation-trigger after-previous` |
-| All groups animate together | `--animation fade --animation-trigger with-previous` |
-| Auto-vary element animation | `--animation mixed` |
+| Disable element animation | `-a none` |
+| Switch to on-click trigger | `--animation-trigger on-click` |
+| Use a single effect instead of mixed | `--animation fade` |
+| All groups animate together | `--animation-trigger with-previous` |
| Slower per-element reveal | `--animation-duration 0.5` |
| Wider gap in after-previous | `--animation-stagger 0.8` |
diff --git a/skills/ppt-master/references/shared-standards.md b/skills/ppt-master/references/shared-standards.md
index bc2f43a8..32f48b89 100644
--- a/skills/ppt-master/references/shared-standards.md
+++ b/skills/ppt-master/references/shared-standards.md
@@ -310,8 +310,8 @@ python3 scripts/svg_to_pptx.py <project_path> -s final
**Optional animation flags** (only when the user asks):
- `-t <effect>` — page transition (`fade` / `push` / `wipe` / `split` / `strips` / `cover` / `random` / `none`; default `fade`)
-- `-a <effect>` — per-element entrance animation (`fade` / `mixed` / `random` / one of 22 named effects; default off). Anchors on top-level `<g id="...">` groups.
-- `--animation-trigger {on-click,with-previous,after-previous}` — Start mode matching PowerPoint's animation-pane Start dropdown. Default `on-click`; `after-previous` cascades on slide entry (pace via `--animation-stagger <seconds>`); `with-previous` plays all groups together.
+- `-a <effect>` — per-element entrance animation (`fade` / `mixed` / `random` / one of 22 named effects / `none`; default `mixed`). Anchors on top-level `<g id="...">` groups.
+- `--animation-trigger {on-click,with-previous,after-previous}` — Start mode matching PowerPoint's animation-pane Start dropdown. Default `after-previous` (cascade on slide entry; pace via `--animation-stagger <seconds>`); `on-click` advances per click; `with-previous` plays all groups together.
- `--auto-advance <seconds>` — kiosk-style auto-play
Full reference: [`animations.md`](animations.md).
diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.md
index 03ad38a7..b794614c 100644
--- a/skills/ppt-master/scripts/docs/svg-pipeline.md
+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md
@@ -48,7 +48,7 @@ Behavior:
- Speaker notes are embedded automatically unless `--no-notes` is used
- Page transitions are controlled by `-t/--transition`; per-element entrance animations are controlled by `-a/--animation`
- Per-element animation applies to top-level SVG `<g id="...">` groups in z-order; aim for 3–8 content groups per slide. Page chrome (background / header / footer / decorations / watermark / page number, by id token) is skipped automatically
-- Start mode is set by `--animation-trigger`, mirroring PowerPoint's Start dropdown: `on-click` (default, presenter-paced), `with-previous` (all together on slide entry), `after-previous` (cascade with `--animation-stagger` spacing)
+- Start mode is set by `--animation-trigger`, mirroring PowerPoint's Start dropdown: `after-previous` (default, cascade with `--animation-stagger` spacing on slide entry), `on-click` (presenter-paced), `with-previous` (all together on slide entry)
- Flat SVG roots without top-level groups fall back to at most 8 visible primitives; beyond that, animation is skipped on the slide
- `mixed` is deterministic: the first animated group on each slide uses `fade`, then later groups cycle through a curated visible-effect pool across the whole deck; `random` samples from that same pool
- `--animation-duration` controls per-element entrance length; `--animation-stagger` adds gap between elements in `after-previous` mode
diff --git a/skills/ppt-master/scripts/pptx_animations.py b/skills/ppt-master/scripts/pptx_animations.py
index d82a13f1..6481eb72 100644
--- a/skills/ppt-master/scripts/pptx_animations.py
+++ b/skills/ppt-master/scripts/pptx_animations.py
@@ -292,7 +292,7 @@ def _build_effect_xml(
def create_sequence_timing_xml(
targets: list,
duration: float = 0.3,
- trigger: str = 'on-click',
+ trigger: str = 'after-previous',
) -> str:
"""Generate a multi-target entrance sequence.
@@ -304,11 +304,12 @@ def create_sequence_timing_xml(
the other two).
duration: per-element entrance duration in seconds.
trigger: PowerPoint-standard Start mode for each element.
- ``'on-click'`` — one presenter click per element (default).
+ ``'after-previous'`` — first element fires on slide entry,
+ rest chain after the previous one with ``delay_ms`` spacing
+ (default).
+ ``'on-click'`` — one presenter click per element.
``'with-previous'`` — all elements start together on slide
entry.
- ``'after-previous'`` — first element fires on slide entry,
- rest chain after the previous one with ``delay_ms`` spacing.
Returns:
A ``<p:timing>`` element string. Returns an empty string when
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_builder.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_builder.py
index bb8e0bee..673d0748 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_builder.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_builder.py
@@ -136,7 +136,7 @@ def create_pptx_with_native_svg(
animation: str | None = None,
animation_duration: float = 0.3,
animation_stagger: float = 0.1,
- animation_trigger: str = 'on-click',
+ animation_trigger: str = 'after-previous',
) -> bool:
"""Create a PPTX file with native SVG.
@@ -157,8 +157,8 @@ def create_pptx_with_native_svg(
animation_duration: Per-element entrance duration in seconds.
animation_stagger: Delay between elements in ``after-previous``
trigger mode (seconds). Ignored otherwise.
- animation_trigger: PowerPoint Start mode — ``'on-click'`` (default),
- ``'with-previous'``, or ``'after-previous'``.
+ animation_trigger: PowerPoint Start mode — ``'after-previous'`` (default),
+ ``'on-click'``, or ``'with-previous'``.
Returns:
Whether all slides were successfully created.
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py
index 7cf7b788..cab15de6 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py
@@ -56,13 +56,15 @@ Transition effects (-t/--transition):
Per-element entrance animation (-a/--animation, native shapes mode):
{', '.join(animation_choices)}
- Notes: applied to top-level <g id="..."> SVG groups in z-order. Start mode set
- by --animation-trigger, matching PowerPoint's Start dropdown:
- on-click (default) one presenter click per group
+ Notes: applied to top-level <g id="..."> SVG groups in z-order. Default is
+ "mixed" (auto-vary effects per group). Start mode set by
+ --animation-trigger, matching PowerPoint's Start dropdown:
+ on-click one presenter click per group
with-previous all groups start together on slide entry
- after-previous cascade; gap = --animation-stagger seconds
+ after-previous (default) cascade on slide entry;
+ gap = --animation-stagger seconds
mixed uses a curated visible-effect sequence across the deck; random samples
- from the same visible-effect pool.
+ from the same visible-effect pool. Use "-a none" to disable.
Compatibility mode (enabled by default):
- Automatically generates PNG fallback images, SVG embedded as extension
@@ -106,19 +108,19 @@ Speaker notes (enabled by default):
help='Auto-advance interval in seconds (default: manual advance)')
parser.add_argument('-a', '--animation', type=str, choices=animation_choices,
- default='none',
+ default='mixed',
help='Per-element entrance animation (native shapes mode '
'only). Pick a single effect, "mixed" (auto-vary per '
- 'element), "random", or "none" (default).')
+ 'element, default), "random", or "none" to disable.')
parser.add_argument('--animation-duration', type=float, default=0.3,
help='Per-element entrance duration in seconds (default: 0.3)')
parser.add_argument('--animation-trigger', type=str,
choices=['on-click', 'with-previous', 'after-previous'],
- default='on-click',
+ default='after-previous',
help='Per-element Start mode (matches PowerPoint Start dropdown): '
- '"on-click" (default, one click per element), '
+ '"on-click" (one click per element), '
'"with-previous" (all start together on slide entry), '
- '"after-previous" (cascade after the previous element).')
+ '"after-previous" (default, cascade after the previous element).')
parser.add_argument('--animation-stagger', type=float, default=0.4,
help='Delay between elements in --animation-trigger=after-previous '
'(seconds, default 0.4). Ignored in other modes.')