如何在OpenTK中通过ImGui.NET将帧缓冲区渲染到ImGui图像？

核心问题分析 #

你的代码存在几个关键问题导致帧缓冲区纹理无法在ImGui中正确显示：

• 原生GL纹理ID不能直接传给ImGui：ImGui.Image需要的是通过ImGui控制器注册后的纹理ID，而非OpenTK返回的GLuint原生ID。
• 帧缓冲区纹理缺少必要参数：未设置纹理过滤和环绕模式，OpenGL可能无法正确采样纹理。
• 未验证FBO完整性：没有检查帧缓冲区是否创建成功，可能FBO本身就处于无效状态。

分步解决方案 #

1. 注册ImGui纹理 #

在OnLoad中创建GL纹理后，需要将其注册到ImGui的纹理管理器，获取ImGui可用的纹理ID：

// 在原纹理创建代码后添加
ImGuiIOPtr io = ImGui.GetIO();
ImGuiTextureID imGuiTextureId = io.Fonts.AddTexture(framebufferTexture);
// 将此ID保存为类成员变量，例如命名为_imGuiFboTextureId

2. 完善帧缓冲区纹理参数 #

创建纹理时添加过滤和环绕模式设置，避免采样异常：

GL.BindTexture(TextureTarget.Texture2D, framebufferTexture);
GL.TexImage2D(TextureTarget.Texture2D, 0, PixelInternalFormat.Rgb, ClientSize.X, ClientSize.Y, 0, PixelFormat.Rgb, PixelType.UnsignedByte, IntPtr.Zero);
// 添加以下两行参数设置
GL.TexParameter(TextureTarget.Texture2D, TextureParameterName.TextureMinFilter, (int)TextureMinFilter.Linear);
GL.TexParameter(TextureTarget.Texture2D, TextureParameterName.TextureMagFilter, (int)TextureMagFilter.Linear);
GL.FramebufferTexture2D(FramebufferTarget.Framebuffer, FramebufferAttachment.ColorAttachment0, TextureTarget.Texture2D, framebufferTexture, 0);

3. 添加FBO完整性检查 #

绑定FBO后检查创建状态，排除FBO本身的问题：

GL.BindFramebuffer(FramebufferTarget.Framebuffer, FBO);
FramebufferStatus status = GL.CheckFramebufferStatus(FramebufferTarget.Framebuffer);
if (status != FramebufferStatus.FramebufferComplete)
{
    Console.WriteLine($"FBO初始化失败: {status}");
}
GL.BindFramebuffer(FramebufferTarget.Framebuffer, 0);

4. 修正ImGui.Image调用 #

使用注册后的ImGui纹理ID，同时调整UV坐标适配OpenGL纹理的Y轴翻转特性：

ImGui.Image(_imGuiFboTextureId,
    new System.Numerics.Vector2(CameraWidth, CameraHeight),
    new System.Numerics.Vector2(0, 1),
    new System.Numerics.Vector2(1, 0),
    new System.Numerics.Vector4(1.0f),
    new System.Numerics.Vector4(1, 1, 1, 0f));

5. 补充OnResize的纹理更新 #

窗口大小变化时，重新调整帧缓冲区纹理尺寸：

protected override void OnResize(EventArgs e)
{
    base.OnResize(e);
    GL.BindTexture(TextureTarget.Texture2D, framebufferTexture);
    GL.TexImage2D(TextureTarget.Texture2D, 0, PixelInternalFormat.Rgb, ClientSize.X, ClientSize.Y, 0, PixelFormat.Rgb, PixelType.UnsignedByte, IntPtr.Zero);
    // 重新绑定纹理到FBO
    GL.BindFramebuffer(FramebufferTarget.Framebuffer, FBO);
    GL.FramebufferTexture2D(FramebufferTarget.Framebuffer, FramebufferAttachment.ColorAttachment0, TextureTarget.Texture2D, framebufferTexture, 0);
    GL.BindFramebuffer(FramebufferTarget.Framebuffer, 0);
}

修正后的完整代码片段 #

private int FBO;
private int framebufferTexture;
private ImGuiTextureID _imGuiFboTextureId; // 新增ImGui纹理ID成员

protected override void OnLoad()
{
    base.OnLoad();

    FBO = GL.GenFramebuffer();
    GL.BindFramebuffer(FramebufferTarget.Framebuffer, FBO);

    framebufferTexture = GL.GenTexture();
    GL.BindTexture(TextureTarget.Texture2D, framebufferTexture);
    GL.TexImage2D(TextureTarget.Texture2D, 0, PixelInternalFormat.Rgb, ClientSize.X, ClientSize.Y, 0, PixelFormat.Rgb, PixelType.UnsignedByte, IntPtr.Zero);
    // 设置纹理过滤参数
    GL.TexParameter(TextureTarget.Texture2D, TextureParameterName.TextureMinFilter, (int)TextureMinFilter.Linear);
    GL.TexParameter(TextureTarget.Texture2D, TextureParameterName.TextureMagFilter, (int)TextureMagFilter.Linear);
    GL.FramebufferTexture2D(FramebufferTarget.Framebuffer, FramebufferAttachment.ColorAttachment0, TextureTarget.Texture2D, framebufferTexture, 0);

    // 检查FBO完整性
    FramebufferStatus status = GL.CheckFramebufferStatus(FramebufferTarget.Framebuffer);
    if (status != FramebufferStatus.FramebufferComplete)
    {
        Console.WriteLine($"FBO初始化失败: {status}");
    }

    // 注册ImGui纹理
    ImGuiIOPtr io = ImGui.GetIO();
    _imGuiFboTextureId = io.Fonts.AddTexture(framebufferTexture);

    GL.BindFramebuffer(FramebufferTarget.Framebuffer, 0);
}

protected override void OnRenderFrame(FrameEventArgs e)
{
    GL.BindFramebuffer(FramebufferTarget.Framebuffer, FBO);

    GL.ClearColor(new Color4(255, 255, 255, 255));
    GL.Clear(ClearBufferMask.ColorBufferBit);

    // 此处添加你的渲染逻辑，绘制内容到FBO中

    GL.BindFramebuffer(FramebufferTarget.Framebuffer, 0);

    ImGui.DockSpaceOverViewport();

    ImGui.Begin("Editor");

    // 使用ImGui纹理ID渲染图像
    ImGui.Image(_imGuiFboTextureId,
        new System.Numerics.Vector2(CameraWidth, CameraHeight),
        new System.Numerics.Vector2(0, 1),
        new System.Numerics.Vector2(1, 0),
        new System.Numerics.Vector4(1.0f),
        new System.Numerics.Vector4(1, 1, 1, 0f));

    ImGui.End();

    _controller.Render();

    SwapBuffers();
    base.OnRenderFrame(e);
}

protected override void OnResize(EventArgs e)
{
    base.OnResize(e);
    // 更新帧缓冲区纹理尺寸
    GL.BindTexture(TextureTarget.Texture2D, framebufferTexture);
    GL.TexImage2D(TextureTarget.Texture2D, 0, PixelInternalFormat.Rgb, ClientSize.X, ClientSize.Y, 0, PixelFormat.Rgb, PixelType.UnsignedByte, IntPtr.Zero);
    // 重新绑定纹理到FBO
    GL.BindFramebuffer(FramebufferTarget.Framebuffer, FBO);
    GL.FramebufferTexture2D(FramebufferTarget.Framebuffer, FramebufferAttachment.ColorAttachment0, TextureTarget.Texture2D, framebufferTexture, 0);
    GL.BindFramebuffer(FramebufferTarget.Framebuffer, 0);
}

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