EVEngine/docs/usr/modules/mouse.md

鼠标模块

脚本入口： eve.Mouse()

查询鼠标位置、按键和相对移动模式。

基本用法

local mx = mouse.getX();
local my = mouse.getY();
if (mouse.isDown(1)) fireAt(mx, my);

对象关系与调用时机

Mouse 当前脚本绑定只提供坐标、按键和可见状态查询。坐标位于窗口空间；世界命中测试需要用当前相机反变换。

目标导向指南

点击屏幕坐标中的对象

在更新阶段用 getX() / getY() 取得坐标，用 isDown(button) 判断按键；若摄像机有缩放或平移，先将窗口坐标反变换到世界坐标再做命中测试。

显示或隐藏游戏光标

用 isVisible() 查询当前状态。当前脚本绑定未提供相对模式或设定可见性的接口；第一人称相机应通过原生输入扩展实现，不能假设 Mouse 的 C++ 后端能力已绑定。

常见问题

• 把按钮编号与键盘名混用：鼠标按钮使用整数编号。
• UI 已捕获鼠标仍触发游戏点击：先检查 ui.wantCaptureMouse()。
• 假设存在相对模式 setter：当前脚本绑定没有该接口。

API 快查

下列方法名来自当前 Squirrel 绑定；同一模块创建的辅助对象（例如 World、Body、Source）的方法也列在这里。

• getName()、getX()、getY()、isDown()、isVisible()

使用要点

• 模块对象和它创建的资源对象应保存在全局或实体状态中，不要在每帧重复创建。
• 带 update(dt) 的系统应在 eve_update 调用；绘制方法应在 eve_render 调用。
• 参数约束、默认值和返回类型以对应模块头文件及 addFunc 绑定为准；本文 API 快查与当前源码同步生成。

源码： src/modules/mouse/ 相关测试： 在 test/ 中搜索 mouse。