# motion_graphics

> データ駆動の“図解・モーション素材”を自動生成するためのスキルです。

- Author: e-ld2020
- Repository: SAKAINO-KAORU/Kit-slide-TamaTama
- Version: 20260127122211
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/SAKAINO-KAORU/Kit-slide-TamaTama
- Web: https://mule.run/skillshub/@@SAKAINO-KAORU/Kit-slide-TamaTama~motion_graphics:20260127122211

---

# motion_graphics skill

データ駆動の“図解・モーション素材”を自動生成するためのスキルです。

対象例:
- 地理/地政学: **マップズーム・国ハイライト・ルート矢印**
- 経済/ビジネス: **線グラフ/棒グラフ（描画アニメ）・数値カウント**
- 宇宙/科学: **太陽系の簡易2D軌道アニメ**
- 歴史: **タイムライン（スクロール/年号マーカー）**

> 生成した動画/画像は `projects/<slug>/assets/generated/` に出力し、
> `40_asset_manifest.json` → `55_timeline_blueprint.json` → `timeline.fcpxml` の流れで利用します。

---

## 使い方

### 1) BGMビート解析（任意: ビート同期編集用）

```bash
python .claude/skills/motion_graphics/scripts/analyze_bgm_beats.py \
  --audio projects/<slug>/assets/audio/bgm/bgm_main.mp3 \
  --output projects/<slug>/data/bgm_beats.json
```

出力例:
- bpm（推定）
- beat_times（秒の配列）
- downbeats（簡易推定）

### 2) graphics_plan から映像生成

```bash
python .claude/skills/motion_graphics/scripts/generate_graphics.py \
  --project projects/<slug> \
  --plan projects/<slug>/45_graphics_plan.yaml
```

対応 type（v4）:
- `map_animation`
- `line_chart`
- `solar_system`
- `timeline`

---

## 実装メモ

- 生成は基本 **Matplotlib** ベースで、mp4 を書き出します。
- 解像度/fps は `00_project_spec.yaml` の `editing.timeline` を参照（未指定なら 1920x1080/30fps）。
- “超高度な”表現（矢印が伸びる、マスクで線が描画される等）は、
  まず **生成済み動画を置く** 方式（最も壊れにくい）を推奨。

---

## トラブルシュート

- mp4書き出しに失敗する場合:
  - ffmpeg が無い/古い可能性があります（Matplotlibのwriter依存）。
  - `--render-mode png` で PNG連番にしてから ffmpeg で結合する運用も可能です。