RadialGradientPaint (Платформа Java SE 7)

java.lang. Объект
- java.awt. MultipleGradientPaint
- - java.awt. RadialGradientPaint

Все Реализованные Интерфейсы:

Краска, Прозрачность
```
public final class RadialGradientPaint
extends MultipleGradientPaint
```
RadialGradientPaint класс обеспечивает способ заполнить форму круговым радиальным цветным образцом градиента. Пользователь может определить 2 или больше цвета градиента, и эта краска обеспечит интерполяцию между каждым цветом.
Пользователь должен определить круг, управляющий образцом градиента, который описывается центральной точкой и радиусом. Пользователь может также определить отдельный фокус в пределах того круга, который управляет расположением первого цвета градиента. По умолчанию фокус устанавливается быть центром круга.
Эта краска отобразит первый цвет градиента к фокусу, и последний цвет к периметру круга, интерполируя гладко для любых промежуточных цветов, определенных пользователем. Любая, проведенная от фокуса до окружности, таким образом охватит все цвета градиента.
Определение фокуса за пределами радиуса круга заставит кольца образца градиента центрироваться на точке только в краю круга в направлении фокуса. Рендеринг будет внутренне использовать это измененное расположение, как будто это был указанный фокус.
Пользователь должен предоставить массиву плаваний, определяющих, как распределить цвета вдоль градиента. Эти значения должны колебаться от 0.0 до 1.0 и действие как ключевые кадры вдоль градиента (они отмечают, где градиент должен быть точно определенным цветом).
Когда пользователь не устанавливает первое значение ключевого кадра, равное 0, и/или последний ключевой кадр оценивают равный 1, ключевые кадры будут создаваться в этих позициях, и первые и последние цвета будут тиражированы там. Так, если пользователь определяет следующие массивы, чтобы создать градиент:
```
     {Color.BLUE, Color.RED}, {.3f, .7f}
 
```
это будет преобразовано в градиент со следующими ключевыми кадрами:
```
     {Color.BLUE, Color.BLUE, Color.RED, Color.RED}, {0f, .3f, .7f, 1f}
 
```
Пользователь может также выбрать что действие RadialGradientPaint объект берет, когда он заполняет пространство вне радиуса круга, устанавливая CycleMethod к также REFLECTION или REPEAT. Пропорции цвета градиента равны для любой определенной, проведенной от фокуса. Следующие данные показывают, что AB расстояния равен BC расстояния, и AD расстояния равен расстоянию DE.
Если градиент и графические преобразования рендеринга однородно масштабируются, и пользователь устанавливает фокус так, чтобы это совпало с центром круга, пропорции цвета градиента равны для любой, проведенной от центра. Следующие данные показывают AB расстояний, BC, AD, и DE. Они все равны. Отметьте, что некоторые незначительные изменения в расстояниях могут произойти из-за выборки при гранулярности пикселя. Если никакой метод цикла не определяется, NO_CYCLE будет выбран по умолчанию, что означает, последний цвет ключевого кадра будет использоваться, чтобы заполнить остающуюся область.
colorSpace параметр позволяет пользователю определять, в котором colorspace интерполяция должна быть выполнена, значение по умолчанию sRGB или линеаризовавший RGB.
Следующий код демонстрирует типичное использование RadialGradientPaint, где центр и фокусы являются тем же самым:
```
     Point2D center = new Point2D.Float(50, 50);
     float radius = 25;
     float[] dist = {0.0f, 0.2f, 1.0f};
     Color[] colors = {Color.RED, Color.WHITE, Color.BLUE};
     RadialGradientPaint p =
         new RadialGradientPaint(center, radius, dist, colors);
 
```
Это изображение демонстрирует пример кода выше со значением по умолчанию (центрируемый) фокус для каждого из трех методов цикла:

Также возможно определить нецентрируемый фокус, как в следующем коде:
```
     Point2D center = new Point2D.Float(50, 50);
     float radius = 25;
     Point2D focus = new Point2D.Float(40, 40);
     float[] dist = {0.0f, 0.2f, 1.0f};
     Color[] colors = {Color.RED, Color.WHITE, Color.BLUE};
     RadialGradientPaint p =
         new RadialGradientPaint(center, radius, focus,
                                 dist, colors,
                                 CycleMethod.NO_CYCLE);
 
```
Это изображение демонстрирует предыдущий пример кода с нецентрируемым фокусом для каждого из трех методов цикла:
С тех пор:

1.6

См. Также:
Paint, Graphics2D.setPaint(java.awt.Paint)

Вложенная Сводка Класса
- Вложенные классы/интерфейсы java.awt унаследованный от класса. MultipleGradientPaint
  MultipleGradientPaint.ColorSpaceType, MultipleGradientPaint.CycleMethod

