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

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

Задано:

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

Параметры:

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

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

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

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

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

Возвращает:

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

См. также:

getTransparency

public int getTransparency()

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

Задано:

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

Возвращает:

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

См. также:

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/GradientPaint.html