Класс PickResult

java.lang.Object

javafx.scene.input.PickResult

public class PickResult extends Object

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

С момента:: JavaFX 8.0

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

Модификатор и тип	Поле	Описание
`static final 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.

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

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

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

См. также:

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

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 - Пересечённая грань выбранного узла; normal - Нормаль пересечения выбранного узла; texCoord - Текстурные координаты пересечения выбранного узла
С момента:: 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 в случае с Scene); 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, представляющий нормаль пересечения
С момента:: 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.