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

См. также:: Paint, Graphics2D.setPaint(java.awt.Paint)

Поля

Поля, объявленные в интерфейсе 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 для генерации цветовых узоров.
См. также:: Paint, PaintContext, ColorModel, Rectangle, Rectangle2D, AffineTransform, RenderingHints

getTransparency

public int getTransparency()

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

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

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