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

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