# qtpic

**Repository Path**: pxbf/qtpic

## Basic Information

- **Project Name**: qtpic
- **Description**: 一款完全有AI编写的基于Qt的封面图片编辑工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QtPic - 跨平台封面图片编辑器

QtPic 是一款基于 Qt 开发的跨平台封面图片编辑器，用于创建精美的封面图片。支持多种宽高比、背景样式、文字样式等功能。

![](./docs/img1.png)

## 功能特性

### 1. 背景设置
- **图片背景** - 支持从本地选择图片或搜索 Unsplash 在线图片
- **纯色背景** - 多种预设纯色颜色可选
- **渐变背景** - 多种渐变样式可选
- **叠加层** - 可调节模糊程度和透明度

### 2. 文字编辑
- **主标题** - 可编辑标题文字、颜色、字体
- **副标题** - 支持副标题文字
- **作者信息** - 显示作者名称和图标

### 3. 自定义文本框
- 添加自定义文本元素
- 10种预设文字样式模板（流行、彩虹、渐变、发光、3D、霓虹、边框、投影、闪亮、故障）
- 拖拽移动文本框位置
- 调整文本框大小
- 修改文字颜色、字体、大小

### 4. 图标支持
- 支持 100+ DevIcon 图标
- 可选择图标显示位置

### 5. 宽高比
支持多种常用宽高比：
- 16:9（YouTube 视频封面）
- 4:3
- 3:2
- 1:1（Instagram/小红书）
- 2:3
- 3:4
- 9:16（抖音/短视频封面）
- 21:9
- 2:1
- 1:2

### 6. 导出功能
- 导出为 PNG 格式
- 导出为 JPG 格式
- 自定义输出分辨率

### 7. 其他功能
- **撤销/重做** - 支持 Ctrl+Z 撤销操作（最多50步）
- **中英文切换** - 支持简体中文和 English 切换
- **拖拽交互** - 鼠标拖拽调整元素位置和大小
- **属性面板** - 右侧面板实时编辑所有属性

## 项目结构

```
qtpic/
├── CMakeLists.txt          # CMake 构建配置
├── include/                # 头文件目录
│   ├── covercanvas.h       # 画布控件
│   ├── mainwindow.h        # 主窗口
│   ├── propertypanel.h     # 属性面板
│   ├── imageresourcepanel.h # 左侧资源面板
│   ├── languagemanager.h   # 语言管理
│   ├── textelement.h       # 文本元素数据结构
│   ├── exportimage.h       # 图片导出
│   └── backgroundrenderer.h # 背景渲染
├── src/                    # 源代码目录
│   ├── main.cpp            # 程序入口
│   ├── mainwindow.cpp      # 主窗口实现
│   ├── covercanvas.cpp     # 画布实现
│   ├── propertypanel.cpp   # 属性面板实现
│   ├── imageresourcepanel.cpp # 左侧资源面板实现
│   ├── languagemanager.cpp # 语言管理实现
│   ├── textelement.cpp     # 文本元素实现
│   ├── exportimage.cpp     # 图片导出实现
│   └── backgroundrenderer.cpp # 背景渲染实现
└── resources/              # 资源文件目录
```

## 构建与运行

### 环境要求
- Qt 5.x 或更高版本
- CMake 3.10+
- C++11 兼容的编译器

### 构建步骤

```bash
# 进入项目目录
cd qtpic

# 创建构建目录
mkdir build && cd build

# 配置项目
cmake ..

# 编译
cmake --build . -j$(nproc)

# 运行
./qtpic
```

### 快速运行

如果已经完成构建：

```bash
cd qtpic/build
./qtpic
```

## 使用说明

### 1. 设置背景
- 在左侧面板的"图片"标签页搜索或选择图片
- 或在"颜色"标签页选择纯色/渐变背景

### 2. 编辑标题
- 在右侧属性面板的"标题"区域输入标题文字
- 可设置标题颜色、字体、大小
- 拖拽画布上的标题可调整位置

### 3. 添加自定义文字
- 在左侧面板的"文字"标签页点击"添加文字"按钮
- 或在"样式"标签页选择预设样式模板
- 选中文本框后可在右侧修改属性
- 按 Delete 键删除选中的文本框

### 4. 导出图片
- 点击菜单"文件" -> "导出 PNG" 或 "导出 JPG"
- 选择保存路径和文件名

### 5. 撤销操作
- 按 Ctrl+Z 撤销上一步操作
- 支持连续撤销最多50步

### 6. 切换语言
- 点击菜单"语言" -> "中文" 或 "English"

## 键盘快捷键

| 快捷键 | 功能 |
|--------|------|
| Ctrl+Z | 撤销 |
| Delete | 删除选中元素 |
| Ctrl+O | 打开图片 |
| Ctrl+S | 导出图片 |

## 技术特点

- **纯 Qt 实现** - 无需额外图形库依赖
- **信号槽机制** - 组件间解耦通信
- **中英文支持** - 国际化设计
- **撤销栈** - 50步撤销历史记录
- **多种宽高比** - 适配多平台需求

## 注意事项

- 首次运行可能需要设置 Unsplash API Key 才能搜索在线图片
- 未设置 API Key 时可使用本地图片作为背景
- 导出高分辨率图片时可能需要较长时间处理

## 许可证

MIT License