dsh-motion 0.1.1 → 0.3.0

package/styles/3b1b/theme.py

@@ -0,0 +1,43 @@
+"""3b1b 1.0.0 — 3Blue1Brown 风格（Manim 社区通行做法）的 manimgx 实现层。
+
+来源与许可：subinium/3b1b-style-animation-skill（MIT），配色表取自其 color-scheme.md；
+方法论参考 adithya-s-k/manim_skill（MIT，1.2k stars）。不是 3Blue1Brown 官方项目。
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import manimgx as m
+
+TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
+
+BG = TOKENS["colors"]["bg"]
+TEXT = TOKENS["colors"]["text"]
+LABEL = TOKENS["colors"]["label"]
+BLUE = TOKENS["colors"]["blue"]
+YELLOW = TOKENS["colors"]["yellow"]
+TEAL = TOKENS["colors"]["teal"]
+GREEN = TOKENS["colors"]["green"]
+RED = TOKENS["colors"]["red"]
+GRAY = TOKENS["colors"]["gray"]
+MATH = TOKENS["colors"]["math"]
+AXIS = TOKENS["colors"]["axis"]
+LAYOUT = TOKENS["layout"]
+
+
+def apply_config(width: int = 1920, height: int = 1080, fps: int = 30) -> None:
+    m.config.pixel_width = width
+    m.config.pixel_height = height
+    m.config.frame_rate = fps
+    m.config.background_color = BG
+
+
+def backdrop() -> m.Rectangle:
+    """近黑灰底；3b1b 规定不用纯黑。"""
+    return (
+        m.Rectangle(width=LAYOUT["frame"]["width"], height=LAYOUT["frame"]["height"], color=BG)
+        .set_fill(BG, 1)
+        .set_stroke(width=0)
+    )

package/styles/3b1b/tokens.json

@@ -0,0 +1,32 @@
+{
+  "name": "3b1b",
+  "version": "1.0.0",
+  "source": "https://github.com/subinium/3b1b-style-animation-skill",
+  "license": "MIT (style skill); unofficial tribute to 3Blue1Brown",
+  "colors": {
+    "bg": "#1c1c1c",
+    "text": "#FFFFFF",
+    "label": "#E5E5E5",
+    "blue": "#3b82f6",
+    "yellow": "#fbbf24",
+    "teal": "#14b8a6",
+    "green": "#22c55e",
+    "red": "#ef4444",
+    "gray": "#9ca3af",
+    "math": "#fde047",
+    "axis": "#5A5A5A"
+  },
+  "typography": {
+    "display": { "family": "Noto Sans", "weight": "BOLD", "size": 46 },
+    "body": { "family": "Noto Sans", "size": 28 },
+    "mono": { "family": "Menlo", "size": 18 },
+    "math": { "family": "New Computer Modern", "size": 64 }
+  },
+  "layout": {
+    "aspect": "16:9",
+    "frame": { "width": 14.222, "height": 8.0 },
+    "margin": 0.5
+  },
+  "motion": { "fps": 30, "easing": "smooth", "hold_min_seconds": 2.0 },
+  "audio": { "target_lufs": -14, "true_peak_db": -1 }
+}

package/styles/README.md

@@ -0,0 +1,28 @@
+# 风格库
+
+可复用的视觉语言。当前有 5 套：4 套改编自 [Lemo-Opuscar](https://github.com/lemomo-ai/lemo-opuscar)（MIT），1 套来自 Manim 社区的 3b1b skill。都不是自创。`style.json` 是唯一事实来源；下面的表和 `registry.json` 由 `node scripts/build-style-index.mjs` 生成，不手改：
+
+<!-- styles:start -->
+| 风格 | 适合 | 来源 | 入口 |
+|---|---|---|---|
+| `swiss-motion` / 瑞士动态排版（默认） | 公式、定义、数据结论、排版 | Lemo-Opuscar | [STYLE](swiss-motion/STYLE.md) · [tokens](swiss-motion/tokens.json) · [theme](swiss-motion/theme.py) |
+| `dataviz` / 数据叙事 | 趋势、比较、分布、科学数据 | Lemo-Opuscar | [STYLE](dataviz/STYLE.md) · [tokens](dataviz/tokens.json) · [theme](dataviz/theme.py) |
+| `blueprint` / 蓝图工程制图 | 几何证明、结构、尺寸关系 | Lemo-Opuscar | [STYLE](blueprint/STYLE.md) · [tokens](blueprint/tokens.json) · [theme](blueprint/theme.py) |
+| `whiteboard` / 白板讲解 | 科学解释、课程、机制说明 | Lemo-Opuscar | [STYLE](whiteboard/STYLE.md) · [tokens](whiteboard/tokens.json) · [theme](whiteboard/theme.py) |
+| `3b1b` / 3b1b 数学动画 | 线代、微积分、概率、神经网络 | subinium + manim_skill | [STYLE](3b1b/STYLE.md) · [tokens](3b1b/tokens.json) · [theme](3b1b/theme.py) |
+<!-- styles:end -->
+
+## 约定
+
+- 每个风格目录：`style.json`（元数据）+ `STYLE.md`（不变量）+ `tokens.json` + `theme.py` + `preview.jpg`；
+- `STYLE.md` 是**改编**，必须在上游基础上写清楚差异；不复制 demo 代码；
+- 颜色、字体、时间表、音频以 `tokens.json` 为准；版面坐标与组件配方写在 `STYLE.md`；
+- 路由：`styles/registry.json` 是元数据，`node scripts/route-style.mjs "<题材>"` 打分；点名优先，低置信度/并列先问用户；
+- 新片在自己的项目目录写 `DESIGN.md`，头部 `style: <slug>` + `style_version: 1.0.0`；
+- 参考与示例统一用 HyperFrames 的 [examples](https://hyperframes.heygen.com/examples) / [catalog](https://hyperframes.heygen.com/catalog)，不在仓库里放样片（`showcase/` 只放可复现的演示）。
+
+## 许可
+
+- 上游风格文档：Lemo-Opuscar / subinium / adithya-s-k 均为 MIT，分别署名；
+- 上游 demo 静帧：CC BY 4.0，商用需署名；
+- 本仓库的 `theme.py` / `tokens.json` / 场景代码：MIT。

package/styles/blueprint/STYLE.md

@@ -0,0 +1,59 @@
+---
+name: blueprint
+version: 1.0.0
+source: https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/blueprint
+license: MIT（上游风格文档）；demo 静帧 CC BY 4.0（LemoLab）
+status: adapted
+---
+
+# Blueprint · 蓝图 / 工程制图
+
+> 上游：Lemo-Opuscar `styles/blueprint`（MIT）。保留青晒纸、白线、制图顺序与一次红色印章；
+> 去掉了 WebGL 纸纹与 3D 投影。
+
+## 1. 定位
+
+工程图在青晒纸上活起来：普鲁士蓝上的白色技术线，按制图顺序画出，标注会动。
+
+- 适合：几何证明、工程结构、尺寸关系、专利/发明叙事；
+- 不适合：需要真实材质、角色表演、实拍的题材。
+
+## 2. 不变量
+
+| 项 | 规则 |
+|---|---|
+| 桌 | 深色绘图桌 `#0D1116` |
+| 纸 | 青晒蓝 `#18336B → #2A58A6`，可有轻微不均 |
+| 线 | 白 `#E7F0F9`；四种线宽（轮廓/细节/细/发丝）；虚线有制图含义 |
+| 印章 | 全片只有一个非蓝颜色：红 `#B5442E`，只盖一次 |
+| 字体 | 手写体注释（Chalkboard SE）；技术字段（Menlo）；公式 New Computer Modern |
+| 运动 | draw-on：中心线 → 轮廓 → 细节 → 尺寸 → 标注；不做 3D 旋转、不做辉光 |
+| 声音 | 纸张、钢笔、尺规、机械；−14 LUFS |
+
+## 3. manimgx 映射
+
+- `theme.py`：`apply_config()`、`backdrop()`（青晒纸渐变 + 噪点）、`sheet()`、`title_block()`；
+- 用 `Line`、`Polygon`、`DoubleArrow`、`Create` 实现制图与 draw-on；
+- 上游的 3D 斜投影、纸纹 shader 没有实现；用 2D 制图语言近似；
+- 字体替换：Architects Daughter → Chalkboard SE；B612 → Menlo。
+
+## 4. Do / Don't
+
+**Do**
+
+- 按制图顺序画：先中心线，再轮廓，最后尺寸与标注；
+- 红色印章只出现一次，承担结论；
+- 尺寸线、引出线、编号气球让画面“像图”；
+- 标题块写图号/状态。
+
+**Don't**
+
+- 不做 3D 渲染、辉光、全息 HUD；
+- 不用第二个非蓝颜色；
+- 不让主线贴边；文字不压线。
+
+## 5. 与上游的差异
+
+- 上游是 WebGL2 纸纹 + 3D 斜投影；这里是 2D 平涂 + 渐变；
+- 上游 24 fps、30–60 秒；本实现 30 fps、7 秒量级；
+- 上游手写字体不随包分发；这里用 Chalkboard SE / Menlo 近似。

package/styles/blueprint/style.json

@@ -0,0 +1,47 @@
+{
+  "slug": "blueprint",
+  "en": "Blueprint",
+  "cn": "蓝图工程制图",
+  "category_en": "Graphic & Type",
+  "category_cn": "图形与排版",
+  "uses": [
+    "Geometry proof",
+    "Structures",
+    "Dimensions"
+  ],
+  "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/blueprint",
+  "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
+  "implementation": "manimgx (theme.py + tokens.json)",
+  "num": "03",
+  "film": "Pythagorean Triple",
+  "line": "A 3-4-5 triangle drawn in drafting order, stamped Q.E.D.",
+  "line_cn": "按制图顺序画出的 3-4-5 三角形，最后盖上 Q.E.D.",
+  "uses_cn": [
+    "几何证明",
+    "结构",
+    "尺寸关系"
+  ],
+  "keywords": [
+    "几何",
+    "证明",
+    "三角形",
+    "圆",
+    "角度",
+    "尺寸",
+    "工程",
+    "结构",
+    "作图",
+    "勾股"
+  ],
+  "avoid": [
+    "图表",
+    "手绘"
+  ],
+  "demo": "showcase/blueprint-pythagoras",
+  "demo_duration_sec": 6.9,
+  "aspect": [
+    "16:9"
+  ],
+  "fps": 30,
+  "complexity": "medium"
+}

package/styles/blueprint/theme.py

@@ -0,0 +1,65 @@
+"""blueprint 1.0.0 — Lemo-Opuscar 的 Blueprint，manimgx 实现层。
+
+上游规范（MIT）：styles/blueprint/STYLE.md
+普鲁士蓝纸 + 白线 + 一次红色印章；不做 3D、不做辉光。
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import numpy as np
+
+import manimgx as m
+
+TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
+
+TABLE = TOKENS["colors"]["table"]
+PAPER = TOKENS["colors"]["paper"]
+PAPER_LIGHT = TOKENS["colors"]["paper_light"]
+LINE = TOKENS["colors"]["line"]
+MUTED = TOKENS["colors"]["muted"]
+STAMP = TOKENS["colors"]["stamp"]
+LAYOUT = TOKENS["layout"]
+
+
+def apply_config(width: int = 1920, height: int = 1080, fps: int = 30) -> None:
+    m.config.pixel_width = width
+    m.config.pixel_height = height
+    m.config.frame_rate = fps
+    m.config.background_color = TABLE
+
+
+def backdrop(seed: int = 11) -> m.ImageMobject:
+    """青晒纸：两档普鲁士蓝 + 轻微噪点，压在深色绘图桌上。"""
+    w, h = m.config.pixel_width, m.config.pixel_height
+    yy, xx = np.mgrid[0:h, 0:w]
+    u = xx / (w - 1)
+    v = yy / (h - 1)
+    glow = np.exp(-(((u - 0.48) ** 2) / 0.16 + ((v - 0.44) ** 2) / 0.10))
+    dark = np.array([24, 51, 107], dtype=float)
+    light = np.array([42, 88, 166], dtype=float)
+    rgb = dark + glow[..., None] * (light - dark)
+    rng = np.random.default_rng(seed)
+    rgb = np.clip(rgb + rng.normal(0, 2.1, rgb.shape), 0, 255).astype(np.uint8)
+    img = m.ImageMobject(rgb, scale_to_resolution=min(w, h), resampling_algorithm=3)
+    return img.move_to(m.ORIGIN)
+
+
+def sheet() -> m.Rectangle:
+    """纸边：一条细白线，标出图幅。"""
+    return m.Rectangle(
+        width=LAYOUT["frame"]["width"] - 0.9,
+        height=LAYOUT["frame"]["height"] - 0.9,
+        color=LINE,
+        stroke_width=1.2,
+    )
+
+
+def title_block() -> m.VGroup:
+    x, y = LAYOUT["title_block"]["x"], LAYOUT["title_block"]["y"]
+    box = m.Rectangle(width=3.3, height=1.15, color=LINE, stroke_width=1.0).move_to([x, y, 0])
+    name = m.Text("DRAWING 001", font="Menlo", font_size=21, color=LINE).move_to([x - 0.35, y + 0.27, 0])
+    status = m.Text("STATUS: VERIFIED", font="Menlo", font_size=20, color=MUTED).move_to([x - 0.05, y - 0.27, 0])
+    return m.VGroup(box, name, status)

