Класс GradientPaint

java.lang.Object

java.awt.GradientPaint

Все реализуемые интерфейсы:: Paint, Transparency

public class GradientPaint extends Object implements Paint

Класс GradientPaint предоставляет способ заполнения Shape линейным градиентом цветов. Если заданы точка P1 с цветом C1 и точка P2 с цветом C2 в пространстве пользователя, то цвет на прямой, соединяющей P1 и P2, пропорционально изменяется от C1 к C2. Любая точка P, не лежащая на продолжении прямой P1, P2, имеет цвет точки P', которая является перпендикулярной проекцией P на продолжение прямой P1, P2. Точки на продолжении прямой за пределами отрезка P1, P2 могут быть окрашены одним из двух способов.

Если градиент циклический, то точки на продолжении прямой P1, P2 циклически переходят от цвета C1 к цвету C2.
Если градиент ациклический, то точки по сторону P1 отрезка имеют постоянный цвет C1, а точки по сторону P2 – постоянный цвет C2.

См. также:

Краткое описание полей

Поля, объявленные в интерфейсе java.awt.Transparency

BITMASK, OPAQUE, TRANSLUCENT

Краткое описание конструкторов

Конструктор	Описание
`GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2)`	Создаёт простой ациклический объект `GradientPaint`.
`GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2, boolean cyclic)`	Создаёт циклический или ациклический объект `GradientPaint` в зависимости от параметра `boolean`.
`GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2)`	Создаёт простой ациклический объект `GradientPaint`.
`GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2, boolean cyclic)`	Создаёт циклический или ациклический объект `GradientPaint` в зависимости от параметра `boolean`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`PaintContext`	`createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)`	Создаёт и возвращает `PaintContext`, используемый для генерации линейного градиента цветов.
`Color`	`getColor1()`	Возвращает цвет C1, привязанный к точке P1.
`Color`	`getColor2()`	Возвращает цвет C2, привязанный к точке P2.
`Point2D`	`getPoint1()`	Возвращает копию точки P1, которая является якорем для первого цвета.
`Point2D`	`getPoint2()`	Возвращает копию точки P2, которая является якорем для второго цвета.
`int`	`getTransparency()`	Возвращает режим прозрачности для этого объекта `GradientPaint`.
`boolean`	`isCyclic()`	Возвращает true, если градиент циклически повторяется между двумя цветами C1 и C2.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

GradientPaint

public GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2)

Создаёт объект простого ациклического градиента.

Параметры:: x1 - координата x первой указанной точки в пространстве пользователя; y1 - координата y первой указанной точки в пространстве пользователя; color1 - Color в первой указанной точке; x2 - координата x второй указанной точки в пространстве пользователя; y2 - координата y второй указанной точки в пространстве пользователя; color2 - Color во второй указанной точке
Исключения:: NullPointerException - если хотя бы один из цветов равен null

GradientPaint

public GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2)

Создаёт объект простого ациклического градиента.

Параметры:: pt1 - первая указанная точка в пространстве пользователя; color1 - Color в первой указанной точке; pt2 - вторая указанная точка в пространстве пользователя; color2 - Color во второй указанной точке
Исключения:: NullPointerException - если хотя бы один из цветов или точек равен null

GradientPaint

public GradientPaint(float x1, float y1, Color color1, float x2, float y2, Color color2, boolean cyclic)

Создаёт циклический или ациклический объект градиента в зависимости от параметра цикличности.

Параметры:: x1 - координата x первой указанной точки в пространстве пользователя; y1 - координата y первой указанной точки в пространстве пользователя; color1 - Color в первой указанной точке; x2 - координата x второй указанной точки в пространстве пользователя; y2 - координата y второй указанной точки в пространстве пользователя; color2 - Color во второй указанной точке; cyclic - true, если градиент должен циклически повторяться между двумя цветами; false в противном случае

GradientPaint

@ConstructorProperties({"point1","color1","point2","color2","cyclic"}) public GradientPaint(Point2D pt1, Color color1, Point2D pt2, Color color2, boolean cyclic)

Создаёт циклический или ациклический объект градиента в зависимости от параметра цикличности.

Параметры:: pt1 - первая указанная точка в пространстве пользователя; color1 - Color в первой указанной точке; pt2 - вторая указанная точка в пространстве пользователя; color2 - Color во второй указанной точке; cyclic - true, если градиент должен циклически повторяться между двумя цветами; false в противном случае
Исключения:: NullPointerException - если хотя бы один из цветов или точек равен null

Подробное описание методов

getPoint1

public Point2D getPoint1()

Возвращает копию точки P1, которая определяет первый цвет.

Возвращает:: объект Point2D, являющийся копией точки, определяющей первый цвет этого градиента.

getColor1

public Color getColor1()

Возвращает цвет C1, заданный точкой P1.

Возвращает:: объект Color, представляющий цвет, заданный точкой P1.

getPoint2

public Point2D getPoint2()

Возвращает копию точки P2, которая определяет второй цвет.

Возвращает:: объект Point2D, являющийся копией точки, определяющей второй цвет этого градиента.

getColor2

public Color getColor2()

Возвращает цвет C2, заданный точкой P2.

Возвращает:: объект Color, представляющий цвет, заданный точкой P2.

isCyclic

public boolean isCyclic()

Возвращает true, если градиент циклически повторяется между двумя цветами C1 и C2.

Возвращает:: true, если градиент циклически повторяется между двумя цветами; false в противном случае.

createContext

public PaintContext createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)

Создаёт и возвращает PaintContext, используемый для генерации линейного градиента. См. specification интерфейса Paint для информации об обработке параметров null.

Определено в:

createContext в интерфейсе Paint

Параметры:

cm - предпочтительная модель цвета ColorModel, которая представляет наиболее удобный для вызывающего объекта формат получения пиксельных данных, или null, если нет предпочтений.

deviceBounds - ограничивающая рамка в пространстве устройства для отрисовываемого графического элемента.

userBounds - ограничивающая рамка в пространстве пользователя для отрисовываемого графического элемента.

xform - преобразование AffineTransform из пространства пользователя в пространство устройства.

hints - набор настроек, которые объект контекста может использовать для выбора между альтернативными вариантами отрисовки.

Возвращает:

контекст PaintContext для генерации цветовых шаблонов.

См. также:

getTransparency

public int getTransparency()

Возвращает режим прозрачности для данного объекта градиента.

Определено в:

getTransparency в интерфейсе Transparency

Возвращает:

целое число, представляющее режим прозрачности этого объекта градиента.

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/GradientPaint.html