com.sun.javafx.scene.SceneUtils Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of javafx-graphics Show documentation
There is a newer version: 24-ea+15
/*
 * Copyright (c) 2013, 2016, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package com.sun.javafx.scene;

import javafx.geometry.Point2D;
import javafx.geometry.Point3D;
import javafx.scene.Node;
import javafx.scene.SubScene;

/**
 * Utility class for helper methods needed by scene.
 */
public class SceneUtils {

    /**
     * Translates point from inner subScene coordinates to scene coordinates.
     */
    public static Point3D subSceneToScene(SubScene subScene, Point3D point) {

        Node n = subScene;
        while(n != null) {
            // flatten the coords - project them by subScene's camera
            final Point2D projection = CameraHelper.project(
                    SubSceneHelper.getEffectiveCamera(subScene), point);
            // transform to scene/outer-subScene coords
            point = n.localToScene(projection.getX(), projection.getY(), 0.0);
            n = NodeHelper.getSubScene(n);
        }

        return point;
    }

    /**
     * Translates point from scene coordinates to subScene local coordinates.
     */
    public static Point2D sceneToSubScenePlane(SubScene subScene, Point2D point) {

        // compute pick ray intersection with the subScene, recursively
        // over all parent subScenes
        point = computeSubSceneCoordinates(point.getX(), point.getY(), subScene);

        return point;
    }

    /**
     * Computes subScene local intersection point from the given scene mouse
     * coordinates. Works recursively over all outer subScenes.
     */
    private static Point2D computeSubSceneCoordinates(
            double x, double y, SubScene subScene) {
        SubScene outer = NodeHelper.getSubScene(subScene);

        if (outer == null) {
            return CameraHelper.pickNodeXYPlane(
                    SceneHelper.getEffectiveCamera(subScene.getScene()),
                    subScene, x, y);
        } else {
            Point2D coords = computeSubSceneCoordinates(x, y, outer);
            if (coords != null) {
                coords = CameraHelper.pickNodeXYPlane(
                        SubSceneHelper.getEffectiveCamera(outer),
                        subScene, coords.getX(), coords.getY());
            }
            return coords;
        }
    }

// This method is currently not used, but its code may be useful
// for the future introducion of public 3D picking and in particular
// 3D screenToLocal functionality.
//    /**
//     * Translates 2D scene coordinates to 3D local coordinates of a node.
//     *
//     * If the node contains (is rendered at) the given flat coordinates,
//     * the returned point represents the intersection of the node and a
//     * ray cast by the given coordinates; otherwise it represents
//     * the intersection point of the ray and the projection plane.
//     */
//    public Point3D sceneToLocal3D(Node n, double sceneX, double sceneY) {
//        Scene scene = n.getScene();
//        if (scene == null) {
//            return null;
//        }
//
//        Point2D pt = new Point2D(screenX, screenY);
//        final SubScene subScene = NodeHelper.getSubScene(n);
//        if (subScene != null) {
//            pt = SceneUtils.sceneToSubScenePlane(subScene, pt);
//            if (pt == null) {
//                return null;
//            }
//        }
//
//        // compute pick ray
//        final Camera cam = subScene != null
//                ? SubSceneHelper.getEffectiveCamera(subScene)
//                : SceneHelper.getEffectiveCamera(scene);
//        final PickRay pickRay = cam.computePickRay(pt.getX(), pt.getY(), null);
//
//        // convert it to node's local pickRay
//        final Affine3D localToSceneTx = new Affine3D();
//        TransformHelper.apply(n.getLocalToSceneTransform(), localToSceneTx);
//        try {
//            Vec3d origin = pickRay.getOriginNoClone();
//            Vec3d direction = pickRay.getDirectionNoClone();
//            localToSceneTx.inverseTransform(origin, origin);
//            localToSceneTx.inverseDeltaTransform(direction, direction);
//        } catch (NoninvertibleTransformException e) {
//            return null;
//        }
//
//        // compute the intersection
//        final PickResultChooser result = new PickResultChooser();
//        NodeHelper.computeIntersects(this, pickRay, result);
//        if (result.getIntersectedNode() == n) {
//            return result.getIntersectedPoint();
//        }
//
//        // there is none, use point on projection plane instead
//        final Point3D ppIntersect = CameraAccess.getCameraAccess().pickProjectPlane(cam, pt.getX(), pt.getY());
//        return n.sceneToLocal(ppIntersect);
//    }
}