/*
* Copyright (c) 2000, 2020, 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.input;
import com.sun.javafx.scene.CameraHelper;
import com.sun.javafx.scene.NodeHelper;
import com.sun.javafx.scene.SceneHelper;
import com.sun.javafx.scene.SceneUtils;
import com.sun.javafx.scene.SubSceneHelper;
import java.util.Arrays;
import java.util.List;
import javafx.geometry.Point2D;
import javafx.geometry.Point3D;
import javafx.scene.Node;
import javafx.scene.SubScene;
import javafx.scene.input.PickResult;
import javafx.scene.input.TransferMode;
Utility class for helper methods needed by input events.
/**
* Utility class for helper methods needed by input events.
*/
public class InputEventUtils {
Recomputes event coordinates for a different node.
Params: - coordinates – Coordinates to recompute
- oldSource – Node in whose coordinate system the coordinates are
- newSource – Node to whose coordinate system to recompute
Returns: the recomputed coordinates
/**
* Recomputes event coordinates for a different node.
* @param coordinates Coordinates to recompute
* @param oldSource Node in whose coordinate system the coordinates are
* @param newSource Node to whose coordinate system to recompute
* @return the recomputed coordinates
*/
public static Point3D recomputeCoordinates(PickResult result,
Object newSource) {
Point3D coordinates = result.getIntersectedPoint();
if (coordinates == null) {
return new Point3D(Double.NaN, Double.NaN, Double.NaN);
}
final Node oldSourceNode = result.getIntersectedNode();
final Node newSourceNode =
(newSource instanceof Node) ? (Node) newSource : null;
final SubScene oldSubScene =
(oldSourceNode == null ? null : NodeHelper.getSubScene(oldSourceNode));
final SubScene newSubScene =
(newSourceNode == null ? null : NodeHelper.getSubScene(newSourceNode));
final boolean subScenesDiffer = (oldSubScene != newSubScene);
if (oldSourceNode != null) {
// transform to scene/nearest-subScene coordinates
coordinates = oldSourceNode.localToScene(coordinates);
if (subScenesDiffer && oldSubScene != null) {
// transform to scene coordiantes
coordinates = SceneUtils.subSceneToScene(oldSubScene, coordinates);
}
}
if (newSourceNode != null) {
if (subScenesDiffer && newSubScene != null) {
// flatten the coords to flat mouse coordinates - project
// by scene's camera
Point2D planeCoords = CameraHelper.project(
SceneHelper.getEffectiveCamera(newSourceNode.getScene()),
coordinates);
// convert the point to subScene coordinates
planeCoords = SceneUtils.sceneToSubScenePlane(newSubScene, planeCoords);
// compute inner intersection with the subScene's camera
// projection plane
if (planeCoords == null) {
coordinates = null;
} else {
coordinates = CameraHelper.pickProjectPlane(
SubSceneHelper.getEffectiveCamera(newSubScene),
planeCoords.getX(), planeCoords.getY());
}
}
// transform the point to source's local coordinates
if (coordinates != null) {
coordinates = newSourceNode.sceneToLocal(coordinates);
}
if (coordinates == null) {
coordinates = new Point3D(Double.NaN, Double.NaN, Double.NaN);
}
}
return coordinates;
}
private static final List<TransferMode> TM_ANY = List.of(
TransferMode.COPY,
TransferMode.MOVE,
TransferMode.LINK);
private static final List<TransferMode> TM_COPY_OR_MOVE = List.of(
TransferMode.COPY,
TransferMode.MOVE);
Makes sure changes to the static arrays specified in TransferMode
don't have any effect on the transfer modes used.
Params: - modes – Modes passed in by user
Returns: list containing the passed modes. If one of the static arrays
is passed, the expected modes are returned regardless of the
values in those arrays.
/**
* Makes sure changes to the static arrays specified in TransferMode
* don't have any effect on the transfer modes used.
* @param modes Modes passed in by user
* @return list containing the passed modes. If one of the static arrays
* is passed, the expected modes are returned regardless of the
* values in those arrays.
*/
public static List<TransferMode> safeTransferModes(TransferMode[] modes) {
if (modes == TransferMode.ANY) {
return TM_ANY;
} else if (modes == TransferMode.COPY_OR_MOVE) {
return TM_COPY_OR_MOVE;
} else {
return Arrays.asList(modes);
}
}
}