Skip to content

README.md

Latest commit

 

History

History
69 lines (48 loc) · 3.17 KB

README.md

File metadata and controls

69 lines (48 loc) · 3.17 KB
Raw

FrameSmith

FrameSmith 是一款面向 2D 动画与游戏美术管线的 macOS 桌面工具，可以把角色视频或 GIF 转换为带透明背景的动画帧，并导出 PNG 序列、Sprite Sheet、GIF 和 FrameSmith JSON。

项目源码公开托管在 GitHub。所有素材都在 Mac 本机处理，FrameSmith 不会上传导入的媒体。

项目状态

  • 当前公开的是源码；暂不提供可公开下载的官方 DMG。
  • 干净克隆可以直接构建，并使用 Apple Vision 完成前景分割。
  • 可选的游戏美术 Core ML 模型及其约 84 MB 权重不在仓库中。
  • 历史内部 Beta 的 DMG 包含该模型。在模型权重获得明确的公开再分发授权前，请勿把这些二进制文件附加到公开 GitHub Release。

运行与开发要求

  • macOS 26 或更新版本
  • Apple Silicon Mac（M1 或更新）
  • Xcode 26.6 或兼容的更新版本
  • XcodeGen

从源码运行

brew install xcodegen
git clone https://github.com/jdbd25414-ops/FrameSmith.git
cd FrameSmith
xcodegen generate --spec project.yml
open FrameSmith.xcodeproj

在 Xcode 中选择 FrameSmith scheme 后运行。源码构建不需要第三方模型；选择“自动”抠图时，如果本地没有游戏美术模型，应用会回退到 Apple Vision。

快速上手

  1. 导入 MP4、MOV 或 GIF 文件。
  2. 在时间线选择动画 FPS；修改会立即影响预览和导出。
  3. 需要自动去除背景时，打开“动作”，点击“运行 AI 抠图”。
  4. 在时间线或“帧总览”检查并批量选择画面。
  5. 使用魔棒、换色去除、边缘精修、橡皮擦或铅笔修正结果。
  6. 导出需要的 PNG 序列、Sprite Sheet、GIF 或 JSON。

主要功能

  • 视频和 GIF 顺序解码、重采样与动画 FPS 调整
  • 可选的本地 AI 前景分割，不上传素材
  • 单行时间线与多列帧总览
  • 魔棒、换色去除、边缘精修、橡皮擦和铅笔
  • 非破坏编辑、撤销/重做与质量审阅
  • PNG 序列、Sprite Sheet、GIF 和 JSON 选择性导出
  • Unity 2021.3+ 本地 UPM 导入器

可选模型

游戏美术 Core ML 后端基于 SkyTNT anime-segmentation 的固定转换。模型权重必须由开发者自行取得并在本地转换；仓库不会下载或分发权重。具体步骤与许可边界见开发者文档和模型说明。

参与贡献

提交问题前请搜索现有 issue，并移除日志、截图或样例中的个人与未授权素材：

架构、构建、测试和发布边界见开发者文档，后续计划见 ROADMAP。

许可证

FrameSmith 源码使用 MIT License。第三方组件及可选模型不自动适用 MIT License，其许可证与声明见 ThirdPartyNotices。