dsh-motion 0.1.1 → 0.3.0

package/styles/registry.json

@@ -0,0 +1,212 @@
+{
+  "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.md

@@ -0,0 +1,59 @@
+---
+name: swiss-motion
+version: 1.0.0
+source: https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/swiss-motion
+license: MIT（上游风格文档）；demo 静帧 CC BY 4.0（LemoLab）
+status: adapted
+---
+
+# Swiss Motion Graphics · 瑞士动态排版
+
+> 上游：Lemo-Opuscar `styles/swiss-motion`（MIT）。本文件是**改编**，不是原样复制：
+> 去掉了 WebGL/Canvas 专属实现，保留不变量与语法；数值落在 `tokens.json`。
+
+## 1. 定位
+
+国际主义排版风格在动：模块网格、一种字体、一个信号色，运动像印刷机一样精确。
+
+- 适合：公式、定义、数据结论、品牌/活动信息；
+- 不适合：角色叙事、手绘、颗粒质感、连续镜头。
+
+## 2. 不变量
+
+| 项 | 规则 |
+|---|---|
+| 底色 | 纸灰 `#EAE9E5`，纯平；不用渐变、投影、颗粒 |
+| 墨色 | `#111111`；辅助灰 `#6B6B6B`；规矩线 `#C9C7C1` |
+| 强调 | 全片只有一个信号色 `#E30613`，只给“例外/结论/正在动的东西” |
+| 字体 | 一种无衬线，粗细分层；标题最多 3 级 |
+| 网格 | 16:9 画 12 栏；栏线只在页边距露出短刻度 |
+| 运动 | 两个曲线：精确 ease `cubic-bezier(.7,0,.2,1)` 与 linear；无回弹、无弹簧 |
+| 入场 | 划入 / 裁切揭示；不用淡入淡出 |
+| 声音 | 干净的节拍与印刷 Foley；−14 LUFS；不要颗粒 |
+
+## 3. manimgx 映射
+
+- `theme.py`：`apply_config()`、`backdrop()`、`columns()`、`rule()`；
+- 字体替换：上游 Archivo/Inter → `Noto Sans`；等宽 → `Menlo`；公式 → `New Computer Modern`；
+- manimgx 没有 clip-path 遮罩，入场用 `Create` / `Write` 代替裁切揭示；
+- 网格用上下页边距刻度，避免版式检查把“线穿字”判成问题。
+
+## 4. Do / Don't
+
+**Do**
+
+- 一个画面只讲一个结论；先有线，再有字；
+- 信号色只出现一次，结论落在它上面；
+- 大字号与小字号并置，中间留白。
+
+**Don't**
+
+- 不用第二个强调色；不用 Helvetica/Akzidenz 字体文件；
+- 不用渐变球、辉光、投影、颗粒；
+- 不让文字压网格线；不把每个点做成卡片。
+
+## 5. 与上游的差异
+
+- 上游用 WebGL/Canvas 做裁切揭示与精确网格；这里用 manimgx 的矢量对象近似；
+- 上游 24 fps；本实现默认 30 fps（可在 `tokens.motion.fps` 改回 24）；
+- 上游字体不随包分发；这里统一用系统/内置 Noto 与 Menlo，观感会有差异，验收以帧为准。

package/styles/swiss-motion/style.json

@@ -0,0 +1,47 @@
+{
+  "slug": "swiss-motion",
+  "en": "Swiss Motion Graphics",
+  "cn": "瑞士动态排版",
+  "category_en": "Graphic & Type",
+  "category_cn": "图形与排版",
+  "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)",
+  "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

@@ -0,0 +1,59 @@
+"""swiss-motion 1.0.0 — Lemo-Opuscar 的 Swiss Motion Graphics，manimgx 实现层。
+
+上游客服规范（MIT）：styles/swiss-motion/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"))
+
+GROUND = TOKENS["colors"]["ground"]
+PAPER = TOKENS["colors"]["paper"]
+INK = TOKENS["colors"]["ink"]
+MUTED = TOKENS["colors"]["muted"]
+RULE = TOKENS["colors"]["rule"]
+SIGNAL = TOKENS["colors"]["signal"]
+FONT = TOKENS["typography"]["display"]["family"]
+MOTION = TOKENS["motion"]
+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 = GROUND
+
+
+def backdrop() -> m.Rectangle:
+    """Flat paper ground. Swiss 规定无渐变、无投影、无颗粒。"""
+    return (
+        m.Rectangle(width=LAYOUT["frame"]["width"], height=LAYOUT["frame"]["height"], color=GROUND)
+        .set_fill(GROUND, 1)
+        .set_stroke(width=0)
+    )
+
+
+def columns(count: int = 12, margin: float = 0.5, opacity: float = 0.55) -> m.VGroup:
+    """12 栏规矩线：只在上下页边距画短刻度，不穿过文字。"""
+    width = LAYOUT["frame"]["width"] - margin * 2
+    x0 = -LAYOUT["frame"]["width"] / 2 + margin
+    marks = m.VGroup()
+    for i in range(count + 1):
+        x = x0 + width * i / count
+        top = m.Line([x, 3.55, 0], [x, 3.78, 0], color=RULE, stroke_width=1.0)
+        bottom = m.Line([x, -3.55, 0], [x, -3.32, 0], color=RULE, stroke_width=1.0)
+        top.set_stroke(opacity=opacity)
+        bottom.set_stroke(opacity=opacity)
+        marks.add(top, bottom)
+    return marks
+
+
+def rule(y: float, width: float, x: float = 0.0, color: str = RULE, stroke_width: float = 1.2) -> m.Line:
+    return m.Line([x - width / 2, y, 0], [x + width / 2, y, 0], color=color, stroke_width=stroke_width)

package/styles/swiss-motion/tokens.json

@@ -0,0 +1,33 @@
+{
+  "name": "swiss-motion",
+  "version": "1.0.0",
+  "source": "https://github.com/lemomo-ai/lemo-opuscar/tree/main/styles/swiss-motion",
+  "license": "style doc MIT; demo stills CC BY 4.0 (LemoLab)",
+  "colors": {
+    "ground": "#EAE9E5",
+    "paper": "#FFFFFF",
+    "ink": "#111111",
+    "muted": "#6B6B6B",
+    "rule": "#C9C7C1",
+    "signal": "#E30613"
+  },
+  "typography": {
+    "display": { "family": "Noto Sans", "weight": "BOLD", "size": 64 },
+    "body": { "family": "Noto Sans", "size": 26 },
+    "mono": { "family": "Menlo", "size": 18 },
+    "math": { "family": "New Computer Modern", "size": 96 }
+  },
+  "layout": {
+    "aspect": "16:9",
+    "frame": { "width": 14.222, "height": 8.0 },
+    "margin": 0.5,
+    "columns": 12
+  },
+  "motion": {
+    "fps": 30,
+    "easing": "precise",
+    "snap_seconds": 0.4,
+    "hold_min_seconds": 1.0
+  },
+  "audio": { "target_lufs": -14, "true_peak_db": -1 }
+}

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,53 @@
+"""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"))
+
+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 }
+}