Класс 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 позволяет пользователю указать, в какой цветовой системе должна выполняться интерполяция, по умолчанию 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);

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