JavaFX SubScene内容显示异常排查：聚焦3D对象渲染细节

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.SubScene;
import javafx.scene.PerspectiveCamera;
import javafx.scene.SceneAntialiasing;
import javafx.scene.layout.BorderPane;
import javafx.scene.paint.Color;
import javafx.scene.paint.PhongMaterial;
import javafx.scene.shape.Box;
import javafx.scene.PointLight;
import javafx.stage.Stage;
import javafx.geometry.Point3D;

public class SubSceneDisplayExample extends Application {

    private BorderPane borderPane; // 假设这个borderPane是从FXML加载的

    @Override
    public void start(Stage stage) throws Exception {
        // 1. 从FXML加载BorderPane (模拟从FXMLController获取)
        // 在实际应用中，FXMLLoader.load() 会返回根节点，然后可以获取其中的BorderPane
        // 为了演示，我们直接创建一个，并假设它来自FXML
        borderPane = new BorderPane();
        // borderPane = FXMLLoader.load(getClass().getResource("YourFXML.fxml"));
        // 如果是从FXML加载，你可能需要在Controller中通过@FXML注解注入borderPane

        // 2. 创建一个包含可见3D内容的SubScene
        SubScene subScene = create3DSubScene(600, 550);

        // 3. 将SubScene设置到BorderPane的中心
        borderPane.setCenter(subScene);

        // 4. 设置主场景并显示
        Scene scene = new Scene(borderPane, 800, 600);
        stage.setScene(scene);
        stage.setTitle("JavaFX SubScene Display Example");
        stage.show();
    }

    /**
     * 创建并返回一个包含3D内容的SubScene
     * @param width SubScene的宽度
     * @param height SubScene的高度
     * @return 包含3D内容的SubScene实例
     */
    private SubScene create3DSubScene(double width, double height) {
        // 创建一个简单的3D对象 - 一个有尺寸的盒子
        // 确保 Box 的尺寸是非零的
        Box box = new Box(100, 100, 100);
        PhongMaterial material = new PhongMaterial(Color.BLUE);
        box.setMaterial(material);

        // 创建一个3D场景的根Group
        Group root3D = new Group();
        root3D.getChildren().add(box); // 将盒子添加到根Group

        // 创建一个透视摄像机
        PerspectiveCamera camera = new PerspectiveCamera(true);
        camera.setNearClip(0.1);
        camera.setFarClip(1000.0);
        camera.setTranslateX(0);
        camera.setTranslateY(0);
        camera.setTranslateZ(-300); // 将摄像机向后移动，以便能看到盒子

        // 创建一个点光源
        PointLight light = new PointLight(Color.WHITE);
        light.setTranslateX(200);
        light.setTranslateY(200);
        light.setTranslateZ(-200);
        root3D.getChildren().add(light); // 将光源添加到根Group

        // 将摄像机也添加到根Group，或者直接设置给SubScene
        // 推荐直接设置给SubScene，因为它是一个特殊的节点
        // root3D.getChildren().add(camera); // 通常不直接将相机添加到场景图中，而是设置给SubScene

        // 创建SubScene
        SubScene subScene = new SubScene(root3D, width, height, true, SceneAntialiasing.BALANCED);
        subScene.setFill(Color.LIGHTGRAY); // 设置SubScene的背景色
        subScene.setCamera(camera); // 将摄像机设置给SubScene

        // 旋转盒子以提供更好的视觉效果 (可选)
        box.setRotationAxis(new Point3D(1, 1, 0));
        box.setRotate(45);

        return subScene;
    }

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