Класс 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 и заданным значением альфа. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
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 включительно - См. также:
Цвет
public Color(float r, float g, float b, float a)
- Параметры:
-
r- компонент красного цвета -
g- компонент зелёного цвета -
b- компонент синего цвета -
a- компонент альфа-канала - Исключения:
-
IllegalArgumentException- еслиr,g,bили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
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- строка, которая представляет непрозрачный цвет в виде 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, указанное вторым аргументом.
- Parameters:
-
nm- имя свойства цвета -
v- значение по умолчанию дляColor - Returns:
- значение
Color, преобразованное из системного свойства, или указанное значениеColor. - Since:
- 1.0
- See Also:
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)
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 для получения информации об обработке параметров со значением null.- 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Color.html