Класс 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 включительно - См. также:
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
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.
Если указанное свойство не найдено или не может быть разобранo как целое число, вместо него используется целочисленное значение 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, который принимает один целочисленный аргумент.
- Параметры:
-
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, используемый для генерации шаблона заполнения цветом. См. specification метода в интерфейсе Paint для информации об обработке параметров null.- Определено в:
-
createContextв интерфейсеPaint - Параметры:
-
cm- предпочтительнаяColorModel, которая представляет наиболее удобный формат для получения данных пикселей вызывающей стороной, илиnullв случае отсутствия предпочтения. -
r- ограничивающая прямоугольная область в пространстве устройства для отрисовываемого графического элемента. -
r2d- ограничивающая прямоугольная область в пространстве пользователя для отрисовываемого графического элемента. -
xform-AffineTransformиз пространства пользователя в пространство устройства. -
hints- набор подсказок, которые объект контекста может использовать для выбора между альтернативными вариантами рендеринга. - Возвращает:
- контекст
PaintContextдля генерации шаблонов цвета. - См. также:
getTransparency
public int getTransparency()
Color. Это необходимо для реализации интерфейса Paint. - Определено в:
-
getTransparencyв интерфейсеTransparency - Возвращает:
- режим прозрачности этого объекта
Color. - См. также:
© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/Color.html