Полевая Сводка
- Поля, наследованные от интерфейса java.awt. Прозрачность
  BITMASK, OPAQUE, TRANSLUCENT

Сводка конструктора

Конструкторы
Конструктор и Описание
`RadialGradientPaint(float cx, float cy, float radius, float[] fractions, Color[] colors)` Конструкции a `RadialGradientPaint` со значением по умолчанию `NO_CYCLE` повторение метода и `SRGB` цветовое пространство, используя центр в качестве фокуса.
`RadialGradientPaint(float cx, float cy, float radius, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` Конструкции a `RadialGradientPaint` со значением по умолчанию `SRGB` цветовое пространство, используя центр в качестве фокуса.
`RadialGradientPaint(float cx, float cy, float radius, float fx, float fy, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` Конструкции a `RadialGradientPaint` со значением по умолчанию `SRGB` цветовое пространство.
`RadialGradientPaint(Point2D center, float radius, float[] fractions, Color[] colors)` Конструкции a `RadialGradientPaint` со значением по умолчанию `NO_CYCLE` повторение метода и `SRGB` цветовое пространство, используя центр в качестве фокуса.
`RadialGradientPaint(Point2D center, float radius, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` Конструкции a `RadialGradientPaint` со значением по умолчанию `SRGB` цветовое пространство, используя центр в качестве фокуса.
`RadialGradientPaint(Point2D center, float radius, Point2D focus, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` Конструкции a `RadialGradientPaint` со значением по умолчанию `SRGB` цветовое пространство.
`RadialGradientPaint(Point2D center, float radius, Point2D focus, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod, MultipleGradientPaint.ColorSpaceType colorSpace, AffineTransform gradientTransform)` Конструкции a `RadialGradientPaint`.
`RadialGradientPaint(Rectangle2D gradientBounds, float[] fractions, Color[] colors, MultipleGradientPaint.CycleMethod cycleMethod)` Конструкции a `RadialGradientPaint` со значением по умолчанию `SRGB` цветовое пространство.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`PaintContext`	`createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform transform, RenderingHints hints)` Создает и возвращает a `PaintContext` используемый, чтобы генерировать круговой радиальный цветной образец градиента.
`Point2D`	`getCenterPoint()` Возвращает копию центральной точки радиального градиента.
`Point2D`	`getFocusPoint()` Возвращает копию фокуса радиального градиента.
`float`	`getRadius()` Возвращает радиус круга, определяющего радиальный градиент.

Методы java.awt унаследованный от класса. MultipleGradientPaint
getColors, getColorSpace, getCycleMethod, getFractions, getTransform, getTransparency

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - RadialGradientPaint
```
public RadialGradientPaint(float cx,
                   float cy,
                   float radius,
                   float[] fractions,
                   Color[] colors)
```
    Конструкции a RadialGradientPaint со значением по умолчанию NO_CYCLE повторение метода и SRGB цветовое пространство, используя центр в качестве фокуса.
    
    Параметры:
    cx - эти X координат в пространстве пользователя центральной точки круга, определяющего градиент. Последний цвет градиента отображается на периметр этого круга.
    cy - Y координируют в пространстве пользователя центральной точки круга, определяющего градиент. Последний цвет градиента отображается на периметр этого круга.
    radius - радиус круга, определяющего степени цветного градиента
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, чтобы использовать в градиенте. Первый цвет используется в фокусе, последнем цвете вокруг периметра круга.
    
    Броски:
    
    NullPointerException - если fractions массив является нулем, или colors массив является нулем
    
    IllegalArgumentException - если radius неположительно, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - RadialGradientPaint
```
public RadialGradientPaint(Point2D center,
                   float radius,
                   float[] fractions,
                   Color[] colors)
```
    Конструкции a RadialGradientPaint со значением по умолчанию NO_CYCLE повторение метода и SRGB цветовое пространство, используя центр в качестве фокуса.
    
    Параметры:
    center - центральная точка, в пространстве пользователя, круга, определяющего градиент
    radius - радиус круга, определяющего степени цветного градиента
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, чтобы использовать в градиенте. Первый цвет используется в фокусе, последнем цвете вокруг периметра круга.
    
    Броски:
    
    NullPointerException - если center точка является нулем, или fractions массив является нулем, или colors массив является нулем
    
    IllegalArgumentException - если radius неположительно, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - RadialGradientPaint
```
public RadialGradientPaint(float cx,
                   float cy,
                   float radius,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    Конструкции a RadialGradientPaint со значением по умолчанию SRGB цветовое пространство, используя центр в качестве фокуса.
    
    Параметры:
    cx - эти X координат в пространстве пользователя центральной точки круга, определяющего градиент. Последний цвет градиента отображается на периметр этого круга.
    cy - Y координируют в пространстве пользователя центральной точки круга, определяющего градиент. Последний цвет градиента отображается на периметр этого круга.
    radius - радиус круга, определяющего степени цветного градиента
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, чтобы использовать в градиенте. Первый цвет используется в фокусе, последнем цвете вокруг периметра круга.
    cycleMethod - также NO_CYCLE, REFLECT, или REPEAT
    
    Броски:
    
    NullPointerException - если fractions массив является нулем, или colors массив является нулем, или cycleMethod нуль
    
    IllegalArgumentException - если radius неположительно, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - RadialGradientPaint
```
public RadialGradientPaint(Point2D center,
                   float radius,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    Конструкции a RadialGradientPaint со значением по умолчанию SRGB цветовое пространство, используя центр в качестве фокуса.
    
    Параметры:
    center - центральная точка, в пространстве пользователя, круга, определяющего градиент
    radius - радиус круга, определяющего степени цветного градиента
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, чтобы использовать в градиенте. Первый цвет используется в фокусе, последнем цвете вокруг периметра круга.
    cycleMethod - также NO_CYCLE, REFLECT, или REPEAT
    
    Броски:
    
    NullPointerException - если center точка является нулем, или fractions массив является нулем, или colors массив является нулем, или cycleMethod нуль
    
    IllegalArgumentException - если radius неположительно, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - RadialGradientPaint
```
public RadialGradientPaint(float cx,
                   float cy,
                   float radius,
                   float fx,
                   float fy,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    Конструкции a RadialGradientPaint со значением по умолчанию SRGB цветовое пространство.
    
    Параметры:
    cx - эти X координат в пространстве пользователя центральной точки круга, определяющего градиент. Последний цвет градиента отображается на периметр этого круга.
    cy - Y координируют в пространстве пользователя центральной точки круга, определяющего градиент. Последний цвет градиента отображается на периметр этого круга.
    radius - радиус круга, определяющего степени цветного градиента
    fx - X координат точки в пространстве пользователя, на которое отображается первый цвет
    fy - координата Y точки в пространстве пользователя, на которое отображается первый цвет
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, чтобы использовать в градиенте. Первый цвет используется в фокусе, последнем цвете вокруг периметра круга.
    cycleMethod - также NO_CYCLE, REFLECT, или REPEAT
    
    Броски:
    
    NullPointerException - если fractions массив является нулем, или colors массив является нулем, или cycleMethod нуль
    
    IllegalArgumentException - если radius неположительно, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - RadialGradientPaint
```
public RadialGradientPaint(Point2D center,
                   float radius,
                   Point2D focus,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    Конструкции a RadialGradientPaint со значением по умолчанию SRGB цветовое пространство.
    
    Параметры:
    center - центральная точка, в пространстве пользователя, круга, определяющего градиент. Последний цвет градиента отображается на периметр этого круга.
    radius - радиус круга, определяющего степени цветного градиента
    focus - точка в пространстве пользователя, на которое отображается первый цвет
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, чтобы использовать в градиенте. Первый цвет используется в фокусе, последнем цвете вокруг периметра круга.
    cycleMethod - также NO_CYCLE, REFLECT, или REPEAT
    
    Броски:
    
    NullPointerException - если одна из точек является нулем, или fractions массив является нулем, или colors массив является нулем, или cycleMethod нуль
    
    IllegalArgumentException - если radius неположительно, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - RadialGradientPaint
```
@ConstructorProperties(value={"centerPoint","radius","focusPoint","fractions","colors","cycleMethod","colorSpace","transform"})
public RadialGradientPaint(Point2D center,
                                              float radius,
                                              Point2D focus,
                                              float[] fractions,
                                              Color[] colors,
                                              MultipleGradientPaint.CycleMethod cycleMethod,
                                              MultipleGradientPaint.ColorSpaceType colorSpace,
                                              AffineTransform gradientTransform)
```
    Конструкции a RadialGradientPaint.
    
    Параметры:
    center - центральная точка в пространстве пользователя круга, определяющего градиент. Последний цвет градиента отображается на периметр этого круга.
    radius - радиус круга, определяющего степени цветного градиента
    focus - точка в пространстве пользователя, на которое отображается первый цвет
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, чтобы использовать в градиенте. Первый цвет используется в фокусе, последнем цвете вокруг периметра круга.
    cycleMethod - также NO_CYCLE, REFLECT, или REPEAT
    colorSpace - какое цветовое пространство использовать для интерполяции, также SRGB или LINEAR_RGB
    gradientTransform - преобразуйте, чтобы примениться к градиенту
    
    Броски:
    
    NullPointerException - если одна из точек является нулем, или fractions массив является нулем, или colors массив является нулем, или cycleMethod нуль, или colorSpace нуль, или gradientTransform нуль
    
    IllegalArgumentException - если radius неположительно, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
  - RadialGradientPaint
```
public RadialGradientPaint(Rectangle2D gradientBounds,
                   float[] fractions,
                   Color[] colors,
                   MultipleGradientPaint.CycleMethod cycleMethod)
```
    Конструкции a RadialGradientPaint со значением по умолчанию SRGB цветовое пространство. Круг градиента RadialGradientPaint определяется данным ограничивающим прямоугольником.
    Этот конструктор является более удобным способом выразить следующий (эквивалентный) код:
```
     double gw = gradientBounds.getWidth();
     double gh = gradientBounds.getHeight();
     double cx = gradientBounds.getCenterX();
     double cy = gradientBounds.getCenterY();
     Point2D center = new Point2D.Double(cx, cy);

     AffineTransform gradientTransform = new AffineTransform();
     gradientTransform.translate(cx, cy);
     gradientTransform.scale(gw / 2, gh / 2);
     gradientTransform.translate(-cx, -cy);

     RadialGradientPaint gp =
         new RadialGradientPaint(center, 1.0f, center,
                                 fractions, colors,
                                 cycleMethod,
                                 ColorSpaceType.SRGB,
                                 gradientTransform);
 
```
    Параметры:
    gradientBounds - ограничивающий прямоугольник, в пространстве пользователя, круга, определяющего наиболее удаленную степень градиента
    fractions - числа в пределах от 0.0 к 1.0 определениям распределения цветов вдоль градиента
    colors - массив цветов, чтобы использовать в градиенте. Первый цвет используется в фокусе, последнем цвете вокруг периметра круга.
    cycleMethod - также NO_CYCLE, REFLECT, или REPEAT
    
    Броски:
    
    NullPointerException - если gradientBounds нуль, или fractions массив является нулем, или colors массив является нулем, или cycleMethod нуль
    
    IllegalArgumentException - если gradientBounds пусто, или fractions.length != colors.length, или colors меньше чем 2 в размере, или a fractions значение - меньше чем 0.0 или больше чем 1.0, или fractions не обеспечиваются в строго увеличивающемся порядке
- Деталь метода
  - createContext
```
public PaintContext createContext(ColorModel cm,
                         Rectangle deviceBounds,
                         Rectangle2D userBounds,
                         AffineTransform transform,
                         RenderingHints hints)
```
    Создает и возвращает a PaintContext используемый, чтобы генерировать круговой радиальный цветной образец градиента. См. описание createContext метод для информации о нулевой обработке параметра.
    
    Параметры:
    cm - привилегированное ColorModel который представляет самый удобный формат для вызывающей стороны, чтобы получить пиксельные данные, или null если нет никакого предпочтения.
    deviceBounds - ограничивающий прямоугольник пространства устройства представляемого графического примитива.
    userBounds - ограничивающий прямоугольник пространства пользователя представляемого графического примитива.
    transform - AffineTransform от пространства пользователя в пространство устройства.
    hints - набор подсказок, что объект контекста может использовать, чтобы выбрать между рендерингом альтернатив.
    
    Возвраты:
    PaintContext для того, чтобы генерировать цветные узоры.
    См. Также:
    Paint, PaintContext, ColorModel, Rectangle, Rectangle2D, AffineTransform, RenderingHints
  - getCenterPoint
```
public Point2D getCenterPoint()
```
    Возвращает копию центральной точки радиального градиента.
    
    Возвраты:
    a Point2D объект, который является копией центральной точки
  - getFocusPoint
```
public Point2D getFocusPoint()
```
    Возвращает копию фокуса радиального градиента. Отметьте, что, если фокус, определенный, когда радиальный градиент был создан, находится за пределами радиуса круга, этот метод все еще возвратит исходный фокус даже при том, что рендеринг может центрировать кольца цвета на различной точке, которая находится в радиусе.
    
    Возвраты:
    a Point2D объект, который является копией фокуса
  - getRadius
```
public float getRadius()
```
    Возвращает радиус круга, определяющего радиальный градиент.
    
    Возвраты:
    радиус круга, определяющего радиальный градиент

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс RadialGradientPaint

Вложенная Сводка Класса

Вложенные классы/интерфейсы java.awt унаследованный от класса. MultipleGradientPaint

Полевая Сводка

Поля, наследованные от интерфейса java.awt. Прозрачность

Сводка конструктора

Сводка метода

Методы java.awt унаследованный от класса. MultipleGradientPaint

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

RadialGradientPaint

Деталь метода

createContext

getCenterPoint

getFocusPoint

getRadius