Класс GradientPaint

java.lang.Object

java.awt.GradientPaint

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

public class GradientPaint extends Object implements Paint

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

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

См. также:

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

Поля, объявленные в интерфейсе 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.

Методы, объявленные в классе 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)

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

Параметры:: x1 — координата x первой заданной Point в пользовательском пространстве; y1 — координата y первой заданной Point в пользовательском пространстве; color1 — Color в первой заданной Point; x2 — координата x второй заданной Point в пользовательском пространстве; y2 — координата y второй заданной Point в пользовательском пространстве; color2 — Color во второй заданной Point
Вызывает исключение:: NullPointerException — если один из цветов равен null

GradientPaint

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

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

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

GradientPaint

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

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

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

GradientPaint

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

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

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

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

getPoint1

public Point2D getPoint1()

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

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

getColor1

public Color getColor1()

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

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

getPoint2

public Point2D getPoint2()

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

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

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, используемый для создания линейного цветового градиента. Информацию об обработке параметров null см. в specification метода в интерфейсе Paint.

Определен в:

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

Параметры:

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

deviceBounds — ограничивающая рамка графического примитива в пространстве устройства.

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

xform — AffineTransform из пользовательского пространства в пространство устройства.

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

Возвращает:

PaintContext для создания цветовых узоров.

См. также:

getTransparency

public int getTransparency()

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

Определен в:

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

Возвращает:

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

См. также:

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/GradientPaint.html