Spec-Zone.ru › OpenJavaFX 21

Класс PhongMaterial

java.lang.Object
javafx.scene.paint.Material
javafx.scene.paint.PhongMaterial
public class PhongMaterial extends Material
Класс PhongMaterial предоставляет определения свойств, которые представляют материал с затенением Фонга. Он описывает взаимодействие света с поверхностью Mesh, к которому он применяется. PhongMaterial отражает свет с точки зрения диффузной и зеркальной составляющих вместе с окружающей и самоподсвечивающей составляющими. Цвет точки на геометрической поверхности является математической функцией этих четырёх составляющих.

Цвет вычисляется по следующему уравнению:


 for each ambient light source i {
     ambient += lightColor[i]
 }

 for each point light source i {
     diffuse += (L[i] . N) * lightColor[i]
     specular += ((R[i] . V) ^ (specularPower * intensity(specularMap))) * lightColor[i]
 }

 color = (ambient + diffuse) * diffuseColor * diffuseMap
             + specular * specularColor * specularMap
             + selfIlluminationMap
 
где lightColor[i] — цвет источника света i,
L[i] — вектор от поверхности до источника света i,
N — вектор нормали (с учётом bumpMap, если он присутствует),
R[i] — нормализованный отраженный вектор для L[i] относительно нормали поверхности,
а V — нормализованный вектор взгляда.
С момента:
JavaFX 8.0
См. также:
  • AmbientLight
  • PointLight

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

Тип Свойство Описание
final ObjectProperty<Image> bumpMap
Карта рельефа этого PhongMaterial, которая представляет собой карту нормалей, хранящуюся как RGB Image.
final ObjectProperty<Color> diffuseColor
Диффузный цвет этого PhongMaterial.
final ObjectProperty<Image> diffuseMap
Диффузная карта этого PhongMaterial.
final ObjectProperty<Image> selfIlluminationMap
Карта самоподсвечивания этого PhongMaterial.
final ObjectProperty<Color> specularColor
Зеркальный цвет этого PhongMaterial.
final ObjectProperty<Image> specularMap
Зеркальная карта этого PhongMaterial.
final DoubleProperty specularPower
Мощность зеркального отражения этого PhongMaterial.

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

Конструктор Описание
PhongMaterial()
Создаёт новый экземпляр класса PhongMaterial с свойством по умолчанию Color.WHITE diffuseColor.
PhongMaterial(Color diffuseColor)
Создаёт новый экземпляр класса PhongMaterial, используя указанный цвет для его свойства diffuseColor.
PhongMaterial(Color diffuseColor, Image diffuseMap, Image specularMap, Image bumpMap, Image selfIlluminationMap)
Создаёт новый экземпляр класса PhongMaterial, используя указанные цвета и изображения для его свойств diffuseColor.

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

Модификатор и тип Метод Описание
final ObjectProperty<Image> bumpMapProperty()
Карта рельефа этого PhongMaterial, которая представляет собой карту нормалей, хранящуюся как RGB Image.
final ObjectProperty<Color> diffuseColorProperty()
Диффузный цвет этого PhongMaterial.
final ObjectProperty<Image> diffuseMapProperty()
Диффузная карта этого PhongMaterial.
final Image getBumpMap()
Возвращает значение свойства bumpMap.
final Color getDiffuseColor()
Возвращает значение свойства diffuseColor.
final Image getDiffuseMap()
Возвращает значение свойства diffuseMap.
final Image getSelfIlluminationMap()
Возвращает значение свойства selfIlluminationMap.
final Color getSpecularColor()
Возвращает значение свойства specularColor.
final Image getSpecularMap()
Возвращает значение свойства specularMap.
final double getSpecularPower()
Возвращает значение свойства specularPower.
final ObjectProperty<Image> selfIlluminationMapProperty()
Карта самоподсвечивания этого PhongMaterial.
final void setBumpMap(Image value)
Устанавливает значение свойства bumpMap.
final void setDiffuseColor(Color value)
Устанавливает значение свойства diffuseColor.
final void setDiffuseMap(Image value)
Устанавливает значение свойства diffuseMap.
final void setSelfIlluminationMap(Image value)
Устанавливает значение свойства selfIlluminationMap.
final void setSpecularColor(Color value)
Устанавливает значение свойства specularColor.
final void setSpecularMap(Image value)
Устанавливает значение свойства specularMap.
final void setSpecularPower(double value)
Устанавливает значение свойства specularPower.
final ObjectProperty<Color> specularColorProperty()
Зеркальный цвет этого PhongMaterial.
final ObjectProperty<Image> specularMapProperty()
Зеркальная карта этого PhongMaterial.
final DoubleProperty specularPowerProperty()
Мощность зеркального отражения этого PhongMaterial.

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

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

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

diffuseColor

