Skip to content

fix(render): advance destination pointer in convertToRgba8 for RGBA8/BGRA8 - #97

Merged
sudoevolve merged 1 commit into
devfrom
fix-convertToRgba8
Oct 10, 2026
Merged

sudoevolve merged 1 commit into
devfrom
fix-convertToRgba8

Conversation

@sudoevolve

Copy link
Copy Markdown
Owner

fix(render): advance destination pointer in convertToRgba8 for RGBA8/BGRA8

问题

  • 复现方式:向 core::render::ImageStream 提交一个宽度 > 1 的 ImageFrame(ImagePixelFormat::BGRA8 或 RGBA8,例如 width=256, height=256, stride=width*4),经 ImageFrame::convertToRgba8() 转换后上传为纹理,再通过 ui.image().stream() 渲染。
    • 预期行为:完整图像正常显示。
    • 实际行为:图像坍缩为元素左边缘的一条 1px 竖线,其余区域全透明(不可见)。
  • 根因:ImageFrame::convertToRgba8() 的 RGBA8/BGRA8 分支中,内层 x 循环里 source 指针随 x 前进(source + x*4),但 destination 指针从不前进。每轮循环都向同一行的前 4 字节写入,循环结束后每行只剩最后一个像素的转换值;其余像素因 output.resize() 预分配的零值(alpha=0)被 alpha 混合“擦掉”,最终纹理只有最左一列不透明。
  • 现有单元测试仅用 1×1 的 BGRA 帧覆盖该路径(tests/unit/image_stream.cpp:39),1 像素循环只执行一次,指针是否前进无差别,因此该 bug 未被发现。

修改

  • 实现方案:在内层循环末尾补 destination += 4;(单行最小修改),使写指针随 x 逐像素前进,与 source 的推进保持一致。YUV 分支本就使用 output.data() + (y*width + x)*4 的绝对偏移写法,不受影响。
  • 为什么符合简单、快速、易上手的原则:仅修复指针推进逻辑,不改变任何 API、内存布局或性能特征;一行改动消除整类“多像素 RGBA/BGRA 上传损坏”问题。

影响

  • 修改文件数:1(core/render/image_stream.cpp)
  • 代码净增行数:+1
  • 仓库追踪内容净增体积:约 0(一行代码)
  • 新增依赖或资源:无

本机环境

  • OS:Windows 11
  • 编译器:MSVC 19.x(Ninja 构建)
  • 渲染后端:OpenGL(GLFW)

验证

  • 回归测试:新增 4×1 BGRA8 与 2×2 RGBA8 两个多像素转换断言(tests/unit/image_stream.cpp),修复前失败、修复后通过。
  • GLFW + OpenGL:Release 构建通过,image_stream 单元测试通过;实际应用(ui.image().stream() 提交 256×256 BGRA 帧)验证画面完整显示,非竖线。
  • SDL2 + OpenGL / GLFW + Vulkan / SDL2 + Vulkan:本改动为纯 CPU 像素转换逻辑(convertToRgba8),不涉及窗口/渲染后端代码路径,由 CI 覆盖。

@sudoevolve
sudoevolve merged commit 24f5ecb into dev Oct 10, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant