Класс RadialGradientPaint

Класс 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.

Параметр 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);

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

Конструкторы

RadialGradientPaint

public RadialGradientPaint(float cx,
                           float cy,
                           float radius,
                           float[] fractions,
                           Color[] colors)

Создаёт RadialGradientPaint с методом повторения по умолчанию и цветовым пространством по умолчанию, используя центр в качестве точки фокуса.

Параметры:

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

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

radius - радиус окружности, определяющий границы цветового градиента

fractions - числа от 0.0 до 1.0, определяющие распределение цветов по градиенту

colors - массив цветов для использования в градиенте. Первый цвет используется в точке фокуса, последний — на периметре окружности.

Исключения:

NullPointerException - если массив fractions null, или массив colors null

IllegalArgumentException - если radius не положительно, или fractions.length != colors.length, или colors имеет размер меньше 2, или значение fractions меньше 0.0 или больше 1.0, или цвета fractions не заданы в строго возрастающем порядке

RadialGradientPaint

public RadialGradientPaint(Point2D center,
                           float radius,
                           float[] fractions,
                           Color[] colors)

Создаёт RadialGradientPaint с методом повторения по умолчанию и цветовым пространством по умолчанию, используя центр в качестве точки фокуса.

Параметры:

center - центральная точка в пространстве пользователя окружности, определяющей градиент

radius - радиус окружности, определяющий границы цветового градиента

fractions - числа от 0.0 до 1.0, определяющие распределение цветов по градиенту

colors - массив цветов для использования в градиенте. Первый цвет используется в точке фокуса, последний — на периметре окружности.

Исключения:

NullPointerException - если точка center null, или массив fractions null, или массив colors null

IllegalArgumentException - если radius не положительно, или fractions.length != colors.length, или colors имеет размер меньше 2, или значение fractions меньше 0.0 или больше 1.0, или цвета fractions не заданы в строго возрастающем порядке

RadialGradientPaint

public RadialGradientPaint(float cx,
                           float cy,
                           float radius,
                           float[] fractions,
                           Color[] colors,
                           MultipleGradientPaint.CycleMethod cycleMethod)

Создаёт RadialGradientPaint с методом повторения по умолчанию и цветовым пространством по умолчанию, используя центр в качестве точки фокуса.

Параметры:

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

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

radius - радиус окружности, определяющий границы цветового градиента

fractions - числа от 0.0 до 1.0, определяющие распределение цветов по градиенту

colors - массив цветов для использования в градиенте. Первый цвет используется в точке фокуса, последний — на периметре окружности.

cycleMethod - метод цикла NO_CYCLE, REFLECT, или REPEAT

Исключения:

NullPointerException - если массив fractions null, или массив colors null, или cycleMethod null

IllegalArgumentException - если radius не положительно, или fractions.length != colors.length, или colors имеет размер меньше 2, или значение fractions меньше 0.0 или больше 1.0, или цвета fractions не заданы в строго возрастающем порядке

RadialGradientPaint

public RadialGradientPaint(Point2D center,
                           float radius,
                           float[] fractions,
                           Color[] colors,
                           MultipleGradientPaint.CycleMethod cycleMethod)

Создаёт RadialGradientPaint с цветовым пространством по умолчанию, используя центр в качестве точки фокуса.

Параметры:

center - центральная точка в пространстве пользователя окружности, определяющей градиент

radius - радиус окружности, определяющий границы цветового градиента

fractions - числа от 0.0 до 1.0, определяющие распределение цветов по градиенту

colors - массив цветов для использования в градиенте. Первый цвет используется в точке фокуса, последний — на периметре окружности.

cycleMethod - метод цикла NO_CYCLE, REFLECT, или REPEAT

Исключения:

NullPointerException - если точка center null, или массив fractions null, или массив colors null, или cycleMethod null

IllegalArgumentException - если radius не положительно, или fractions.length != colors.length, или colors имеет размер меньше 2, или значение 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)

Создаёт RadialGradientPaint с цветовым пространством по умолчанию.

Параметры:

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

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

radius - радиус окружности, определяющий границы цветового градиента

fx - координата X точки в пространстве пользователя, к которой сопоставляется первый цвет

fy - координата Y точки в пространстве пользователя, к которой сопоставляется первый цвет

fractions - числа от 0.0 до 1.0, определяющие распределение цветов по градиенту

colors - массив цветов для использования в градиенте. Первый цвет используется в точке фокуса, последний — на периметре окружности.

cycleMethod - метод цикла NO_CYCLE, REFLECT, или REPEAT

Исключения:

NullPointerException - если массив fractions null, или массив colors null, или cycleMethod null

IllegalArgumentException - если radius не положительно, или fractions.length != colors.length, или colors имеет размер меньше 2, или значение fractions меньше 0.0 или больше 1.0, или цвета fractions не заданы в строго возрастающем порядке

RadialGradientPaint

public RadialGradientPaint(Point2D center,
                           float radius,
                           Point2D focus,
                           float[] fractions,
                           Color[] colors,
                           MultipleGradientPaint.CycleMethod cycleMethod)

Создаёт RadialGradientPaint с цветовым пространством по умолчанию.

Параметры:

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

radius - радиус окружности, определяющий границы цветового градиента

focus - точка в пространстве пользователя, к которой сопоставляется первый цвет

fractions - числа от 0.0 до 1.0, определяющие распределение цветов по градиенту

colors - массив цветов для использования в градиенте. Первый цвет используется в точке фокуса, последний — на периметре окружности.

cycleMethod - метод цикла NO_CYCLE, REFLECT, или REPEAT

Исключения:

NullPointerException - если одна из точек null, или массив fractions null, или массив colors null, или cycleMethod null

IllegalArgumentException - если radius не положительно, или fractions.length != colors.length, или colors имеет размер меньше 2, или значение 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)

Создаёт RadialGradientPaint.

Параметры:

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

radius - радиус круга, определяющего границы цветового градиента

focus - точка в пространстве пользователя, к которой отображается первый цвет

fractions - числа от 0,0 до 1,0, определяющие распределение цветов по градиенту

colors - массив цветов для использования в градиенте. Первый цвет используется в фокусной точке, последний цвет — вокруг периметра круга.

cycleMethod - либо NO_CYCLE, либо REFLECT, либо REPEAT

colorSpace - цветовое пространство, используемое для интерполяции, либо SRGB или LINEAR_RGB

gradientTransform - преобразование, применяемое к градиенту

Исключения:

NullPointerException - если одна из точек равна null, или массив fractions равен null, или массив colors равен null, или cycleMethod равен null, или colorSpace равен null, или gradientTransform равен null

IllegalArgumentException - если radius неположительное, или fractions.length != colors.length, или colors имеет размер меньше 2, или значение fractions меньше 0,0 или больше 1,0, или значения fractions не указаны в строго возрастающем порядке

RadialGradientPaint

public RadialGradientPaint(Rectangle2D gradientBounds,
                           float[] fractions,
                           Color[] colors,
                           MultipleGradientPaint.CycleMethod cycleMethod)

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 равен null, или массив fractions равен null, или массив colors равен null, или cycleMethod равен null

IllegalArgumentException - если gradientBounds пуст, или fractions.length != colors.length, или colors имеет размер меньше 2, или значение fractions меньше 0,0 или больше 1,0, или значения fractions не указаны в строго возрастающем порядке

Методы

createContext

public PaintContext createContext(ColorModel cm,
                                  Rectangle deviceBounds,
                                  Rectangle2D userBounds,
                                  AffineTransform transform,
                                  RenderingHints hints)

Создаёт и возвращает PaintContext, используемый для генерации кругового радиального цветового градиента. См. описание метода createContext для информации об обработке параметров null.

Параметры:

cm - предпочтительная ColorModel, которая представляет наиболее удобный для вызывающего объекта формат для получения данных пикселей, или null если предпочтения нет.

deviceBounds - ограничивающая прямоугольная область в пространстве устройства для отображаемой графической примитива.

userBounds - ограничивающая прямоугольная область в пространстве пользователя для отображаемой графической примитива.

transform - AffineTransform из пространства пользователя в пространство устройства.

hints - набор подсказок, которые объект контекста может использовать для выбора между альтернативными способами отображения.

Возвращает:

PaintContext для генерации цветовых узоров.

См. также:

Paint, PaintContext, ColorModel, Rectangle, Rectangle2D, AffineTransform, RenderingHints

getCenterPoint

public Point2D getCenterPoint()

Возвращает копию центральной точки радиального градиента.

Возвращает:

объект Point2D, который является копией центральной точки

getFocusPoint

public Point2D getFocusPoint()

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

Возвращает:

объект Point2D, который является копией фокусной точки

getRadius

public float getRadius()

Возвращает радиус круга, определяющего радиальный градиент.

Возвращает:

радиус круга, определяющего радиальный градиент