# iconpainter

**Repository Path**: aleckstygit/iconpainter

## Basic Information

- **Project Name**: iconpainter
- **Description**: icon file editer tools
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-21
- **Last Updated**: 2026-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IconPainter — 图标制作工具

![Version](https://img.shields.io/badge/版本-0.01--beta.1-blue)
![Platform](https://img.shields.io/badge/平台-Windows%20x86-lightgrey)
![Framework](https://img.shields.io/badge/框架-MFC%204.2%2B-green)

一个基于 Win32 MFC 的 Windows 图标编辑器，支持创建、打开、编辑和保存 `.ico` 图标文件（1/4/8/16/24/32 bpp，含高彩色图标）。

## 功能特色

- ✅ 新建图标（支持多种尺寸与色深）
- ✅ 打开/编辑/保存 `.ico` 文件
- ✅ 支持打开含多个图像的图标文件
- ✅ 画笔 / 直线绘图工具
- ✅ 放大/缩小显示
- ✅ 调色板（2色 / 16色 / 256色 / 真彩色）
- ✅ 前景色/背景色/透明色选择
- ✅ 支持 .exe / .dll / .bmp 文件中的图标提取（骨架）
- ❌ 圆形/矩形/填充/文字/拾色等工具（待实现）
- ❌ 撤销/重做（待实现）
- ❌ 复制/剪切/粘贴（待实现）
- ❌ BMP 导入/导出（待实现）

## 系统要求

- Windows XP / Vista / 7 / 8 / 10 / 11（32 位）
- Visual Studio 2010 或更高版本（用于构建）
- 需要 MFC 动态链接库（随 VS 安装）

## 构建

1. 打开 `IconPainter.sln`
2. 选择配置：**Debug|Win32** 或 **Release|Win32**
3. 按 `F5` 构建并运行

## 使用说明

| 操作 | 说明 |
|---|---|
| 文件 → 新建 | 创建新图标（预设 48×48 24bpp） |
| 文件 → 打开 | 打开 .ico / .exe / .dll / .bmp 文件 |
| 文件 → 保存 | 保存图标文件 |
| 视图 → 绘图栏 | 显示/隐藏绘图工具栏 |
| 视图 → 调色板 | 显示/隐藏调色板 |
| 绘图 → 画笔 / 直线 | 当前仅这两种工具可用 |
| 视图 → 放大 / 缩小 | 调整编辑视图缩放比例 |

## 项目结构

```
IconPainter/
├── IconPainter.h/.cpp    — 应用程序入口（CWinApp）
├── MainFrm.h/.cpp        — 主框架窗口、工具栏、状态栏
├── IconPainterDoc.h/.cpp — 文档类、文件 I/O 串行化
├── IconPainterView.h/.cpp— 视图类、绘图渲染与鼠标交互
├── Icon.h/.cpp           — 图标数据引擎（核心位图操作）
├── IconLoad.h/.cpp       — 多图标选择对话框
├── ColorBar.h/.cpp       — 自绘调色板控件
├── NewIcon.h/.cpp        — 新建图标对话框
├── DlgLoadIcon.h/.cpp    — 多图标加载选择
├── DialogLoad.h/.cpp     — 加载对话框（未完成）
├── DialogProperty.h/.cpp — 属性对话框（未完成）
├── DlgView.h/.cpp        — 预览对话框（未完成）
└── RES/                  — 资源文件（图标、光标、位图）
```

## 技术说明

- **架构**：MFC SDI（单文档界面），Document/View 模式
- **字符集**：多字节（MultiByte）
- **编译环境**：从 VC6 → VS2005 → VS2010 逐步迁移
- **调色板**：2/16/256 色块自绘，256 色分 8 页显示
- **绘图底层**：CIcon 类管理全部位图数据（单次 malloc 分配）

## 代码问题

当前已知问题详见 [CHANGELOG.md](./CHANGELOG.md) 和 [AGENTS.md](./AGENTS.md)。

## 许可

项目最初由**施探宇**于 2002 年开发。