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

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

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

createContext

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

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

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

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

Параметры:

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

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

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

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

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

Возвращает:

объект PaintContext для генерации цветовых узоров.

См. также:

getTransparency

public int getTransparency()

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

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

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

Возвращает:

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

См. также:

Transparency

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