Spec-Zone.ru › OpenJDK 27

Класс Color

java.lang.Object
java.awt.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 .

См. также:
  • ColorSpace
  • AlphaComposite
  • Сериализованная форма

Краткое описание полей

Модификатор и тип Поле Описание
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(float r, float g, float b)
Создает непрозрачный цвет sRGB с указанными значениями красного, зеленого и синего компонентов в диапазоне (0.0–1.0).
Color(float r, float g, float b, float a)
Создает цвет sRGB с указанными значениями красного, зеленого, синего компонентов и альфа-канала в диапазоне (0.0–1.0).
Color(int rgb)
Создает непрозрачный цвет sRGB с указанным значением RGB, состоящим из компонента красного цвета в битах 16–23, компонента зеленого цвета в битах 8–15 и компонента синего цвета в битах 0–7.
Color(int argb, boolean hasAlpha)
Создает цвет sRGB с указанным значением ARGB, состоящим из компонента альфа-канала в битах 24–31, компонента красного цвета в битах 16–23, компонента зеленого цвета в битах 8–15 и компонента синего цвета в битах 0–7.
Color(int r, int g, int b)
Создает непрозрачный цвет sRGB с указанными значениями красного, зеленого и синего компонентов в диапазоне (0–255).
Color(int r, int g, int b, int a)
Создает цвет sRGB с указанными значениями красного, зеленого, синего компонентов и альфа-канала в диапазоне (0–255).
Color(ColorSpace cspace, float[] components, float alpha)
Создает цвет в указанном ColorSpace с компонентами цвета, заданными в массиве float, и указанным значением альфа-канала.

Краткое описание методов

Модификатор и тип Метод Описание
Color brighter()
Создает новый Color, который является более яркой версией этого Color.
PaintContext createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints)
Создает и возвращает PaintContext, используемый для создания сплошного узора цветового поля.
Color darker()
Создает новый Color, который является более темной версией этого Color.
static Color decode(String nm)
Преобразует String в целое число и возвращает указанный непрозрачный Color.
boolean equals(Object obj)
Определяет, равен ли другой объект этому Color.
int getAlpha()
Возвращает компонент альфа-канала в диапазоне 0–255.
int getBlue()
Возвращает компонент синего цвета в диапазоне 0–255 в пространстве sRGB по умолчанию.
static Color getColor(String nm)
Находит цвет в системных свойствах.
static Color getColor(String nm, int v)
Находит цвет в системных свойствах.
static Color getColor(String nm, Color v)
Находит цвет в системных свойствах.
float[] getColorComponents(float[] compArray)
Возвращает массив float, содержащий только компоненты цвета объекта Color в ColorSpace объекта Color.
float[] getColorComponents(ColorSpace cspace, float[] compArray)
Возвращает массив float, содержащий только компоненты цвета объекта Color в ColorSpace, заданном параметром cspace.
ColorSpace getColorSpace()
Возвращает ColorSpace этого Color.
float[] getComponents(float[] compArray)
Возвращает массив float, содержащий компоненты цвета и альфа-канала объекта Color в ColorSpace объекта Color.
float[] getComponents(ColorSpace cspace, float[] compArray)
Возвращает массив float, содержащий компоненты цвета и альфа-канала объекта Color в ColorSpace, заданном параметром cspace.
int getGreen()
Возвращает компонент зеленого цвета в диапазоне 0–255 в пространстве sRGB по умолчанию.
static Color getHSBColor(float h, float s, float b)
Создает объект Color на основе указанных значений цветовой модели HSB.
int getRed()
Возвращает компонент красного цвета в диапазоне 0–255 в пространстве sRGB по умолчанию.
int getRGB()
Возвращает значение RGB, представляющее цвет в ColorModel sRGB по умолчанию и состоящее из компонента альфа-канала в битах 24–31, компонента красного цвета в битах 16–23, компонента зеленого цвета в битах 8–15 и компонента синего цвета в битах 0–7.
float[] getRGBColorComponents(float[] compArray)
Возвращает массив float, содержащий только компоненты цвета объекта Color в цветовом пространстве sRGB по умолчанию.
float[] getRGBComponents(float[] compArray)
Возвращает массив float, содержащий компоненты цвета и альфа-канала объекта Color, представленные в цветовом пространстве sRGB по умолчанию.
int getTransparency()
Возвращает режим прозрачности для этого Color.
int hashCode()
Вычисляет хеш-код для этого Color.
static int HSBtoRGB(float hue, float saturation, float brightness)
Преобразует компоненты цвета, заданные моделью HSB, в эквивалентный набор значений модели RGB по умолчанию.
static float[] RGBtoHSB(int r, int g, int b, float[] hsbvals)
Преобразует компоненты цвета, заданные моделью 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(long timeoutMillis)
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством уведомления или прерывания, либо пока не пройдет определенное время.
final void wait(long timeoutMillis, int nanos)
Переводит текущий поток в состояние ожидания до тех пор, пока он не будет пробужден, обычно посредством уведомления или прерывания, либо пока не пройдет определенное время.

Подробное описание полей

white

public static final Color white
Белый цвет. В пространстве sRGB по умолчанию.

WHITE

public static final Color WHITE
Белый цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

lightGray

public static final Color lightGray
Светло-серый цвет. В пространстве sRGB по умолчанию.

LIGHT_GRAY

public static final Color LIGHT_GRAY
Светло-серый цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

gray

public static final Color gray
Серый цвет. В пространстве sRGB по умолчанию.

GRAY

public static final Color GRAY
Серый цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

darkGray

public static final Color darkGray
Темно-серый цвет. В пространстве sRGB по умолчанию.

DARK_GRAY

public static final Color DARK_GRAY
Темно-серый цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

black

public static final Color black
Черный цвет. В пространстве sRGB по умолчанию.

BLACK

public static final Color BLACK
Черный цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

red

public static final Color red
Красный цвет. В пространстве sRGB по умолчанию.

RED

public static final Color RED
Красный цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

pink

public static final Color pink
Розовый цвет. В пространстве sRGB по умолчанию.

PINK

public static final Color PINK
Розовый цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

orange

public static final Color orange
Оранжевый цвет. В пространстве sRGB по умолчанию.

ORANGE

public static final Color ORANGE
Оранжевый цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

yellow

public static final Color yellow
Желтый цвет. В пространстве sRGB по умолчанию.

YELLOW

public static final Color YELLOW
Желтый цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

green

public static final Color green
Зеленый цвет. В пространстве sRGB по умолчанию.

GREEN

public static final Color GREEN
Зеленый цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

magenta

public static final Color magenta
Пурпурный цвет. В пространстве sRGB по умолчанию.

MAGENTA

public static final Color MAGENTA
Пурпурный цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

cyan

public static final Color cyan
Голубой цвет. В пространстве sRGB по умолчанию.

CYAN

public static final Color CYAN
Голубой цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

blue

public static final Color blue
Синий цвет. В пространстве sRGB по умолчанию.

BLUE

public static final Color BLUE
Синий цвет. В пространстве sRGB по умолчанию.
Начиная с:
1.4

Подробное описание конструкторов

Color

public Color(int r, int g, int b)
Создает непрозрачный цвет sRGB с заданными значениями красного, зеленого и синего компонентов в диапазоне (0–255). Фактически используемый при отображении цвет зависит от того, насколько хорошо он соответствует цветовому пространству, доступному для данного устройства вывода. По умолчанию значение альфа-компонента равно 255.
Параметры:
r — красная компонента
g — зеленая компонента
b — синяя компонента
Исключения:
IllegalArgumentException — если r, g или b выходят за пределы диапазона от 0 до 255 включительно
См. также:
  • getRed()
  • getGreen()
  • getBlue()
  • getRGB()

Color

