HandyView 技术文档

HandyView 技术文档

HandyView Handy image viewer based on PyQt5. Convenient for viewing and comparing :-) 项目地址: https://gitcode.com/gh_mirrors/ha/HandyView

安装指南

对于Windows用户：

1. 下载安装: 前往 HandyView发布页面，下载预编译好的可执行文件压缩包。
2. 解压文件: 解压缩下载的文件到您喜欢的目录。
3. 设置默认查看器: 打开“设置”->“应用”->“默认应用”，将 HandyView 设置为图片的默认打开程序，这样您就能通过双击图片来启动 HandyView。

对于MacOS用户：

1. 下载与安装: 从 发布页面 下载 .dmg 文件，然后安装应用。
   • 若安装遇到问题，可能需先 禁用Gatekeeper。注意此举带来的安全风险。
2. 设为默认: 使用 cmd+i 查看图片属性，并在“打开方式”中选择 HandyView 设为默认。

对于Ubuntu用户（早期版本适用）：

1. 手动编译与安装: 先克隆仓库 git clone https://github.com/xinntao/HandyView.git，之后修改 HandyView.desktop 文件中的 Exec 和 Icon路径。复制该 .desktop 文件至 /usr/share/applications。
2. 调整默认查看器: 右键点击图片，选择“属性”->“打开方式”，指定 HandyView。

对于Python开发者：

1. 环境搭建: 克隆仓库，使用pip安装依赖 git clone https://github.com/xinntao/HandyView.git && cd HandyView && pip install -r requirements.txt。
2. 运行: 直接从命令行启动 python -m handyview.handyviewer [图片路径]。

项目使用说明

HandyView 专为方便查看和对比图像而设计，支持以下操作：

• 固定放大率切换: 快速对比不同处理结果。
• 图像信息显示: 包括尺寸、当前位置的坐标与RGB值。
• 多视图对比: 支持双栏或多栏展示，便于效果评估。
• 智能筛选: 根据文件名后缀快速筛选图像。
• 图形绘制: 精准测量绘制框的起始位置和尺寸。

API使用文档

HandyView 的核心功能通过其用户界面实现，不提供公开API供外部调用。但若需进行脚本化控制，可以考虑贡献代码或利用Python脚本间接调用内部逻辑。

编译成可执行程序

对于想要自行构建Windows或MacOS可执行程序的开发者，详细步骤位于项目内的 how_to_build.md 文件。

文档与进一步学习

虽然详细的文档尚在路上，用户可通过软件内“帮助”按钮获取基础操作指导。更多高级使用技巧和更新信息请关注项目仓库的更新日志与讨论区。

---

本文档旨在提供快速入门和基础操作指南，完整功能体验推荐直接操作HandyView应用程序并探索其内置的帮助文档。如果有特定技术细节或进阶功能的需求，请向开发者反馈。

HandyView Handy image viewer based on PyQt5. Convenient for viewing and comparing :-) 项目地址: https://gitcode.com/gh_mirrors/ha/HandyView