Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RefBoard 图板

一个 Windows 桌面参考图浮窗工具(类似 PureRef 的轻量实现)——把参考图片钉在一个无边框、可置顶、可穿透的悬浮画板上,适合绘画、建模、设计时对照参考。

基于 Python + PySide6,单文件入口,无后端依赖。

浅色主题截图

功能

  • 多图包管理:图片按「图包」分组,侧边抽屉新建 / 重命名 / 删除 / 切换,布局独立保存
  • 多种导入方式:工具栏按钮、拖拽文件 / 文件夹入画布、Ctrl+V 粘贴剪贴板图片、全局快捷键截屏收集
  • 画布操作:移动 / 缩放 / 旋转图片卡片;画布平移、缩放;选中框实时变换
  • 图片工具:左旋 / 右旋 15°、水平翻转、灰度、置顶 / 置底层级、左对齐、顶对齐、横向等距、自动网格、适应全部
  • 浮窗特性:无边框窗口、边缘拖拽缩放、窗口置顶、贴边自动收起
  • 鼠标穿透:开启后窗口只显示不拦截鼠标,可边画边对照(系统级 WS_EX_TRANSPARENT 实现)
  • 主题:深色 / 浅色 / 跟随系统,即时切换
  • 全局快捷键:任意应用内可用
  • 系统托盘:显示隐藏、穿透开关、切换图包、设置、退出

安装与运行

要求:Windows 10/11,Python 3.10+

pip install -r requirements.txt
python main.py

或用 pythonw.exe 启动可避免控制台窗口。

快捷键

快捷键 功能
Ctrl+Shift+H 显示 / 隐藏窗口
Ctrl+Shift+T 鼠标穿透开关
Ctrl+Tab 切换到下一个图包
Ctrl+Shift+C 截屏收集到当前图包
Ctrl+V 粘贴剪贴板图片
Ctrl+B 图包抽屉开关
Delete 删除选中图片

快捷键可在「托盘右键 → 设置」中修改。

数据存储

图包布局与设置保存在 %APPDATA%\RefBoard\ 下的 packs.json / settings.json,图片文件本身不被复制(引用原始路径;截屏收集的截图除外)。

技术要点

  • GUI:PySide6(QGraphicsView 画布 + QPainter 程序化绘制的线性图标,无图标资源文件)
  • 鼠标穿透:Win32 SetWindowLongPtr(WS_EX_TRANSPARENT | WS_EX_LAYERED)
  • 全局热键:Win32 RegisterHotKey(ctypes)
  • 单实例:QLocalServer / 本地锁

License

MIT

Releases

Packages

Contributors

Languages