Spec-Zone.ru › OpenJavaFX 21

Класс RadialGradient

java.lang.Object
javafx.scene.paint.Paint
javafx.scene.paint.RadialGradient
public final class RadialGradient extends Paint
Класс RadialGradient предоставляет способ заполнения фигуры радиальным цветовым градиентом по окружности. Пользователь может указать 2 или более цветов градиента, и эта покраска обеспечит интерполяцию между каждым цветом.

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

Центр и радиус задаются относительно единичного квадрата, если переменная proportional не равна false. По умолчанию значение proportional равно true, и градиент будет масштабироваться для заполнения любой фигуры, к которой он применяется. Точка фокуса всегда задаётся относительно центральной точки углом и расстоянием относительно радиуса.

Эта покраска сопоставит первый цвет градиента с точкой фокуса, а последний цвет с окружностью круга, плавно интерполируя для любых промежуточных цветов, указанных пользователем. Любая линия, проведенная от точки фокуса до окружности, таким образом, охватит все цвета градиента.

Расстояние до фокуса будет ограничено диапазоном (-1, 1), чтобы точка фокуса всегда находилась строго внутри круга.

Приложение предоставляет массив Stop, определяющий способ распределения цветов по градиенту. Переменная Stop#offset должна принимать значения от 0,0 до 1,0 и действовать как ключевые кадры вдоль градиента. Они отмечают, где градиент должен быть точно определённого цвета.

Since:
JavaFX 2.0

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

Конструктор Описание
RadialGradient(double focusAngle, double focusDistance, double centerX, double centerY, double radius, boolean proportional, CycleMethod cycleMethod, List<Stop> stops)
Создаёт новый экземпляр RadialGradient.
RadialGradient(double focusAngle, double focusDistance, double centerX, double centerY, double radius, boolean proportional, CycleMethod cycleMethod, Stop... stops)
Создаёт новый экземпляр RadialGradient.

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

Модификатор и тип Метод Описание
boolean equals(Object obj)
Указывает, является ли другой объект "равным" данному объекту.
final double getCenterX()
Определяет координату X центральной точки окружности, определяющей градиент.
final double getCenterY()
Определяет координату X центральной точки окружности, определяющей градиент.
final CycleMethod getCycleMethod()
Определяет метод цикла, применяемый к RadialGradient.
final double getFocusAngle()
Определяет угол в градусах от центра градиента до точки фокуса, к которой сопоставляется первый цвет.
final double getFocusDistance()
Определяет расстояние от центра градиента до точки фокуса, к которой сопоставляется первый цвет.
final double getRadius()
Устанавливает радиус окружности, определяющей границы цветового градиента.
final List<Stop> getStops()
Последовательность из 2 или более Stop значений, определяющих способ распределения цветов по градиенту.
int hashCode()
Возвращает хэш-код для данного объекта RadialGradient.
final boolean isOpaque()
Возвращает значение, указывающее, является ли данная покраска полностью непрозрачной.
final boolean isProportional()
Указывает, являются ли значения центра и радиуса пропорциональными или абсолютными.
String toString()
Возвращает строковое представление объекта RadialGradient.
static RadialGradient valueOf(String value)
Создаёт значение радиального градиента из строкового представления.

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

RadialGradient

public RadialGradient(double focusAngle, double focusDistance, double centerX, double centerY, double radius, boolean proportional, CycleMethod cycleMethod, Stop... stops)
Создаёт новый экземпляр RadialGradient.
Параметры:
focusAngle - угол в градусах от центра градиента до точки фокуса, к которой сопоставляется первый цвет
focusDistance - расстояние от центра градиента до точки фокуса, к которой сопоставляется первый цвет
centerX - координата X центральной точки окружности градиента
centerY - координата Y центральной точки окружности градиента
radius - радиус окружности, определяющей пределы цветового градиента
proportional - указывается ли, что координаты и размеры пропорциональны форме, которую заполняет этот градиент
cycleMethod - метод циклирования, применяемый к градиенту
stops - цветовое описание градиента

RadialGradient

public RadialGradient(double focusAngle, double focusDistance, double centerX, double centerY, double radius, boolean proportional, CycleMethod cycleMethod, List<Stop> stops)
Создаёт новый экземпляр RadialGradient.
Параметры:
focusAngle - угол в градусах от центра градиента до точки фокуса, к которой сопоставляется первый цвет
focusDistance - расстояние от центра градиента до точки фокуса, к которой сопоставляется первый цвет
centerX - координата X центральной точки окружности градиента
centerY - координата Y центральной точки окружности градиента
radius - радиус окружности, определяющей пределы цветового градиента
proportional - указывается ли, что координаты и размеры пропорциональны форме, которую заполняет этот градиент
cycleMethod - метод циклирования, применяемый к градиенту
stops - цветовое описание градиента

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

getFocusAngle

public final double getFocusAngle()
Определяет угол в градусах от центра градиента до точки фокуса, к которой сопоставляется первый цвет.
Возвращает:
угол в градусах от центра градиента до точки фокуса, к которой сопоставляется первый цвет

getFocusDistance

public final double getFocusDistance()
Определяет расстояние от центра градиента до точки фокуса, к которой сопоставляется первый цвет. Расстояние 0.0 будет в центре окружности градиента. Расстояние 1.0 будет на окружности градиента.
Возвращает:
расстояние от центра градиента до точки фокуса, к которой сопоставляется первый цвет

getCenterX

