快速创建一个可触发互动区域
这份向导假设软件已经可以启动。它只讲实际操作：先确认画布分辨率，再创建 Slot、导入媒体、调整 Idle/Main 画面、设置触发区域、保存并测试。
1. 打开调试模式
- 启动
HogwartsWall.exe。 - 按 M 进入调试模式。
- 左侧会出现调试面板，可以查看 FPS、内存、触点数、Slot 数、TUIO 状态。
看到调试面板后，第一步先确认画布分辨率，再继续创建和编辑 Slot。
2. 确认画布分辨率
画布分辨率决定整个互动墙的逻辑坐标范围。Slot 的位置、触发区域、TUIO 坐标换算都会基于这个宽高。
- 进入调试模式后，在左侧调试面板的“运行状态”里查看当前分辨率。
- 如果分辨率不符合现场投影或大屏输出，在“宽”“高”输入框中填写目标分辨率。
- 点击“应用”，系统会保存到
config.json并尝试立即应用。 - 如果弹出确认窗口，请先阅读提示，再决定是否继续。
建议先确定分辨率，再创建 Slot。这样 Slot 坐标会直接落在正确画布内，后期调整更省事。
如果从大分辨率改成小分辨率，原来靠右或靠下的 Slot 可能会超出新画布范围。程序会在应用前提示可能受影响的 Slot。
3. 创建第一个 Slot
居中新建
按 N，系统会在画面中心创建一个默认 Slot。
指定位置新建
按住 Ctrl，在画面目标位置点击鼠标右键。
Trial 授权最多允许运行 10 个 Slot。如果创建失败，先看调试面板的 Slot 数量。
4. 绑定媒体内容
- 在调试模式中，右键点击目标 Slot。
- 选择“绑定 Idle 媒体...”设置待机内容。
- 选择“绑定 Main 媒体...”设置触发后播放的内容。
导入窗口状态
正在快速复制 / 准备复制
资源复制完成，正在加载媒体
导入成功，已应用到 Slot
如果看到“资源复制完成，正在加载媒体...”，说明文件已经复制完成，后续等待是在加载视频解码器或创建纹理。
5. 调整 Idle 画面
Idle 是 Slot 的待机状态。选中 Slot 后，默认编辑 Idle 画面区域。
W/A/S/D
上 / 左 / 下 / 右移动
Shift + W/A/S/D
快速移动
Ctrl + 左键拖动
拖动画面内容位置
Q/E
逆时针 / 顺时针旋转
Z/C
缩小 / 放大
Ctrl + Z/C
只调整 X 方向缩放
Alt + Z/C
只调整 Y 方向缩放
也可以在调试面板的“Slot 尺寸”里直接输入宽高，然后按 Enter 生效。
调试边框颜色：绿色表示 Idle 待机画面，红色表示 Main / Playing 主内容，蓝色表示触发命中区域，青色表示关联连线。
6. 测试和调整 Main 画面
- 选中 Slot 后按 T，切换到
Playing，显示 Main 内容。 - 在 Main / Playing 状态下，按住 Alt 并用鼠标左键拖动，可以调整 Main 内容位置。
- 继续使用 Q/E、Z/C 调整 Main 内容的旋转和缩放。
- 再次按 T 回到 Idle。
Idle 和 Main 可以有不同的位置、尺寸、旋转和缩放。Main 状态下调整的是主内容，不会移动多边形触发区。
7. 设置触发区域
触发区域决定触摸或鼠标点击哪里会触发 Slot。
Tab
切换编辑 Slot 画面 / 触发区域
W/A/S/D
移动触发区域偏移
Shift + W/A/S/D
快速移动触发区域
Z/C
缩小 / 放大触发区域
Ctrl + Z/C
只调整触发区域 X 方向缩放
Alt + Z/C
只调整触发区域 Y 方向缩放
Alt + 左键拖动
Idle 模式下拖动触发区域
8. 多边形触发区
- 按 H 在矩形、圆形、多边形之间切换。
- 切到多边形后，按住 Ctrl 并点击画面添加顶点。
- 点数大于等于 3 后，按 Enter 立即闭合多边形。
- Backspace：未闭合时删除最后一个点；已闭合时重新打开。
- Delete：清空所有多边形顶点。
多边形必须闭合后才会参与触发判断。
9. 保存与运行测试
Ctrl + S
保存当前配置到
config.jsonF5
重新加载配置
M
退出调试模式，回到正式运行画面
Esc
非调试模式下退出软件
测试建议
- 按 T 确认 Main 内容可以播放。
- 退出调试模式后，用触摸或鼠标点击触发区测试。
- 需要看触摸位置时，在调试面板勾选“显示指针”。这个状态会保存。
10. 常见问题
Slot 创建不了
Trial 授权最多 10 个 Slot。请检查调试面板的 Slot 数量。
改小分辨率后看不到内容
可能是 Slot 坐标仍在旧画布范围内。先回到较大分辨率把 Slot 移入新范围，或在配置中调整对应 Slot 的位置。
媒体导入后没显示
确认导入窗口是否显示“导入成功”。如果是视频，加载阶段可能需要等待解码器初始化。
TUIO 没反应
看调试面板里的 TUIO: n 是否变化，并确认 TUIO 端口为 3333 或与配置一致。
多边形不触发
确认多边形至少 3 个点，并已按 Enter 闭合。
完成配置后记得按 Ctrl + S 保存，否则重启后修改不会保留。