PNG Image Viewer

一个简单的PNG图片浏览器，支持显示RGB图像和Alpha通道。

程序界面展示：左侧显示RGB图像，右侧显示Alpha通道（透明度信息）

功能特性

• 打开PNG图片文件
• 同时显示RGB图像和Alpha通道（灰度图）
• 支持RGBA模式的PNG文件
• 简洁的图形用户界面

安装

使用UV（推荐）

# 安装UV（如果还没有安装）
pip install uv

# 克隆项目
git clone <repository-url>
cd PngViewer

# 创建虚拟环境并安装依赖
uv venv
uv pip install -e .

# 或者直接运行
uv run main.py

传统方式

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate     # Windows

# 安装依赖
pip install PyQt6 Pillow

# 运行程序
python main.py

使用方法

1. 运行程序：python main.py 或 uv run main.py
2. 点击菜单栏的 "File" -> "Open PNG"
3. 选择一个PNG图片文件
4. 程序会同时显示RGB图像和Alpha通道

界面说明

程序界面分为两个并排的显示区域：

• 左侧面板：显示PNG图像的RGB彩色内容
• 右侧面板：显示Alpha通道的灰度图像，白色区域表示不透明部分，黑色区域表示透明部分

这种设计特别适合查看游戏素材、图标等需要透明度信息的PNG文件。

系统要求

• Python 3.8+
• PyQt6
• Pillow (PIL)

开发

# 安装开发依赖
uv pip install -e ".[dev]"

# 运行测试
uv run pytest

# 代码格式化
uv run black .

# 代码检查
uv run flake8 .

打包

使用PyInstaller打包成exe（推荐）

# 安装PyInstaller
uv pip install pyinstaller

# 使用配置文件打包
uv run pyinstaller png_viewer.spec

# 或者直接打包（不使用spec文件）
uv run pyinstaller --onefile --windowed --name PNG_Viewer main.py

打包后的exe文件将生成在 dist/ 目录中。

构建Python分发包

# 构建分发包
uv run python -m build

# 或者使用UV
uv run build

许可证

MIT License