Spec-Zone.ru › OpenJavaFX 17

Класс 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)
Указывает, является ли другой объект "равным" этому.
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)
Создаёт значение радиального градиента из строкового представления.

Методы, объявленные в классе 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
Возвращает:
координата X центральной точки окружности, определяющей градиент

getCenterY

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

getRadius

public final double getRadius()
Указывает радиус окружности, определяющей границы цветового градиента. Если proportional = 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