Класс PickResult

java.lang.Object

javafx.scene.input.PickResult

public class PickResult
extends Object

Объект-контейнер, содержащий результат события выбора

Since:: JavaFX 8.0

Краткое описание полей

Поля
Модификатор и тип	Поле	Описание
`static int`	`FACE_UNDEFINED`	Неопределённая грань.

Краткое описание конструкторов

Конструкторы
Конструктор	Описание
`PickResult(EventTarget target, double sceneX, double sceneY)`	Создаёт результат выбора для 2D-случая, когда дополнительная информация не требуется.
`PickResult(Node node, Point3D point, double distance)`	Создаёт новый экземпляр PickResult для целевого объекта, не являющегося 3D-формой.
`PickResult(Node node, Point3D point, double distance, int face, Point2D texCoord)`	Создаёт новый экземпляр PickResult.
`PickResult(Node node, Point3D point, double distance, int face, Point3D normal, Point2D texCoord)`	Создаёт новый экземпляр PickResult.

Краткое описание методов

Модификатор и тип	Метод	Описание
`double`	`getIntersectedDistance()`	Возвращает расстояние от камеры до точки пересечения.
`int`	`getIntersectedFace()`	Возвращает грань выбранного узла, FACE_UNDEFINED, если у узла нет граней или он выбран по границам.
`Node`	`getIntersectedNode()`	Возвращает выбранный узел.
`Point3D`	`getIntersectedNormal()`	Возвращает нормаль к пересечённой 3D-форме.
`Point3D`	`getIntersectedPoint()`	Возвращает точку пересечения в локальных координатах выбранного узла.
`Point2D`	`getIntersectedTexCoord()`	Возвращает текстурные координаты пересечённой 3D-формы.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание полей

FACE_UNDEFINED

public static final int FACE_UNDEFINED

Неопределённая грань. Это значение используется для грани пересечения, если у выбранного узла нет явно заданных граней.

See Also:: Постоянные значения полей

Подробное описание конструкторов

PickResult

public PickResult(Node node, Point3D point, double distance, int face, Point2D texCoord)

Создаёт новый экземпляр PickResult.

Параметры:: node - Выбранный узел; point - Точка пересечения в локальных координатах выбранного узла; distance - Расстояние от камеры до выбранного узла; face - Грань выбранного узла; texCoord - Текстурные координаты выбранного узла

PickResult

public PickResult(Node node, Point3D point, double distance, int face, Point3D normal, Point2D texCoord)

Создаёт новый экземпляр PickResult.

Параметры:: node - Выбранный узел; point - Точка пересечения в локальных координатах выбранного узла; distance - Расстояние от камеры до выбранного узла; face - Грань выбранного узла; texCoord - Текстурные координаты выбранного узла; normal - Нормаль к пересечённой форме
Since:: JavaFX 8u40

PickResult

public PickResult(Node node, Point3D point, double distance)

Создаёт новый экземпляр PickResult для целевого объекта, не являющегося 3D-формой. Устанавливает грань в FACE_UNDEFINED и texCoord в null.

Параметры:: node - Выбранный узел; point - Точка пересечения в локальных координатах выбранного узла; distance - Расстояние от камеры до выбранного узла

PickResult

public PickResult(EventTarget target, double sceneX, double sceneY)

Создаёт результат выбора для 2D-случая, когда дополнительная информация не требуется. Преобразует заданные координаты сцены в локальные координаты целевого объекта и сохраняет значение как точку пересечения. Устанавливает выбранный узел в заданный целевой объект, расстояние в 1.0, грань в FACE_UNDEFINED и texCoord в null.

Параметры:: target - Выбранный целевой объект (null в случае сцены); sceneX - Координата X в пространстве сцены; sceneY - Координата Y в пространстве сцены

Подробное описание методов

getIntersectedNode

public final Node getIntersectedNode()

Возвращает выбранный узел. Возвращает null, если не было пересечения ни с одним узлом и была выбрана сцена.

Возвращает:: выбранный узел или null, если узел не выбран

getIntersectedPoint

public final Point3D getIntersectedPoint()

Возвращает точку пересечения в локальных координатах выбранного узла. Если узел не выбран, возвращает точку пересечения с плоскостью проекции.

Возвращает:: новый Point3D, представляющий точку пересечения

getIntersectedDistance

public final double getIntersectedDistance()

Возвращает расстояние от камеры до точки пересечения.

Возвращает:: расстояние от камеры до пересечения

getIntersectedFace

public final int getIntersectedFace()

Возвращает грань выбранного узла, FACE_UNDEFINED, если у узла нет явно заданных граней или он выбран по границам.

Возвращает:: выбранная грань

getIntersectedNormal

public final Point3D getIntersectedNormal()

Возвращает нормаль к пересечённой 3D-форме. Если выбранный объект не Shape3D или у него pickOnBounds==true, возвращает null.

Возвращает:: новый Point3D, представляющий нормаль
Since:: JavaFX 8u40

getIntersectedTexCoord

public final Point2D getIntersectedTexCoord()

Возвращает текстурные координаты пересечённой 3D-формы. Если выбранный объект не Shape3D или у него pickOnBounds==true, возвращает null.

Возвращает:: новый Point2D, представляющий текстурные координаты

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.