package/styles/blueprint/tokens.json

@@ -0,0 +1,27 @@
+{
+  "name": "blueprint",
+  "version": "1.0.0",
+  "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/blueprint",
+  "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
+  "colors": {
+    "table": "#0D1116",
+    "paper": "#18336B",
+    "paper_light": "#2A58A6",
+    "line": "#E7F0F9",
+    "muted": "#9FB6D4",
+    "stamp": "#B5442E"
+  },
+  "typography": {
+    "hand": { "family": "Chalkboard SE", "size": 24 },
+    "tech": { "family": "Menlo", "size": 17 },
+    "math": { "family": "New Computer Modern", "size": 54 }
+  },
+  "layout": {
+    "aspect": "16:9",
+    "frame": { "width": 14.222, "height": 8.0 },
+    "margin": 0.55,
+    "title_block": { "x": 4.95, "y": -2.95 }
+  },
+  "motion": { "fps": 30, "easing": "draw-on", "hold_min_seconds": 1.0 },
+  "audio": { "target_lufs": -14, "true_peak_db": -1 }
+}

package/styles/dataviz/STYLE.md

@@ -0,0 +1,58 @@
+---
+name: dataviz
+version: 1.0.0
+source: https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/dataviz
+license: MIT（上游风格文档）；demo 静帧 CC BY 4.0（LemoLab）
+status: adapted
+---
+
+# Data Storytelling · 数据叙事
+
+> 上游：Lemo-Opuscar `styles/dataviz`（MIT）。保留“图表就是电影”的语法；
+> 铅笔/纸纹等材质实现换成了 manimgx 的平涂与细线。
+
+## 1. 定位
+
+一张会讲故事的图：真实数据、逐笔画出、手写注释钉在数字上。图表本身就是镜头、节奏和情节。
+
+- 适合：趋势、比较、分布、前后变化、科学数据；
+- 不适合：没有数据支撑的口号、纯角色故事。
+
+## 2. 不变量
+
+| 项 | 规则 |
+|---|---|
+| 纸 | 奶油纸 `#F4EDE1`；墨 `#2B2622`；网格 `#C9BFAE` |
+| 数据色 | 发散数据用 RdBu（`#2166AC → #F7F7F7 → #B2182B`），以有意义的均值为中心 |
+| 强调 | 蓝 `#2F5D8A` 表示过程/记忆；红 `#B5442E` 表示记录/警告/结论 |
+| 字体 | 衬线标题与图注（Songti SC）；等宽刻度（Menlo）；公式 New Computer Modern |
+| 运动 | 图表操作就是转场：轴生长、点落下、尺度变化、形变；不用淡入淡出 |
+| 注释 | 钉在数据空间（值 + 像素偏移），缩放后仍跟着点 |
+| 声音 | 每个 mark 一个音高；−14 LUFS |
+
+## 3. manimgx 映射
+
+- `theme.py`：`apply_config()`、`backdrop()`、`rule()`、`leader()`；
+- 用 `Axes`、`Dot`、`Line`、`always_redraw` 实现“轴生长 / 点落下 / 割线滑动”；
+- 上游的铅笔、纸纹、手写抖动没有实现；用颜色与注释层级表达同一语法；
+- 字体替换：Newsreader → Songti SC；IBM Plex Mono → Menlo。
+
+## 4. Do / Don't
+
+**Do**
+
+- 一次只讲一个想法；让轴、标注、尺度变化承担叙事；
+- 注释贴着数据点，颜色有语义（蓝=过程，红=结论）；
+- 结论出现时停住，给读者读数时间。
+
+**Don't**
+
+- 不做 dashboard；不堆多个图；
+- 不为了戏剧性拉伸色阶；
+- 不用装饰性图标代替数据。
+
+## 5. 与上游的差异
+
+- 上游是 Canvas 2D + 手写笔刷；这里是矢量平涂，质感更干净；
+- 上游 24 fps、50 秒量级；本实现 30 fps、10 秒量级；
+- ColorBrewer RdBu 为标准色板；纸色/墨色取上游描述的中值，验收以帧为准。

