OBS Zoom to Mouse 脚本安装与使用指南
前言:OBS有两个不错的放大插件,经过多台电脑测试发现,唯一好用的就是下面介绍的obs-zoom-to-mouse.lua这个插件,因为它安装简单,不需要python,设置更人性化性价比极高。
zoom_and_follow_mouse.py 这个python插件能用但已费。
安装
- Git 克隆仓库(或者直接保存
obs-zoom-to-mouse.lua
文件)。 - 启动 OBS。
- 在 OBS 中,添加一个“显示捕捉”源(如果尚未添加)。
- 在 OBS 中,打开 工具 -> 脚本。
- 在脚本窗口中,点击 + 按钮,添加一个新的脚本。
- 查找并添加
obs-zoom-to-mouse.lua
脚本。
显示捕捉源的最佳设置
- 转换 (Transform):位置对齐 - 左上
- 边界框类型 (Bounding Box type) - 缩放至内部边界
- 边界框内对齐 (Alignment in Bounding Box) - 左上
- 裁剪 (Crop) - 全部设为零
如果您想要裁剪显示内容,添加新的滤镜 -> 裁剪/填充。
- 相对 (Relative) - 假 (False)
- X - 从左侧裁剪的量
- Y - 从上侧裁剪的量
- 宽度 (Width) - 显示器的完整宽度减去 X 的值以及从右侧裁剪的量
- 高度 (Height) - 显示器的完整高度减去 Y 的值以及从底部裁剪的量
注意:如果您的显示源没有使用这种设置(例如,您设置为“没有边界”或者“变换上有裁剪”),脚本会尝试自动更改您的设置以使其兼容缩放功能。这可能会对您的布局产生不期望的影响,或者可能根本不起作用。
注意:如果您在 Windows 中更改了桌面显示属性(例如,移动显示器、更改主显示器、更新显示器的方向),您需要重新添加显示捕捉源到 OBS,以便更新脚本使用的计算值。然后,您需要重新加载脚本。
使用
您可以在 OBS 脚本窗口 中自定义以下设置:
- Zoom Source:当前场景中用于缩放的显示捕捉源。
- Zoom Factor:缩放的程度。
- Zoom Speed:缩放动画的速度。
- Auto follow mouse:启用自动追踪光标,即使在缩放后,不需要按下“切换追踪热键”。
- Follow outside bounds:即使光标超出源的边界,也会追踪光标。
- Follow Speed:缩放区域追踪鼠标的速度。
- Follow Border:重新启用鼠标追踪的源边缘的距离百分比。
- Lock Sensitivity:当追踪停止时,光标必须多接近才能锁定,直到您进入追踪区域。
- Auto Lock on reverse direction:如果光标方向反转,自动停止追踪。
- Show all sources:允许选择任何源作为 Zoom Source(注意:对于非显示捕捉源,您必须设置手动源位置)。
- Set manual source position:通过设置 X,Y,宽度和高度来手动覆盖源的计算位置和大小。
快捷键设置
- 打开 文件 -> 设置 -> 快捷键。
- 添加“切换缩放到鼠标”的快捷键以进行缩放。
- 添加“切换追踪鼠标”快捷键以在缩放时开启或关闭光标追踪(可选)。
双机支持
该脚本还支持基本的双机设置。通过使用相关项目 obs-zoom-to-mouse-remote,您可以在第二台计算机上跟踪鼠标位置。
当您在与 obs-zoom-to-mouse.lua
文件相同的目录中使用 ljsocket.lua
时,以下设置将可用:
- 启用远程鼠标监听 (Enable remote mouse listener):启用 UDP 套接字服务器,用于监听来自远程客户端的鼠标位置消息。
- 端口 (Port):设置用于套接字服务器的端口号。
- 轮询延迟 (Poll Delay):更新鼠标位置的时间间隔(以毫秒为单位)。
更多信息请参考 obs-zoom-to-mouse-remote 项目。
其他信息
该脚本通过调整裁剪和缩放滤镜的宽度/高度值来模拟放大过程。您可以使用“跟踪鼠标”功能自动追踪光标,或者通过设置锁定灵敏度,光标在停止移动后会停留在“安全区”内。
如果您启用了 Show all sources,您可以选择任何 OBS 源作为 Zoom Source,但必须手动设置源的位置和大小。
已知限制
- 只对显示捕捉源有效(自动)
- 可能可以在窗口捕捉源上工作,但需要特定方法来获取相对鼠标位置。
- 使用 Linux 时,可能需要安装
loopback
包以启用 XSHM 显示捕捉源。
开发设置
- 克隆此仓库。
- 编辑
obs-zoom-to-mouse.lua
。 - 在 OBS 脚本窗口点击 重新加载脚本。
安装与演示
直接将压缩包文件放在OBS的C:\Program Files\obs-studio\data\obs-plugins\
然后在脚本里加载他。
obs-zoom-to-mouse.lua 下载参考xoxome.online
B站视频演示