Класс RadialGradientPaint

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

Этот объект отрисовки отобразит первый цвет градиента в точке фокуса, а последний цвет — на окружности круга, плавно интерполируя любые промежуточные цвета, указанные пользователем. Любая линия, проведенная от точки фокуса к окружности, будет охватывать все цвета градиента.

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

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

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