package/styles/dataviz/style.json

@@ -0,0 +1,50 @@
+{
+  "slug": "dataviz",
+  "en": "Data Storytelling",
+  "cn": "数据叙事",
+  "category_en": "Information & Keynote",
+  "category_cn": "信息与发布",
+  "uses": [
+    "Trends",
+    "Comparison",
+    "Distribution",
+    "Scientific data"
+  ],
+  "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/dataviz",
+  "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
+  "implementation": "manimgx (theme.py + tokens.json)",
+  "num": "02",
+  "film": "Secant to Tangent",
+  "line": "A secant slides into a tangent; the slope reading falls from 2.50 to 2.00.",
+  "line_cn": "割线滑成切线，斜率读数从 2.50 落到 2.00。",
+  "uses_cn": [
+    "趋势",
+    "比较",
+    "分布",
+    "科学数据"
+  ],
+  "keywords": [
+    "数据",
+    "图表",
+    "趋势",
+    "比较",
+    "分布",
+    "斜率",
+    "切线",
+    "割线",
+    "函数",
+    "变化率",
+    "统计"
+  ],
+  "avoid": [
+    "纯文字排版",
+    "角色叙事"
+  ],
+  "demo": "showcase/dataviz-secant",
+  "demo_duration_sec": 10.1,
+  "aspect": [
+    "16:9"
+  ],
+  "fps": 30,
+  "complexity": "low"
+}