@ConstructorProperties({"red","green","blue","alpha"}) public Color(int r, int g, int b, int a)
Создает цвет sRGB с заданными значениями красного, зеленого, синего и альфа-компонентов в диапазоне (0–255).
Параметры:
r — красная компонента
g — зеленая компонента
b — синяя компонента
a — альфа-компонента
Исключения:
IllegalArgumentException — если r, g, b или a выходят за пределы диапазона от 0 до 255 включительно
См. также:
  • getRed()
  • getGreen()
  • getBlue()
  • getAlpha()
  • getRGB()

Color

public Color(int rgb)
Создает непрозрачный цвет sRGB с заданным значением RGB, состоящим из
  • красной компоненты в битах 16–23,
  • зеленой компоненты в битах 8–15 и
  • синей компоненты в битах 0–7.
Фактически используемый при отображении цвет зависит от того, насколько хорошо он соответствует цветовому пространству, доступному для конкретного устройства вывода. По умолчанию значение альфа-компонента равно 255.
Параметры:
rgb — объединенные компоненты RGB
См. также:
  • ColorModel.getRGBdefault()
  • getRed()
  • getGreen()
  • getBlue()
  • getRGB()

Color

public Color(int argb, boolean hasAlpha)
Создает цвет sRGB с заданным значением ARGB, состоящим из
  • альфа-компоненты в битах 24–31,
  • красной компоненты в битах 16–23,
  • зеленой компоненты в битах 8–15 и
  • синей компоненты в битах 0–7.
Если аргумент hasAlpha имеет значение false, значение альфа-компонента по умолчанию равно 255.
Параметры:
argb — объединенные компоненты ARGB
hasAlpha — true, если биты альфа-компонента допустимы; false в противном случае
См. также:
  • ColorModel.getRGBdefault()
  • getRed()
  • getGreen()
  • getBlue()
  • getAlpha()
  • getRGB()

Color

public Color(float r, float g, float b)
Создает непрозрачный цвет sRGB с заданными значениями красного, зеленого и синего компонентов в диапазоне (0,0–1,0). По умолчанию значение альфа-компонента равно 1,0. Фактически используемый при отображении цвет зависит от того, насколько хорошо он соответствует цветовому пространству, доступному для конкретного устройства вывода.
Параметры:
r — красная компонента
g — зеленая компонента
b — синяя компонента
Исключения:
IllegalArgumentException — если r, g или b выходят за пределы диапазона от 0,0 до 1,0 включительно
См. также:
  • getRed()
  • getGreen()
  • getBlue()
  • getRGB()

Color

public Color(float r, float g, float b, float a)
Создает цвет sRGB с заданными значениями красного, зеленого, синего и альфа-компонентов в диапазоне (0,0–1,0). Фактически используемый при отображении цвет зависит от того, насколько хорошо он соответствует цветовому пространству, доступному для конкретного устройства вывода.
Параметры:
r — красная компонента
g — зеленая компонента
b — синяя компонента
a — альфа-компонента
Исключения:
IllegalArgumentException — если r, g b или a выходят за пределы диапазона от 0,0 до 1,0 включительно
См. также:
  • getRed()
  • getGreen()
  • getBlue()
  • getAlpha()
  • getRGB()

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
См. также:
  • getComponents(float[])
  • getColorComponents(float[])

Подробное описание методов

getRed

public int getRed()
Возвращает красную компоненту в диапазоне 0–255 в пространстве sRGB по умолчанию.
Возвращает:
красную компоненту.
См. также:
  • getRGB()

getGreen

public int getGreen()
Возвращает зеленую компоненту в диапазоне 0–255 в пространстве sRGB по умолчанию.
Возвращает:
зеленую компоненту.
См. также:
  • getRGB()

getBlue

public int getBlue()
Возвращает синюю компоненту в диапазоне 0–255 в пространстве sRGB по умолчанию.
Возвращает:
синюю компоненту.
См. также:
  • getRGB()

getAlpha

public int getAlpha()
Возвращает альфа-компоненту в диапазоне 0–255.
Возвращает:
альфа-компоненту.
См. также:
  • getRGB()

getRGB

