Класс Color
- Все реализованные интерфейсы:
-
Paint,Transparency,Serializable
- Прямые известные подклассы:
-
ColorUIResource,SystemColor
public class Color extends Object implements Paint, Serializable
Color используется для инкапсуляции цветов в стандартном цветовом пространстве sRGB или цветах в произвольных цветовых пространствах, идентифицируемых с помощью ColorSpace. Каждый цвет имеет неявное значение альфа 1.0 или явное, заданное в конструкторе. Значение альфа определяет прозрачность цвета и может быть представлено значением с плавающей точкой в диапазоне 0.0 - 1.0 или целым числом от 0 до 255. Значение альфа 1.0 или 255 означает, что цвет полностью непрозрачный, а значение альфа 0 или 0.0 означает, что цвет полностью прозрачный. При создании Color с явным значением альфа или получении цветовых/альфа-компонентов Color, цветовые компоненты никогда не предумножаются на альфа-компонент. Стандартное цветовое пространство для API Java 2D(tm) - sRGB, предлагаемый стандарт RGB цветового пространства. Дополнительную информацию об sRGB можно найти по адресу http://www.w3.org/pub/WWW/Graphics/Color/sRGB.html .
- См. также:
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final Color |
black |
Цвет черный. |
static final Color |
BLACK |
Цвет черный. |
static final Color |
blue |
Цвет синий. |
static final Color |
BLUE |
Цвет синий. |
static final Color |
cyan |
Цвет циан. |
static final Color |
CYAN |
Цвет циан. |
static final Color |
DARK_GRAY |
Цвет темно-серый. |
static final Color |
darkGray |
Цвет темно-серый. |
static final Color |
gray |
Цвет серый. |
static final Color |
GRAY |
Цвет серый. |
static final Color |
green |
Цвет зеленый. |
static final Color |
GREEN |
Цвет зеленый. |
static final Color |
LIGHT_GRAY |
Цвет светло-серый. |
static final Color |
lightGray |
Цвет светло-серый. |
static final Color |
magenta |
Цвет пурпурный. |
static final Color |
MAGENTA |
Цвет пурпурный. |
static final Color |
orange |
Цвет оранжевый. |
static final Color |
ORANGE |
Цвет оранжевый. |
static final Color |
pink |
Цвет розовый. |
static final Color |
PINK |
Цвет розовый. |
static final Color |
red |
Цвет красный. |
static final Color |
RED |
Цвет красный. |
static final Color |
white |
Цвет белый. |
static final Color |
WHITE |
Цвет белый. |
static final Color |
yellow |
Цвет желтый. |
static final Color |
YELLOW |
Цвет желтый. |
Поля, объявленные в интерфейсе java.awt.Transparency
BITMASK, OPAQUE, TRANSLUCENT
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
Color |
Создаёт непрозрачный цвет sRGB со значениями красного, зеленого и синего в диапазоне (0.0 - 1.0). |
Color |
Создаёт цвет sRGB со значениями красного, зеленого, синего и альфа в диапазоне (0.0 - 1.0). |
Color |
Создаёт непрозрачный цвет sRGB с указанным комбинированным значением RGB, состоящим из компоненты красного в битах 16-23, компоненты зеленого в битах 8-15 и компоненты синего в битах 0-7. |
Color |
Создаёт цвет sRGB с указанным комбинированным значением RGBA, состоящим из компоненты альфа в битах 24-31, компоненты красного в битах 16-23, компоненты зеленого в битах 8-15 и компоненты синего в битах 0-7. |
Color |
Создаёт непрозрачный цвет sRGB со значениями красного, зеленого и синего в диапазоне (0 - 255). |
Color |
Создаёт цвет sRGB со значениями красного, зеленого, синего и альфа в диапазоне (0 - 255). |
Color |
Создаёт цвет в заданном ColorSpace с цветовыми компонентами, указанными в массиве float, и заданным значением альфа. |
Краткое описание методов
| Modifier and Type | Method | Description |
|---|---|---|
Color |
brighter() |
Создает новый Color, который является более светлой версией этого Color. |
PaintContext |
createContext |
Создает и возвращает PaintContext, используемый для генерации узора заполнения твёрдым цветом. |
Color |
darker() |
Создает новый Color, который является более тёмной версией этого Color. |
static Color |
decode |
Преобразует String в целое число и возвращает указанный непрозрачный Color. |
boolean |
equals |
Определяет, равен ли другой объект этому Color. |
int |
getAlpha() |
Возвращает альфа-компонент в диапазоне от 0 до 255. |
int |
getBlue() |
Возвращает синюю компоненту в диапазоне от 0 до 255 в стандартном пространстве sRGB. |
static Color |
getColor |
Находит цвет в свойствах системы. |
static Color |
getColor |
Находит цвет в свойствах системы. |
static Color |
getColor |
Находит цвет в свойствах системы. |
float[] |
getColorComponents |
Возвращает массив float, содержащий только цветовые компоненты Color, в пространстве ColorSpace Color. |
float[] |
getColorComponents |
Возвращает массив float , содержащий только цветовые компоненты Color в пространстве ColorSpace, заданном параметром cspace. |
ColorSpace |
getColorSpace() |
Возвращает ColorSpace этого Color. |
float[] |
getComponents |
Возвращает массив float , содержащий цветовые и альфа-компоненты Color в пространстве ColorSpace Color. |
float[] |
getComponents |
Возвращает массив float , содержащий цветовые и альфа-компоненты Color в пространстве ColorSpace, заданном параметром cspace. |
int |
getGreen() |
Возвращает зелёную компоненту в диапазоне от 0 до 255 в стандартном пространстве sRGB. |
static Color |
getHSBColor |
Создаёт объект Color на основе заданных значений для цветовой модели HSB. |
int |
getRed() |
Возвращает красную компоненту в диапазоне от 0 до 255 в стандартном пространстве sRGB. |
int |
getRGB() |
Возвращает значение RGB, представляющее цвет в стандартном пространстве sRGB ColorModel. |
float[] |
getRGBColorComponents |
Возвращает массив float , содержащий только цветовые компоненты Color в стандартном пространстве sRGB. |
float[] |
getRGBComponents |
Возвращает массив float , содержащий цветовые и альфа-компоненты Color в стандартном пространстве sRGB. |
int |
getTransparency() |
Возвращает режим прозрачности для этого Color. |
int |
hashCode() |
Вычисляет код хэша для этого Color. |
static int |
HSBtoRGB |
Преобразует компоненты цвета, указанные в модели HSB, в эквивалентные значения для стандартной модели RGB. |
static float[] |
RGBtoHSB |
Преобразует компоненты цвета, указанные в стандартной модели RGB, в эквивалентные значения для оттенка, насыщенности и яркости — трёх компонентов модели HSB. |
String |
toString() |
Возвращает строковое представление этого Color. |
Подробное описание полей
white
public static final Color white
WHITE
public static final Color WHITE
- С момента:
- 1.4
светло-серый
public static final Color lightGray
LIGHT_GRAY
public static final Color LIGHT_GRAY
- С момента:
- 1.4
серый
public static final Color gray
GRAY
public static final Color GRAY
- С момента:
- 1.4
темно-серый
public static final Color darkGray
DARK_GRAY
public static final Color DARK_GRAY
- С момента:
- 1.4
черный
public static final Color black
BLACK
public static final Color BLACK
- С момента:
- 1.4
красный
public static final Color red
RED
public static final Color RED
- С момента:
- 1.4
розовый
public static final Color pink
PINK
public static final Color PINK
- С момента:
- 1.4
оранжевый
public static final Color orange
ORANGE
public static final Color ORANGE
- С момента:
- 1.4
желтый
public static final Color yellow
YELLOW
public static final Color YELLOW
- С момента:
- 1.4
зеленый
public static final Color green
GREEN
public static final Color GREEN
- С момента:
- 1.4
пурпурный
public static final Color magenta
MAGENTA
public static final Color MAGENTA
- С момента:
- 1.4
голубой
public static final Color cyan
CYAN
public static final Color CYAN
- С момента:
- 1.4
синий
public static final Color blue
BLUE
public static final Color BLUE
- С момента:
- 1.4
Подробное описание конструкторов
Color
public Color(int r, int g, int b)
- Параметры:
-
r- компонент красного цвета -
g- компонент зелёного цвета -
b- компонент синего цвета - Исключения:
-
IllegalArgumentException- еслиr,gилиbнаходятся за пределами диапазона от 0 до 255 включительно - См. также:
Color
@ConstructorProperties({"red","green","blue","alpha"}) public Color(int r, int g, int b, int a) - Параметры:
-
r- компонент красного цвета -
g- компонент зелёного цвета -
b- компонент синего цвета -
a- компонент альфа - Исключения:
-
IllegalArgumentException- еслиr,g,bилиaнаходятся за пределами диапазона от 0 до 255 включительно - См. также:
Color
public Color(int rgb)
- Параметры:
-
rgb- комбинированные компоненты RGB - См. также:
Color
public Color(int rgba, boolean hasalpha)
hasalpha равен false, альфа по умолчанию 255.- Параметры:
-
rgba- комбинированные компоненты RGBA -
hasalpha-trueесли биты альфа корректны;falseв противном случае - См. также:
Color
public Color(float r, float g, float b)
- Параметры:
-
r- компонент красного цвета -
g- компонент зелёного цвета -
b- компонент синего цвета - Исключения:
-
IllegalArgumentException- еслиr,gилиbнаходятся за пределами диапазона от 0.0 до 1.0 включительно - См. также:
Color
public Color(float r, float g, float b, float a)
- Параметры:
-
r- компонент красного цвета -
g- компонент зелёного цвета -
b- компонент синего цвета -
a- компонент альфа - Исключения:
-
IllegalArgumentException- еслиr,gbилиaнаходятся за пределами диапазона от 0.0 до 1.0 включительно - См. также:
Цвет
public Color(ColorSpace cspace, float[] components, float alpha)
ColorSpace с компонентами цвета, указанными в массиве float и заданным альфа-каналом. Количество компонентов определяется типом ColorSpace. Например, RGB требует 3 компонента, а CMYK — 4.- Параметры:
-
cspace— используемоеColorSpaceдля интерпретации компонентов -
components— произвольное количество компонентов цвета, совместимое сColorSpace -
alpha— значение альфа-канала - Исключения:
-
IllegalArgumentException— если какое-либо из значений в массивеcomponentsилиalphaвыходит за пределы от 0,0 до 1,0 - См. также:
Подробное описание методов
getRed
public int getRed()
- Возвращает:
- красный компонент.
- См. также:
getGreen
public int getGreen()
- Возвращает:
- зелёный компонент.
- См. также:
getBlue
public int getBlue()
- Возвращает:
- синий компонент.
- См. также:
getAlpha
public int getAlpha()
- Возвращает:
- компонент альфа-канала.
- См. также:
getRGB
public int getRGB()
ColorModel. (Биты 24-31 — альфа, 16-23 — красный, 8-15 — зелёный, 0-7 — синий).- Возвращает:
- значение RGB цвета в стандартном пространстве sRGB
ColorModel. - С:
- 1.0
- См. также:
brighter
public Color brighter()
Color, более светлый, чем этот Color. Этот метод применяет произвольный масштабирующий коэффициент к каждому из трёх компонентов RGB этого Color, чтобы создать более светлый вариант этого Color. Значение alpha сохраняется. Хотя brighter и darker являются обратными операциями, результаты последовательных вызовов этих двух методов могут быть несогласованными из-за ошибок округления.
- Возвращает:
- новый объект
Color, более светлый, чем этотColor, с тем же значениемalpha. - С:
- 1.0
- См. также:
darker
public Color darker()
Color, более тёмный, чем этот Color. Этот метод применяет произвольный масштабирующий коэффициент к каждому из трёх компонентов RGB этого Color, чтобы создать более тёмный вариант этого Color. Значение alpha сохраняется. Хотя brighter и darker являются обратными операциями, результаты последовательных вызовов этих двух методов могут быть несогласованными из-за ошибок округления.
- Возвращает:
- новый объект
Color, более тёмный, чем этотColor, с тем же значениемalpha. - С:
- 1.0
- См. также:
hashCode
public int hashCode()
Color.- Переопределяет:
-
hashCodeв классеObject - Возвращает:
- значение хеш-кода для этого объекта.
- С:
- 1.0
- См. также:
equals
public boolean equals(Object obj)
Color. Результат равен true тогда и только тогда, когда аргумент не null и является объектом Color с такими же значениями красного, зелёного, синего и альфа-каналов, как и этот объект.
- Переопределяет:
-
equalsв классеObject - Параметры:
-
obj— объект для проверки на равенство с этимColor - Возвращает:
-
trueесли объекты равны;falseв противном случае. - С:
- 1.0
- См. также:
toString
public String toString()
Color. Этот метод предназначен только для отладки. Содержимое и формат возвращаемой строки могут различаться между реализациями. Возвращаемая строка может быть пустой, но не может быть null.- Переопределяет:
-
toStringв классеObject - Возвращает:
- строковое представление этого
Color.
decode
public static Color decode(String nm) throws NumberFormatException
String в целое число и возвращает указанный непрозрачный Color. Этот метод обрабатывает строковые форматы, используемые для представления восьмеричных и шестнадцатеричных чисел.- Параметры:
-
nm— строка, представляющая непрозрачный цвет как целое 24-битовое число - Возвращает:
- новый объект
Color. - Исключения:
-
NumberFormatException— если заданная строка не может быть интерпретирована как десятичное, восьмеричное или шестнадцатеричное целое число. - С:
- 1.1
- См. также:
getColor
public static Color getColor(String nm)
Аргумент рассматривается как имя системного свойства, которое нужно получить. Строковое значение этого свойства интерпретируется как целое число, которое затем преобразуется в объект Color.
Если указанное свойство не найдено или не может быть обработано как целое число, то возвращается null.
- Параметры:
-
nm— имя свойства цвета - Возвращает:
- цвет, преобразованный из системного свойства.
- С:
- 1.0
- См. также:
getColor
public static Color getColor(String nm, Color v)
Первый аргумент рассматривается как имя системного свойства, которое нужно получить. Строковое значение этого свойства интерпретируется как целое число, которое затем преобразуется в объект Color.
Если указанное свойство не найдено или не может быть обработано как целое число, то возвращается Color , указанный во втором аргументе.
- Параметры:
-
nm— имя свойства цвета -
v— значение по умолчанию дляColor - Возвращает:
- цвет, преобразованный из системного свойства, или указанный
Color. - С:
- 1.0
- См. также:
getColor
public static Color getColor(String nm, int v)
Первый аргумент рассматривается как имя системного свойства, которое нужно получить. Строковое значение этого свойства интерпретируется как целое число, которое затем преобразуется в объект Color.
Если указанное свойство не найдено или не может быть обработано как целое число, то используется целое значение v , которое преобразуется в объект Color.
- Parameters:
-
nm- имя свойства цвета -
v- значение цвета по умолчанию, как целое число - Returns:
- объект
Color, преобразованный из системного свойства, или объектColor, преобразованный из указанного целого числа. - Since:
- 1.0
- See Also:
HSBtoRGB
public static int HSBtoRGB(float hue, float saturation, float brightness)
Компоненты saturation и brightness должны быть числами с плавающей точкой в диапазоне от нуля до единицы (числа в диапазоне 0.0-1.0). Компонент hue может быть любым числом с плавающей точкой. От этого числа вычитается его целая часть, чтобы получить дробную часть в диапазоне от 0 до 1. Эта дробная часть затем умножается на 360, чтобы получить угол оттенка в модели цвета HSB.
Целое число, возвращаемое HSBtoRGB , кодирует значение цвета в битах 0-23 целого значения, имеющего тот же формат, что и у метода getRGB. Это целое число может быть передано в качестве аргумента конструктору Color , принимающему одно целое число в качестве аргумента.
- Parameters:
-
hue- компонент оттенка цвета -
saturation- насыщенность цвета -
brightness- яркость цвета - Returns:
- значение RGB цвета с указанным оттенком, насыщенностью и яркостью.
- Since:
- 1.0
- See Also:
RGBtoHSB
public static float[] RGBtoHSB(int r, int g, int b, float[] hsbvals)
Если аргумент hsbvals равен null, то для возврата результата выделяется новый массив. В противном случае метод возвращает массив hsbvals, куда значения помещаются в этот массив.
- Parameters:
-
r- красный компонент цвета -
g- зелёный компонент цвета -
b- синий компонент цвета -
hsbvals- массив для возвращения трёх значений HSB, илиnull - Returns:
- массив из трёх элементов, содержащий оттенок, насыщенность и яркость (в указанном порядке) цвета с указанными компонентами красного, зелёного и синего цветов.
- Since:
- 1.0
- See Also:
getHSBColor
public static Color getHSBColor(float h, float s, float b)
Color на основе указанных значений для модели цвета HSB. Компоненты s и b должны быть числами с плавающей точкой в диапазоне от нуля до единицы (числа в диапазоне 0.0-1.0). Компонент h может быть любым числом с плавающей точкой. От этого числа вычитается его целая часть, чтобы получить дробную часть в диапазоне от 0 до 1. Эта дробная часть затем умножается на 360, чтобы получить угол оттенка в модели цвета HSB.
- Parameters:
-
h- компонент оттенка -
s- насыщенность цвета -
b- яркость цвета - Returns:
- объект
Colorс указанным оттенком, насыщенностью и яркостью. - Since:
- 1.0
getRGBComponents
public float[] getRGBComponents(float[] compArray)
float , содержащий компоненты цвета и альфа-компоненты Color, представленные в стандартном цветовом пространстве sRGB. Если compArray равно null, то создаётся массив длиной 4 для возвращаемого значения. В противном случае compArray должен иметь длину 4 или более, и он заполняется компонентами и возвращается.- Parameters:
-
compArray- массив, который этот метод заполняет компонентами цвета и альфа-компонентами и возвращает - Returns:
- компоненты RGBA в массиве
float.
getRGBColorComponents
public float[] getRGBColorComponents(float[] compArray)
float , содержащий только цветовые компоненты Color, в стандартном цветовом пространстве sRGB. Если compArray равно null, то создаётся массив длиной 3 для возвращаемого значения. В противном случае compArray должен иметь длину 3 или более, и он заполняется компонентами и возвращается.- Parameters:
-
compArray- массив, который этот метод заполняет цветовыми компонентами и возвращает - Returns:
- компоненты RGB в массиве
float.
getComponents
public float[] getComponents(float[] compArray)
float , содержащий цветовые и альфа-компоненты Color, в ColorSpace Color. Если compArray равно null, то создаётся массив длиной, равной числу компонентов в ассоциированном ColorSpace плюс один. В противном случае compArray должен иметь длину не меньше этой, и он заполняется компонентами и возвращается.- Parameters:
-
compArray- массив, который этот метод заполняет цветовыми и альфа-компонентами этогоColorв егоColorSpaceи возвращает - Returns:
- цветовые и альфа-компоненты в массиве
float.
getColorComponents
public float[] getColorComponents(float[] compArray)
float , содержащий только цветовые компоненты Color, в ColorSpace Color. Если compArray равно null, то создаётся массив длиной, равной числу компонентов в ассоциированном ColorSpace. В противном случае compArray должен иметь длину не меньше этой, и он заполняется компонентами и возвращается.- Parameters:
-
compArray- массив, который этот метод заполняет цветовыми компонентами этогоColorв егоColorSpaceи возвращает - Returns:
- цветовые компоненты в массиве
float.
getComponents
public float[] getComponents(ColorSpace cspace, float[] compArray)
float , содержащий цветовые и альфа-компоненты Color, в ColorSpace , заданном параметром cspace. Если compArray равно null, то создаётся массив длиной, равной числу компонентов в cspace плюс один. В противном случае compArray должен иметь длину не меньше этой, и он заполняется компонентами и возвращается.- Parameters:
-
cspace- указанноеColorSpace -
compArray- массив, который этот метод заполняет цветовыми и альфа-компонентами этогоColorв указанномColorSpaceи возвращает - Returns:
- цветовые и альфа-компоненты в массиве
float.
getColorComponents
public float[] getColorComponents(ColorSpace cspace, float[] compArray)
float , содержащий только цветовые компоненты Color в ColorSpace , заданном параметром cspace. Если compArray равно null, то создаётся массив длиной, равной числу компонентов в cspace. В противном случае compArray должен иметь длину не меньше этой, и он заполняется компонентами и возвращается.- Parameters:
-
cspace- указанноеColorSpace -
compArray- массив, который этот метод заполняет цветовыми компонентами этогоColorв указанномColorSpace - Returns:
- цветовые компоненты в массиве
float.
getColorSpace
public ColorSpace getColorSpace()
ColorSpace этого Color.- Returns:
- объект
Colorэтого объектаColorSpace.
createContext
public PaintContext createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints)
PaintContext, используемый для генерации узора заливки твёрдым цветом. Обратитесь к specification метода в интерфейсе Paint для получения информации об обработке нулевых параметров.- Specified by:
-
createContextв интерфейсеPaint - Parameters:
-
cm- предпочитаемыйColorModel, представляющий наиболее удобный для вызывающей стороны формат получения данных пикселей, илиnullв случае отсутствия предпочтений. -
r- граница области устройства, в которой отображается графический примитив. -
r2d- граница области пользователя, в которой отображается графический примитив. -
xform-AffineTransformиз пространства пользователя в пространство устройства. -
hints- набор подсказок, которые объект контекста может использовать для выбора между альтернативными способами отображения. - Returns:
PaintContextдля генерации узоров заливки цветом.- See Also:
getTransparency
public int getTransparency()
Color. Это необходимо для реализации интерфейса Paint. - Specified by:
-
getTransparencyв интерфейсеTransparency - Returns:
- режим прозрачности объекта
Color. - See Also:
© 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/Color.html