Класс SpotLight

javafx.scene.SpotLight

Все реализованные интерфейсы:: Styleable, EventTarget

public class SpotLight
extends PointLight

Источник света типа «SpotLight» — это источник света, который излучает свет в конусе в определённом направлении. Направление определяется вектором свойства direction источника света. Направление можно повернуть, задав преобразование вращения для SpotLight. Например, если вектор направления — (1, 1, 1), а источник света не повернут, он будет направлен в (1, 1, 1) направление, а если источник света повернут на 90 градусов вокруг оси y, он будет направлен в (1, 1, -1) направление.

В дополнение к факторам, которые управляют интенсивностью света PointLight, источник света типа «SpotLight» имеет коэффициент затухания света в конусе, spot, который определяется 3 свойствами:

innerAngle: угол внутреннего конуса (см. изображение ниже)
outerAngle: угол внешнего конуса (см. изображение ниже)
falloff: коэффициент, контролирующий падение интенсивности света внутри внешнего конуса

Допустимые диапазоны для этих свойств — 0 <= innerAngle <= outerAngle <= 180 и falloff >= 0; значения вне этих диапазонов могут привести к непредсказуемым результатам.

Угол от точки до источника света определяется как угол между вектором от точки до позиции источника света и направлением источника света. Для такого угла theta, если

theta < innerAngle, то spot = 1
theta > outerAngle, то spot = 0
innerAngle <= theta <= outerAngle, то
```
spot = pow((cos(theta) - cos(outer)) / (cos(inner) - cos(outer)), falloff)
```
, что представляет собой падение интенсивности от угла внутреннего конуса до угла внешнего конуса.

В результате 0 <= spot <= 1. Общая интенсивность света — I = lambert * atten * spot.

Image of the Spotlight

С тех пор:: 17
См. также:: PhongMaterial

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

Свойства
Тип	Свойство	Описание
`ObjectProperty<Point3D>`	`direction`	Вектор направления `direction`.
`DoubleProperty`	`falloff`	Коэффициент затухания интенсивности внешнего конуса `falloff`.
`DoubleProperty`	`innerAngle`	Угол внутреннего конуса `innerAngle`, в градусах.
`DoubleProperty`	`outerAngle`	Угол внешнего конуса `outerAngle`, в градусах (как показано на изображении в документации класса).

Свойства, объявленные в классе javafx.scene.PointLight

constantAttenuation, linearAttenuation, maxRange, quadraticAttenuation

Свойства, объявленные в классе javafx.scene.LightBase

color, lightOn

Свойства, объявленные в классе javafx.scene.Node

accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, viewOrder, visible

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

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

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

Конструкторы
Конструктор	Описание
`SpotLight()`	Создаёт новый экземпляр класса `SpotLight` с источником света по умолчанию `Color.WHITE`.
`SpotLight(Color color)`	Создаёт новый экземпляр класса `SpotLight`, используя указанный цвет.

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

Модификатор и тип	Метод	Описание
`ObjectProperty<Point3D>`	`directionProperty()`	Вектор направления `directionProperty()`.
`DoubleProperty`	`falloffProperty()`	Коэффициент затухания интенсивности внешнего конуса `falloffProperty()`.
`Point3D`	`getDirection()`	Получает значение свойства direction.
`double`	`getFalloff()`	Получает значение свойства falloff.
`double`	`getInnerAngle()`	Получает значение свойства innerAngle.
`double`	`getOuterAngle()`	Получает значение свойства outerAngle.
`DoubleProperty`	`innerAngleProperty()`	Угол внутреннего конуса `innerAngleProperty()`, в градусах.
`DoubleProperty`	`outerAngleProperty()`	Угол внешнего конуса `outerAngleProperty()`, в градусах (как показано на изображении в документации класса).
`void`	`setDirection(Point3D value)`	Устанавливает значение свойства direction.
`void`	`setFalloff(double value)`	Устанавливает значение свойства falloff.
`void`	`setInnerAngle(double value)`	Устанавливает значение свойства innerAngle.
`void`	`setOuterAngle(double value)`	Устанавливает значение свойства outerAngle.

Методы, объявленные в классе javafx.scene.PointLight

constantAttenuationProperty, getConstantAttenuation, getLinearAttenuation, getMaxRange, getQuadraticAttenuation, linearAttenuationProperty, maxRangeProperty, quadraticAttenuationProperty, setConstantAttenuation, setLinearAttenuation, setMaxRange, setQuadraticAttenuation

