dsh-motion 0.2.0 → 0.4.0

package/styles/registry.json

@@ -0,0 +1,213 @@
+{
+  "version": 1,
+  "generated": true,
+  "default": "swiss-motion",
+  "styles": [
+    {
+      "slug": "swiss-motion",
+      "num": "01",
+      "name_cn": "瑞士动态排版",
+      "name_en": "Swiss Motion Graphics",
+      "category_cn": "图形与排版",
+      "uses": [
+        "Formula",
+        "Definition",
+        "Data conclusion",
+        "Typography"
+      ],
+      "uses_cn": [
+        "公式",
+        "定义",
+        "数据结论",
+        "排版"
+      ],
+      "keywords": [
+        "公式",
+        "欧拉",
+        "定理",
+        "定义",
+        "恒等式",
+        "推导",
+        "排版",
+        "方程"
+      ],
+      "avoid": [
+        "图表",
+        "几何证明"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "low",
+      "demo": "showcase/swiss-euler",
+      "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/swiss-motion"
+    },
+    {
+      "slug": "dataviz",
+      "num": "02",
+      "name_cn": "数据叙事",
+      "name_en": "Data Storytelling",
+      "category_cn": "信息与发布",
+      "uses": [
+        "Trends",
+        "Comparison",
+        "Distribution",
+        "Scientific data"
+      ],
+      "uses_cn": [
+        "趋势",
+        "比较",
+        "分布",
+        "科学数据"
+      ],
+      "keywords": [
+        "数据",
+        "图表",
+        "趋势",
+        "比较",
+        "分布",
+        "导数",
+        "斜率",
+        "切线",
+        "割线",
+        "函数",
+        "变化率",
+        "统计"
+      ],
+      "avoid": [
+        "纯文字排版",
+        "角色叙事"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "low",
+      "demo": "showcase/dataviz-secant",
+      "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/dataviz"
+    },
+    {
+      "slug": "blueprint",
+      "num": "03",
+      "name_cn": "蓝图工程制图",
+      "name_en": "Blueprint",
+      "category_cn": "图形与排版",
+      "uses": [
+        "Geometry proof",
+        "Structures",
+        "Dimensions"
+      ],
+      "uses_cn": [
+        "几何证明",
+        "结构",
+        "尺寸关系"
+      ],
+      "keywords": [
+        "几何",
+        "证明",
+        "三角形",
+        "圆",
+        "角度",
+        "尺寸",
+        "工程",
+        "结构",
+        "作图",
+        "勾股"
+      ],
+      "avoid": [
+        "图表",
+        "手绘"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "medium",
+      "demo": "showcase/blueprint-pythagoras",
+      "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/blueprint"
+    },
+    {
+      "slug": "whiteboard",
+      "num": "04",
+      "name_cn": "白板讲解",
+      "name_en": "Whiteboard Explainer",
+      "category_cn": "手绘与绘画",
+      "uses": [
+        "Explainers",
+        "Online courses",
+        "Science"
+      ],
+      "uses_cn": [
+        "科学解释",
+        "课程",
+        "机制说明"
+      ],
+      "keywords": [
+        "讲解",
+        "课程",
+        "科学",
+        "机制",
+        "流程",
+        "为什么",
+        "原理",
+        "物理",
+        "化学",
+        "生物"
+      ],
+      "avoid": [
+        "高密度公式",
+        "暗场"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "medium",
+      "demo": "showcase/whiteboard-derivative",
+      "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/whiteboard"
+    },
+    {
+      "slug": "3b1b",
+      "num": "05",
+      "name_cn": "3b1b 数学动画",
+      "name_en": "3Blue1Brown Style",
+      "category_cn": "数学讲解",
+      "uses": [
+        "Linear algebra",
+        "Calculus",
+        "Probability",
+        "Neural networks"
+      ],
+      "uses_cn": [
+        "线代",
+        "微积分",
+        "概率",
+        "神经网络"
+      ],
+      "keywords": [
+        "向量",
+        "矩阵",
+        "特征值",
+        "旋转",
+        "复数",
+        "单位圆",
+        "线代",
+        "概率",
+        "微积分",
+        "神经网络"
+      ],
+      "avoid": [
+        "产品发布",
+        "纯排版"
+      ],
+      "aspect": [
+        "16:9"
+      ],
+      "fps": 30,
+      "complexity": "medium",
+      "demo": "showcase/3b1b-unit-circle",
+      "source": "https://github.com/subinium/3b1b-style-animation-skill"
+    }
+  ]
+}

package/styles/swiss-motion/style.json

@@ -4,8 +4,44 @@
   "cn": "瑞士动态排版",
   "category_en": "Graphic & Type",
   "category_cn": "图形与排版",
-  "uses": ["Brand identity", "Events", "Design education"],
+  "uses": [
+    "Formula",
+    "Definition",
+    "Data conclusion",
+    "Typography"
+  ],
   "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/swiss-motion",
   "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
-  "implementation": "manimgx (theme.py + tokens.json)"
+  "implementation": "manimgx (theme.py + tokens.json)",
+  "num": "01",
+  "film": "Euler Formula",
+  "line": "A formula on a Swiss grid: one red accent, five constants.",
+  "line_cn": "瑞士网格上的一个公式：一个红色信号色，五个常数。",
+  "uses_cn": [
+    "公式",
+    "定义",
+    "数据结论",
+    "排版"
+  ],
+  "keywords": [
+    "公式",
+    "欧拉",
+    "定理",
+    "定义",
+    "恒等式",
+    "推导",
+    "排版",
+    "方程"
+  ],
+  "avoid": [
+    "图表",
+    "几何证明"
+  ],
+  "demo": "showcase/swiss-euler",
+  "demo_duration_sec": 6.2,
+  "aspect": [
+    "16:9"
+  ],
+  "fps": 30,
+  "complexity": "low"
 }

package/styles/swiss-motion/theme.py

@@ -13,6 +13,9 @@ import manimgx as m
 
 TOKENS = json.loads(Path(__file__).with_name("tokens.json").read_text(encoding="utf-8"))
 
+# inspect 在 import 时读 config.frame_rate；必须放在模块层，不能只在 construct 里。
+m.config.frame_rate = int(TOKENS["motion"]["fps"])
+
 GROUND = TOKENS["colors"]["ground"]
 PAPER = TOKENS["colors"]["paper"]
 INK = TOKENS["colors"]["ink"]

package/styles/whiteboard/STYLE.md

@@ -0,0 +1,58 @@
+---
+name: whiteboard
+version: 1.0.0
+source: https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/whiteboard
+license: MIT（上游风格文档）；demo 静帧 CC BY 4.0（LemoLab）
+status: adapted
+---
+
+# Whiteboard Explainer · 白板讲解
+
+> 上游：Lemo-Opuscar `styles/whiteboard`（MIT）。保留“一块板 + 三支马克笔 + 书写顺序”的语法；
+> manimgx 版省掉手/浮空笔/相机旅行，用 draw-on 与固定机位近似。
+
+## 1. 定位
+
+一块暖白干擦板，所有内容都是马克笔“写”出来的：
+
+- 适合：科学解释、课程、机制/流程说明；
+- 不适合：需要真实材质、角色表演、复杂 3D 的题材。
+
+## 2. 不变量
+
+| 项 | 规则 |
+|---|---|
+| 板面 | 暖白 `#F7F5EF`，可有轻微不均与旧字痕 |
+| 墨色 | 黑 `#23262C`：结构与文字 |
+| 过程色 | 蓝 `#2A5CB3`：测量、过程、正在变化 |
+| 强调 | 橙 `#D97757`：结论、最终答案；每区最多一次 |
+| 字体 | 手写体（Chalkboard SE）；公式 New Computer Modern |
+| 运动 | 按书写顺序 draw-on；一笔接一笔；不弹跳 |
+| 版面 | 一个想法一个区域；距离=论证距离；标签要么全在画面内，要么不出现 |
+
+## 3. manimgx 映射
+
+- `theme.py`：`apply_config()`、`backdrop()`（暖白渐变 + 细噪点）；
+- 线条与文字用 `Create` / `Write` 按顺序出现；没有笔、手、橡皮、相机；
+- 字体替换：EMS Tech / Architects Daughter → `Chalkboard SE`；
+- 旧字痕用低透明度 `Text`/`Line` 近似。
+
+## 4. Do / Don't
+
+**Do**
+
+- 先写标题，再按“定义 → 例子 → 结论”在板面上展开；
+- 蓝色只给“正在变化”的对象，橙色只给结论；
+- 结论出现后停住，给读者读完。
+
+**Don't**
+
+- 不画手、笔、光标；
+- 不用第四种马克笔颜色；
+- 不做镜头急推/急拉；文字不压线。
+
+## 5. 与上游的差异
+
+- 上游有浮空马克笔、笔影、干擦纹理、相机旅行；这里只保留书写顺序与三色语义；
+- 上游 24 fps、板面可远大于画幅；本实现 30 fps、固定画幅；
+- 字体与纹理均为近似，验收以帧为准。

package/styles/whiteboard/style.json

@@ -0,0 +1,47 @@
+{
+  "slug": "whiteboard",
+  "en": "Whiteboard Explainer",
+  "cn": "白板讲解",
+  "category_en": "Hand-drawn & Painting",
+  "category_cn": "手绘与绘画",
+  "uses": [
+    "Explainers",
+    "Online courses",
+    "Science"
+  ],
+  "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/whiteboard",
+  "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
+  "implementation": "manimgx (theme.py + tokens.json)",
+  "num": "04",
+  "film": "Secant on a Whiteboard",
+  "line": "A derivative explained on one warm whiteboard with three markers.",
+  "line_cn": "在一块暖白板上，用三支马克笔讲清导数。",
+  "uses_cn": [
+    "科学解释",
+    "课程",
+    "机制说明"
+  ],
+  "keywords": [
+    "讲解",
+    "课程",
+    "科学",
+    "机制",
+    "流程",
+    "为什么",
+    "原理",
+    "物理",
+    "化学",
+    "生物"
+  ],
+  "avoid": [
+    "高密度公式",
+    "暗场"
+  ],
+  "demo": "showcase/whiteboard-derivative",
+  "demo_duration_sec": 9.6,
+  "aspect": [
+    "16:9"
+  ],
+  "fps": 30,
+  "complexity": "medium"
+}

package/styles/whiteboard/theme.py

@@ -0,0 +1,56 @@
+"""whiteboard 1.0.0 — Lemo-Opuscar 的 Whiteboard Explainer，manimgx 实现层。
+
+上游规范（MIT）：styles/whiteboard/STYLE.md
+暖白板 + 三支马克笔；manimgx 版省掉笔/手/相机旅行，只保留书写与结构。
+"""
+
+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"))
+
+# inspect 在 import 时读 config.frame_rate；必须放在模块层，不能只在 construct 里。
+m.config.frame_rate = int(TOKENS["motion"]["fps"])
+
+BOARD = TOKENS["colors"]["board"]
+BOARD_EDGE = TOKENS["colors"]["board_edge"]
+INK = TOKENS["colors"]["ink"]
+BLUE = TOKENS["colors"]["blue"]
+ORANGE = TOKENS["colors"]["orange"]
+MUTED = TOKENS["colors"]["muted"]
+GHOST = TOKENS["colors"]["ghost"]
+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 = BOARD
+
+
+def backdrop(seed: int = 5) -> 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.45) ** 2) / 0.30 + ((v - 0.42) ** 2) / 0.30))
+    rgb = np.empty((h, w, 3), dtype=float)
+    base = np.array([247, 245, 239], dtype=float)
+    edge = np.array([233, 228, 216], dtype=float)
+    rgb[:] = edge + glow[..., None] * (base - edge)
+    rng = np.random.default_rng(seed)
+    rgb = np.clip(rgb + rng.normal(0, 1.0, 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 board_line(y: float, x0: float, x1: float, color: str = INK, width: float = 2.4) -> m.Line:
+    return m.Line([x0, y, 0], [x1, y, 0], color=color, stroke_width=width)

package/styles/whiteboard/tokens.json

@@ -0,0 +1,27 @@
+{
+  "name": "whiteboard",
+  "version": "1.0.0",
+  "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/whiteboard",
+  "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
+  "colors": {
+    "board": "#F7F5EF",
+    "board_edge": "#E9E4D8",
+    "ink": "#23262C",
+    "blue": "#2A5CB3",
+    "orange": "#D97757",
+    "muted": "#8A857C",
+    "ghost": "#C9C3B6"
+  },
+  "typography": {
+    "hand": { "family": "Chalkboard SE", "size": 34 },
+    "label": { "family": "Chalkboard SE", "size": 24 },
+    "math": { "family": "New Computer Modern", "size": 54 }
+  },
+  "layout": {
+    "aspect": "16:9",
+    "frame": { "width": 14.222, "height": 8.0 },
+    "margin": 0.55
+  },
+  "motion": { "fps": 30, "easing": "hand-speed", "hold_min_seconds": 1.4 },
+  "audio": { "target_lufs": -14, "true_peak_db": -1 }
+}