@ganziliang/desktop-pet 0.1.0 → 0.1.2

package/README.md

@@ -24,6 +24,7 @@ desktop-pet
 ```
 
 包内自带 electron 依赖，命令行参数原样透传给主进程（`--snapshot`、`--anim=<walk|run|swim|awaken:seraph>`、`--no-auto`）。
+首次启动会先下载 Electron 运行时（约 100MB，只在第一次），终端会打印 `Downloading Electron binary...`。
 只发布运行需要的素材，`assets/source/`（生图原始图，约 39MB）与 `character_green*.png` 不进包。
 
 
@@ -59,21 +60,35 @@ desktop-pet
 和特效事件共用同一条时间轴，所以「动作推到哪一帧」和「特效炸在哪一刻」是对死的：
 
 ```
-0ms          黑屏切入（canvas 暗幕，全黑 0.94）
-180ms        窗口放大（藏在黑幕里，看不见窗口在变形）
-560ms        暗幕提到 0.6 —— 角色以「蓄力」序列帧亮相
+0ms          切入（默认不铺暗幕，桌面直接透出去）
+180ms        窗口放大（只向上、向两侧长，脚下那条线和水平中心都不动，所以看不到变形）
+560ms        角色以「蓄力」序列帧亮相
              蓄力 4 帧 × 360ms：合手聚气 → 抬手 → 上举 → 蓄力顶点
              同时跑魔法阵、向心汇聚、脚下螺旋
 2000ms       爆发（revealAt）：白闪 + 抖屏 + 冲击波，切到「爆发」序列帧
              爆发 4 帧 × 300ms：张臂 → 光爆 → 释放 → 收势
 2200ms       光柱冲天 + 主爆星屑
 2650ms       技能名落字
-4400ms       暗幕再进 + 窗口收回（同样藏在黑幕里）
-5700ms       暗幕退掉，回到站立
+4400ms       窗口收回（同样只向上向两侧收，角色不动）
+5700ms       回到站立
 ```
 
-暗幕在 `charge.at` 就从全黑提到 0.6，所以**蓄力动作是真的看得见的** ——
-不是一层黑幕盖满五秒再炸一下。
+**演出期间窗口背景完全透明**：桌面上只看得到角色和光效，不会出现一块暗色矩形。
+这一点靠 `assets/outfits.json` 的 `curtain` 控制，默认 `false`：
+
+```json
+{ "curtain": false }
+```
+
+开关只有**一个**生效点 —— `renderer/fx.js` 的 `FX.setDimEnabled()`：`dim()` 的调用点一半在
+`app.js` 的演出时间线，一半散在 `awaken.js` 每套觉醒亮相时的柔暗底（`fx.dim(0.34, …, c.stroke, true)`），
+只在调用点各自判会漏 —— 漏掉的那一处就是屏幕上那块暗紫色矩形（`capturePage` 的四角探针也看不见它，
+因为柔暗底在画面正中浓、到四角已经淡到 0，但**窗口的四条边**上依然是有颜色的）。
+要回归就往 `scripts/probe-dim.py` 那条命令，看环带的中位 alpha。
+
+要不要铺暗幕，取决于壁纸：加色混合的光效（金光、雷光）在**亮色壁纸**上本来就很难拉开对比，
+垫一层暗底才亮得起来 —— 想回到老的「黑屏切入」就把 `curtain` 改成 `true`（代价是屏幕上会多一个暗窗）。
+关掉时光效照跑，只是没有暗底垫着。
 
 ### 素材是两步，不是一步
 
@@ -315,7 +330,7 @@ npx electron . --snapshot
 #    --anim=<walk|run|swim> 先把角色摆到某个动作再截，用来查动作素材
 npx electron . --snapshot --anim=swim
 #    觉醒也能截：--anim=awaken:<id>；换 PET_SNAPSHOT_MS 就能逐帧看整场演出
-PET_SNAPSHOT_MS=1200 npx electron . --snapshot --anim=awaken:seraph   # 蓄力：黑屏 + 魔法阵
+PET_SNAPSHOT_MS=1200 npx electron . --snapshot --anim=awaken:seraph   # 蓄力：魔法阵 + 聚气
 PET_SNAPSHOT_MS=3400 npx electron . --snapshot --anim=awaken:seraph   # 亮相 + 技能名
 PET_SNAPSHOT_MS=6500 npx electron . --snapshot --anim=awaken:seraph   # 收招：窗口应该已还原
 #    PET_SNAPSHOT_MS 改截帧时刻。用两个不同值各截一张做差分，就能证明逐帧动画真的在推进：
@@ -323,6 +338,11 @@ PET_SNAPSHOT_MS=6500 npx electron . --snapshot --anim=awaken:seraph   # 收招
 PET_SNAPSHOT_MS=1500 PET_SNAPSHOT_OUT=f1.png npx electron . --snapshot --anim=run
 PET_SNAPSHOT_MS=1580 PET_SNAPSHOT_OUT=f2.png npx electron . --snapshot --anim=run
 
+#    觉醒「不该有暗色矩形」的回归测试：沿画布四边取 18px 环带看 alpha。
+#    注意 --snapshot 的 capturePage 只证明「画布上没画暗色」，不能证明桌面上没有暗雾，
+#    所以真正要看的是脚本里的中位 alpha（整窗覆盖 ≈ 几十，只有粒子 ≈ 0）：
+python scripts/probe-dim.py /tmp/dim-probe 2000,2400,3000,3600 seraph nocturne thunder astral
+
 # 2) 带调试日志启动（写 pet-debug.log）
 powershell -ExecutionPolicy Bypass -File scripts/debug-run.ps1
 

package/assets/awaken/README.md

@@ -18,11 +18,12 @@
 ```js
 sheet: { charge: { at: 560, step: 360 }, burst: { at: 2000, step: 300 } },
 revealAt: 2000,   // = burst.at，爆发那一刻（白闪 + 抖屏）
