Класс RadialGradient

java.lang.Object

javafx.scene.paint.Paint

javafx.scene.paint.RadialGradient

Все реализуемые интерфейсы:: Interpolatable<Paint>

public final class RadialGradient extends Paint

Класс RadialGradient предоставляет способ заполнения фигуры радиальным цветовым градиентом по окружности. Пользователь может указать 2 или более цветов градиента, и эта покраска обеспечит интерполяцию между каждым цветом.

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

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

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

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

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

С тех пор:: 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`.
`Paint`	`interpolate(Paint endValue, double t)`	Возвращает промежуточное значение между значением этого объекта `Interpolatable` и указанным объектом `endValue`, используя коэффициент линейной интерполяции `t`, изменяющийся от 0 (включительно) до 1 (включительно).
`RadialGradient`	`interpolate(RadialGradient endValue, double t)`	Возвращает промежуточное значение между значением этого объекта `RadialGradient` и указанным объектом `endValue`, используя коэффициент линейной интерполяции `t`, изменяющийся от 0 (включительно) до 1 (включительно).
`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 центральной точки круга, определяющего градиент. Если proportional равен true (по умолчанию), это значение задаёт точку на единичном квадрате, которая будет масштабирована для соответствия размеру фигуры, которую заполняет градиент. Последний цвет градиента отображается по периметру этого круга.

Значение по умолчанию:: 0.0
Тип интерполяции:: линейный, если оба значения абсолютные или оба значения proportional, дискретный в противном случае
Возвращает:: координата X центральной точки круга, определяющего градиент

getCenterY

public final double getCenterY()

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

Значение по умолчанию:: 0.0
Тип интерполяции:: линейный если оба значения абсолютные или оба значения proportional, дискретный в противном случае
Возвращает:: координата Y центральной точки круга, определяющего градиент

getRadius

public final double getRadius()

Указывает радиус круга, определяющего границы цветового градиента. Если proportional равен true (по умолчанию), это значение задаёт размер, относительный к единичному квадрату, который будет масштабирован для соответствия размеру фигуры, которую заполняет градиент.

Значение по умолчанию:: 1.0
Тип интерполяции:: линейный если оба значения абсолютные или оба значения proportional, дискретный в противном случае
Возвращает:: радиус круга, определяющего границы цветового градиента

isProportional

public final boolean isProportional()

Указывает, являются ли значения центра и радиуса пропорциональными или абсолютными. Если этот флаг равен true, центральная точка и радиус определяются в системе координат, где координаты в диапазоне [0..1] масштабируются для отображения на границах фигуры, которую заполняет градиент. Если этот флаг равен false, то координаты центра и радиус задаются в локальной системе координат узла.

Значение по умолчанию:: true
Тип интерполяции:: дискретный
Возвращает:: true, если значения центра и радиуса пропорциональны, иначе абсолютные

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

interpolate

public RadialGradient interpolate(RadialGradient endValue, double t)

Возвращает промежуточное значение между значением этого RadialGradient и указанным endValue, используя линейный коэффициент интерполяции t, изменяющийся от 0 (включительно) до 1 (включительно).

Параметры:: endValue - целевое значение; t - коэффициент интерполяции
Возвращает:: промежуточное значение
Исключения:: NullPointerException - если endValue равен null
С:: 24

interpolate

public Paint interpolate(Paint endValue, double t)

Возвращает промежуточное значение между значением этого Interpolatable и указанным endValue, используя линейный коэффициент интерполяции t, изменяющийся от 0 (включительно) до 1 (включительно).

Возвращаемое значение может не быть новым экземпляром; реализация может также вернуть один из двух существующих экземпляров, если промежуточное значение будет равно одному из существующих значений. Однако это оптимизация, и приложения не должны предполагать какой-либо особой идентичности возвращаемого значения.

Параметры:: endValue - целевое значение; t - коэффициент интерполяции
Возвращает:: промежуточное значение
Исключения:: NullPointerException - если endValue равен null
С:: 24

equals

public boolean equals(Object obj)

Указывает, является ли какой-либо другой объект "равным" данному.

Overrides:: equals в классе Object
Параметры:: obj - объект ссылки для сравнения.
Возвращает:: true, если этот объект равен переданному аргументу; false в противном случае.

hashCode

public int hashCode()

Возвращает хеш-код для этого объекта RadialGradient.

Overrides:: hashCode в классе Object
Возвращает:: хеш-код для этого объекта RadialGradient.

toString

public String toString()

Возвращает строковое представление этого объекта RadialGradient.

Overrides:: 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.