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

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