使用SFML与imgui-SFML遇ImGui::NewFrame()调用错误及固定步长问题

你的问题根源在于ImGui的帧生命周期规则被打破：每一次ImGui::Render()必须对应且仅对应一次ImGui::NewFrame()（而ImGui::SFML::Update()内部会调用ImGui::NewFrame()）。在你的固定时间步循环中，update()函数会被多次执行（当累积时间超过固定步长时），导致多次调用ImGui::SFML::Update()，但render()只执行一次，这就造成了“多次NewFrame但仅一次Render”的矛盾，触发Forgot to call ImGui::NewFrame()?错误。

修改后的正确代码 #

#include <SFML/Graphics.hpp>
#include "ImGui.h"
#include "ImGui-SFML.h"

void update(sf::Time dt, sf::RenderWindow& window);
void processEvents(sf::RenderWindow& window);
void render(sf::RenderWindow& window);
void drawUI();

int main()
{
    sf::RenderWindow window;
    window.create(sf::VideoMode(800, 600), "window");
    ImGui::SFML::Init(window);

    sf::Clock clock;
    sf::Time timeSinceLastUpdate = sf::Time::Zero;
    const sf::Time mTimePerFrame = sf::seconds(1.f / 60.f);

    while (window.isOpen())
    {
        // 1. 处理所有事件（每帧仅执行一次，避免重复处理）
        processEvents(window);

        // 2. 固定时间步执行游戏逻辑更新
        const sf::Time elapsedTime = clock.restart();
        timeSinceLastUpdate += elapsedTime;
        while (timeSinceLastUpdate > mTimePerFrame)
        {
            timeSinceLastUpdate -= mTimePerFrame;
            update(mTimePerFrame, window); // 仅处理游戏核心逻辑
        }

        // 3. ImGui更新与UI绘制（每帧仅执行一次，与Render严格对应）
        ImGui::SFML::Update(window, elapsedTime);
        drawUI();

        // 4. 渲染游戏内容与ImGui
        render(window);
    }

    ImGui::SFML::Shutdown();
    return 0;
}

void update(sf::Time dt, sf::RenderWindow& window)
{
    // 这里放置你的游戏逻辑：角色移动、物理计算、状态更新等
}

void processEvents(sf::RenderWindow& window)
{
    sf::Event event;
    while (window.pollEvent(event))
    {
        ImGui::SFML::ProcessEvent(event);
        // 处理窗口关闭事件（原代码遗漏，导致窗口无法关闭）
        if (event.type == sf::Event::Closed)
        {
            window.close();
        }
    }
}

void drawUI()
{
    ImGui::Begin("Hello!", NULL);
    ImGui::Button("click me", ImVec2(32, 32));
    ImGui::End();
}

void render(sf::RenderWindow& window)
{
    window.clear();
    // 这里渲染你的游戏场景：精灵、地图、特效等
    ImGui::SFML::Render();
    window.display();
}

关键改动说明 #

• 事件处理移至主循环外层：避免多次逻辑更新时重复处理同一事件，同时确保ImGui能完整捕获输入。补充了窗口关闭事件的处理，修复原代码无法关闭窗口的问题。
• ImGui流程与渲染绑定：将ImGui::SFML::Update()和UI绘制代码移至渲染阶段前，每帧仅执行一次，严格遵循“一次NewFrame对应一次Render”的ImGui规则。
• ImGui使用真实帧间隔：ImGui::SFML::Update()传入的是实际帧间隔elapsedTime，而非固定步长，保证ImGui的动画（如按钮 hover、窗口拖动）平滑自然。
• 游戏逻辑与UI分离：固定时间步循环仅处理游戏核心逻辑，UI代码单独拆分，符合两者不同的驱动逻辑（逻辑是时间驱动，UI是帧驱动）。

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