Skip to content

Latest commit

 

History

History
163 lines (110 loc) · 8.98 KB

README_CN.md

File metadata and controls

163 lines (110 loc) · 8.98 KB
Raw

download visitors PyPI license python lint Publish-pip Release

HandyView 是一款基于 PyQt5 开发的方便的图像查看和比对工具

Handy Series:    HandyView Icon HandyView   HandyFigure Icon HandyFigure   HandyCrawler Icon HandyCrawler   HandyWriting Icon HandyWriting

🔧 安装

Windows

  1. Download the pre-compiled executable zip file from the release page.
  2. Unzip the file
  3. Set HandyView as the default image viewer, so that you can double-click the image to open HandyView.

MacOS

  1. Download the handyviewer.dmg from the release page and install.
  2. If you fail to install the app, you may first need to disable gatekeeper first. You should be aware of the risk of disabling gatekeeper.
  3. Set HandyView as the default image viewer (use cmd+i), so that you can double-click the image to open HandyView.

Ubuntu

I used the early version of HandyView on Ubuntu. The current version is not tested on Ubuntu and may be out-of-date.

  1. Clone this repo git clone https://github.com/xinntao/HandyView.git
  2. How to double click to open an image
    1. Modify the HandyView.desktop file - Exec & Icon
    2. Copy the .desktop file to /usr/share/applications
  3. How to change the default image viewer
    1. Right click an image
    2. Go to Properties -> Open With
    3. Choose HandyView

Ubuntu

For python user, you can also launch HandyView from the command line:

  1. Clone repo and install dependent packages

    git clone https://github.com/xinntao/HandyView.git
cd HandyView
pip install -r requirements.txt

  2. Run

    python -m handyview.handyviewer [image_path]

✨ 特性

  • 固定放大比率下, 图像切换对比. 能够看出不同方法(不同参数)下复原图像的细微差异
  • 显示图像基本信息: 长宽, 尺寸大小; 特别是鼠标所在位置的坐标和RGB颜色
  • 更丰富实用的对比模式. 比如:
    • 我们做实验, 往往会把得到的验证集结果放在两个文件夹里面, 比如 Exp_results_1 和 Exp_results_2, 这两个文件夹里面的图像往往是对应的. 那么, 我们希望能够方便快捷地对比这两个文件夹里图像的质量
    • 除了上面提到的切换图像来动态地对比, 我们也希望能够双栏/多栏肩并肩地对比
  • 更加便捷地筛选需要对比的图像. 在实际实验中, 往往会把很多结果放在同一个文件夹里面. 这些图像仅仅是后缀名称不同. 那么我们希望根据后缀的字符来包含或者剔除一些对比图像
  • 能够在图中画框, 方便地知道所画框的起始位置和长宽信息

👀 展示

  • HandyView截图

  • 固定放大比率下, 图像切换对比

  • 多视图比较, 双栏、三栏肩并肩比较

  • 当移动鼠标, 右侧会显示当前鼠标所在坐标及像素颜色值

  • 拖动鼠标画框时, 右边会显示框的起始位置和长宽信息

Compile to executable program

For Windows and MacOS users, you can find the instructions of compiling the executable program from how-to-build.

📖 文档 (还在路上...)

基本的操作可以通过 工具栏的 Help 按钮来查看

⏳ TODO list

  • preview mode
  • show zoom info for each folder (store in database)
  • drag together in the multi-view comparison mode

Editing operation

  • Simple image edit: crop, resize, color conversion, etc
  • Draw rectangular and enlarged the area
  • Make GIF easily

📚 References

📜 许可和致谢

本项目使用 MIT license.

图标

I have used the icons from flaticon. The following are the source links.

Icon Link Icon Link Icon Link
Open Open History History Refresh Refresh
Index Index Include Include Exclude Exclude
Compare Compare Clear comparison Clear comparison Help Help
Main canvas Main canvas Compare canvas Compare canvas Preview canvas Preview canvas
Fingerprint Fingerprint auto zoom Auto Zoom

📧 联系

若有任何问题, 请提 issue 或者电邮 [email protected].