如何让不同距离下的JavaFX 3D缩放纹理保持像素完美？

我正在开发一款类似Minecraft的8位风格游戏，使用JavaFX的PerspectiveCamera与SubScene组件。给Box设置8×8像素的红黑棋盘格纹理后，出现严重模糊问题，核心代码如下：

new Box() {{
    setMaterial(new PhongMaterial() {{
        setDiffuseMap(new Image("img.png"));
    }});
}};

最小可复现示例 #

package com.example.jfx;

import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.PerspectiveCamera;
import javafx.scene.Scene;
import javafx.scene.image.Image;
import javafx.scene.paint.PhongMaterial;
import javafx.scene.shape.Box;
import javafx.stage.Stage;

public class MRE extends Application {
    public static void main(String[] args) {
        launch(args);
    }

    @Override
    public void start(Stage stage) {
        Image img = new Image("example.png");
        Scene scene = new Scene(new Group(
                new Box(500, 500, 500) {{ // 最远的盒子
                    setMaterial(new PhongMaterial() {{
                        setDiffuseMap(img);
                    }});
                }},
                new Box(500, 500, 500) {{ // 中间的盒子
                    setMaterial(new PhongMaterial() {{
                        setDiffuseMap(img);
                        setSelfIlluminationMap(img);
                    }});
                    setTranslateZ(1000);
                }},
                new Box(500, 500, 500) {{ // 最近的盒子
                    setMaterial(new PhongMaterial() {{
                        setDiffuseMap(new Image("example.png", 1600, 1600, false, false, false));
                    }});
                    setTranslateZ(2000);
                }}
        ) {{
            setTranslateY(300);
        }}, 800, 600);
        stage.setScene(scene);
        scene.setCamera(new PerspectiveCamera());
        stage.show();
    }
}

当前尝试的方法及问题 #

• 仅用Diffuse Map：纹理严重模糊
• 搭配Self Illumination Map：模糊略有改善，但破坏游戏光照逻辑
• 使用放大纹理：效果尚可，但内存占用高，近距离仍有模糊

需要找到能让不同距离下的低分辨率纹理都保持像素完美的解决方案。

JavaFX默认对纹理使用双线性过滤，会对相邻像素插值导致模糊。要实现像素锐利的效果，需强制使用最近邻采样：

1. 加载图片时禁用平滑 #

加载纹理时将smooth参数设为false，让JavaFX直接取最近像素颜色：

// 加载原始8×8纹理，禁用平滑缩放
Image originalPixelImg = new Image("example.png", false);

2. 用WritableImage确保采样模式生效 #

为了彻底避免系统自动插值，将原始图片包装为WritableImage：

WritableImage pixelPerfectImg = new WritableImage(
    originalPixelImg.getPixelReader(),
    (int) originalPixelImg.getWidth(),
    (int) originalPixelImg.getHeight()
);

3. 禁用场景抗锯齿 #

关闭场景的抗锯齿功能，避免渲染时对画面整体平滑处理：

Scene scene = new Scene(root, 800, 600, true, SceneAntialiasing.DISABLED);

完整修改后的示例代码 #

package com.example.jfx;

import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.PerspectiveCamera;
import javafx.scene.Scene;
import javafx.scene.SceneAntialiasing;
import javafx.scene.image.Image;
import javafx.scene.image.WritableImage;
import javafx.scene.paint.PhongMaterial;
import javafx.scene.shape.Box;
import javafx.stage.Stage;

public class MRE extends Application {
    public static void main(String[] args) {
        launch(args);
    }

    @Override
    public void start(Stage stage) {
        // 加载低分辨率纹理，禁用平滑
        Image originalImg = new Image("example.png", false);
        // 转换为WritableImage确保采样模式正确
        WritableImage pixelPerfectImg = new WritableImage(
            originalImg.getPixelReader(),
            (int) originalImg.getWidth(),
            (int) originalImg.getHeight()
        );

        Scene scene = new Scene(new Group(
                new Box(500, 500, 500) {{
                    setMaterial(new PhongMaterial() {{
                        setDiffuseMap(pixelPerfectImg);
                    }});
                }},
                new Box(500, 500, 500) {{
                    setMaterial(new PhongMaterial() {{
                        setDiffuseMap(pixelPerfectImg);
                    }});
                    setTranslateZ(1000);
                }},
                new Box(500, 500, 500) {{
                    setMaterial(new PhongMaterial() {{
                        setDiffuseMap(pixelPerfectImg);
                    }});
                    setTranslateZ(2000);
                }}
        ) {{
            setTranslateY(300);
        }}, 800, 600, true, SceneAntialiasing.DISABLED);

        stage.setScene(scene);
        scene.setCamera(new PerspectiveCamera());
        stage.show();
    }
}

原理说明 #

最近邻过滤会直接选取距离采样点最近的像素颜色，不进行任何插值计算，能完美保留低分辨率纹理的锐利像素边缘；禁用场景抗锯齿则避免了渲染阶段对画面的额外平滑处理，彻底还原8位风格的像素质感。

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