LibGDX中FrameBuffer在iOS平台存在偏移异常问题

问题现象 #

相同代码在Android平台运行正常，但iOS平台使用FrameBuffer时出现绘制组定位偏移问题：不通过FBO直接绘制时显示完全正常，一旦先在FBO中绘制再渲染到屏幕，就会出现位置错误，使用的是常规遮罩着色器。

关联代码片段 #

fboGroup!!.begin()
ScreenUtils.clear(Color.CLEAR, true)
batch.begin()
batch.projectionMatrix = camera.combined

batch.setBlendFunction(GL20.GL_ONE_MINUS_DST_ALPHA, GL20.GL_ONE_MINUS_SRC_ALPHA)
super.draw(batch, parentAlpha)

batch.setBlendFunction(GL20.GL_SRC_ALPHA, GL20.GL_ONE_MINUS_SRC_ALPHA)
batch.color = Color.WHITE

batch.projectionMatrix = stage.camera.combined

batch.end()
fboGroup!!.end(screenXInPixels, screenYInPixels, screenWidthInPixels, screenHeightInPixels)

针对性排查与修复建议 #

• 统一FBO绘制阶段的投影矩阵：代码中在batch.begin()后先设置了camera.combined，绘制完成后又切换为stage.camera.combined，但FBO绘制全程应保持单一投影矩阵，避免矩阵切换导致坐标计算混乱。建议删除中间的投影矩阵切换代码，全程使用stage.camera.combined（或确保两个相机的参数完全一致）。
• 适配iOS屏幕坐标系与像素密度：iOS屏幕的坐标原点与OpenGL标准坐标系存在差异，且高DPI设备需要处理像素比。检查fboGroup.end()传入的screenXInPixels等参数，需确保是基于OpenGL左下角原点的坐标，同时FBO的创建尺寸要乘以Gdx.graphics.density，避免因像素密度不匹配导致缩放偏移。
• 检查FBO视口配置：调用fboGroup.begin()后，需确认视口已正确设置为FBO的实际尺寸，可通过Gdx.gl.glViewport(0, 0, fboWidth, fboHeight)手动指定，防止iOS设备自动调整视口导致坐标错位。
• 验证混合函数兼容性：iOS的OpenGL ES对混合模式的实现可能与Android存在细微差异，先暂时注释setBlendFunction相关代码，测试是否是混合模式引发的定位异常，再根据测试结果调整混合参数。

内容的提问来源于stack exchange，提问作者Владислав Шестернин