SDL2长按鼠标按键时MOUSEMOTION事件xrel、yrel值异常问题

问题根因 #

1. 相对鼠标模式切换时机错误：你将SDL_SetRelativeMouseMode调用放在了事件循环结束之后，按下左键的当前帧内，所有鼠标移动事件处理完成后才会切换到相对模式，不仅会漏掉当前帧的位移处理，切换时SDL自动重置鼠标位置到中心的操作还会生成反向位移事件。
2. ImGui鼠标事件拦截：ImGui默认会接管鼠标输入，按住左键时如果被ImGui判定为窗口拖动/控件点击操作，会强制回设鼠标位置，生成反向位移。
3. SDL 2.0.14版本已知BUG：该版本在Windows平台下启用SDL_HINT_MOUSE_RELATIVE_MODE_WARP时，存在相对位移计算错误问题，会周期性生成反向的重置位移。

修复步骤 #

1. 调整相对鼠标模式调用时机 #

在鼠标按键事件触发时立即切换相对模式，不要等到事件循环结束后处理，避免切换时机滞后带来的位移错误：

while(SDL_PollEvent(&event)) {
    if (event.type == SDL_MOUSEBUTTONDOWN) {
        if (event.button.button == SDL_BUTTON_LEFT) {
            relative = true;
            SDL_SetRelativeMouseMode(SDL_TRUE);
            // 清空切换前残留的鼠标事件，避免读取到无效位移
            SDL_FlushEvent(SDL_MOUSEMOTION);
        }
        if (event.button.button == SDL_BUTTON_RIGHT) {
            relative = false;
            SDL_SetRelativeMouseMode(SDL_FALSE);
            SDL_FlushEvent(SDL_MOUSEMOTION);
        }
    }
    // 其余事件处理逻辑保持不变
}
// 移除事件循环外原来的SDL_SetRelativeMouseMode调用

2. 配置ImGui不拦截游戏鼠标操作 #

在ImGui初始化后添加配置，禁止ImGui接管视角控制用的左键输入：

ImGuiIO& io = ImGui::GetIO();
io.ConfigFlags |= ImGuiConfigFlags_NoMouseCursorChange;
// 游戏视角控制状态下，不让ImGui捕获鼠标输入
if (relative) {
    io.WantCaptureMouse = false;
}

3. 修复SDL版本问题 #

两种方案二选一：

• 升级SDL到2.24.0及以上版本，直接通过vcpkg更新sdl2包即可
• 若需要保留当前SDL版本，删除SDL_SetHintWithPriority(SDL_HINT_MOUSE_RELATIVE_MODE_WARP, "1", SDL_HINT_OVERRIDE);这行配置，改用Windows原生相对鼠标模式即可

4. 额外优化：过滤无效位移 #

可添加简单的过滤逻辑，丢弃切换模式后第一帧的异常反向位移，避免视角跳变：

bool just_switched = false;
// 切换相对模式时设置just_switched = true
if (event.type == SDL_MOUSEMOTION && relative && !just_switched) {
    std::cout << "Mouse Motion Triggered: (" + std::to_string(event.motion.xrel) +  " ," + std::to_string(event.motion.yrel) + ")" << std::endl;
}
// 每帧事件处理结束后将just_switched设为false

内容的提问来源于stack exchange，提问作者ThIsJaCk