javafx.scene.paint

Класс 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 и действовать как ключевые кадры вдоль градиента. Они отмечают, где градиент должен быть точно определённого цвета.

С:

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()` Определяет, какой из следующих методов цикла применяется к `LinearGradient`: `CycleMethod.NO_CYCLE`, `CycleMethod.REFLECT` или `CycleMethod.REPEAT`.
`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 - угол в градусах от центра градиента до точки фокусировки, к которой сопоставляется первый цвет

RadialGradient

public RadialGradient(double focusAngle,
                      double focusDistance,
                      double centerX,
                      double centerY,
                      double radius,
                      boolean proportional,
                      CycleMethod cycleMethod,
                      List<Stop> stops)

Создаёт новый экземпляр RadialGradient.

Параметры:

focusAngle - угол в градусах от центра градиента до точки фокусировки, к которой сопоставляется первый цвет

Подробное описание методов
- getFocusAngle
```
public final double getFocusAngle()
```
  Определяет угол в градусах от центра градиента до точки фокусировки, к которой сопоставляется первый цвет.
- getFocusDistance
```
public final double getFocusDistance()
```
  Определяет расстояние от центра градиента до точки фокусировки, к которой сопоставляется первый цвет. Расстояние 0.0 будет в центре круга градиента. Расстояние 1.0 будет на окружности круга градиента.
- getCenterX
```
public final double getCenterX()
```
  Определяет координату X центральной точки круга, определяющего градиент. Если proportional true (по умолчанию), это значение определяет точку на единичном квадрате, которая будет масштабирована для соответствия размеру фигуры, которую заполняет градиент. Последний цвет градиента сопоставляется с периметром этого круга.
  
  Значение по умолчанию:
  
  0.0
- getCenterY
```
public final double getCenterY()
```
  Определяет координату Y центральной точки круга, определяющего градиент. Если proportional true (по умолчанию), это значение определяет точку на единичном квадрате, которая будет масштабирована для соответствия размеру фигуры, которую заполняет градиент. Последний цвет градиента сопоставляется с периметром этого круга.
  
  Значение по умолчанию:
  
  0.0
- getRadius
```
public final double getRadius()
```
  Задает радиус круга, определяющего границы градиента цвета. Если proportional true (по умолчанию), это значение задаёт размер относительно единичного квадрата, который будет масштабирован для соответствия размеру фигуры, которую заполняет градиент.
  
  Значение по умолчанию:
  
  1.0
- isProportional
```
public final boolean isProportional()
```
  Указывает, являются ли значения center и radius пропорциональными или абсолютными. Если этот флаг true, точка центра и радиус определяются в координатном пространстве, где координаты в диапазоне [0..1] масштабируются для сопоставления с границами фигуры, которую заполняет градиент. Если этот флаг false, то координаты центра и радиус задаются в локальной системе координат узла.
  
  Значение по умолчанию:
  
  true
- getCycleMethod
```
public final CycleMethod getCycleMethod()
```
  Определяет, какой из следующих методов циклирования применяется к LinearGradient: CycleMethod.NO_CYCLE, CycleMethod.REFLECT или CycleMethod.REPEAT.
  
  Значение по умолчанию:
  
  NO_CYCLE
- getStops
```
public final List<Stop> getStops()
```
  Последовательность из 2 или более значений Stop, определяющих, как распределять цвета по градиенту. Эти значения должны находиться в диапазоне от 0,0 до 1,0. Они действуют как ключевые кадры вдоль градиента: они отмечают, где градиент должен быть точно определенного цвета.
  Каждое значение в последовательности должно иметь смещение, большее, чем предыдущее значение.
  
  Список неизменяемый и будет выбрасывать UnsupportedOperationException при каждой попытке изменения.
  
  Значение по умолчанию:
  
  пустое
- isOpaque
```
public final boolean isOpaque()
```
  Описание скопировано из класса: Paint
  
  Определяет, является ли этот Paint полностью непрозрачным. Непрозрачный 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 - если строковое представление некорректно
  
  С тех пор как:
  
  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

RadialGradient

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

getFocusAngle

getFocusDistance

getCenterX

getCenterY

getRadius

isProportional

getCycleMethod

getStops

isOpaque

equals

hashCode

toString

valueOf