public final ObjectProperty<Color> diffuseColorProperty
Цвет рассеянного света этого PhongMaterial.
Значение по умолчанию:
Color.WHITE
См. также:
  • getDiffuseColor()
  • setDiffuseColor(Color)
  • diffuseColorProperty()

specularColor

public final ObjectProperty<Color> specularColorProperty
Цвет зеркального света этого PhongMaterial.
Значение по умолчанию:
null
См. также:
  • getSpecularColor()
  • setSpecularColor(Color)
  • specularColorProperty()

specularPower

public final DoubleProperty specularPowerProperty
Мощность зеркального света этого PhongMaterial.
Значение по умолчанию:
32.0
См. также:
  • getSpecularPower()
  • setSpecularPower(double)
  • specularPowerProperty()

diffuseMap

public final ObjectProperty<Image> diffuseMapProperty
Карта рассеянного света этого PhongMaterial.
Значение по умолчанию:
null
См. также:
  • getDiffuseMap()
  • setDiffuseMap(Image)
  • diffuseMapProperty()

specularMap

public final ObjectProperty<Image> specularMapProperty
Карта зеркального света этого PhongMaterial.
Значение по умолчанию:
null
См. также:
  • getSpecularMap()
  • setSpecularMap(Image)
  • specularMapProperty()

bumpMap

public final ObjectProperty<Image> bumpMapProperty
Карта рельефа этого PhongMaterial, которая является картой нормалей, хранящейся как RGB Image.
Значение по умолчанию:
null
См. также:
  • getBumpMap()
  • setBumpMap(Image)
  • bumpMapProperty()

selfIlluminationMap

public final ObjectProperty<Image> selfIlluminationMapProperty
Карта собственного освещения этого PhongMaterial.
Значение по умолчанию:
null
См. также:
  • getSelfIlluminationMap()
  • setSelfIlluminationMap(Image)
  • selfIlluminationMapProperty()

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

PhongMaterial

public PhongMaterial()
Создает новый экземпляр класса PhongMaterial с полем по умолчанию Color.WHITE diffuseColor.

PhongMaterial

public PhongMaterial(Color diffuseColor)
Создает новый экземпляр класса PhongMaterial, используя указанный цвет для свойства diffuseColor.
Параметры:
diffuseColor - цвет свойства diffuseColor

PhongMaterial

public PhongMaterial(Color diffuseColor, Image diffuseMap, Image specularMap, Image bumpMap, Image selfIlluminationMap)
Создает новый экземпляр класса PhongMaterial, используя указанные цвета и изображения для свойств diffuseColor.
Параметры:
diffuseColor - цвет свойства diffuseColor
diffuseMap - изображение свойства diffuseMap
specularMap - изображение свойства specularMap
bumpMap - изображение свойства bumpMap
selfIlluminationMap - изображение свойства selfIlluminationMap

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

setDiffuseColor

public final void setDiffuseColor(Color value)
Устанавливает значение свойства diffuseColor.
Описание свойства:
Цвет рассеянного света этого PhongMaterial.
Значение по умолчанию:
Color.WHITE
Параметры:
value - значение для свойства diffuseColor
См. также:
  • getDiffuseColor()
  • diffuseColorProperty()

getDiffuseColor

public final Color getDiffuseColor()
Получает значение свойства diffuseColor.
Описание свойства:
Цвет рассеянного света этого PhongMaterial.
Значение по умолчанию:
Color.WHITE
Возвращает:
значение свойства diffuseColor
См. также:
  • setDiffuseColor(Color)
  • diffuseColorProperty()

diffuseColorProperty

public final ObjectProperty<Color> diffuseColorProperty()
Цвет рассеянного света этого PhongMaterial.
Значение по умолчанию:
Color.WHITE
Возвращает:
свойство diffuseColor
См. также:
  • getDiffuseColor()
  • setDiffuseColor(Color)

setSpecularColor

public final void setSpecularColor(Color value)
Устанавливает значение свойства specularColor.
Описание свойства:
Цвет зеркального света этого PhongMaterial.
Значение по умолчанию:
null
Параметры:
value - значение для свойства specularColor
См. также:
  • getSpecularColor()
  • specularColorProperty()

getSpecularColor

public final Color getSpecularColor()
Получает значение свойства specularColor.
Описание свойства:
Цвет зеркального света этого PhongMaterial.
Значение по умолчанию:
null
Возвращает:
значение свойства specularColor
См. также:
  • setSpecularColor(Color)
  • specularColorProperty()

specularColorProperty

public final ObjectProperty<Color> specularColorProperty()
Цвет зеркального света этого PhongMaterial.
Значение по умолчанию:
null
Возвращает:
свойство specularColor
См. также:
  • getSpecularColor()
  • setSpecularColor(Color)

setSpecularPower

public final void setSpecularPower(double value)
Устанавливает значение свойства specularPower.
Описание свойства:
Мощность зеркального света этого PhongMaterial.
Значение по умолчанию:
32.0
Параметры:
value - значение для свойства specularPower
См. также:
  • getSpecularPower()
  • specularPowerProperty()