Методы, объявленные в классе javafx.scene.LightBase

colorProperty, getColor, getExclusionScope, getScope, isLightOn, lightOnProperty, setColor, setLightOn

Методы, объявленные в классе javafx.scene.Node

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBaselineOffset, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClassCssMetaData, getClip, getContentBias, getCssMetaData, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInitialFocusTraversable, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isResizable, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, maxHeight, maxWidth, minHeight, minWidth, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, prefHeight, prefWidth, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, resize, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

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

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

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode, getStyleClass

Подробности свойства

направление

public final ObjectProperty<Point3D> directionProperty

Вектор направления прожектора. Его можно повернуть, задав преобразование вращения для SpotLight. Вектор не обязательно должен быть нормированным.

Значение по умолчанию:: Point3D(0, 0, 1)
См. также:: getDirection(), setDirection(Point3D)

внутреннийУгол

public final DoubleProperty innerAngleProperty

Угол внутреннего конуса прожектора в градусах. Точка, угол которой до света меньше этого угла, не ослабляется фактором прожектора (spot = 1). При больших углах интенсивность света начинает уменьшаться. Дополнительная информация в документации класса.

Допустимый диапазон значений 0 <= innerAngle <= outerAngle; значения вне этого диапазона могут привести к непредсказуемым результатам.

Значение по умолчанию:: 0
См. также:: getInnerAngle(), setInnerAngle(double)

внешнийУгол

public final DoubleProperty outerAngleProperty

Угол внешнего конуса прожектора в градусах (как показано на изображении в документации класса). Точка, угол которой до света больше этого угла, не получает света (spot = 0). Точка, угол которой до света меньше внешнего угла, но больше внутреннего угла, получает частичную интенсивность, регулируемую коэффициентом спада. Дополнительная информация в документации класса.

Допустимый диапазон значений innerAngle <= outerAngle <= 180; значения вне этого диапазона могут привести к непредсказуемым результатам.

Значение по умолчанию:: 30
См. также:: getOuterAngle(), setOuterAngle(double)

спада

public final DoubleProperty falloffProperty

Коэффициент спада интенсивности внешнего конуса прожектора. Точка, угол которой до света больше внутреннего угла, но меньше внешнего угла, получает частичную интенсивность, регулируемую этим фактором. Чем больше спад, тем резче падение интенсивности от внутреннего конуса. Коэффициент спада 1 обеспечивает линейное уменьшение интенсивности, значения больше 1 — выпуклое уменьшение, а значения меньше 1 — вогнутое уменьшение. Дополнительная информация в документации класса.

Допустимый диапазон значений 0 <= falloff; значения вне этого диапазона могут привести к непредсказуемым результатам.

Значение по умолчанию:: 1
См. также:: getFalloff(), setFalloff(double)

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

SpotLight

public SpotLight()

Создает новый экземпляр класса SpotLight с источником света по умолчанию.

SpotLight

public SpotLight(Color color)

Создает новый экземпляр класса SpotLight, используя указанный цвет.

Параметры:: color — цвет источника света

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

setDirection

public final void setDirection(Point3D value)

Устанавливает значение свойства direction.

Описание свойства:: Вектор направления прожектора. Его можно повернуть, задав преобразование вращения для SpotLight. Вектор не обязательно должен быть нормированным.
Значение по умолчанию:: Point3D(0, 0, 1)

getDirection

public final Point3D getDirection()

Получает значение свойства direction.

Описание свойства:: Вектор направления прожектора. Его можно повернуть, задав преобразование вращения для SpotLight. Вектор не обязательно должен быть нормированным.
Значение по умолчанию:: Point3D(0, 0, 1)

directionProperty

public final ObjectProperty<Point3D> directionProperty()

Значение по умолчанию:: Point3D(0, 0, 1)
См. также:: getDirection(), setDirection(Point3D)

setInnerAngle

public final void setInnerAngle(double value)

Устанавливает значение свойства innerAngle.

Описание свойства:: Угол внутреннего конуса прожектора в градусах. Точка, угол которой до света меньше этого угла, не ослабляется фактором прожектора (spot = 1). При больших углах интенсивность света начинает уменьшаться. Дополнительная информация в документации класса.
Допустимый диапазон значений 0 <= innerAngle <= outerAngle; значения вне этого диапазона могут привести к непредсказуемым результатам.
Значение по умолчанию:: 0

