Класс PointLight

javafx.scene.PointLight

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

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

public class PointLight
extends LightBase

Источник света, который равномерно излучает свет во всех направлениях от себя. Положение источника света — это единственная точка в пространстве. Любой пиксель в пределах действия света будет освещён им, если он не принадлежит к Shape3D за пределами его scope.

Интенсивность света может уменьшаться с расстоянием за счёт его ослабления. Формула ослабления

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

определяет 3 коэффициента: ca, la и qa, которые управляют постоянным, линейным и квадратичным поведением уменьшения интенсивности с расстоянием соответственно. Эффективный цвет света в данной точке пространства определяется как color * attn. Можно, хотя и нереалистично, задавать отрицательные значения коэффициентов ослабления. Это позволяет получить отрицательный коэффициент ослабления, что приводит к тому, что цвет света вычитается из материала, а не добавляется к нему, тем самым создавая "источник тени".

Для реалистичного эффекта maxRange следует установить на расстояние, на котором ослабление близко к 0, так как это даст мягкое обрезание.

С:: JavaFX 8.0
См. также:: PhongMaterial

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

Свойства
Тип	Свойство	Описание
`DoubleProperty`	`constantAttenuation`	Коэффициент постоянного ослабления.
`DoubleProperty`	`linearAttenuation`	Коэффициент линейного ослабления.
`DoubleProperty`	`maxRange`	Максимальный радиус действия этого `PointLight`.
`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, 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` с источником света по умолчанию `Color.WHITE`.
`PointLight(Color color)`	Создаёт новый экземпляр класса `PointLight` с использованием указанного цвета.

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

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

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

maxRange

public final DoubleProperty maxRangeProperty

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

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

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

Значение по умолчанию:: Double.POSITIVE_INFINITY
С версии:: 16
См. также:: getMaxRange(), setMaxRange(double)

constantAttenuation

public final DoubleProperty constantAttenuationProperty

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

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

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

Значение по умолчанию:: 1
С версии:: 16
См. также:: getConstantAttenuation(), setConstantAttenuation(double)

linearAttenuation

public final DoubleProperty linearAttenuationProperty

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

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

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

Значение по умолчанию:: 0
С версии:: 16
См. также:: getLinearAttenuation(), setLinearAttenuation(double)

quadraticAttenuation

public final DoubleProperty quadraticAttenuationProperty

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

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

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

Значение по умолчанию:: 0
С версии:: 16
См. также:: getQuadraticAttenuation(), setQuadraticAttenuation(double)

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

PointLight

public PointLight()

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

PointLight

public PointLight(Color color)

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

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

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

setMaxRange

public final void setMaxRange(double value)

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

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

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

Double.POSITIVE_INFINITY

С версии:

getMaxRange

public final double getMaxRange()

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

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

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

Double.POSITIVE_INFINITY

С версии:

maxRangeProperty

public final DoubleProperty maxRangeProperty()

Значение по умолчанию:: Double.POSITIVE_INFINITY
С версии:: 16
См. также:: getMaxRange(), setMaxRange(double)

setConstantAttenuation

public final void setConstantAttenuation(double value)

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

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

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

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

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

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

С версии:

getConstantAttenuation

public final double getConstantAttenuation()

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

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

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

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

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

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

С версии:

constantAttenuationProperty

public final DoubleProperty constantAttenuationProperty()

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

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

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

Значение по умолчанию:: 1
С версии:: 16
См. также:: getConstantAttenuation(), setConstantAttenuation(double)

setLinearAttenuation

public final void setLinearAttenuation(double value)

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

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

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

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

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

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

С версии:

getLinearAttenuation

public final double getLinearAttenuation()

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

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

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

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

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

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

С версии:

linearAttenuationProperty

public final DoubleProperty linearAttenuationProperty()

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

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

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

Значение по умолчанию:: 0
С версии:: 16
См. также:: getLinearAttenuation(), setLinearAttenuation(double)

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

public final void setQuadraticAttenuation(double value)

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

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

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

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

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

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

С версии:

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

public final double getQuadraticAttenuation()

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

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

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

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

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

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

С версии:

СвойствоquadraticAttenuation

public final DoubleProperty quadraticAttenuationProperty()

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

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

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

Значение по умолчанию:: 0
С версии:: 16
См. также:: 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.