getSpecularPower

public final double getSpecularPower()
Получает значение свойства specularPower.
Описание свойства:
Мощность зеркального света этого PhongMaterial.
Значение по умолчанию:
32.0
Возвращает:
значение свойства specularPower
См. также:
  • setSpecularPower(double)
  • specularPowerProperty()

specularPowerProperty

public final DoubleProperty specularPowerProperty()
Мощность зеркального света этого PhongMaterial.
Значение по умолчанию:
32.0
Возвращает:
свойство specularPower
См. также:
  • getSpecularPower()
  • setSpecularPower(double)

Установить карту диффузного отражения

public final void setDiffuseMap(Image value)
Устанавливает значение свойства diffuseMap.
Описание свойства:
Карта диффузного отражения этого PhongMaterial.
Значение по умолчанию:
null
Параметры:
value - значение для свойства diffuseMap
См. также:
  • getDiffuseMap()
  • diffuseMapProperty()

Получить карту диффузного отражения

public final Image getDiffuseMap()
Получает значение свойства diffuseMap.
Описание свойства:
Карта диффузного отражения этого PhongMaterial.
Значение по умолчанию:
null
Возвращает:
значение свойства diffuseMap
См. также:
  • setDiffuseMap(Image)
  • diffuseMapProperty()

diffuseMapProperty

public final ObjectProperty<Image> diffuseMapProperty()
Карта диффузного отражения этого PhongMaterial.
Значение по умолчанию:
null
Возвращает:
свойство diffuseMap
См. также:
  • getDiffuseMap()
  • setDiffuseMap(Image)

Установить карту зеркального отражения

public final void setSpecularMap(Image value)
Устанавливает значение свойства specularMap.
Описание свойства:
Карта зеркального отражения этого PhongMaterial.
Значение по умолчанию:
null
Параметры:
value - значение для свойства specularMap
См. также:
  • getSpecularMap()
  • specularMapProperty()

Получить карту зеркального отражения

public final Image getSpecularMap()
Получает значение свойства specularMap.
Описание свойства:
Карта зеркального отражения этого PhongMaterial.
Значение по умолчанию:
null
Возвращает:
значение свойства specularMap
См. также:
  • setSpecularMap(Image)
  • specularMapProperty()

specularMapProperty

public final ObjectProperty<Image> specularMapProperty()
Карта зеркального отражения этого PhongMaterial.
Значение по умолчанию:
null
Возвращает:
свойство specularMap
См. также:
  • getSpecularMap()
  • setSpecularMap(Image)

Установить карту рельефа

public final void setBumpMap(Image value)
Устанавливает значение свойства bumpMap.
Описание свойства:
Карта рельефа этого PhongMaterial, которая представляет собой карту нормалей, хранящуюся как RGB Image.
Значение по умолчанию:
null
Параметры:
value - значение для свойства bumpMap
См. также:
  • getBumpMap()
  • bumpMapProperty()

Получить карту рельефа

public final Image getBumpMap()
Получает значение свойства bumpMap.
Описание свойства:
Карта рельефа этого PhongMaterial, которая представляет собой карту нормалей, хранящуюся как RGB Image.
Значение по умолчанию:
null
Возвращает:
значение свойства bumpMap
См. также:
  • setBumpMap(Image)
  • bumpMapProperty()

bumpMapProperty

public final ObjectProperty<Image> bumpMapProperty()
Карта рельефа этого PhongMaterial, которая представляет собой карту нормалей, хранящуюся как RGB Image.
Значение по умолчанию:
null
Возвращает:
свойство bumpMap
См. также:
  • getBumpMap()
  • setBumpMap(Image)

Установить карту самоосвещения

public final void setSelfIlluminationMap(Image value)
Устанавливает значение свойства selfIlluminationMap.
Описание свойства:
Карта самоосвещения этого PhongMaterial.
Значение по умолчанию:
null
Параметры:
value - значение для свойства selfIlluminationMap
См. также:
  • getSelfIlluminationMap()
  • selfIlluminationMapProperty()

Получить карту самоосвещения

public final Image getSelfIlluminationMap()
Получает значение свойства selfIlluminationMap.
Описание свойства:
Карта самоосвещения этого PhongMaterial.
Значение по умолчанию:
null
Возвращает:
значение свойства selfIlluminationMap
См. также:
  • setSelfIlluminationMap(Image)
  • selfIlluminationMapProperty()

selfIlluminationMapProperty

public final ObjectProperty<Image> selfIlluminationMapProperty()
Карта самоосвещения этого PhongMaterial.
Значение по умолчанию:
null
Возвращает:
свойство selfIlluminationMap
См. также:
  • getSelfIlluminationMap()
  • setSelfIlluminationMap(Image)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API