public int getRGB()
Возвращает значение RGB, представляющее цвет в модели ColorModel пространства sRGB по умолчанию и состоящее из
  • альфа-компоненты в битах 24–31,
  • красной компоненты в битах 16–23,
  • зеленой компоненты в битах 8–15 и
  • синей компоненты в битах 0–7.
Возвращает:
значение RGB цвета в модели sRGB по умолчанию ColorModel.
Начиная с:
1.0
См. также:
  • ColorModel.getRGBdefault()
  • getRed()
  • getGreen()
  • getBlue()

brighter

public Color brighter()
Создает новый объект Color, представляющий более светлый вариант этого объекта Color.

Этот метод применяет произвольный коэффициент масштабирования к каждой из трех компонент RGB этого объекта Color, чтобы создать его более светлый вариант Color. Значение alpha сохраняется. Хотя brighter и darker являются обратными операциями, результаты последовательных вызовов этих двух методов могут быть непоследовательными из-за ошибок округления.

Возвращает:
новый объект Color, представляющий более светлый вариант этого объекта Color с тем же значением alpha.
Начиная с:
1.0
См. также:
  • darker()

darker

public Color darker()
Создает новый объект Color, представляющий более темный вариант этого объекта Color.

Этот метод применяет произвольный коэффициент масштабирования к каждой из трех компонент RGB этого объекта Color, чтобы создать его более темный вариант Color. Значение alpha сохраняется. Хотя brighter и darker являются обратными операциями, результаты последовательных вызовов этих двух методов могут быть непоследовательными из-за ошибок округления.

Возвращает:
новый объект Color, представляющий более темный вариант этого объекта Color с тем же значением alpha.
Начиная с:
1.0
См. также:
  • brighter()

hashCode

public int hashCode()
Вычисляет хеш-код этого объекта Color.
Переопределяет:
hashCode в классе Object
Возвращает:
значение хеш-кода этого объекта.
Начиная с:
1.0
См. также:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(Object)

equals

public boolean equals(Object obj)
Определяет, равен ли другой объект этому объекту Color.

Результат равен true тогда и только тогда, когда аргумент не равен null и является объектом Color с такими же значениями красного, зеленого, синего и альфа-компонентов, как у этого объекта.

Переопределяет:
equals в классе Object
Параметры:
obj — объект, равенство которого этому объекту Color нужно проверить
Возвращает:
true, если объекты одинаковы; false в противном случае.
Начиная с:
1.0
См. также:
  • Object.hashCode()
  • HashMap

toString

public String toString()
Возвращает строковое представление этого объекта Color. Этот метод предназначен только для отладки. Содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.
Переопределяет:
toString в классе Object
Возвращает:
строковое представление этого объекта Color.

decode

public static Color decode(String nm) throws NumberFormatException
Преобразует String в целое число и возвращает заданный непрозрачный объект Color. Этот метод обрабатывает строковые форматы, используемые для представления восьмеричных и шестнадцатеричных чисел.
Параметры:
nm — String, представляющая непрозрачный цвет в виде 24-разрядного целого числа
Возвращает:
новый объект Color.
Исключения:
NumberFormatException — если указанную строку нельзя интерпретировать как десятичное, восьмеричное или шестнадцатеричное целое число.
Начиная с:
1.1
См. также:
  • Integer.decode(String)

getColor

public static Color getColor(String nm)
Находит цвет в системных свойствах.

Аргумент рассматривается как имя системного свойства, значение которого нужно получить. Строковое значение этого свойства интерпретируется как целое число, которое затем преобразуется в объект Color.

Если указанное свойство не найдено или его значение не удалось преобразовать в целое число, возвращается null.

Параметры:
nm — имя свойства цвета
Возвращает:
объект Color, преобразованный из системного свойства.
Начиная с:
1.0
См. также:
  • System.getProperty(java.lang.String)
  • Integer.getInteger(java.lang.String)
  • Color(int)

getColor

public static Color getColor(String nm, Color v)
Находит цвет в системных свойствах.

