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

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