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

Модификатор и тип	Поле	Описание
`static final int`	`BITMASK`	Представляет данные изображения, для которых гарантируется либо полная непрозрачность со значением альфа-канала 1.0, либо полная прозрачность со значением альфа-канала 0.0.
`static final int`	`OPAQUE`	Представляет данные изображения, для которых гарантируется полная непрозрачность, то есть значение альфа-канала всех пикселей равно 1.0.
`static final int`	`TRANSLUCENT`	Представляет данные изображения, содержащие или потенциально содержащие произвольные значения альфа-канала в диапазоне от 0.0 до 1.0 включительно.

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

Конструктор	Описание
`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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого объекта `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно после вызова метода notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно после вызова метода notify или interrupt, либо до истечения заданного промежутка времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно после вызова метода notify или interrupt, либо до истечения заданного промежутка времени.

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

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.