Класс Color
- Все реализуемые интерфейсы:
Paint, Transparency, Serializable
- Прямые известные подклассы:
ColorUIResource, SystemColor
public class Color extends Object implements Paint, Serializable
Color используется для инкапсуляции цветов в цветовом пространстве sRGB по умолчанию или цветов в произвольных цветовых пространствах, определяемых с помощью ColorSpace. Каждый цвет имеет неявное значение альфа-канала 1.0 или явное значение, заданное в конструкторе. Значение альфа-канала определяет прозрачность цвета и может быть представлено значением типа float в диапазоне 0.0–1.0 или значением в диапазоне 0–255. Значение альфа-канала 1.0 или 255 означает, что цвет полностью непрозрачен, а значение 0 или 0.0 означает, что цвет полностью прозрачен. При создании Color с явным значением альфа-канала или получении компонентов цвета/альфа-канала Color компоненты цвета никогда не умножаются предварительно на компонент альфа-канала. Цветовое пространство по умолчанию для Java 2D(tm) API — 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 |
Желтый цвет. |
Поля, объявленные в интерфейсе 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, и указанным значением альфа-канала. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
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
lightGray
public static final Color lightGray
LIGHT_GRAY
public static final Color LIGHT_GRAY
- С версии:
- 1.4
gray
public static final Color gray
GRAY
public static final Color GRAY
- С версии:
- 1.4
darkGray
public static final Color darkGray
DARK_GRAY
public static final Color DARK_GRAY
- С версии:
- 1.4
black
public static final Color black
BLACK
public static final Color BLACK
- С версии:
- 1.4
red
public static final Color red
RED
public static final Color RED
- С версии:
- 1.4
pink
public static final Color pink
PINK
public static final Color PINK
- С версии:
- 1.4
orange
public static final Color orange
ORANGE
public static final Color ORANGE
- С версии:
- 1.4
yellow
public static final Color yellow
YELLOW
public static final Color YELLOW
- С версии:
- 1.4
green
public static final Color green
GREEN
public static final Color GREEN
- С версии:
- 1.4
magenta
public static final Color magenta
MAGENTA
public static final Color MAGENTA
- С версии:
- 1.4
cyan
public static final Color cyan
CYAN
public static final Color CYAN
- С версии:
- 1.4
blue
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 включительно - См. также:
Color
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 sRGB по умолчанию. (Биты 24–31 — альфа-компонент, 16–23 — красный, 8–15 — зелёный, 0–7 — синий.)- Возвращает:
- значение RGB цвета в
ColorModelsRGB по умолчанию. - С версии:
- 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
equals
public boolean equals(Object obj)
Color. Результат равен true тогда и только тогда, когда аргумент не является null и представляет собой объект Color с такими же значениями красного, зелёного, синего и альфа-компонентов, как у этого объекта.
toString
public String toString()
Color. Этот метод предназначен только для отладки. Содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.decode
public static Color decode(String nm) throws NumberFormatException
String в целое число и возвращает указанный непрозрачный объект Color. Этот метод обрабатывает строковые форматы, используемые для представления восьмеричных и шестнадцатеричных чисел.- Параметры:
-
nm—String, представляющая непрозрачный цвет в виде 24-битного целого числа - Возвращает:
- новый объект
Color. - Исключения:
-
NumberFormatException— если указанную строку невозможно интерпретировать как десятичное, восьмеричное или шестнадцатеричное целое число. - С версии:
- 1.1
- См. также:
getColor
public static Color getColor(String nm)
Аргумент рассматривается как имя системного свойства, значение которого нужно получить. Затем строковое значение этого свойства интерпретируется как целое число, которое преобразуется в объект Color.
Если указанное свойство не найдено или его значение невозможно разобрать как целое число, возвращается null.
- Параметры:
-
nm— имя свойства цвета - Возвращает:
- объект
Color, полученный из системного свойства. - С версии:
- 1.0
- См. также:
getColor
public static Color getColor(String nm, Color v)
Первый аргумент рассматривается как имя системного свойства, значение которого нужно получить. Затем строковое значение этого свойства интерпретируется как целое число, которое преобразуется в объект Color.
Если указанное свойство не найдено или его значение невозможно разобрать как целое число, вместо него возвращается объект Color, заданный вторым аргументом.
- Параметры:
-
nm— имя свойства цвета -
v— цветColor - Возвращает:
- объект
Color, полученный из системного свойства, или указанный объектColor. - С версии:
- 1.0
- См. также:
getColor
public static Color getColor(String nm, int v)
Первый аргумент рассматривается как имя системного свойства, значение которого нужно получить. Затем строковое значение этого свойства интерпретируется как целое число, которое преобразуется в объект Color.
Если указанное свойство не найдено или его значение невозможно разобрать как целое число, вместо него используется целочисленное значение v, которое преобразуется в объект Color.
- Параметры:
-
nm— имя свойства цвета -
v— значение цвета по умолчанию в виде целого числа - Возвращает:
- объект
Color, полученный из системного свойства, или объектColor, полученный из указанного целого числа. - С версии:
- 1.0
- См. также:
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, принимающему один аргумент типа int.
- Параметры:
-
hue— компонент оттенка цвета -
saturation— насыщенность цвета -
brightness— яркость цвета - Возвращает:
- значение RGB цвета с указанными оттенком, насыщенностью и яркостью.
- С версии:
- 1.0
- См. также:
RGBtoHSB
public static float[] RGBtoHSB(int r, int g, int b, float[] hsbvals)
Если аргумент hsbvals равен null, для возвращаемого результата выделяется новый массив. В противном случае метод возвращает массив hsbvals, заполнив его значениями.
- Параметры:
-
r— компонент красного цвета -
g— компонент зелёного цвета -
b— компонент синего цвета -
hsbvals— массив для возврата трёх значений HSB илиnull - Возвращает:
- массив из трёх элементов, содержащий в указанном порядке оттенок, насыщенность и яркость цвета с указанными компонентами красного, зелёного и синего цветов.
- С версии:
- 1.0
- См. также:
getHSBColor
public static Color getHSBColor(float h, float s, float b)
Color на основе указанных значений цветовой модели HSB. Компоненты s и b должны быть числами с плавающей точкой от нуля до единицы (в диапазоне 0,0–1,0). Компонент h может быть любым числом с плавающей точкой. Из этого числа вычитается его целая часть, чтобы получить дробное число от 0 до 1. Затем это дробное число умножается на 360, чтобы получить угол оттенка в цветовой модели HSB.
- Параметры:
-
h— компонент оттенка -
s— насыщенность цвета -
b— яркость цвета - Возвращает:
- объект
Colorс указанными оттенком, насыщенностью и яркостью. - С версии:
- 1.0
getRGBComponents
public float[] getRGBComponents(float[] compArray)
float, содержащий компоненты цвета и альфа-компонент объекта Color, представленные в цветовом пространстве sRGB по умолчанию. Если compArray равен null, для возвращаемого значения создаётся массив длиной 4. В противном случае длина compArray должна быть не меньше 4; массив заполняется компонентами и возвращается.- Параметры:
-
compArray— массив, который этот метод заполняет компонентами цвета и альфа-компонентом, а затем возвращает - Возвращает:
- компоненты RGBA в массиве
float.
getRGBColorComponents
public float[] getRGBColorComponents(float[] compArray)
float, содержащий только компоненты цвета Color в цветовом пространстве sRGB по умолчанию. Если compArray равно null, для возвращаемого значения создается массив длины 3. В противном случае compArray должен иметь длину 3 или более; он заполняется компонентами и возвращается.- Параметры:
-
compArray— массив, который этот метод заполняет компонентами цвета и возвращает - Возвращает:
- компоненты RGB в массиве
float.
getComponents
public float[] getComponents(float[] compArray)
float, содержащий компоненты цвета и альфа-канала Color в ColorSpace Color. Если compArray равно null, для возвращаемого значения создается массив длины, равной количеству компонентов в связанной ColorSpace, плюс один. В противном случае compArray должен иметь как минимум такую длину; он заполняется компонентами и возвращается.- Параметры:
-
compArray— массив, который этот метод заполняет компонентами цвета и альфа-канала данногоColorв егоColorSpaceи возвращает - Возвращает:
- компоненты цвета и альфа-канала в массиве
float.
getColorComponents
public float[] getColorComponents(float[] compArray)
float, содержащий только компоненты цвета Color в ColorSpace Color. Если compArray равно null, для возвращаемого значения создается массив длины, равной количеству компонентов в связанной ColorSpace. В противном случае compArray должен иметь как минимум такую длину; он заполняется компонентами и возвращается.- Параметры:
-
compArray— массив, который этот метод заполняет компонентами цвета данногоColorв егоColorSpaceи возвращает - Возвращает:
- компоненты цвета в массиве
float.
getComponents
public float[] getComponents(ColorSpace cspace, float[] compArray)
float, содержащий компоненты цвета и альфа-канала Color в ColorSpace, заданном параметром cspace. Если compArray равно null, для возвращаемого значения создается массив длины, равной количеству компонентов в cspace, плюс один. В противном случае compArray должен иметь как минимум такую длину; он заполняется компонентами и возвращается.- Параметры:
-
cspace— заданноеColorSpace -
compArray— массив, который этот метод заполняет компонентами цвета и альфа-канала данногоColorв указанномColorSpaceи возвращает - Возвращает:
- компоненты цвета и альфа-канала в массиве
float.
getColorComponents
public float[] getColorComponents(ColorSpace cspace, float[] compArray)
float, содержащий только компоненты цвета Color в ColorSpace, заданном параметром cspace. Если compArray равно null, для возвращаемого значения создается массив длины, равной количеству компонентов в cspace. В противном случае compArray должен иметь как минимум такую длину; он заполняется компонентами и возвращается.- Параметры:
-
cspace— заданноеColorSpace -
compArray— массив, который этот метод заполняет компонентами цвета данногоColorв указанномColorSpace - Возвращает:
- компоненты цвета в массиве
float.
getColorSpace
public ColorSpace getColorSpace()
ColorSpace этого Color.- Возвращает:
ColorSpaceобъектаColor.
createContext
public PaintContext createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints)
PaintContext, используемый для создания узора сплошного цветового поля. Сведения об обработке параметров null см. в specification метода в интерфейсе Paint.- Определено в:
-
createContextв интерфейсеPaint - Параметры:
-
cm— предпочтительнаяColorModel, представляющая наиболее удобный для вызывающего кода формат получения данных пикселей, илиnull, если предпочтений нет. -
r— ограничивающий прямоугольник графического примитива в пространстве устройства, который отображается. -
r2d— ограничивающий прямоугольник графического примитива в пользовательском пространстве, который отображается. -
xform—AffineTransformиз пользовательского пространства в пространство устройства. -
hints— набор подсказок, которые объект контекста может использовать для выбора одного из вариантов отображения. - Возвращает:
PaintContextдля создания цветовых узоров.- См. также:
getTransparency
public int getTransparency()
Color. Это необходимо для реализации интерфейса Paint.- Определено в:
-
getTransparencyв интерфейсеTransparency - Возвращает:
- режим прозрачности объекта
Color. - См. также:
© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/Color.html