-closeAt: 4400,    // 暗幕再进 + 窗口收回
+closeAt: 4400,    // 窗口收回（默认铺暗幕；见下）
 ```
 
 蓄力 4 帧 × 360ms（560→1640），爆发 4 帧 × 300ms（2000→2900），之后停在最后一帧收招式。
-暗幕在 `charge.at` 从全黑提到 0.6，所以**蓄力动作是真的看得见的**，不是一层黑幕盖完五秒。
+暗幕默认**关**（`assets/outfits.json` 的 `curtain: false`）：演出期间窗口背景全透明，墙上不会出现暗色矩形。
+改成 `true` 就回到「黑屏切入」—— 起步全黑、`charge.at` 提到 0.6 的柔暗底，蓄力动作依然看得见。
 
 ## 怎么加一张
 

package/assets/outfits.json

@@ -1,5 +1,6 @@
 {
   "comment": "战斗服装 / 觉醒技能清单。渲染层按 id 找 assets/awaken/<id>.png 作为觉醒立绘；素材缺失时用 idle 帧 + 纯特效兜底，不会崩。",
+  "curtain": false,
   "stage": {
     "widthRatio": 0.46,
     "heightRatio": 0.72,
@@ -10,9 +11,29 @@
     "zoom": 1.5
   },
   "list": [
-    { "id": "seraph", "name": "圣光 · 炽天使", "skill": "圣裁之光", "hint": "金白光柱 / 羽翼 / 圆形符文阵" },
-    { "id": "nocturne", "name": "暗影 · 血月狂想", "skill": "夜狱降临", "hint": "血月升起 / 蝠影 / 黑雾" },
-    { "id": "thunder", "name": "雷霆 · 天罚", "skill": "雷神裁决", "hint": "雷云 / 连锁闪电 / 电磁环" },
-    { "id": "astral", "name": "幻梦 · 星海", "skill": "星海咏叹", "hint": "星尘漩涡 / 星河光带 / 水晶碎片" }
+    {
+      "id": "seraph",
+      "name": "圣光 · 炽天使",
+      "skill": "圣裁之光",
+      "hint": "金白光柱 / 羽翼 / 圆形符文阵"
+    },
+    {
+      "id": "nocturne",
+      "name": "暗影 · 血月狂想",
+      "skill": "夜狱降临",
+      "hint": "血月升起 / 蝠影 / 黑雾"
+    },
+    {
+      "id": "thunder",
+      "name": "雷霆 · 天罚",
+      "skill": "雷神裁决",
+      "hint": "雷云 / 连锁闪电 / 电磁环"
+    },
+    {
+      "id": "astral",
+      "name": "幻梦 · 星海",
+      "skill": "星海咏叹",
+      "hint": "星尘漩涡 / 星河光带 / 水晶碎片"
+    }
   ]
 }

package/main.js

@@ -128,12 +128,20 @@ function loadSpriteManifest() {
  * 而不会因为少个 json 让整个右键菜单空掉。
  */
 function loadOutfits() {
-  const fallback = { stage: {}, list: [{ id: 'seraph', name: '圣光 · 炽天使', skill: '圣裁之光' }] };
+  const fallback = {
+    stage: {},
+    list: [{ id: 'seraph', name: '圣光 · 炽天使', skill: '圣裁之光' }],
+    curtain: false,
+  };
   try {
     const raw = JSON.parse(fs.readFileSync(OUTFITS_FILE, 'utf8'));
     return {
       stage: raw.stage || {},
       list: Array.isArray(raw.list) && raw.list.length ? raw.list : fallback.list,
+      // 觉醒暗幕开关。默认关：演出期间窗口背景完全透明，桌面上只有角色和光效，
+      // 不会出现一块暗色矩形。显式写 true 才回到旧的「黑屏切入」
+      // （亮色壁纸下加色光效更清楚，代价是屏幕上多一个暗窗）。
+      curtain: raw.curtain === true,
     };
   } catch {
     return fallback;
@@ -1002,7 +1010,7 @@ function registerIpc() {
     roamGapMs: Number(process.env.PET_ROAM_GAP_MS) || null,
     assets: spriteAssets(),
     // 觉醒清单交给渲染层：菜单里的名字、角色缩放比例、窗口目标规模都从这取
-    awaken: { list: outfits.list, stage: outfits.stage },
+    awaken: { list: outfits.list, stage: outfits.stage, curtain: outfits.curtain },
     httpPort: HTTP_PORT,
   }));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ganziliang/desktop-pet",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "桌面动漫角色小控件：透明置顶窗 + 像素级命中测试 + 鼠标交互 + 本地 HTTP 消息接口（Electron 桌宠）",
   "main": "main.js",
   "bin": {

package/renderer/app.js

@@ -716,18 +716,28 @@ function applyDemo(anim) {
 
 /**
  * 一场觉醒演出的时间线（毫秒）：
- *   0            黑屏切入（canvas 暗幕）
+ *   0            切入（curtain=true 时是黑屏，默认直接把桌面透出去）
  *   180          窗口放大 + 换上战斗服立绘 + 「镜头推近」
- *   revealAt     暗幕退 + 白闪 + 画面抖动 + 主爆发（具体特效由各套觉醒的 build 排）
- *   closeAt      暗幕再进 + 窗口收回（正好盖住窗口变回去的那一帧）
+ *   revealAt     亮相 + 白闪 + 画面抖动 + 主爆发（具体特效由各套觉醒的 build 排）
+ *   closeAt      暗幕再进 + 窗口收回
  *   duration     暗幕退掉，回到站立
  *
- * 关键点：窗口尺寸是在「暗幕已经盖满」之后才改的，所以看不到窗口在变形。
- * DNF 的觉醒也是这么处理的 —— 黑屏切入从来不只是省钱，它负责把不好看的那一帧藏起来。
+ * 窗口尺寸是在「画面已经被盖住」之后才改的。默认 curtain=false，也就是不铺暗幕：
+ * 窗口只向上、向两侧长（见 main.js 的 awakenTarget），角色脚下那条线和水平中心都不动，
+ * 所以窗口变形这一帧本来就看不出来 —— 没必要为了藏它而多一块暗色矩形。
+ * 亮色壁纸下想让金光/雷光更亮，可以在 assets/outfits.json 里把 curtain 改成 true。
  */
 
 let awakenToken = 0; // 每次演出一个令牌；旧演出的挂起回调拿它对不上号就自己失效
 
+/**
+ * 暗幕开关（assets/outfits.json 的 curtain，默认 false = 不铺暗色底）。
+ * 真正生效的位置在 fx.js 的 FX.setDimEnabled()：那里是唯一的开关，
+ * 因为 dim() 的调用点除了下面这条时间线，还有 awaken.js 里每套觉醒亮相时的柔暗底。
+ * 漏掉任何一处都会在屏幕上留一块暗色矩形，所以不要在调用点反复判。
+ */
+const curtainOn = () => cfg.awaken?.curtain === true;
+
 /** 角色当前的屏幕位置，事件在触发的那一刻现取（窗口刚被放大过） */
 /**
  * 觉醒演出的逐帧播放：直接写 backgroundPositionX，不走 steps() 帧动画。
@@ -800,13 +810,15 @@ async function playAwaken(id, { auto = false } = {}) {
 
   const token = ++awakenToken;
   state.autoAwaken = !!auto;
+  // 整场演出的暗幕开关一次性定好（含 awaken.js 里各套觉醒自己排的柔暗底）
+  FX.setDimEnabled(curtainOn());
   if (state.roaming) {
     window.pet.haltRoam();
     endLoco('awaken');
   }
   holdShow();
 
-  // 1) 先把屏幕压黑
+  // 1) 先把屏幕压黑（curtain=false 时 FX 内部直接忽略）
   FX.dim(def.dimAlpha, 170, def.palette.stroke);
 
   // 2) 暗幕盖满之后再把窗口放大，同时按新窗口高度算「镜头推近」的倍数
@@ -886,7 +898,8 @@ async function playAwaken(id, { auto = false } = {}) {
     () => {
       if (token !== awakenToken) return;
       FX.dim(def.dimAlpha, 240, def.palette.stroke);
-      // 窗口变回去这一帧同样藏在暗幕后面，所以这里可以放心地提前收
+      // 窗口变回去的那一帧本来就不用遮（窗口只向上向两侧收回，角色不动）；
+      // curtain=true 时这层仍然和以前一样盖住收招
       setTimeout(() => {
         if (token !== awakenToken) return;
         el.stage.classList.remove('awakening', 'flashing', 'shaking');
@@ -1099,6 +1112,7 @@ async function init() {
   cfg = await window.pet.getConfig();
   dbgOn = !!cfg.debug;
   gapOverride = cfg.roamGapMs || null;
+  FX.setDimEnabled(cfg.awaken?.curtain === true); // 暗幕开关交给引擎，见 curtainOn 的注释
   dbg(`init debug=${dbgOn} roamGap=${gapOverride ?? '默认区间'}`);
   state.scale = cfg.scale ?? 1;
   applyScale(state.scale);

package/renderer/fx.js

@@ -550,6 +550,14 @@ const FX = (() => {
   let dimColor = '#0a0410';
   let dimSoft = false;
 
+  // 暗幕总开关。setDimEnabled(false) 之后 dim() 全部变成空操作，
+  // 也就是「演出期间窗口背景完全透明，桌面上只看得到角色和光效」。
+  //
+  // 为什么开关放在引擎里，而不是让每个调用点自己判：dim 的调用点一半在 app.js 的时间线、
+  // 一半散在 awaken.js 每套觉醒的 build 里（亮相那一下的柔暗底），
+  // 漏掉任何一处就会在屏幕上留下一层「暗色矩形」—— 这正是之前的 bug。
+  let dimAllowed = true;
+
   /**
    * 暗幕 / 全屏闪白。alpha 0 = 全透明，1 = 全黑。
    * 0→1 用来做「黑屏切入」，1→0 用来做「角色亮相」，alpha 1 + 白色 = 闪白。
@@ -558,6 +566,13 @@ const FX = (() => {
    * 本来就很难看清楚（白底上加白还是白），垫一层柔和的暗底，金光/雷光才能真的亮起来。
    */
   function dim(alpha, ms, color, soft) {
+    if (!dimAllowed) {
+      // 关掉时顺手把残留清干净，避免开关切换的瞬间卡在半透明
+      dimNow = 0;
+      dimTo = 0;
+      dimSoft = false;
+      return;
+    }
     if (color) dimColor = color;
     if (soft !== undefined) dimSoft = !!soft;
     const target = Math.max(0, Math.min(1, alpha));
@@ -1023,6 +1038,19 @@ const FX = (() => {
     play,
     stop,
     reset,
+    /** 暗幕总开关：false = 演出全程不铺任何暗色底（默认关，见 app.js 的 curtainOn） */
+    setDimEnabled(on) {
+      dimAllowed = !!on;
+      if (!dimAllowed) {
+        dimNow = 0;
+        dimTo = 0;
+        dimSoft = false;
+        drawDim(); // dimNow 已归零 → 内部直接 return，等效于不再画
+      }
+    },
+    get dimEnabled() {
+      return dimAllowed;
+    },
     get busy() {
       return (
         !!script || emitters.length > 0 || geo.length > 0 || dimNow !== dimTo || aliveParticles() > 0

package/scripts/probe-dim.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python
+# QA：用 capturePage 逐帧探「整窗覆盖物」——沿画布四边 18px 环带取 alpha
+# 用法: probe-dim.py <输出目录> <a,b,c... 时刻ms> <anim...>
+import os, subprocess, sys, glob
+from PIL import Image
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+outdir, stamps, anims = sys.argv[1], [int(v) for v in sys.argv[2].split(',')], sys.argv[3:]
+os.makedirs(outdir, exist_ok=True)
+
+def ring_stats(path):
+    im = Image.open(path).convert('RGBA')
+    W, H = im.size
+    px = im.load()
+    band = 18
+    alphas = []
+    for x in range(0, W, 3):
+        for y in list(range(0, band)) + list(range(H - band, H)):
+            alphas.append(px[x, y][3])
+    for y in range(0, H, 3):
+        for x in list(range(0, band)) + list(range(W - band, W)):
+            alphas.append(px[x, y][3])
+    alphas.sort()
+    return W, H, max(alphas), alphas[len(alphas) // 2], sum(alphas) / len(alphas)
+
+print(f"{'套装':<10}{'时刻ms':<8}{'画布':<12}{'环带max α':<11}{'环带中位 α':<11}{'环带均值 α'}")
+bad = []
+for anim in anims:
+    for ms in stamps:
+        dst = os.path.join(outdir, f'{anim}-{ms}.png')
+        env = dict(os.environ, PET_SNAPSHOT_OUT=dst, PET_SNAPSHOT_MS=str(ms))
+        subprocess.run(['node', 'bin/desktop-pet.js', '--snapshot', f'--anim=awaken:{anim}'],
+                       cwd=ROOT, env=env, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+        W, H, mx, med, avg = ring_stats(dst)
+        flag = ''
+        if mx > 12:
+            flag = '   ← 整窗有覆盖物!'
+            bad.append((anim, ms, mx))
+        print(f"{anim:<10}{ms:<8}{f'{W}x{H}':<12}{mx:<11}{med:<11}{avg:<8.1f}{flag}")
+print()
+print("结论:", "环带上还有非零 alpha 的帧:" + str(bad) if bad else "全部帧环带 alpha 均为 0 —— 没有任何整窗覆盖物")

package/scripts/qa-awaken-capture.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+# QA：在「已确认是亮色」的背景板上，对同一段觉醒演出连拍整屏。
+# 用法: qa-awaken-capture.sh <输出目录> [curtain:false|true]
+set -u
+# 仓库根 = 本脚本所在目录的上一级，不写死绝对路径
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -W 2>/dev/null || cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+OUT="$1"; CURTAIN="${2:-false}"; ANIM="${3:-awaken:seraph}"
+mkdir -p "$OUT"
+
+kill_all() {
+  powershell -NoProfile -Command "Get-Process electron -ErrorAction SilentlyContinue | Stop-Process -Force" >/dev/null 2>&1
+  powershell -NoProfile -Command "Get-Process powershell -ErrorAction SilentlyContinue | Where-Object { \$_.MainWindowTitle -eq '' } | Stop-Process -Force" >/dev/null 2>&1
+  sleep 1
+}
+
+# 1) 背景板，等到「照片确实是亮的」再继续
+kill_all
+powershell -NoProfile -ExecutionPolicy Bypass -File "$ROOT/scripts/qa-backdrop.ps1" \
+  "$(cygpath -w $ROOT/outputs/qa-backdrop.png)" >/dev/null 2>&1 &
+for i in $(seq 1 25); do
+  sleep 1
+  powershell -NoProfile -ExecutionPolicy Bypass -File "$ROOT/scripts/shoot-screen.ps1" "$(cygpath -w $OUT/warmup.png)" >/dev/null 2>&1
+  bright=$(python - "$OUT/warmup.png" <<'PY'
+import sys
+from PIL import Image
+im = Image.open(sys.argv[1]).convert('L').resize((32,18))
+px = sorted(im.getdata()); print(px[len(px)//2])
+PY
+)
+  echo "背景板预热 ${i}s 中位亮度=$bright"
+  [ "$bright" -gt 200 ] && break
+done
+
+# 2) 开桌宠（curtain 由调用方先改好 outfits.json）
+cd "$ROOT"
+PET_DEBUG=1 nohup node bin/desktop-pet.js --no-auto > "$OUT/pet.out" 2>&1 &
+ok=0
+for i in $(seq 1 25); do
+  sleep 1
+  if curl -s --max-time 2 http://127.0.0.1:8520/health > "$OUT/health.json"; then ok=1; break; fi
+done
+if [ "$ok" != 1 ]; then
+  echo "!! /health 起不来，pet.out:"; cat "$OUT/pet.out"; tail -3 "$OUT/pet-debug.log" 2>/dev/null; exit 1
+fi
+echo "pet 就绪（${i}s）"
+grep -o '"bounds":{[^}]*}' "$OUT/health.json" || true
+
+# 3) 连拍整屏，中途触发一次觉醒
+powershell -NoProfile -ExecutionPolicy Bypass -File "$ROOT/scripts/qa-burst.ps1" \
+  "$(cygpath -w $OUT)" 6.5 2.0 "$ANIM"
+
+# 门禁：base 必须是亮的，否则背景板没真的在最上层，这轮数据不能用
+base_med=$(python - "$OUT/base.png" <<'PY2'
+import sys
+from PIL import Image
+im = Image.open(sys.argv[1]).convert('L').resize((60,34))
+px = sorted(im.getdata()); print(px[len(px)//2])
+PY2
+)
+echo "base.png 全屏中位亮度=$base_med"
+if [ "$base_med" -lt 180 ]; then
+  echo "!! 背景板被盖住了（base 偏暗），这轮作废"; exit 2
+fi
+
+cp "$ROOT/pet-debug.log" "$OUT/pet-debug.log" 2>/dev/null
+grep -o 'awaken-open {[^}]*}' "$OUT/pet-debug.log" | tail -1 > "$OUT/awaken-rect.txt"
+echo "curtain=$CURTAIN → $OUT  ($(ls "$OUT"/t*.png | wc -l) 帧)  觉醒矩形: $(cat "$OUT/awaken-rect.txt")"
+kill_all

package/scripts/qa-backdrop.ps1

@@ -0,0 +1,14 @@
+Add-Type -AssemblyName System.Windows.Forms, System.Drawing
+$img = [System.Drawing.Image]::FromFile($args[0])
+$f = New-Object System.Windows.Forms.Form
+$f.FormBorderStyle = 'None'
+$f.StartPosition = 'Manual'
+$f.Location = New-Object System.Drawing.Point(0, 0)
+$f.Size = [System.Windows.Forms.Screen]::PrimaryScreen.Bounds.Size
+$f.BackColor = [System.Drawing.Color]::White
+$f.BackgroundImage = $img
+$f.BackgroundImageLayout = 'Stretch'
+$f.ShowInTaskbar = $false
+$f.TopMost = $true
+$f.Add_Shown({ $f.Activate() })
+[System.Windows.Forms.Application]::Run($f)

package/scripts/qa-burst.ps1

@@ -0,0 +1,36 @@
+# QA: capture the whole screen on a fixed cadence and fire one awaken mid-way.
+# ASCII only on purpose: PowerShell 5.1 reads .ps1 as ANSI, CJK comments can break parsing.
+Add-Type -AssemblyName System.Windows.Forms, System.Drawing
+
+$outDir  = $args[0]
+$seconds = [double]$args[1]
+$delay   = [double]$args[2]   # wait before firing the awaken
+$anim    = $args[3]
+
+$screen = [System.Windows.Forms.Screen]::PrimaryScreen.Bounds
+$sw = [System.Diagnostics.Stopwatch]::StartNew()
+
+function Shoot([string]$name) {
+  $bmp = New-Object System.Drawing.Bitmap($screen.Width, $screen.Height)
+  $g = [System.Drawing.Graphics]::FromImage($bmp)
+  $g.CopyFromScreen($screen.Location, [System.Drawing.Point]::Empty, $screen.Size)
+  $bmp.Save((Join-Path $outDir $name), [System.Drawing.Imaging.ImageFormat]::Png)
+  $g.Dispose(); $bmp.Dispose()
+}
+
+Start-Sleep -Seconds $delay
+Shoot 'base.png'
+$t0 = $sw.Elapsed.TotalMilliseconds
+
+try {
+  Invoke-RestMethod -Method Post -Uri 'http://127.0.0.1:8520/action' `
+    -ContentType 'application/json' -Body ("{`"name`":`"$anim`"}") | Out-Null
+} catch { Write-Output "trigger failed: $_" }
+
+$i = 0
+while ($sw.Elapsed.TotalSeconds -lt ($delay + $seconds)) {
+  $ms = [int]($sw.Elapsed.TotalMilliseconds - $t0)
+  Shoot ('t{0:d5}.png' -f $ms)
+  $i++
+}
+Write-Output "shots=$i  dur=$([int]($sw.Elapsed.TotalSeconds - $delay))s"

package/scripts/shoot-screen.ps1

@@ -0,0 +1,7 @@
+Add-Type -AssemblyName System.Windows.Forms, System.Drawing
+$b = [System.Windows.Forms.Screen]::PrimaryScreen.Bounds
+$bmp = New-Object System.Drawing.Bitmap($b.Width, $b.Height)
+$g = [System.Drawing.Graphics]::FromImage($bmp)
+$g.CopyFromScreen($b.Location, [System.Drawing.Point]::Empty, $b.Size)
+$bmp.Save($args[0], [System.Drawing.Imaging.ImageFormat]::Png)
+$g.Dispose(); $bmp.Dispose()