Первый аргумент рассматривается как имя системного свойства, значение которого нужно получить. Строковое значение этого свойства интерпретируется как целое число, которое затем преобразуется в объект Color.

Если указанное свойство не найдено или его значение не удалось преобразовать в целое число, вместо него возвращается объект Color, заданный вторым аргументом.

Параметры:
nm — имя свойства цвета
v — значение Color по умолчанию
Возвращает:
объект Color, преобразованный из системного свойства, или указанный объект Color.
Начиная с:
1.0
См. также:
  • System.getProperty(java.lang.String)
  • Integer.getInteger(java.lang.String)
  • Color(int)

getColor

public static Color getColor(String nm, int v)
Находит цвет в системных свойствах.

Первый аргумент рассматривается как имя системного свойства, значение которого нужно получить. Строковое значение этого свойства интерпретируется как целое число, которое затем преобразуется в объект Color.

Если указанное свойство не найдено или его значение не удалось преобразовать в целое число, вместо него используется целочисленное значение v, которое преобразуется в объект Color.

Параметры:
nm — имя свойства цвета
v — целочисленное значение цвета по умолчанию
Возвращает:
объект Color, преобразованный из системного свойства, или объект Color, преобразованный из указанного целого числа.
Начиная с:
1.0
См. также:
  • System.getProperty(java.lang.String)
  • Integer.getInteger(java.lang.String)
  • Color(int)

HSBtoRGB

public static int HSBtoRGB(float hue, float saturation, float brightness)
Преобразует компоненты цвета, заданные моделью HSB, в эквивалентный набор значений модели RGB по умолчанию.

Компоненты saturation и brightness должны быть числами с плавающей точкой от нуля до единицы (значения в диапазоне 0,0–1,0). Компонента hue может быть любым числом с плавающей точкой. Из этого числа вычитается его целая часть, чтобы получить дробное число от 0 до 1. Затем это дробное число умножается на 360, чтобы получить угол оттенка в цветовой модели HSB.

Целое число, возвращаемое методом HSBtoRGB, кодирует значение цвета в битах 0–23 целого числа в том же формате, который используется методом getRGB. Это целое число можно передать конструктору Color, принимающему один целочисленный аргумент.

Параметры:
hue — компонента оттенка цвета
saturation — насыщенность цвета
brightness — яркость цвета
Возвращает:
значение RGB цвета с указанными оттенком, насыщенностью и яркостью.
Начиная с:
1.0
См. также:
  • getRGB()
  • Color(int)
  • ColorModel.getRGBdefault()

RGBtoHSB

public static float[] RGBtoHSB(int r, int g, int b, float[] hsbvals)
Преобразует компоненты цвета, заданные моделью RGB по умолчанию, в эквивалентный набор значений оттенка, насыщенности и яркости — трех компонентов модели HSB.

Если аргумент hsbvals равен null, для возврата результата выделяется новый массив. В противном случае метод возвращает массив hsbvals, в который помещаются значения.

Параметры:
r — красная компонента цвета
g — зеленая компонента цвета
b — синяя компонента цвета
hsbvals — массив для возврата трех значений HSB или null
Возвращает:
массив из трех элементов, содержащий оттенок, насыщенность и яркость (именно в таком порядке) цвета с указанными красной, зеленой и синей компонентами.
Начиная с:
1.0
См. также:
  • getRGB()
  • Color(int)
  • ColorModel.getRGBdefault()

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 для создания цветовых шаблонов.
См. также:
  • Paint
  • PaintContext
  • ColorModel
  • Rectangle
  • Rectangle2D
  • AffineTransform
  • RenderingHints

getTransparency

public int getTransparency()
Возвращает режим прозрачности для этого Color. Это необходимо для реализации интерфейса Paint.
Определено в:
getTransparency в интерфейсе Transparency
Возвращает:
режим прозрачности объекта Color.
См. также:
  • Paint
  • Transparency
  • createContext(ColorModel, Rectangle, Rectangle2D, AffineTransform, RenderingHints)

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API