# ViewImage

**Repository Path**: kudos09/ViewImage

## Basic Information

- **Project Name**: ViewImage
- **Description**: ViewImage 是一款专业的多格式图像查看器，面向嵌入式和图像传感器开发场景。支持
YUV、RGB、RAW 原始图像数据以及常见图片格式的查看与分析，提供通道分离显示、ISP
优化、图像测量、多格式转换保存等功能。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-30
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ViewImage - 多格式图像查看器

专业级 RAW/YUV/RGB 原始图像查看器，面向嵌入式 ISP 调试和图像传感器开发场景。

## 功能特性

### 支持格式

| 模式 | 格式 | 位深 |
|------|------|------|
| **YUV** | 400/420SP/420I/422SP/422I/422P/444/444P (18种) | 8bit / 10bit (H/L/NC/C) |
| **RGB** | RGB565/888/888P, BGR, RGBA/BGRA/ARGB (12种) | - |
| **RAW** | raw1~raw32 (17种位深) | MSB/LSB/Packed/MIPI |
| **图片** | JPEG/PNG/GIF/BMP/WEBP/TIFF/PPM | - |

### MIPI CSI-2 支持
- **RAW10**: 4像素 → 5字节，按行打包
- **RAW12**: 2像素 → 3字节，按行打包
- **RAW14**: 4像素 → 7字节，按行打包

### ISP 优化 (A3P-ISP)
- **自动优化**: P50 中位数前向模拟搜索最优 Gain (1~64x)
- **S-Curve 对比度**: tanh S 曲线增强中间调 (0.2~3.0, 步进 0.1)
- **Soft Knee 高光压缩**: P99 ≤ 250 保护
- **Gamma 校正**: 线性光 → 人眼感知 (0.2~3.0, 步进 0.1)
- **Demosaic 缓存**: 切换通道/调参毫秒级响应
- **质量指标**: P1 / P50 / P99 / Mean / Std / CR 实时显示

### 显示与交互
- 双线性插值去马赛克 (float64 精度)
- 通道分离显示 (Y/U/V, R/G/B/A, All/R/Gr/Gb/B/Grey)
- 缩放 (0.1x~5.0x, 滚轮, 适应窗口)
- 亮度调节 / 旋转 / 翻转
- 鼠标坐标与像素值实时显示
- 图像测量 (矩形 ROI + 平均 RGB)
- 拖放文件加载

### 其他
- 30+ 常用分辨率预设
- 最近文件记录 (保存并恢复模式参数)
- 加载后自动保存配置
- 命令行参数支持 (`viewer_img.exe file.raw`)
- 崩溃日志持久化

## 快速开始

### 环境要求
- Windows 10/11
- Python 3.10+

### 安装依赖
```bash
pip install -r requirements.txt
```

### 运行
```bash
python viewer_img.py                    # 启动查看器
python viewer_img.py path/to/file.raw   # 直接打开文件
```

### 打包 exe
```bash
pyinstaller --onefile --noconsole --name ViewImage --icon=icon.ico viewer_img.py
```

### 命令行参数
```
viewer_img.exe [文件路径] [-W 宽度] [-H 高度] [-f 格式]

参数:
  文件路径        直接打开指定文件
  -W, --width    图像宽度 (默认 1920)
  -H, --height   图像高度 (默认 1080)
  -f, --format   格式: raw/yuv/rgb/image (默认自动检测)
```

## 项目结构

```
ViewImage/
├── viewer_img.py          # 主程序
├── icon.ico               # 应用图标
├── requirements.txt       # Python 依赖
├── README.md              # 项目说明
├── CHANGELOG.md           # 版本记录
├── LICENSE                # 许可文件
├── build.bat              # 打包脚本
├── installer.iss          # Inno Setup 安装脚本
├── test_all_features.py   # 测试程序 (106项)
├── ViewImage操作指南.docx   # 用户手册
└── ViewImage操作指南.pdf    # 用户手册 (PDF版)
```

## 测试
```bash
python test_all_features.py
```
106 项自动化测试覆盖: Demosaic / ISP / 文件解析 / MIPI / 质量指标 / 端到端流水线

## 作者
jeremy8631@163.com