HandyView 技术文档
安装指南
对于Windows用户:
- 下载安装: 前往 HandyView发布页面,下载预编译好的可执行文件压缩包。
- 解压文件: 解压缩下载的文件到您喜欢的目录。
- 设置默认查看器: 打开“设置”->“应用”->“默认应用”,将 HandyView 设置为图片的默认打开程序,这样您就能通过双击图片来启动 HandyView。
对于MacOS用户:
- 下载与安装: 从 发布页面 下载
.dmg
文件,然后安装应用。- 若安装遇到问题,可能需先 禁用Gatekeeper。注意此举带来的安全风险。
- 设为默认: 使用
cmd+i
查看图片属性,并在“打开方式”中选择 HandyView 设为默认。
对于Ubuntu用户(早期版本适用):
- 手动编译与安装: 先克隆仓库
git clone https://github.com/xinntao/HandyView.git
,之后修改HandyView.desktop
文件中的 Exec 和 Icon路径。复制该.desktop
文件至/usr/share/applications
。 - 调整默认查看器: 右键点击图片,选择“属性”->“打开方式”,指定 HandyView。
对于Python开发者:
- 环境搭建: 克隆仓库,使用pip安装依赖
git clone https://github.com/xinntao/HandyView.git && cd HandyView && pip install -r requirements.txt
。 - 运行: 直接从命令行启动
python -m handyview.handyviewer [图片路径]
。
项目使用说明
HandyView 专为方便查看和对比图像而设计,支持以下操作:
- 固定放大率切换: 快速对比不同处理结果。
- 图像信息显示: 包括尺寸、当前位置的坐标与RGB值。
- 多视图对比: 支持双栏或多栏展示,便于效果评估。
- 智能筛选: 根据文件名后缀快速筛选图像。
- 图形绘制: 精准测量绘制框的起始位置和尺寸。
API使用文档
HandyView 的核心功能通过其用户界面实现,不提供公开API供外部调用。但若需进行脚本化控制,可以考虑贡献代码或利用Python脚本间接调用内部逻辑。
编译成可执行程序
对于想要自行构建Windows或MacOS可执行程序的开发者,详细步骤位于项目内的 how_to_build.md 文件。
文档与进一步学习
虽然详细的文档尚在路上,用户可通过软件内“帮助”按钮获取基础操作指导。更多高级使用技巧和更新信息请关注项目仓库的更新日志与讨论区。
本文档旨在提供快速入门和基础操作指南,完整功能体验推荐直接操作HandyView应用程序并探索其内置的帮助文档。如果有特定技术细节或进阶功能的需求,请向开发者反馈。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考