qpwgraph的16个鼠标与键盘快捷键全清单:一次掌握平移、缩放、选择与连线
qpwgraph的16个鼠标与键盘快捷键全清单:一次掌握平移、缩放、选择与连线
🎛️ qpwgraph 快捷键全清单来了!qpwgraph 是一个基于 Qt 的 PipeWire 图形界面(PipeWire Graph Qt GUI Interface),用一张节点画布就能看清系统里所有音频设备与连线关系。这篇清单把最常用的 16 个鼠标与键盘快捷键按"平移、缩放、选择、连线"四大类整理好,零基础用户照着记一遍,就能在画布上如鱼得水。
qpwgraph 是什么:先看一眼主界面
qpwgraph 的核心是一块画布(canvas),上面显示 PipeWire 中所有相关节点,每个节点左侧是 Sink 端口(输入),右侧是 Source 端口(输出),端口用颜色区分类型:
- 🟢 绿色 — Audio 音频
- 🔵 蓝色 — Video 视频
- 🔴 红色 — PipeWire/JACK MIDI
- 🟣 紫色 — ALSA MIDI
同类型、方向相反的端口之间就可以连线。画布顶部工具栏里的 Connect、Disconnect、Undo、Center、Zoom In/Out、Zoom Fit 等按钮,其实都对应着下面的快捷键——会快捷键,操作效率至少快一倍。
一、平移(Pan):3 种方式移动画布
节点多的时候画布会超出屏幕,这 3 个操作让你自由"挪动镜头":
| # | 操作 | 作用 |
|---|---|---|
| 1 | 鼠标中键 + 拖拽 | 平移画布 |
| 2 | Ctrl + 左键 + 拖拽 | 平移画布(没有中键的笔记本推荐) |
| 3 | 鼠标滚轮 上下 / Alt + 滚轮 左右 | 垂直 / 水平滚动画布 |
💡 小贴士:滚轮默认只动垂直方向,加 Alt 就能水平滚动,找远处的节点更快。
二、缩放(Zoom):4 种方式调整视角
| # | 快捷键 | 作用 |
|---|---|---|
| 4 | Ctrl + 滚轮 | 以当前视角平滑缩放画布 |
| 5 | Ctrl + Plus(+) | 放大 |
| 6 | Ctrl + Minus(-) | 缩小 |
| 7 | Ctrl + 0 / Ctrl + 1 | 缩放至适合全部内容 / 回到 100% |
💡 节点多到看不清全貌时,直接按 Ctrl + 0(对应工具栏的 Zoom Fit)一步缩放到刚好容纳所有内容,是最常用的"上帝视角"。
三、选择(Selection):4 种方式点中节点与端口
连线、改名都要先"选中"目标,选择操作如下:
| # | 操作 | 作用 |
|---|---|---|
| 8 | 左键单击 | 选中一个节点或端口 |
| 9 | 左键 + 拖拽 | 框选(矩形选择) |
| 10 | Shift + 单击或拖拽 | 在现有选择基础上追加 |
| 11 | Ctrl + A | 全选(另有 Ctrl + Shift + A 取消全选、Ctrl + I 反选) |
💡 补充:Ctrl + 单击或拖拽 可以反切换选中状态(已选中的取消、未选中的加入),配合 Ctrl + A 先全选再反切几个节点,可以精准"排除"某些节点。
四、连线(Linking):5 种方式连接与断开
这是 qpwgraph 最核心的操作——把输入和输出接起来:
| # | 操作 | 作用 |
|---|---|---|
| 12 | 左键按住端口拖到另一个端口 | 直接建立连接(最直观) |
| 13 | Insert | 连接已选中的节点或端口 |
| 14 | Ctrl + C | 连接已选中的节点或端口(与 Insert 等效) |
| 15 | Delete | 断开已选中的连接 |
| 16 | Ctrl + D | 断开已选中的连接(与 Delete 等效) |
💡 两种连法按需选:单个端口之间随手拖线最方便;如果要一次接多条,用框选选中两组端口后按 Insert 批量连线,效率更高。
🎁 附赠:日常高频快捷键
除了上述 16 个,还有几个"顺手就按"的高频操作值得记一下:
| 快捷键 | 作用 |
|---|---|
| Ctrl + Z / Ctrl + Shift + Z | 撤销 / 重做(连错线别慌) |
| F2 或 双击 | 重命名节点或端口 |
| Ctrl + R | 按拓扑排序自动排列所选节点,乱线团秒变整齐 |
| F5 | 刷新画布(一般自动刷新,很少用到) |
快捷键速查来源
本清单整理自项目自带的官方用户手册 docs/qpwgraph-user_manual.md(其中 "Keyboard and mouse shortcuts" 章节有完整表格),画布交互的实现位于 src/qpwgraph_canvas.cpp。想要保存/恢复整套连线,还可以了解 Patchbay 功能,参见 docs/qpwgraph_patchbay-user_manual.md;项目整体介绍见 README.md。
✅ 建议把这 16 个快捷键截图存到桌面,先练熟中键平移 + Ctrl 缩放 + 框选 + 拖线这套组合,再用
Ctrl + R整理布局,qpwgraph 的基本功就练成了。
