RFR: 8372761: Prevent degenerate transforms for zero-size Scene/SubScene

Michael Strauß mstrauss at openjdk.org
Sun Nov 30 03:32:25 UTC 2025


When a `Scene` or `SubScene` has its width or height set to 0, coordinate transformations stop working because the transformation matrix contains NaNs. This is a consequence of divisions by zero in both parallel and perspective projections.

Even though a 0x0 scene is mathematically degenerate, it is still desirable for coordinate transformation APIs to remain numerically well-behaved and return finite results whenever possible, rather than being poisoned by NaN/Infinity.

Here is an application that demonstrates the failing coordinate transformations. Click on the buttons to resize the SubScene and observe the console output. After applying the patch in this PR, you should observe that `localToScreen()` no longer returns NaN.


public class ZeroSizeSubScene extends Application {

    @Override
    public void start(Stage stage) {
        var rect = new Rectangle(50, 50, Color.RED);
        var subScene = new SubScene(new Group(rect), 100, 100);
        subScene.setFill(Color.GRAY);

        // Also try a perspective camera:
        //
        // var camera = new PerspectiveCamera();
        // camera.setRotate(45);
        // camera.setTranslateX(-20);
        // camera.setRotationAxis(new Point3D(0, 1, 0));
        // subScene.setCamera(camera);

        class MyButton extends Button {
            public MyButton(String text, double width, double height) {
                super(text);
                setOnAction(_ -> {
                    var timeline = new Timeline(
                        new KeyFrame(Duration.seconds(1), new KeyValue(subScene.widthProperty(), width)),
                        new KeyFrame(Duration.seconds(1), new KeyValue(subScene.heightProperty(), height)));

                    timeline.setOnFinished(_ -> {
                        Point2D p0 = rect.localToScreen(0, 0);
                        System.out.println("rect.localToScreen(0, 0) = " + p0);
                    });

                    timeline.play();
                });
            }
        }

        VBox.setMargin(subScene, new Insets(0, 0, 20, 0));

        var root = new VBox(5,
            subScene,
            new CheckBox("Rotate SubScene") {{ setOnAction(_ -> subScene.setRotate(isSelected() ? 45 : 0)); }},
            new MyButton("Size: 100x100", 100, 100),
            new MyButton("Size: 10x10", 10, 10),
            new MyButton("Size: 100x0", 100, 0),
            new MyButton("Size: 0x100", 0, 100),
            new MyButton("Size: 0x0", 0, 0)
        );

        Scene scene = new Scene(root, 300, 300);
        stage.setScene(scene);
        stage.show();
    }
}

-------------

Commit messages:
 - TestScene
 - Prevent degenerate viewport for zero-size Scene/SubScene

Changes: https://git.openjdk.org/jfx/pull/1992/files
  Webrev: https://webrevs.openjdk.org/?repo=jfx&pr=1992&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8372761
  Stats: 163 lines in 3 files changed: 103 ins; 16 del; 44 mod
  Patch: https://git.openjdk.org/jfx/pull/1992.diff
  Fetch: git fetch https://git.openjdk.org/jfx.git pull/1992/head:pull/1992

PR: https://git.openjdk.org/jfx/pull/1992


More information about the openjfx-dev mailing list