# 图片切分

**Repository Path**: yang-yuqing521/image-segmentation

## Basic Information

- **Project Name**: 图片切分
- **Description**: 一个使用 Rust 编写的图片切分工具，支持 GUI 界面和中文显示
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-11-01
- **Last Updated**: 2025-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Rust

## README

<div align="center">

# 图片切分工具 (Image Splitter)

一个使用 Rust 编写的图片切分工具，支持 GUI 界面和中文显示

[![Gitee Stars](https://gitee.com/yang-yuqing521/image-segmentation/badge/star.svg)](https://gitee.com/yang-yuqing521/image-segmentation/stargazers)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Rust](https://img.shields.io/badge/rust-1.89%2B-orange.svg)](https://www.rust-lang.org/)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://gitee.com/yang-yuqing521/image-segmentation/releases)

<img src="blog-cover.svg" alt="项目封面" width="800"/>

</div>

## 功能特性

- ✅ **图形化界面** - 基于 egui 的现代化 GUI
- ✅ **图片预览** - 加载图片后可实时预览
- ✅ **灵活切分** - 支持 1x1 到 10x10 的任意切分
- ✅ **切分预览** - 保存前可预览切分效果
- ✅ **中文支持** - 完整的中文界面和字体支持
- ✅ **多格式支持** - PNG, JPG, JPEG, BMP, GIF

## 📥 下载使用

### 方式一：直接下载（推荐）

无需安装 Rust 环境，直接下载编译好的可执行文件：

**[📦 前往 Gitee 下载最新版本](https://gitee.com/yang-yuqing521/image-segmentation/releases)**

下载后双击 `image-splitter.exe` 即可运行。

### 方式二：从源码编译

## 快速开始

### 编译项目

```bash
cd image-splitter
cargo build --release
```

### 运行程序

```bash
cargo run --release
```

或直接运行编译后的可执行文件：
```bash
target/release/image-splitter.exe
```

## 使用方法

### 步骤 1: 选择图片
点击 **"📁 选择图片"** 按钮，选择要切分的图片文件

### 步骤 2: 设置切分参数
- **行数**: 使用滑块设置垂直切分数量（1-10）
- **列数**: 使用滑块设置水平切分数量（1-10）

### 步骤 3: 预览切分效果
点击 **"🔍 预览切分"** 按钮，查看切分后的效果

### 步骤 4: 保存结果
点击 **"💾 保存切分图片"** 按钮，选择保存文件夹

## 输出文件命名

切分后的文件按以下格式命名：
```
原文件名_行索引_列索引_序号.扩展名
```

例如，切分 `photo.jpg` 成 2x2：
- `photo_0_0_1.jpg` (左上)
- `photo_0_1_2.jpg` (右上)
- `photo_1_0_3.jpg` (左下)
- `photo_1_1_4.jpg` (右下)

## 技术栈

- **Rust** - 系统编程语言
- **egui** - Immediate mode GUI 框架
- **eframe** - egui 的应用框架
- **image** - 图片处理库
- **rfd** - 文件对话框

## 系统要求

- Windows 10/11 (已测试)
- 支持中文字体（微软雅黑、黑体或宋体）

## 项目结构

```
image-splitter/
├── Cargo.toml          # 项目配置
├── README.md           # 本文件
├── src/
│   └── main.rs         # 主程序代码
└── target/
    └── release/
        └── image-splitter.exe  # 编译后的可执行文件
```

## 常见问题

### 中文显示为方框？
程序会自动尝试加载系统中文字体（微软雅黑、黑体、宋体）。如果仍显示为方框，请确保系统已安装这些字体。

### 编译很慢？
首次编译需要下载所有依赖包，可能需要几分钟。后续编译会快很多。

### 想要命令行版本？
查看 Git 历史中的 CLI 版本，或联系开发者。

## 后续扩展

可能的功能扩展：
- [ ] 图片合并功能
- [ ] 不均匀切分（自定义像素大小）
- [ ] 图片处理（缩放、旋转、滤镜）
- [ ] 拖放文件支持
- [ ] 批量处理
- [ ] 自定义输出文件命名规则

## 📸 使用场景

- **社交媒体九宫格**：制作 Instagram/朋友圈九宫格图片
- **拼图制作**：将照片切分成拼图块
- **游戏开发**：精灵图切分成单个素材
- **设计素材**：批量提取图标和图案

## 📖 详细文档

- [使用指南](USAGE.md) - 详细的使用方法和案例
- [技术博客](BLOG.md) - 完整的开发过程和技术细节
- [SVG 转换指南](convert-svg-to-png.md) - 封面图转换方法

## 🔗 相关链接

- **Gitee 仓库**：https://gitee.com/yang-yuqing521/image-segmentation
- **问题反馈**：https://gitee.com/yang-yuqing521/image-segmentation/issues
- **发布版本**：https://gitee.com/yang-yuqing521/image-segmentation/releases

## 许可证

MIT License

## 贡献

欢迎提交 Issue 和 Pull Request！