Класс 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 в случае сцены); 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.