Класс LinearGradientPaint

public final class LinearGradientPaint extends MultipleGradientPaint

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

Пользователь должен предоставить массив чисел с плавающей точкой, определяющий распределение цветов по градиенту. Эти значения должны быть в диапазоне от 0,0 до 1,0 и действовать как ключевые кадры по градиенту (они отмечают, где градиент должен быть точно определённым цветом).

В случае, если пользователь не задаёт первое значение ключевого кадра равным 0 и/или последнее значение ключевого кадра равным 1, будут созданы ключевые кадры в этих позициях, а первый и последний цвета будут дублированы там. Таким образом, если пользователь указывает следующие массивы для построения градиента:

     {Color.BLUE, Color.RED}, {.3f, .7f}
 

это будет преобразовано в градиент с следующими ключевыми кадрами:

     {Color.BLUE, Color.BLUE, Color.RED, Color.RED}, {0f, .3f, .7f, 1f}
 

Пользователь также может выбрать действие объекта LinearGradientPaint при заполнении пространства за пределами начальной и конечной точек, установив CycleMethod в REFLECTION или REPEAT. Расстояния между любыми двумя цветами в любой из отражённых или повторённых копий градиента такие же, как и расстояние между теми же двумя цветами между начальной и конечной точками. Обратите внимание, что могут возникнуть незначительные отклонения в расстояниях из-за дискретизации с точностью до пикселя. Если метод цикла не указан, NO_CYCLE будет выбран по умолчанию, что означает, что для заполнения оставшейся области будут использованы цвета конечной точки.

Параметр colorSpace позволяет пользователю указать, в каком цветовом пространстве должна выполняться интерполяция, по умолчанию sRGB или линейный RGB.

Следующий код демонстрирует типичное использование LinearGradientPaint:

     Point2D start = new Point2D.Float(0, 0);
     Point2D end = new Point2D.Float(50, 50);
     float[] dist = {0.0f, 0.2f, 1.0f};
     Color[] colors = {Color.RED, Color.WHITE, Color.BLUE};
     LinearGradientPaint p =
         new LinearGradientPaint(start, end, dist, colors);
 

Этот код создаст LinearGradientPaint, который интерполирует между красным и белым в первых 20% градиента и между белым и синим в оставшихся 80%.

Это изображение демонстрирует примерный код выше для каждого из трёх методов цикла: