RadialGradient

java.lang.Object
- javafx.scene.paint.Paint
- - javafx.scene.paint.RadialGradient

```
public final class RadialGradient
extends Paint
```
Класс RadialGradient предоставляет способ заполнения фигуры радиальным цветовым градиентом. Пользователь может указать 2 или более цветов градиента, и эта покраска обеспечит интерполяцию между каждым цветом.
Пользователь должен указать окружность, управляющую шаблоном градиента, которая определяется центральной точкой и радиусом. Пользователь также может указать отдельную точку фокуса внутри этой окружности, которая контролирует расположение первого цвета градиента. По умолчанию фокус устанавливается в центр окружности.

Центр и радиус задаются относительно единичного квадрата, если переменная proportional имеет значение false. По умолчанию пропорционально равно 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()
```
  Определяет координату X центральной точки круга, определяющего градиент. Если proportional - true (по умолчанию), это значение задаёт точку на единичном квадрате, которая будет масштабирована для соответствия размеру формы, которую заполняет градиент. Последний цвет градиента отображается по периметру этого круга.
  
  Значение по умолчанию:
  
  0.0
  
  Возвращает:
  
  координата X центральной точки круга, определяющего градиент
- getRadius
```
public final double getRadius()
```
  Указывает радиус окружности, определяющей пределы цветового градиента. Если proportional - true (по умолчанию), это значение задаёт размер, относящийся к единичному квадрату, который будет масштабирован для соответствия размеру формы, которую заполняет градиент.
  
  Значение по умолчанию:
  
  1.0
  
  Возвращает:
  
  радиус окружности, определяющей пределы цветового градиента
- 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
- equals
```
public boolean equals(Object obj)
```
  Указывает, является ли некоторый другой объект "равным" этому.
  
  Переопределяет:
  
  equals в классе Object
  
  Параметры:
  
  obj - объект-ссылка для сравнения.
  
  Возвращает:
  
  true, если этот объект равен переданному аргументу; 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.

Класс RadialGradient

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

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

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

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

RadialGradient

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

getFocusAngle

getFocusDistance

getCenterX

getCenterY

getRadius

isProportional

getCycleMethod

getStops

isOpaque

equals

hashCode

toString

valueOf