qpwgraph的16个鼠标与键盘快捷键全清单:一次掌握平移、缩放、选择与连线

原创2026-10-29 09:21:521,680 阅读

qpwgraph的16个鼠标与键盘快捷键全清单:一次掌握平移、缩放、选择与连线

🎛️ qpwgraph 快捷键全清单来了!qpwgraph 是一个基于 Qt 的 PipeWire 图形界面(PipeWire Graph Qt GUI Interface),用一张节点画布就能看清系统里所有音频设备与连线关系。这篇清单把最常用的 16 个鼠标与键盘快捷键按"平移、缩放、选择、连线"四大类整理好,零基础用户照着记一遍,就能在画布上如鱼得水。

qpwgraph PipeWire图形界面主画布与快捷键工具栏

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 的基本功就练成了。

登录后查看全文
qpwgraph