# 神笔码靓作品集 **Repository Path**: march3/marlion-works ## Basic Information - **Project Name**: 神笔码靓作品集 - **Description**: 神笔码靓作品集分享 - **Primary Language**: Python - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-20 - **Last Updated**: 2026-10-28 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 神笔码靓作品集 用「**神笔码靓**」中文绘图包写的可运行作品源码集：每个作品一个 `.py`，运行一次就产出 **SVG 作品**（浏览器打开即动），需要发视频的还能顺手生成 **录屏页**。 - 作品集仓库： - 绘图包（PyPI）： - 绘图包源码： - 作者：三月三（Python 超人） > 仓库里放的是**作品源码**，不是图片成品。想要的图/视频，自己跑一下脚本就能拿到，所有产物统一落在 `输出文件/`。 --- ## 一、目录结构 ``` marlion-works/ ├── 生活娱乐/ # 作品源码，按主题分目录 │ └── 瑞典艺术时钟Clock24.py # ClockClock 24 风格艺术时钟 ├── 资源库/ # 设计素材（图片、电子书等） ├── 输出文件/ # 运行产物统一输出到这里（SVG / 录屏页 / webm / mp4） ├── requirements.txt # 依赖清单 ├── .gitignore └── README.md ``` --- ## 二、环境要求 | 项 | 要求 | |---------|----------------------------| | Python | **3.8 及以上** | | tkinter | 需要（官方安装包 / Anaconda 默认自带） | | 操作系统 | Windows / macOS / Linux 均可 | > ⚠️ **tkinter 是关键**：绘图包内部要用它做字体检测。部分「精简版」Python 不带 tkinter，运行会报 `No module named '_tkinter'` > 或 `Can't find a usable init.tcl`。遇到就换官方安装包（安装时勾选 `tcl/tk`）或 Anaconda。 --- ## 三、安装教程 ### 1. 获取代码 ```bash git clone https://gitee.com/march3/marlion-works.git cd marlion-works ``` ### 2. 建一个虚拟环境（强烈建议） 绘图包把 `numpy` / `matplotlib` 等依赖**固定了版本**，装在虚拟环境里可以避免影响你机器上其它项目。 ```powershell # Windows python -m venv venv venv\Scripts\activate ``` ```bash # macOS / Linux python3 -m venv venv source venv/bin/activate ``` ### 3. 安装依赖 ```bash pip install -r requirements.txt ``` 也可以只装绘图包本体，两种方式任选其一： ```bash pip install marlion==0.2.0 pip install -i https://pypi.org/simple/ marlion==0.2.0 pip install -i https://mirrors.ustc.edu.cn/pypi/simple/ marlion==0.2.0 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ marlion==0.2.0 pip install -i https://mirrors.huaweicloud.com/repository/pypi/simple/ marlion==0.2.0 pip install -i https://mirrors.cloud.tencent.com/pypi/simple/ marlion==0.2.0 ``` **关于包名**：PyPI 上的包名是 `marlion`，装完在代码里的导入名是中文的 `神笔码靓`，例如： ```python from 神笔码靓.神笔库 import 神笔绘图板 ``` `marlion` 会自动带齐下面这些运行时依赖，**不需要手工逐个装**： | 依赖 | marlion 声明版本 | |--------------|--------------| | svgwrite | 1.4.3 | | svgpathtools | 1.6.1 | | cairosvg | 2.7.1 | | numpy | 1.24.4 | | matplotlib | 3.5.2 | | shapely | 2.0.7 | ### 4.（可选）准备字体 个别作品会给成品加标题装饰字，字体按**相对脚本目录**的路径去取，约定放在仓库根目录的 `字体/` 下： ``` marlion-works/字体/小篆体.ttf # 标题字体 marlion-works/字体/思源圆体.ttf # 副标题字体 ``` **不装也能跑**：字体缺失时脚本只打印一行提示 `⚠ 字体文件不存在，改用系统字体：…`，随后用系统字体正常出图，不影响作品本身。 --- ## 四、使用说明 以作品「瑞典艺术时钟 Clock24」为例。 ### 步骤 1：建输出目录 绘图包会从当前目录向上找一个名为 `输出文件` 的文件夹，**找不到就直接报错**： ``` Exception: 请手动创建一个名为'输出文件'的目录。 ``` Git 不跟踪空目录，所以**新克隆下来的仓库里没有 `输出文件/`，第一次运行前要手工建一个**： ```powershell New-Item -ItemType Directory 输出文件 ``` ```bash mkdir 输出文件 ``` （仓库里已有该目录时跳过这步。） ### 步骤 2：运行脚本 ```powershell python "生活娱乐/瑞典艺术时钟Clock24.py" ``` 脚本跑完会打印产物位置，典型输出： ``` 神笔绘图板保存成功，保存位置： ...\输出文件\瑞典艺术时钟Clock24.svg 录屏页：...\输出文件\ClockClock24_录屏.html ``` ### 步骤 3：拿到产物 跑一次得到两个文件，都在 `输出文件/` 里： | 产物 | 说明 | |------------------------|-------------------------------------------------------------------------------------------| | `瑞典艺术时钟Clock24.svg` | **作品本体**。直接拖进浏览器就能看：36 个迷你钟面（12 列 × 3 行，每个钟面 2 根指针，共 72 根）摆出「时:分:秒」，走时带缓动，开场还有一段放大缩回的推拉镜头 | | `ClockClock24_录屏.html` | **录屏/拍视频专用页**。16:9 画框（1920×1080）+ 上下标题装饰；按任意键（`F12` 除外）重播开场动画 | ### 步骤 4：录成视频 | 方式 | 做法 | 得到 | |--------------|---------------------------------------------------------------------------------------|-------------------------------------| | 方式一 · 浏览器直接录 | 打开 `ClockClock24_录屏.html` → `F11` 全屏 → 按 `V`（或点右下角「● 录制」）→ 弹窗里选「**当前标签页**」→ 播完自动停止并下载 | `.webm`（用 ffmpeg 可转 mp4） | | 方式二 · 离线逐帧渲染 | `python "生活娱乐/瑞典艺术时钟Clock24视频生成.py"` | 直接得到 1080p60 `.mp4`，不需要 OBS / Win+G | > 方式二对应的 `瑞典艺术时钟Clock24视频生成.py` 尚未随本仓库提供（脚本内已预留调用说明），当前请先用方式一。 ### 步骤 5：改参数 脚本顶部有一个 `开场缩放配置` 字典，改它就能调：放大倍数、停留时长、缩回时长、缓动曲线、缩放中心、标题 / 副标题文字与字号、字体、画框尺寸、是否自动循环、录制帧率码率等，注释里逐项都写了。改完重跑脚本即可。 --- ## 五、作品清单 | 目录 | 作品 | 长什么样 | 运行后得到 | |---------|----------------|---------------------------------------------------------------------------|--------------------------------------------| | `生活娱乐/` | 瑞典艺术时钟 Clock24 | 12 列 × 3 行共 36 个迷你钟面（72 根指针），每 2 列拼出 1 位数字，6 位数字显示「时:分:秒」；指针缓动走时 + 开场推拉镜头 | `瑞典艺术时钟Clock24.svg`、`ClockClock24_录屏.html` | --- ## 六、运行流程一览 ``` git clone 仓库 │ ├─ 建虚拟环境并激活 python -m venv venv │ ├─ 装依赖 pip install -r requirements.txt │ ├─ 建输出目录（首次必做） mkdir 输出文件 │ ├─ （可选）放字体 字体/小篆体.ttf、字体/思源圆体.ttf │ └─ 运行作品 python "生活娱乐/瑞典艺术时钟Clock24.py" │ └─ 输出文件/ ├─ 瑞典艺术时钟Clock24.svg ← 浏览器看 └─ ClockClock24_录屏.html ← 录视频 ``` --- ## 七、常见问题 | 现象 | 原因 | 处理 | |---------------------------------------------------------------|--------------------------|-----------------------------------| | `Exception: 请手动创建一个名为'输出文件'的目录。` | 缺 `输出文件/`（新克隆必然没有） | 在项目根目录建 `输出文件/` | | `No module named '_tkinter'` / `Can't find a usable init.tcl` | 用了不带 tkinter 的精简版 Python | 换官方安装包（勾选 tcl/tk）或 Anaconda | | `ModuleNotFoundError: No module named 'svgwrite'` | 依赖没装 | `pip install -r requirements.txt` | | `⚠ 字体文件不存在，改用系统字体：…` | 字体目录里没有对应 ttf | 非报错，可忽略；想要装饰字就把 ttf 放进 `字体/` | | 装依赖时提示 `numpy`、`matplotlib` 被降级 | marlion 固定了这些依赖的版本 | 装在虚拟环境里，别装进系统 / Anaconda 基础环境 | | 录屏页录出来的 `.webm` 播放器显示只有 1 秒 | webm 容器头没写时长，内容其实是完整的 | 用 ffmpeg 转一次 mp4 即正常 | --- ## 八、参与贡献 1. Fork 本仓库 2. 新建 `Feat_xxx` 分支 3. 提交代码 4. 新建 Pull Request 欢迎把你的作品按 `主题目录/作品名.py` 的形式放进来，一起丰富这个作品集。 --- ## 九、版权声明 - 本仓库代码仅供**学习交流**使用，请勿用于商业用途。 - 如需引用、转载、分享，请注明出处并附上本声明。 - 作品源码为作者个人独立创作，未经作者允许，禁止用于任何商业用途或违反法律法规的行为。 --- ## 相关链接 - 作品集仓库： - 绘图包 marlion： - 绘图包源码：