getInnerAngle

public final double getInnerAngle()

Получает значение свойства innerAngle.

Описание свойства:: Угол внутреннего конуса прожектора в градусах. Точка, угол которой до света меньше этого угла, не ослабляется фактором прожектора (spot = 1). При больших углах интенсивность света начинает уменьшаться. Дополнительная информация в документации класса.
Допустимый диапазон значений 0 <= innerAngle <= outerAngle; значения вне этого диапазона могут привести к непредсказуемым результатам.
Значение по умолчанию:: 0

innerAngleProperty

public final DoubleProperty innerAngleProperty()

Значение по умолчанию:: 0
См. также:: getInnerAngle(), setInnerAngle(double)

setOuterAngle

public final void setOuterAngle(double value)

Устанавливает значение свойства outerAngle.

Описание свойства:: Угол внешнего конуса прожектора в градусах (как показано на изображении в документации класса). Точка, угол которой до света больше этого угла, не получает света (spot = 0). Точка, угол которой до света меньше внешнего угла, но больше внутреннего угла, получает частичную интенсивность, регулируемую коэффициентом спада. Дополнительная информация в документации класса.
Допустимый диапазон значений innerAngle <= outerAngle <= 180; значения вне этого диапазона могут привести к непредсказуемым результатам.
Значение по умолчанию:: 30

getOuterAngle

public final double getOuterAngle()

Получает значение свойства outerAngle.

Описание свойства:: Угол внешнего конуса прожектора в градусах (как показано на изображении в документации класса). Точка, угол которой до света больше этого угла, не получает света (spot = 0). Точка, угол которой до света меньше внешнего угла, но больше внутреннего угла, получает частичную интенсивность, регулируемую коэффициентом спада. Дополнительная информация в документации класса.
Допустимый диапазон значений innerAngle <= outerAngle <= 180; значения вне этого диапазона могут привести к непредсказуемым результатам.
Значение по умолчанию:: 30

outerAngleProperty

public final DoubleProperty outerAngleProperty()

Значение по умолчанию:: 30
См. также:: getOuterAngle(), setOuterAngle(double)

setFalloff

public final void setFalloff(double value)

Устанавливает значение свойства falloff.

Описание свойства:: Коэффициент спада интенсивности внешнего конуса прожектора. Точка, угол которой до света больше внутреннего угла, но меньше внешнего угла, получает частичную интенсивность, регулируемую этим фактором. Чем больше спад, тем резче падение интенсивности от внутреннего конуса. Коэффициент спада 1 обеспечивает линейное уменьшение интенсивности, значения больше 1 — выпуклое уменьшение, а значения меньше 1 — вогнутое уменьшение. Дополнительная информация в документации класса.
Допустимый диапазон значений 0 <= falloff; значения вне этого диапазона могут привести к непредсказуемым результатам.
Значение по умолчанию:: 1

getFalloff

public final double getFalloff()

Получает значение свойства falloff.

Описание свойства:: Коэффициент спада интенсивности внешнего конуса прожектора. Точка, угол которой до света больше внутреннего угла, но меньше внешнего угла, получает частичную интенсивность, регулируемую этим фактором. Чем больше спад, тем резче падение интенсивности от внутреннего конуса. Коэффициент спада 1 обеспечивает линейное уменьшение интенсивности, значения больше 1 — выпуклое уменьшение, а значения меньше 1 — вогнутое уменьшение. Дополнительная информация в документации класса.
Допустимый диапазон значений 0 <= falloff; значения вне этого диапазона могут привести к непредсказуемым результатам.
Значение по умолчанию:: 1

falloffProperty

public final DoubleProperty falloffProperty()

Коэффициент спада интенсивности внешнего конуса прожектора. Точка, угол которой до света больше внутреннего, но меньше внешнего, получает частичную интенсивность, управляемую этим коэффициентом. Чем больше коэффициент спада, тем резче падение интенсивности от внутреннего конуса. Коэффициент спада 1 даёт линейное падение интенсивности, значения больше 1 — выпуклое падение, а значения меньше 1 — вогнутое. Подробности см. в документации класса.

Допустимый диапазон — 0 <= falloff; значения вне этого диапазона могут привести к непредсказуемым результатам.

Значение по умолчанию:: 1
См. также:: getFalloff(), setFalloff(double)

© 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.