# py_first_app_project

**Repository Path**: wangxy99/py_first_app_project

## Basic Information

- **Project Name**: py_first_app_project
- **Description**: 第一个python的app应用，实现一个画板
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-02
- **Last Updated**: 2025-08-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 简易画图板应用

这是一个使用Python和Tkinter开发的简易画图板应用，支持基本的绘图功能，并可以打包成exe文件分发。

## 功能特点

- 多种绘图工具：铅笔、直线、矩形、圆形、填充、橡皮擦、文本
- 工具按钮带有直观的图标
- 颜色选择器
- 线宽调整
- 形状填充功能（按住Shift键绘制矩形或圆形时）
- 撤销/重做功能
- 保存/打开图像
- 键盘快捷键支持
- 刻度尺显示（可切换显示/隐藏）
- 画布缩放功能（支持任意缩放比例）
- 画布拖动功能

## 使用方法

### 运行应用

```bash
python main.py
```

### 快捷键

- `1` - 铅笔工具
- `2` - 直线工具
- `3` - 矩形工具
- `4` - 圆形工具
- `5` - 填充工具
- `6` - 橡皮擦工具
- `7` - 文本工具
- `Shift+拖动` - 绘制填充的矩形或圆形
- `Ctrl+Z` - 撤销
- `Ctrl+Y` - 重做
- `Ctrl+S` - 保存图像
- `Ctrl+O` - 打开图像
- `Ctrl+N` - 清空画布

### 画布操作

- `Ctrl+鼠标滚轮` - 放大/缩小画布
- `Ctrl+按住鼠标左键拖动` - 平移画布
- 工具栏中的放大/缩小/重置按钮 - 控制画布缩放
- 刻度尺复选框 - 切换刻度尺显示/隐藏

## 依赖库

- Tkinter (Python标准库)
- Pillow (PIL Fork)

## 安装依赖

```bash
pip install pillow
```

## 打包成exe文件

本项目可以使用PyInstaller打包成可执行文件，方便在没有Python环境的电脑上运行。

### 安装PyInstaller

```bash
pip install pyinstaller
pip install cairosvg 
```

### 打包命令

```bash
# 基本打包（生成单个exe文件）
pyinstaller --onefile --windowed --icon=resources/icon.ico main.py

# 或者打包成带资源文件夹的版本（体积更小，启动更快）
pyinstaller --windowed --icon=resources/icon.ico main.py
```

打包完成后，可执行文件将位于`dist`文件夹中。

## 注意事项

- 打包时确保所有资源文件都在正确的位置
- 如果使用了第三方字体，需要确保打包时包含这些字体文件
- 对于较大的项目，建议使用`--windowed`选项而不是`--onefile`，以提高启动速度

## 许可证

MIT