package/styles/dataviz/theme.py

@@ -0,0 +1,49 @@
+"""dataviz 1.0.0 — Lemo-Opuscar 的 Data Storytelling，manimgx 实现层。
+
+上游规范（MIT）：styles/dataviz/STYLE.md
+纸、墨、蓝红铅笔；颜色与字号只从 tokens.json 取。
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+import manimgx as m
+
+TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
+
+PAPER = TOKENS["colors"]["paper"]
+PAPER_SHADOW = TOKENS["colors"]["paper_shadow"]
+INK = TOKENS["colors"]["ink"]
+GRID = TOKENS["colors"]["grid"]
+MUTED = TOKENS["colors"]["muted"]
+BLUE = TOKENS["colors"]["blue"]
+RED = TOKENS["colors"]["red"]
+FONT = TOKENS["typography"]["display"]["family"]
+MONO = TOKENS["typography"]["mono"]["family"]
+LAYOUT = TOKENS["layout"]
+
+
+def apply_config(width: int = 1920, height: int = 1080, fps: int = 30) -> None:
+    m.config.pixel_width = width
+    m.config.pixel_height = height
+    m.config.frame_rate = fps
+    m.config.background_color = PAPER
+
+
+def backdrop() -> m.Rectangle:
+    """一张平整的奶油纸；不要渐变、不要投影。"""
+    return (
+        m.Rectangle(width=LAYOUT["frame"]["width"], height=LAYOUT["frame"]["height"], color=PAPER)
+        .set_fill(PAPER, 1)
+        .set_stroke(width=0)
+    )
+
+
+def rule(y: float, width: float, x: float = 0.0, color: str = GRID, stroke_width: float = 1.0) -> m.Line:
+    return m.Line([x - width / 2, y, 0], [x + width / 2, y, 0], color=color, stroke_width=stroke_width)
+
+
+def leader(start, end, color: str = MUTED, stroke_width: float = 1.0) -> m.DashedLine:
+    return m.DashedLine(start, end, color=color, stroke_width=stroke_width, dash_length=0.08)

package/styles/dataviz/tokens.json

@@ -0,0 +1,31 @@
+{
+  "name": "dataviz",
+  "version": "1.0.0",
+  "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/dataviz",
+  "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
+  "colors": {
+    "paper": "#F4EDE1",
+    "paper_shadow": "#E8DECF",
+    "ink": "#2B2622",
+    "grid": "#C9BFAE",
+    "muted": "#7A6F63",
+    "blue": "#2F5D8A",
+    "red": "#B5442E",
+    "ramp_low": "#2166AC",
+    "ramp_mid": "#F7F7F7",
+    "ramp_high": "#B2182B"
+  },
+  "typography": {
+    "display": { "family": "Songti SC", "weight": "BOLD", "size": 42 },
+    "body": { "family": "Songti SC", "size": 24 },
+    "mono": { "family": "Menlo", "size": 18 },
+    "math": { "family": "New Computer Modern", "size": 56 }
+  },
+  "layout": {
+    "aspect": "16:9",
+    "frame": { "width": 14.222, "height": 8.0 },
+    "margin": 0.55
+  },
+  "motion": { "fps": 30, "easing": "chart-operation", "hold_min_seconds": 1.2 },
+  "audio": { "target_lufs": -14, "true_peak_db": -1 }
+}