# obs画面缩放插件mouse_magnifier

**Repository Path**: caodaimin/mouse_magnifier

## Basic Information

- **Project Name**: obs画面缩放插件mouse_magnifier
- **Description**: obs画面缩放插件mouse_magnifier，obs画面怎么拉伸到全屏，obs局部放大
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-30
- **Last Updated**: 2026-02-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# OBS 鼠标放大镜插件 (mouse_magnifier)

一个为 OBS Studio 设计的 Lua 脚本插件，可以在鼠标周围显示一个可调节的放大镜效果。

## 功能特点

- **实时放大**：在鼠标周围显示放大区域
- **可调节参数**：支持调整放大倍数、放大镜半径、边框宽度和颜色
- **快捷键控制**：按 F6 键快速开启/关闭放大镜
- **系统自适应**：自动获取屏幕分辨率
- **平滑过渡**：支持边框模糊效果

## 系统要求

- OBS Studio (32位或64位)
- Windows 操作系统
- Lua 脚本支持

## 安装方法

1. 打开 OBS Studio
2. 点击菜单栏的 **工具** → **脚本**
3. 在 **Lua Scripts** 标签页中，点击 **+** 按钮
4. 选择本仓库中的 `mouse_magnifier.lua` 文件
5. 添加成功后，插件会自动加载

## 配置说明

### 默认参数

| 参数 | 默认值 | 说明 |
|------|--------|------|
| 放大倍数 | 2.0 | 放大倍率 |
| 半径 | 100 | 放大镜半径（像素） |
| 边框宽度 | 2 | 边框线条宽度 |
| 边框颜色 | 白色 | 边框颜色值 |

### 快捷键

- **F6**：开启/关闭放大镜效果

### 属性设置

在脚本属性窗口中可以调整以下参数：
- 放大比例 (1.0 - 10.0)
- 放大镜半径 (50 - 500)
- 边框宽度 (0 - 20)
- 边框颜色

## 使用场景

- 直播教学时放大鼠标指针
- 展示软件操作细节
- 游戏直播中的道具/装备展示
- 便于观众看清光标位置

## 技术实现

- 使用 Windows API (user32.dll) 获取屏幕信息
- 使用 FFI 技术实现高效的系统调用
- OBS 源过滤器 (Source Filter) 实现方式
- 支持主滤镜和备用滤镜两种模式

## 版本信息

- 当前版本：1.0.0
- 脚本名称：mouse_magnifier
- 兼容 OBS Studio 27.0+

## 注意事项

1. 本插件仅支持 Windows 平台
2. 确保 OBS Studio 以管理员权限运行以获得最佳效果
3. 放大效果会占用一定的系统资源
4. 在性能要求较高的场景中，建议适当调低放大倍数

## 问题反馈

如有问题或建议，欢迎在 [Gitee 项目页面](https://gitee.com/caodaimin/mouse_magnifier) 提交 Issue。