# SpriteFrameStudio

**Repository Path**: xixin32/SpriteFrameStudio

## Basic Information

- **Project Name**: SpriteFrameStudio
- **Description**: SpriteFrameStudio 是一款功能强大的视频处理工具，专为游戏开发、动画制作和精灵图素材提取设计。它集成了先进的 AI 姿势检测、背景去除和图像优化功能，能够帮助用户快速从视频中提取高质量的帧序列，轻松制作游戏精灵图和动画素材。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2026-01-28
- **Last Updated**: 2026-01-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SpriteFrameStudio - 精灵帧工作室

SpriteFrameStudio 是一款功能强大的视频处理工具，专为游戏开发、动画制作和精灵图素材提取设计。它集成了先进的 AI 姿势检测、背景去除和图像优化功能，能够帮助用户快速从视频中提取高质量的帧序列，轻松制作游戏精灵图和动画素材。

## 核心功能

*   **智能帧提取**：支持自定义 FPS 和时间范围，精准提取视频片段。
*   **多模式分析**：
    *   **RTMPose 姿势检测**：利用高性能 AI 模型识别人物动作。
    *   **分区域 SSIM 比对**：针对动漫或特定场景的精细化相似度分析（可重点关注下半身）。
    *   **轮廓与图像匹配**：多种算法辅助寻找循环动作或剔除重复帧。
*   **背景处理**：
    *   **AI 智能抠图**：内置模型自动去除背景（如 Bria 等模型）。
    *   **传统颜色过滤**：支持绿幕、蓝幕等预设及自定义颜色剔除。
*   **图像后期优化**：
    *   **批量缩放**：保持比例或强制尺寸。
    *   **边缘优化**：平滑边缘，去除毛刺。
    *   **描边与裁剪**：自动为提取的对象添加描边，并裁剪多余空白区域。
*   **高效导出**：支持批量处理与多种导出格式。

## 使用手册

### 环境要求

*   **Python**: 3.9.19 (推荐)
*   **CUDA**: 12.4 (若需 GPU 加速)
*   **cuDNN**: 9.10.2
*   **依赖项**: 详见 `requirements.txt`

### 安装步骤

#### 方式一：使用 Conda 在线安装

1.  创建并激活 Conda 环境：
    ```bash
    conda create -n spriteframe python=3.9.19
    conda activate spriteframe
    ```

2.  安装 CUDA 和 cuDNN（若需 GPU 加速）：
    ```bash
    conda install -c conda-forge cuda-toolkit=12.4
    conda install -c conda-forge cudnn=9
    ```

3.  克隆仓库并安装依赖：
    ```bash
    git clone https://gitee.com/game-cat/SpriteFrameStudio.git
    cd SpriteFrameStudio
    pip install -r requirements.txt
    ```

#### 方式二：使用离线 Conda 环境包

如果你已经导出了完整的 Conda 环境 tar.gz 包，可以使用以下方式快速部署：

1.  从离线包创建环境：
    ```bash
    # 假设你的环境包名为 spriteframe_env.tar.gz
    mkdir -p ~/conda_envs/spriteframe
    tar -xzf spriteframe_env.tar.gz -C ~/conda_envs/spriteframe
    ```

2.  激活离线环境：
    ```bash
    # Windows
    conda activate ~/conda_envs/spriteframe
    
    # Linux/Mac
    source ~/conda_envs/spriteframe/bin/activate
    ```

3.  克隆项目并运行：
    ```bash
    git clone https://gitee.com/game-cat/SpriteFrameStudio.git
    cd SpriteFrameStudio
    python src/main.py
    ```

**导出环境包的方法**（供参考）：
```bash
# 在源机器上导出当前环境
conda activate spriteframe
conda pack -n spriteframe -o spriteframe_env.tar.gz
```

**注意**：使用 `conda pack` 需要先安装该工具：
```bash
conda install -c conda-forge conda-pack
```

#### 方式三：手动配置（不使用 Conda）

1.  安装 Python 3.9.19

2.  克隆仓库：
    ```bash
    git clone https://gitee.com/game-cat/SpriteFrameStudio.git
    cd SpriteFrameStudio
    ```

3.  安装依赖：
    ```bash
    pip install -r requirements.txt
    ```

4.  (可选) 安装 `rtmlib` 及其依赖以启用 RTMPose 姿势检测功能

### 运行程序

执行以下命令启动 GUI 界面：
```bash
python src/main.py
```

### 操作流程

1.  **准备视频**：加载视频文件，选择提取范围和 FPS。
2.  **提取帧**：点击提取按钮获取初始素材。
3.  **动作分析**：选择 RTMPose 或 SSIM 模式，分析帧间相似度，剔除重复项或寻找动作循环。
4.  **背景处理**：使用 AI 抠图或颜色过滤清理背景。
5.  **后期处理**：根据需要进行边缘平滑、描边、缩放和空白裁剪。
6.  **导出**：选择保存路径，一键导出处理后的帧序列。

## 开源协议

### 项目协议
本项目采用 [MIT License](LICENSE) 协议开源，这是一种极其宽松的许可协议。

### 第三方限制说明
本项目使用了 **RTMPose** (来自 OpenMMLab) 进行姿势检测。请注意：
*   **RTMPose 代码** 本身遵循 Apache 2.0 许可。
*   **预训练模型权重**：由于训练数据集（如 COCO 等）的限制，RTMPose 的相关预训练模型通常**仅限于非商业用途**。在使用相关功能进行商业开发前，请务必参考 [OpenMMLab/mmpose](https://github.com/open-mmlab/mmpose) 的官方协议说明。

## 贡献
欢迎提交 Issue 或 Pull Request 来改进本项目！

---
*Created by 小猫学游戏*