Scene2D中FrameBuffer使用求助：渲染适配与投影矩阵疑问

问题背景 #

开发自定义Scene2D Actor时遇到FrameBuffer相关问题，目标是让FrameBuffer的内容正确填满Actor在屏幕上的预期空间。目前有一个看似可行的实现，但不清楚原理，代码如下：

@Override
public void draw(Batch batch, float parentAlpha) {
    
    batch.end();
    buffer.begin();
    ScreenUtils.clear(1,0,0,1);
    batch.begin();
    batch.draw(texture,0,0,640,640); // 这是窗口尺寸！
    batch.end();
    buffer.end();
    batch.begin();
    batch.draw(buffer.getColorBufferTexture(),
               getX(),
               getY(),
               getWidth(),
               getHeight(),
               0,
               0,
               buffer.getColorBufferTexture().getWidth(),
               buffer.getColorBufferTexture().getHeight(),
               false,
               true);

}

已知FrameBuffer使用像素坐标，Scene2D Actor的位置和尺寸使用“世界”坐标，但存在疑问：若渲染到FrameBuffer的纹理尺寸小于窗口尺寸，FrameBuffer的颜色缓冲纹理在屏幕上的渲染尺寸会小于Actor的尺寸。需要解答以下两个核心问题：

1. FrameBuffer应该设置为多大尺寸？ #

FrameBuffer的尺寸需根据渲染精度和显示需求确定：

• 若要避免放大时失真，建议设置为Actor最终显示的像素尺寸：即actor.getWidth() * Gdx.graphics.getBackBufferScale()和actor.getHeight() * Gdx.graphics.getBackBufferScale()，其中getBackBufferScale()是屏幕的像素缩放因子，保证渲染纹理的分辨率匹配屏幕实际像素，缩放后无模糊。
• 若仅适配Actor的逻辑尺寸（世界坐标），也可设置为与Actor的逻辑尺寸一致，但后续渲染时需做好缩放处理，防止拉伸变形。
• 你当前硬编码窗口尺寸（640x640）的方式不合理，会导致Actor尺寸变化或窗口缩放时，FrameBuffer内容无法匹配Actor的显示区域。

2. 绘制到FrameBuffer时是否需要使用不同的投影矩阵？ #

必须修改投影矩阵。FrameBuffer使用像素坐标系，而SpriteBatch默认的投影矩阵适配的是窗口的世界坐标，直接绘制会导致坐标错位或尺寸不匹配。

正确实现方式是在绘制到FrameBuffer前保存当前投影矩阵，然后将SpriteBatch的投影矩阵切换为适配FrameBuffer的像素坐标系，绘制完成后恢复原矩阵：

@Override
public void draw(Batch batch, float parentAlpha) {
    // 保存当前batch的投影矩阵，用于后续恢复
    Matrix4 originalProjection = batch.getProjectionMatrix().cpy();
    
    batch.end();
    buffer.begin();
    ScreenUtils.clear(1, 0, 0, 1);
    
    // 设置batch的投影矩阵为FrameBuffer的像素正交矩阵，覆盖整个FrameBuffer范围
    batch.setProjectionMatrix(new Matrix4().setToOrtho2D(0, 0, buffer.getWidth(), buffer.getHeight()));
    batch.begin();
    // 此时用FrameBuffer的像素坐标绘制，直接铺满整个FrameBuffer
    batch.draw(texture, 0, 0, buffer.getWidth(), buffer.getHeight());
    batch.end();
    buffer.end();
    
    batch.begin();
    // 恢复原投影矩阵，回到Scene2D的世界坐标体系
    batch.setProjectionMatrix(originalProjection);
    // 将FrameBuffer纹理绘制到Actor的逻辑区域，自动适配Actor尺寸
    batch.draw(buffer.getColorBufferTexture(),
               getX(), getY(), getWidth(), getHeight(),
               0, 0, buffer.getWidth(), buffer.getHeight(),
               false, true);
}

关键原理：

• 激活FrameBuffer时，OpenGL视口会自动切换为FrameBuffer的尺寸，但SpriteBatch的投影矩阵不会自动更新，所以需手动设置Ortho2D矩阵，使其覆盖FrameBuffer的全部像素范围（0到宽，0到高）。
• 绘制完成后必须恢复原投影矩阵，否则会破坏后续Scene2D元素的渲染逻辑。

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