public final double getCenterX()
Определяет координату X центральной точки окружности, определяющей градиент. Если пропорционально равно true (по умолчанию), это значение определяет точку на единичном квадрате, которая будет масштабироваться для соответствия размеру формы, которую заполняет градиент. Последний цвет градиента сопоставляется с периметром этой окружности.
Значение по умолчанию:
0.0
Возвращает:
координата X центральной точки окружности, определяющей градиент

getCenterY

public final double getCenterY()
Определяет координату X центральной точки окружности, определяющей градиент. Если пропорционально равно true (по умолчанию), это значение определяет точку на единичном квадрате, которая будет масштабироваться для соответствия размеру формы, которую заполняет градиент. Последний цвет градиента сопоставляется с периметром этой окружности.
Значение по умолчанию:
0.0
Возвращает:
координата X центральной точки окружности, определяющей градиент

getRadius

public final double getRadius()
Указывает радиус окружности, определяющей пределы цветового градиента. Если пропорционально равно true (по умолчанию), это значение указывает размер относительно единичного квадрата, который будет масштабироваться для соответствия размеру формы, которую заполняет градиент.
Значение по умолчанию:
1.0
Возвращает:
радиус окружности, определяющей пределы цветового градиента

isProportional

public final boolean isProportional()
Указывает, являются ли значения центра и радиуса пропорциональными или абсолютными. Если этот флаг имеет значение true, центр и радиус определяются в пространстве координат, где координаты в диапазоне [0..1] масштабируются для сопоставления с границами формы, которую заполняет градиент. Если этот флаг имеет значение false, то координаты центра и радиус задаются в локальной системе координат узла.
Значение по умолчанию:
true
Возвращает:
true, если значения центра и радиуса пропорциональны, в противном случае - false

getCycleMethod

public final CycleMethod getCycleMethod()
Определяет метод циклирования, применяемый к RadialGradient. Один из: CycleMethod.NO_CYCLE, CycleMethod.REFLECT или CycleMethod.REPEAT.
Значение по умолчанию:
NO_CYCLE
Возвращает:
метод циклирования, применяемый к этому радиальному градиенту

getStops

public final List<Stop> getStops()
Последовательность из 2 или более значений Stop, определяющих, как распределить цвета по градиенту. Эти значения должны быть в диапазоне от 0,0 до 1,0. Они действуют как ключевые кадры вдоль градиента: они отмечают, где градиент должен быть точно определенного цвета.

Каждая точка остановки в последовательности должна иметь смещение, большее, чем предыдущая точка остановки в последовательности.

Список является неизменяемым и будет выбрасывать UnsupportedOperationException при каждой попытке модификации.

Значение по умолчанию:
пустой
Возвращает:
список значений Stop

isOpaque

public final boolean isOpaque()
Получает, является ли эта Paint полностью непрозрачной. Непрозрачная paint — это та, у которой нет компонента альфа в ни одном из её цветов. Возможно, Paint может быть непрозрачной, но вернуть false, если нельзя легко определить, действительно ли paint непрозрачная. Например, ImagePattern может не иметь возможности быстро определить свою непрозрачность.
Унаследовано от:
isOpaque в классе Paint
Возвращает:
true, если Paint непрозрачна, false, если она не непрозрачна или если это невозможно определить.
С тех пор:
JavaFX 8.0

equals

public boolean equals(Object obj)
Указывает, является ли какой-либо другой объект «равным» этому.
Переопределяет:
equals в классе Object
Параметры:
obj - объект-ссылка, с которым нужно сравнить.
Возвращает:
true, если этот объект равен переданному obj аргументу; false в противном случае.

hashCode

public int hashCode()
Возвращает хэш-код для этого объекта RadialGradient.
Переопределяет:
hashCode в классе Object
Возвращает:
хэш-код для этого объекта RadialGradient.

toString

public String toString()
Возвращает строковое представление этого объекта RadialGradient.
Переопределяет:
toString в классе Object
Возвращает:
строковое представление этого объекта RadialGradient.

valueOf

public static RadialGradient valueOf(String value)
Создаёт значение радиального градиента из строкового представления.

Формат строкового представления основан на спецификации JavaFX CSS для радиальных градиентов, которая является

 radial-gradient([focus-angle <angle>, ]?
                 [focus-distance <percentage>, ]?
                 [center <point>, ]?
                 radius [<length> | <percentage>],
                 [[repeat | reflect],]?
                 <color-stop>[, <color-stop>]+)
 
где
 <point> = [ [ <length> <length> ] | [ <percentage> | <percentage> ] ]
 <color-stop> = [ <color> [ <percentage> | <length>]? ]
 

В настоящее время длина может быть указана только в px, указание единицы может быть опущено. Формат представления цвета такой же, как в Color.web(String color). Ключевое слово radial-gradient можно опустить. Дополнительную информацию о формате строкового представления см. в Руководстве по CSS.

Примеры:

 RadialGradient g
      = RadialGradient.valueOf("radial-gradient(center 100px 100px, radius 200px, red  0%, blue 30%, black 100%)");
 RadialGradient g
      = RadialGradient.valueOf("center 100px 100px, radius 200px, red  0%, blue 30%, black 100%");
 RadialGradient g
      = RadialGradient.valueOf("radial-gradient(center 50% 50%, radius 50%,  cyan, violet 75%, magenta)");
 RadialGradient g
      = RadialGradient.valueOf("center 50% 50%, radius 50%,  cyan, violet 75%, magenta");
 
Параметры:
value - строка для преобразования
Возвращает:
объект RadialGradient, содержащий значение, представленное строковым аргументом.
Исключения:
NullPointerException - если value является null
IllegalArgumentException - если value не может быть проанализирован
С тех пор:
JavaFX 2.1

© 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