# TiffView

**Repository Path**: JamesJoeLee/tiff-view

## Basic Information

- **Project Name**: TiffView
- **Description**: tiff文件查看器
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# TiffViewer

一个基于 C# WinForms 的 TIFF 图片查看器应用程序，支持多页面 TIFF 文件的浏览、缩放和平移操作。

## 功能特点

- **多页面浏览**：支持打开和浏览多页 TIFF 文件，轻松切换不同页面
- **缩放功能**：支持鼠标滚轮缩放，可自适应窗口大小
- **平移操作**：支持拖拽平移图片，方便查看大尺寸图像
- **页面导航**：提供上一页、下一页导航按钮和页面信息显示
- **文件信息**：显示当前文件路径和页面位置信息

## 环境要求

- **操作系统**：Windows 7/8/10/11
- **.NET Framework**：需要安装 .NET Framework 4.5 或更高版本
- **开发环境**（可选）：Visual Studio 2012 或更高版本

## 安装说明

1. **方法一：直接运行**
   - 下载编译好的可执行文件
   - 解压到任意目录
   - 双击 `TiffViewer.exe` 启动程序

2. **方法二：从源码编译**
   - 使用 Visual Studio 打开 `TiffViewer.sln` 解决方案文件
   - 选择 "Release" 配置
   - 选择 "生成" → "生成解决方案"
   - 编译后的文件将生成在 `bin\Release` 目录下

## 使用方法

### 打开文件
1. 点击界面上的"打开"按钮
2. 在文件选择对话框中浏览并选择 TIFF 文件
3. 点击"确定"加载文件

### 浏览页面
- **上一页**：点击"上一页"按钮或使用快捷键 `Page Up`
- **下一页**：点击"下一页"按钮或使用快捷键 `Page Down`

### 缩放操作
- **鼠标滚轮缩放**：将鼠标指向图片上的任意位置，滚动滚轮即可放大或缩小
- **适应窗口**：点击"适应窗口"按钮，使图片自动适应窗口大小
- **实际大小**：恢复图片到原始实际大小显示

### 平移图片
- 将鼠标指针移动到图片上
- 按住鼠标左键拖动即可平移图片
- 适用于查看超出窗口显示范围的大尺寸图片

### 页面信息
- 程序界面底部显示当前页面编号和总页数
- 同时显示当前打开的文件路径

## 界面说明

```
┌─────────────────────────────────────────────────────┐
│ [打开]  [上一页]  [下一页]  [适应窗口]              │
├─────────────────────────────────────────────────────┤
│                                                     │
│                   图片显示区域                       │
│                                                     │
├─────────────────────────────────────────────────────┤
│ 页面信息: 第 1 页 / 共 5 页                         │
│ 文件路径: C:\Images\sample.tif                      │
└─────────────────────────────────────────────────────┘
```

## 文件格式支持

- **TIFF (*.tif, *.tiff)**：主支持的图像格式
- 支持压缩和非压缩的 TIFF 文件
- 支持多页 TIFF 格式

## 项目结构

```
TiffViewer/
├── Form1.cs              # 主窗体逻辑代码
├── Form1.Designer.cs     # 窗体设计文件
├── Program.cs            # 程序入口点
├── App.config            # 应用程序配置文件
├── Properties/
│   ├── AssemblyInfo.cs   # 程序集信息
│   ├── Resources.resx    # 资源文件
│   └── Settings.settings # 设置文件
├── TiffViewer.csproj     # 项目文件
├── TiffViewer.sln        # 解决方案文件
└── LICENSE               # 许可证文件
```

## 开发说明

### 技术栈
- **编程语言**：C#
- **框架**：.NET Framework WinForms
- **UI 设计**：Windows Forms Designer

### 核心类说明

- **Form1**：主窗体类，包含所有图像查看和导航逻辑
  - `_tiffImage`：存储加载的 TIFF 图像对象
  - `_currentPageBitmap`：当前显示页面的位图对象
  - `_zoomFactor`：当前缩放比例
  - `_panOffset`：图片平移偏移量
  - `_currentPage`：当前页面索引
  - `_totalPages`：总页面数

### 主要方法

| 方法名 | 功能说明 |
|--------|----------|
| `LoadCurrentPageBitmap()` | 加载当前页面的位图数据 |
| `DisplayCurrentPage()` | 刷新显示当前页面 |
| `btnPrev_Click()` | 切换到上一页 |
| `btnNext_Click()` | 切换到下一页 |
| `FitToWindow()` | 调整图片适应窗口大小 |
| `ApplyZoom()` | 应用缩放操作 |

## 许可证

本项目采用 MIT 许可证开源，详情请参阅 LICENSE 文件。

## 贡献指南

欢迎对本项目进行改进和扩展。如果您想贡献代码，请：

1. Fork 本项目
2. 创建您的功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 联系方式

- 项目地址：https://gitee.com/JamesJoeLee/tiff-view
- 如有问题或建议，欢迎在项目 Issues 中提出

## 更新日志

**版本 1.0.0** (初始版本)
- 支持打开和浏览 TIFF 文件
- 多页面导航功能
- 缩放和平移操作
- 界面简洁易用

---

感谢您使用 TiffViewer！如果您觉得这个项目有用，请给它一个 Star ⭐️ 支持一下。