You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
tetris/assets/icons/README.md

89 lines
2.1 KiB

# 应用图标目录
本目录包含 Tetris 游戏的应用图标文件。
## 文件说明
### 主要图标文件
- `app.icns` - macOS 应用图标文件 (96K)
- 格式: Mac OS X icon, "ic12" type
- 包含所有标准尺寸 (16x16 到 1024x1024)
- 支持 Retina 显示屏 (@2x 版本)
### PNG 图标文件
- `icon_16.png` - 16x16 像素图标
- `icon_32.png` - 32x32 像素图标
- `icon_64.png` - 64x64 像素图标
- `icon_128.png` - 128x128 像素图标
- `icon_256.png` - 256x256 像素图标
## 图标设计
### 设计元素
- **主题**: 俄罗斯方块彩色块图案
- **背景**: 深蓝色 (#2c3e50) 圆角矩形
- **方块颜色**:
- 红色 (#e74c3c)
- 蓝色 (#3498db)
- 橙色 (#f39c12)
- 绿色 (#2ecc71)
- 紫色 (#9b59b6)
- 深橙色 (#e67e22)
- 青绿色 (#1abc9c)
- 深灰色 (#34495e)
### 技术特性
- **多分辨率支持**: 适配不同显示密度
- **圆角设计**: 符合 macOS 设计规范
- **高光效果**: 增加视觉层次感
- **白色边框**: 增强方块定义
## 构建集成
在 macOS 构建过程中,`app.icns` 文件会自动复制到应用包中:
```bash
# 构建 macOS 版本
make macos
# 图标将自动复制到:
# dist/macos/TetrisGame.app/Contents/Resources/app.icns
```
## 图标使用
### macOS 应用
- 文件位置: `TetrisGame.app/Contents/Resources/app.icns`
- Info.plist 配置: `CFBundleIconFile = app`
- 显示位置: Finder、Dock、应用启动台
### 其他平台
- Windows: 可使用 PNG 文件转换为 .ico 格式
- Linux: 直接使用 PNG 文件
## 维护说明
### 更新图标
如需更新应用图标:
1. 替换 `app.icns` 文件
2. 可选:更新对应的 PNG 文件
3. 重新构建应用: `make clean && make macos`
### 创建新图标
如需从零创建新图标:
1. 创建 1024x1024 的高分辨率设计
2. 生成多个尺寸的 PNG 文件
3. 使用 macOS `iconutil` 工具创建 .icns 文件:
```bash
iconutil -c icns icon.iconset -o app.icns
```
## 文件完整性
所有图标文件的校验和:
- `app.icns`: 96K (Mac OS X icon format)
- 总体设计一致性: ✅
- 多分辨率覆盖: ✅
- macOS 兼容性: ✅