Класс 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 |
Желтый цвет. |
Поля, объявленные в интерфейсе Transparency
BITMASK, OPAQUE, TRANSLUCENT | Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
BITMASK |
Представляет данные изображения, для которых гарантируется, что они либо полностью непрозрачны (значение альфа-канала 1.0), либо полностью прозрачны (значение альфа-канала 0.0). |
static final int |
OPAQUE |
Представляет данные изображения, для которых гарантируется полная непрозрачность, то есть все пиксели имеют значение альфа-канала 1.0. |
static final int |
TRANSLUCENT |
Представляет данные изображения, которые содержат или могут содержать произвольные значения альфа-канала в диапазоне от 0.0 до 1.0 включительно. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
Color |
Создает непрозрачный цвет sRGB с указанными значениями красного, зеленого и синего компонентов в диапазоне (0.0–1.0). |
Color |
Создает цвет sRGB с указанными значениями красного, зеленого, синего компонентов и альфа-канала в диапазоне (0.0–1.0). |
Color |
Создает непрозрачный цвет sRGB с указанным значением RGB, состоящим из компонента красного цвета в битах 16–23, компонента зеленого цвета в битах 8–15 и компонента синего цвета в битах 0–7. |
Color |
Создает цвет sRGB с указанным значением ARGB, состоящим из компонента альфа-канала в битах 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, представляющее цвет в ColorModel sRGB по умолчанию и состоящее из компонента альфа-канала в битах 24–31, компонента красного цвета в битах 16–23, компонента зеленого цвета в битах 8–15 и компонента синего цвета в битах 0–7. |
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. |
Методы, объявленные в классе Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создает и возвращает копию этого объекта. |
protected void |
finalize() |
Устарело, будет удалено: этот элемент API планируется удалить в будущей версии. Финализация устарела и будет удалена в одном из следующих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого Object. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
final void |
wait() |
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством уведомления или прерывания. |
final void |
wait |
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством уведомления или прерывания, либо пока не пройдет определенное время. |
final void |
wait |
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством уведомления или прерывания, либо пока не пройдет определенное время. |
Подробное описание полей
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)
- красной компоненты в битах 16–23,
- зеленой компоненты в битах 8–15 и
- синей компоненты в битах 0–7.
- Параметры:
-
rgb— объединенные компоненты RGB - См. также:
Color
public Color(int argb, boolean hasAlpha)
- альфа-компоненты в битах 24–31,
- красной компоненты в битах 16–23,
- зеленой компоненты в битах 8–15 и
- синей компоненты в битах 0–7.
hasAlpha имеет значение false, значение альфа-компонента по умолчанию равно 255.- Параметры:
-
argb— объединенные компоненты ARGB -
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 цвета в модели 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—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, принимающему один целочисленный аргумент.
- Параметры:
-
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.