Scene.depthBuffer为true时JavaFX MeshView无法接收鼠标事件的问题

问题现象 #

• 当Scene.depthBuffer=false时：3D对象显示失真（面重叠、层次错乱），但MeshView可正常接收鼠标事件。
• 当Scene.depthBuffer=true时：3D对象显示恢复正常（深度层次正确），但MeshView无法接收鼠标事件。

原因分析 #

1. 渲染管线差异
   • depthBuffer=false时，JavaFX采用2D渲染管线，所有3D元素会被强制扁平化，导致深度信息丢失、显示失真；但2D事件拾取仅基于元素的屏幕投影区域，因此MeshView能正常接收事件。
   • depthBuffer=true时，JavaFX启用3D渲染管线，通过深度缓冲实现正确的3D层次显示，但3D事件拾取依赖射线与3D网格的相交检测。如果Mesh的几何数据（如顶点、法线）不完整，或相机/变换设置导致拾取射线无法正确命中网格，就会出现事件无法触发的情况。
2. 相机设置问题
   原代码中使用PerspectiveCamera(false)创建相机，启用的是平行投影模式而非真正的透视投影，会干扰3D拾取的射线计算，导致无法正确识别点击的MeshView。
3. 未初始化的旋转锚点
   原代码中anchorAngleX和anchorAngleY未在MOUSE_PRESSED时初始化，会导致旋转逻辑异常，也可能间接影响事件传递的判断。

解决方案 #

1. 修复相机设置 #

将透视相机改为启用3D模式，确保拾取射线计算符合透视投影逻辑：

PerspectiveCamera camera = new PerspectiveCamera(true);

2. 确保Mesh几何数据完整 #

检查toJavaFXMesh()方法生成的Mesh是否包含正确的顶点法线：3D拾取依赖法线信息进行相交检测，缺少法线会导致JavaFX无法正确判断点击是否命中3D表面。可通过调整ISolid的网格生成逻辑添加法线。

3. 优化事件处理逻辑 #

• 初始化旋转锚点：在MOUSE_PRESSED事件中为anchorAngleX和anchorAngleY赋值，避免旋转逻辑异常。
• 调试拾取结果：在容器的事件过滤器中打印拾取目标，确认点击是否命中MeshView：

  System.out.println("Pick target: " + event.getPickResult().getIntersectedNode());
  

• 可选测试：设置view.setPickOnBounds(true)，切换为边界盒拾取模式，排查是否是网格本身的几何问题导致拾取失败。

4. 修正平移逻辑 #

原代码中平移操作直接覆盖translateX/Y值，改为累加模式，保证连续拖动时的平移正确性。

测试代码（修正后） #

package us.bringardner.solid3d.ui;

import javafx.application.Application;
import javafx.event.EventType;
import javafx.geometry.HPos;
import javafx.geometry.Pos;
import javafx.scene.Group;
import javafx.scene.PerspectiveCamera;
import javafx.scene.Scene;
import javafx.scene.input.MouseEvent;
import javafx.scene.layout.BorderPane;
import javafx.scene.layout.FlowPane;
import javafx.scene.layout.StackPane;
import javafx.scene.paint.Color;
import javafx.scene.paint.PhongMaterial;
import javafx.scene.shape.CullFace;
import javafx.scene.shape.MeshView;
import javafx.scene.transform.Rotate;
import javafx.stage.Stage;
import us.bringardner.solid3d.api.ISolid;
import us.bringardner.solid3d.api.ISolidFactory;

public class TestFxPane extends Application {
    private StackPane viewStackPane;
    private FlowPane viewContainer;

    private double anchorAngleX;
    private double anchorAngleY;
    private double anchorX;
    private double anchorY;
    private final Rotate rotateX = new Rotate(0, 0, 0, 0, Rotate.X_AXIS);
    private final Rotate rotateZ = new Rotate(0, 0, 0, 0, Rotate.Z_AXIS);
    private final Rotate rotateY = new Rotate(0, 0, 0, 0, Rotate.Y_AXIS);
    private BorderPane rootPane;
    private Group viewGroup;

    private MeshView getCsgCube() {
        int size = 100;
        ISolid csg = ISolidFactory.getFactory().Cube(size, false);
        csg = csg.movex(size);
        csg.setName("Cube");
        return csg.toJavaFXMesh();
    }

    public static void main(String[] args) {
        launch(args);
    }

    @Override
    public void start(Stage stage) {
        rootPane = new BorderPane();

        MeshView view = getCsgCube();
        view.setMaterial(new PhongMaterial(Color.BLUE));
        view.setCullFace(CullFace.NONE);
        // 可选：启用边界盒拾取测试
        // view.setPickOnBounds(true);
        view.addEventHandler(MouseEvent.ANY, (event)->{
            if(event.getEventType() == MouseEvent.MOUSE_PRESSED) {
                System.out.println("Mesh event="+event);
            }
        });

        viewGroup = new Group(view );
        viewContainer = new FlowPane(viewGroup);
        viewContainer.setAlignment(Pos.CENTER);
        viewContainer.setColumnHalignment(HPos.CENTER);
        viewGroup.getTransforms().addAll(rotateX,rotateY,rotateZ);
        viewContainer.addEventFilter(MouseEvent.ANY, (event)->{
            EventType<? extends MouseEvent> type = event.getEventType();
            if(type == MouseEvent.MOUSE_PRESSED) {
                System.out.println("Pane event="+event);
                // 添加拾取结果调试
                System.out.println("Pick target: " + event.getPickResult().getIntersectedNode());
                anchorX = event.getSceneX();
                anchorY = event.getSceneY();
                // 初始化旋转锚点
                anchorAngleX = rotateX.getAngle();
                anchorAngleY = rotateZ.getAngle();
            } else if( type == MouseEvent.MOUSE_DRAGGED) {
                if( event.isMiddleButtonDown()) {
                    double deltax = event.getSceneX() - anchorX;
                    double deltay = event.getSceneY() - anchorY;
                    // 改为累加平移，保证连续拖动正确
                    viewGroup.setTranslateX(viewGroup.getTranslateX() + deltax);
                    viewGroup.setTranslateY(viewGroup.getTranslateY() + deltay);
                } else {
                    rotateZ.setAngle(anchorAngleY - (anchorX - event.getSceneX()) );
                    rotateX.setAngle(anchorAngleX - (anchorY - event.getSceneY()) );
                }
                event.consume();
            }
        });

        viewStackPane = new StackPane(viewContainer);
        rootPane.centerProperty().set(viewStackPane);
        // 启用深度缓冲，保证3D显示正常
        Scene scene = new Scene(rootPane, 1000, 1000, true);
        // 启用3D模式的透视相机
        PerspectiveCamera camera = new PerspectiveCamera(true);
        scene.setCamera(camera);
        stage.setScene(scene);
        stage.show();
    }
}

显示效果截图 #

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