Класс PointLight

javafx.scene.PointLight

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

Непосредственные подклассы:: SpotLight

public class PointLight extends LightBase

Источник света, равномерно излучающий свет во всех направлениях от себя. Расположение источника света — единственная точка в пространстве. Он затухает с помощью свойств constantAttenuation, linearAttenuation, quadraticAttenuation и maxRange.

PointLight могут представлять точечные источники света с незначительной или отсутствующей направленностью. Лампочки и свечи — распространенные источники света, которые можно смоделировать с помощью этого типа света.

С момента:

JavaFX 8.0

См. также:

PhongMaterial

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

Тип	Свойство	Описание
`final DoubleProperty`	`constantAttenuation`	Коэффициент постоянного затухания.
`final DoubleProperty`	`linearAttenuation`	Коэффициент линейного затухания.
`final DoubleProperty`	`maxRange`	Максимальный радиус действия этого `PointLight`.
`final DoubleProperty`	`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, focusVisible, focusWithin, 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

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

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

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

Модификатор и тип	Метод	Описание
`final DoubleProperty`	`constantAttenuationProperty()`	Коэффициент постоянного затухания.
`final double`	`getConstantAttenuation()`	Возвращает значение свойства `constantAttenuation`.
`final double`	`getLinearAttenuation()`	Возвращает значение свойства `linearAttenuation`.
`final double`	`getMaxRange()`	Возвращает значение свойства `maxRange`.
`final double`	`getQuadraticAttenuation()`	Возвращает значение свойства `quadraticAttenuation`.
`final DoubleProperty`	`linearAttenuationProperty()`	Коэффициент линейного затухания.
`final DoubleProperty`	`maxRangeProperty()`	Максимальный радиус действия этого `PointLight`.
`final DoubleProperty`	`quadraticAttenuationProperty()`	Коэффициент квадратичного затухания.
`final void`	`setConstantAttenuation(double value)`	Устанавливает значение свойства `constantAttenuation`.
`final void`	`setLinearAttenuation(double value)`	Устанавливает значение свойства `linearAttenuation`.
`final void`	`setMaxRange(double value)`	Устанавливает значение свойства `maxRange`.
`final void`	`setQuadraticAttenuation(double value)`	Устанавливает значение свойства `quadraticAttenuation`.

Методы, объявленные в классе 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, focusVisibleProperty, focusWithinProperty, 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, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, 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

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

maxRange

public final DoubleProperty maxRangeProperty

Максимальное расстояние до источника света для данного PointLight. Для того, чтобы пиксель был затронут этим светом, его расстояние до источника света должно быть меньше или равно максимальному расстоянию света. Любое отрицательное значение будет обработано как 0.

Более низкие значения maxRange могут обеспечить лучшую производительность, так как пиксели за пределами диапазона света не потребуют сложных вычислений. Формула затухания может быть использована для расчета реалистичного значения maxRange, найдя расстояние, где затухание достаточно близко к 0.

Элементы, находящиеся в пределах диапазона света, всё ещё могут быть исключены из воздействия света, удалив их из его scope (или включив их в его exclusion scope). Если известно, что элемент всегда находится за пределами диапазона света, его исключение из области видимости обеспечивает лучшую производительность.

Значение по умолчанию:

Double.POSITIVE_INFINITY

С версии:

См. также:

getMaxRange()
setMaxRange(double)
maxRangeProperty()

constantAttenuation

public final DoubleProperty constantAttenuationProperty

Коэффициент постоянного затухания. Это член ca в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

С версии:

См. также:

getConstantAttenuation()
setConstantAttenuation(double)
constantAttenuationProperty()

linearAttenuation

public final DoubleProperty linearAttenuationProperty

Коэффициент линейного затухания. Это член la в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

С версии:

См. также:

getLinearAttenuation()
setLinearAttenuation(double)
linearAttenuationProperty()

quadraticAttenuation

public final DoubleProperty quadraticAttenuationProperty

Коэффициент квадратичного затухания. Это член qa в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

С версии:

См. также:

getQuadraticAttenuation()
setQuadraticAttenuation(double)
quadraticAttenuationProperty()

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

PointLight

public PointLight()

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

PointLight

public PointLight(Color color)

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

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

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

setMaxRange

public final void setMaxRange(double value)

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

Описание свойства:

Значение по умолчанию:

Double.POSITIVE_INFINITY

Параметры:

value — значение для свойства maxRange

С версии:

См. также:

getMaxRange()
maxRangeProperty()

getMaxRange

public final double getMaxRange()

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

Описание свойства:

Значение по умолчанию:

Double.POSITIVE_INFINITY

Возвращает:

значение свойства maxRange

С версии:

См. также:

setMaxRange(double)
maxRangeProperty()

maxRangeProperty

public final DoubleProperty maxRangeProperty()

Значение по умолчанию:

Double.POSITIVE_INFINITY

Возвращает:

свойство maxRange

С версии:

См. также:

getMaxRange()
setMaxRange(double)

setConstantAttenuation

public final void setConstantAttenuation(double value)

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

Описание свойства:

Коэффициент постоянного затухания. Это член ca в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

Параметры:

value — значение для свойства constantAttenuation

С версии:

См. также:

getConstantAttenuation()
constantAttenuationProperty()

getConstantAttenuation

public final double getConstantAttenuation()

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

Описание свойства:

Коэффициент постоянного затухания. Это член ca в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

Возвращает:

значение свойства constantAttenuation

С версии:

См. также:

setConstantAttenuation(double)
constantAttenuationProperty()

constantAttenuationProperty

public final DoubleProperty constantAttenuationProperty()

Коэффициент постоянного затухания. Это член ca в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

Возвращает:

свойство constantAttenuation

С версии:

См. также:

getConstantAttenuation()
setConstantAttenuation(double)

УстановитьЛинейноеЗатухание

public final void setLinearAttenuation(double value)

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

Описание свойства:

Коэффициент линейного затухания. Это член la в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

Параметры:

value — значение для свойства linearAttenuation

С версии:

См. также:

getLinearAttenuation()
linearAttenuationProperty()

ПолучитьЛинейноеЗатухание

public final double getLinearAttenuation()

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

Описание свойства:

Коэффициент линейного затухания. Это член la в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

Возвращает:

значение свойства linearAttenuation

С версии:

См. также:

setLinearAttenuation(double)
linearAttenuationProperty()

свойствоЛинейногоЗатухания

public final DoubleProperty linearAttenuationProperty()

Коэффициент линейного затухания. Это член la в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

Возвращает:

свойство linearAttenuation

С версии:

См. также:

getLinearAttenuation()
setLinearAttenuation(double)

УстановитьКвадратичноеЗатухание

public final void setQuadraticAttenuation(double value)

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

Описание свойства:

Коэффициент квадратичного затухания. Это член qa в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

Параметры:

value — значение для свойства quadraticAttenuation

С версии:

См. также:

getQuadraticAttenuation()
quadraticAttenuationProperty()

ПолучитьКвадратичноеЗатухание

public final double getQuadraticAttenuation()

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

Описание свойства:

Коэффициент квадратичного затухания. Это член qa в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

Возвращает:

значение свойства quadraticAttenuation

С версии:

См. также:

setQuadraticAttenuation(double)
quadraticAttenuationProperty()

свойствоКвадратичногоЗатухания

public final DoubleProperty quadraticAttenuationProperty()

Коэффициент квадратичного затухания. Это член qa в формуле затухания:

attn = 1 / (ca + la * dist + qa * dist^2)

где dist — расстояние между источником света и пикселем.

Значение по умолчанию:

Возвращает:

свойство quadraticAttenuation

С версии:

См. также:

getQuadraticAttenuation()
setQuadraticAttenuation(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.