Класс 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 |
Создаёт новый экземпляр RadialGradient. |
RadialGradient |
Создаёт новый экземпляр RadialGradient. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
equals |
Указывает, является ли другой объект "равным" данному объекту. |
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 |
Создаёт значение радиального градиента из строкового представления. |
Подробное описание конструкторов
RadialGradient
public RadialGradient(double focusAngle, double focusDistance, double centerX, double centerY, double radius, boolean proportional, CycleMethod cycleMethod, Stop... stops)
- Параметры:
-
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)
- Параметры:
-
focusAngle- угол в градусах от центра градиента до точки фокуса, к которой сопоставляется первый цвет -
focusDistance- расстояние от центра градиента до точки фокуса, к которой сопоставляется первый цвет -
centerX- координата X центральной точки окружности градиента -
centerY- координата Y центральной точки окружности градиента -
radius- радиус окружности, определяющей пределы цветового градиента -
proportional- указывается ли, что координаты и размеры пропорциональны форме, которую заполняет этот градиент -
cycleMethod- метод циклирования, применяемый к градиенту -
stops- цветовое описание градиента
Подробное описание методов
getFocusAngle
public final double getFocusAngle()
- Возвращает:
- угол в градусах от центра градиента до точки фокуса, к которой сопоставляется первый цвет
getFocusDistance
public final double getFocusDistance()
- Возвращает:
- расстояние от центра градиента до точки фокуса, к которой сопоставляется первый цвет
getCenterX
public final double getCenterX()
- Значение по умолчанию:
- 0.0
- Возвращает:
- координата X центральной точки окружности, определяющей градиент
getCenterY
public final double getCenterY()
- Значение по умолчанию:
- 0.0
- Возвращает:
- координата X центральной точки окружности, определяющей градиент
getRadius
public final double getRadius()
- Значение по умолчанию:
- 1.0
- Возвращает:
- радиус окружности, определяющей пределы цветового градиента
isProportional
public final boolean isProportional()
[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()
Stop, определяющих, как распределить цвета по градиенту. Эти значения должны быть в диапазоне от 0,0 до 1,0. Они действуют как ключевые кадры вдоль градиента: они отмечают, где градиент должен быть точно определенного цвета. Каждая точка остановки в последовательности должна иметь смещение, большее, чем предыдущая точка остановки в последовательности.
Список является неизменяемым и будет выбрасывать UnsupportedOperationException при каждой попытке модификации.
- Значение по умолчанию:
- пустой
- Возвращает:
- список значений Stop
isOpaque
public final boolean isOpaque()
- Унаследовано от:
-
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.