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