Класс Color

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 .

Поля

white

public static final Color white

Цвет белый. В стандартном пространстве sRGB.

WHITE

public static final Color WHITE

Цвет белый. В стандартном пространстве sRGB.

Since:

1.4

lightGray

public static final Color lightGray

Светло-серый цвет. В стандартном пространстве sRGB.

LIGHT_GRAY

public static final Color LIGHT_GRAY

Светло-серый цвет. В стандартном пространстве sRGB.

Since:

1.4

gray

public static final Color gray

Серый цвет. В стандартном пространстве sRGB.

GRAY

public static final Color GRAY

Серый цвет. В стандартном пространстве sRGB.

Since:

1.4

darkGray

public static final Color darkGray

Темно-серый цвет. В стандартном пространстве sRGB.

DARK_GRAY

public static final Color DARK_GRAY

Темно-серый цвет. В стандартном пространстве sRGB.

Since:

1.4

black

public static final Color black

Черный цвет. В стандартном пространстве sRGB.

BLACK

public static final Color BLACK

Черный цвет. В стандартном пространстве sRGB.

Since:

1.4

red

public static final Color red

Красный цвет. В стандартном пространстве sRGB.

RED

public static final Color RED

Красный цвет. В стандартном пространстве sRGB.

Since:

1.4

pink

public static final Color pink

Розовый цвет. В стандартном пространстве sRGB.

PINK

public static final Color PINK

Розовый цвет. В стандартном пространстве sRGB.

Since:

1.4

orange

public static final Color orange

Оранжевый цвет. В стандартном пространстве sRGB.

ORANGE

public static final Color ORANGE

Оранжевый цвет. В стандартном пространстве sRGB.

Since:

1.4

yellow

public static final Color yellow

Желтый цвет. В стандартном пространстве sRGB.

YELLOW

public static final Color YELLOW

Желтый цвет. В стандартном пространстве sRGB.

Since:

1.4

green

public static final Color green

Зеленый цвет. В стандартном пространстве sRGB.

GREEN

public static final Color GREEN

Зеленый цвет. В стандартном пространстве sRGB.

Since:

1.4

magenta

public static final Color magenta

Пурпурный цвет. В стандартном пространстве sRGB.

MAGENTA

public static final Color MAGENTA

Пурпурный цвет. В стандартном пространстве sRGB.

Since:

1.4

cyan

public static final Color cyan

Бирюзовый цвет. В стандартном пространстве sRGB.

CYAN

public static final Color CYAN

Бирюзовый цвет. В стандартном пространстве sRGB.

Since:

1.4

blue

public static final Color blue

Синий цвет. В стандартном пространстве sRGB.

BLUE

public static final Color BLUE

Синий цвет. В стандартном пространстве sRGB.

Since:

1.4

Конструкторы

Color

public Color(int r,
             int g,
             int b)

Создает непрозрачный цвет sRGB с указанными значениями красного, зеленого и синего в диапазоне (0 - 255). Фактический цвет, используемый при рендеринге, зависит от поиска наилучшего соответствия с учетом цветового пространства, доступного для данного выходного устройства. Значение альфа по умолчанию равно 255.

Parameters:

r - красная компонента

g - зеленая компонента

b - синяя компонента

Throws:

IllegalArgumentException - если r, g или b находятся за пределами диапазона от 0 до 255 включительно

See Also:

getRed(), getGreen(), getBlue(), getRGB()

Color

@ConstructorProperties(value={"red","green","blue","alpha"})
public Color(int r,
                                                                          int g,
                                                                          int b,
                                                                          int a)

Создает цвет sRGB с указанными значениями красного, зеленого, синего и альфа в диапазоне (0 - 255).

Parameters:

r - красная компонента

g - зеленая компонента

b - синяя компонента

a - альфа-компонента

Throws:

IllegalArgumentException - если r, g, b или a находятся за пределами диапазона от 0 до 255 включительно

See Also:

getRed(), getGreen(), getBlue(), getAlpha(), getRGB()

Color

public Color(int rgb)

Создает непрозрачный цвет sRGB с указанным комбинированным значением RGB, состоящим из красной компоненты в битах 16-23, зеленой компоненты в битах 8-15 и синей компоненты в битах 0-7. Фактический цвет, используемый при рендеринге, зависит от поиска наилучшего соответствия с учетом цветового пространства, доступного для данного выходного устройства. Значение альфа по умолчанию равно 255.

Parameters:

rgb - комбинированные компоненты RGB

See Also:

ColorModel.getRGBdefault(), getRed(), getGreen(), getBlue(), getRGB()

Color

public Color(int rgba,
             boolean hasalpha)

Создает цвет sRGB с указанным комбинированным значением RGBA, состоящим из альфа-компоненты в битах 24-31, красной компоненты в битах 16-23, зеленой компоненты в битах 8-15 и синей компоненты в битах 0-7. Если аргумент hasalpha равен false, значение альфа по умолчанию равно 255.

Parameters:

rgba - комбинированные компоненты RGBA

hasalpha - true если биты альфа действительны; false в противном случае

See Also:

ColorModel.getRGBdefault(), getRed(), getGreen(), getBlue(), getAlpha(), getRGB()

Color

public Color(float r,
             float g,
             float b)

Создает непрозрачный цвет sRGB с указанными значениями красного, зеленого и синего в диапазоне (0,0 - 1,0). Значение альфа по умолчанию равно 1,0. Фактический цвет, используемый при рендеринге, зависит от поиска наилучшего соответствия с учетом цветового пространства, доступного для данного выходного устройства.

Parameters:

r - красная компонента

g - зеленая компонента

b - синяя компонента

Throws:

IllegalArgumentException - если r, g или b находятся за пределами диапазона от 0,0 до 1,0 включительно

See Also:

getRed(), getGreen(), getBlue(), getRGB()

Color

public Color(float r,
             float g,
             float b,
             float a)

Создает цвет sRGB с указанными значениями красного, зеленого, синего и альфа в диапазоне (0,0 - 1,0). Фактический цвет, используемый при рендеринге, зависит от поиска наилучшего соответствия с учетом цветового пространства, доступного для данного выходного устройства.

Parameters:

r - красная компонента

g - зеленая компонента

b - синяя компонента

a - альфа-компонента

Throws:

IllegalArgumentException - если r, g b или a находятся за пределами диапазона от 0,0 до 1,0 включительно

See Also:

getRed(), getGreen(), getBlue(), getAlpha(), getRGB()

Color

public Color(ColorSpace cspace,
             float[] components,
             float alpha)

Создает цвет в указанном ColorSpace с цветовыми компонентами, указанными в массиве float и указанным значением альфа. Количество компонентов определяется типом ColorSpace. Например, RGB требует 3 компонента, а CMYK — 4 компонента.

Parameters:

cspace - ColorSpace, который будет использоваться для интерпретации компонентов

components - произвольное количество цветовых компонентов, совместимых с ColorSpace

alpha - значение альфа

Throws:

IllegalArgumentException - если любое из значений в массиве components или alpha находится за пределами диапазона от 0,0 до 1,0

See Also:

getComponents(float[]), getColorComponents(float[])

Методы

getRed

public int getRed()

Возвращает красную компоненту в диапазоне 0-255 в стандартном пространстве sRGB.

Returns:

красная компонента.

See Also:

getRGB()

getGreen

public int getGreen()

Возвращает зеленую компоненту в диапазоне 0-255 в стандартном пространстве sRGB.

Returns:

зеленая компонента.

See Also:

getRGB()

getBlue

public int getBlue()

Возвращает синюю компоненту в диапазоне 0-255 в стандартном пространстве sRGB.

Returns:

синяя компонента.

See Also:

getRGB()

getAlpha

public int getAlpha()

Возвращает альфа-компоненту в диапазоне 0-255.

Returns:

альфа-компонента.

See Also:

getRGB()

getRGB

public int getRGB()

Возвращает значение RGB, представляющее цвет в стандартной модели ColorModel sRGB. (Биты 24-31 — альфа, 16-23 — красный, 8-15 — зеленый, 0-7 — синий).

Возвращает:

значение цвета RGB в стандартной модели sRGB ColorModel.

С:

JDK1.0

См. также:

ColorModel.getRGBdefault(), getRed(), getGreen(), getBlue()

brighter

public Color brighter()

Возвращает:

новый объект Color, который является более светлой версией этого объекта Color с тем же значением alpha.

С:

JDK1.0

См. также:

darker()

darker

public Color darker()

Возвращает:

новый объект Color, который является более тёмной версией этого объекта Color с тем же значением alpha.

С:

JDK1.0

См. также:

brighter()

hashCode

public int hashCode()

Вычисляет хэш-код для этого объекта Color.

Переопределяет:

hashCode в классе Object

Возвращает:

значение хэш-кода для этого объекта.

С:

JDK1.0

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

Переопределяет:

equals в классе Object

Параметры:

obj - объект, для сравнения с этим объектом Color

Возвращает:

true если объекты идентичны; false в противном случае.

С:

JDK1.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 - строка, представляющая непрозрачный цвет в виде 24-битового целого числа

Возвращает:

новый объект Color.

Исключение:

NumberFormatException - если заданная строка не может быть интерпретирована как десятичное, восьмеричное или шестнадцатеричное целое число.

С:

JDK1.1

См. также:

Integer.decode(java.lang.String)

getColor

public static Color getColor(String nm)

Параметры:

nm - имя свойства цвета

Возвращает:

объект Color преобразованный из системного свойства.

С:

JDK1.0

См. также:

System.getProperty(java.lang.String), Integer.getInteger(java.lang.String), Color(int)

getColor

public static Color getColor(String nm,
                             Color v)

Параметры:

nm - имя свойства цвета

v - значение по умолчанию Color

Возвращает:

объект Color преобразованный из системного свойства, или указанный объект Color.

С:

JDK1.0

См. также:

System.getProperty(java.lang.String), Integer.getInteger(java.lang.String), Color(int)

getColor

public static Color getColor(String nm,
                             int v)

Параметры:

nm - имя свойства цвета

v - значение цвета по умолчанию, как целое число

Возвращает:

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

С:

JDK1.0

См. также:

System.getProperty(java.lang.String), Integer.getInteger(java.lang.String), Color(int)

HSBtoRGB

public static int HSBtoRGB(float hue,
                           float saturation,
                           float brightness)

Параметры:

hue - компонент оттенка цвета

saturation - насыщенность цвета

brightness - яркость цвета

Возвращает:

значение цвета RGB с указанными оттенком, насыщенностью и яркостью.

С:

JDK1.0

См. также:

getRGB(), Color(int), ColorModel.getRGBdefault()

RGBtoHSB

public static float[] RGBtoHSB(int r,
                               int g,
                               int b,
                               float[] hsbvals)

Параметры:

r - красный компонент цвета

g - зелёный компонент цвета

b - синий компонент цвета

hsbvals - массив для возвращения трёх значений HSB, или null

Возвращает:

массив из трёх элементов, содержащий оттенок, насыщенность и яркость (в этом порядке) цвета с указанными красным, зелёным и синим компонентами.

С:

JDK1.0

См. также:

getRGB(), Color(int), ColorModel.getRGBdefault()

getHSBColor

public static Color getHSBColor(float h,
                                float s,
                                float b)

Параметры:

h - компонент оттенка

s - насыщенность цвета

b - яркость цвета

Возвращает:

объект Color с указанным оттенком, насыщенностью и яркостью.

С:

JDK1.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, в заданном цветовом пространстве, указанном параметром cspace. Если compArray равно null, создаётся массив длиной равной количеству компонентов в cspace плюс один для возвращаемого значения. В противном случае, compArray должен иметь как минимум такую длину, и он заполняется компонентами и возвращается.

Параметры:

cspace - заданное цветовое пространство

compArray - массив, который этот метод заполняет компонентами цвета и альфа-канала этого объекта Color в заданном цветовом пространстве и возвращает

Возвращает:

компоненты цвета и альфа-канала в массиве float.

getColorComponents

public float[] getColorComponents(ColorSpace cspace,
                                  float[] compArray)

Возвращает массив float содержащий только компоненты цвета объекта Color в заданном цветовом пространстве, указанном параметром cspace. Если compArray равно null, создаётся массив длиной равной количеству компонентов в cspace для возвращаемого значения. В противном случае, compArray должен иметь как минимум такую длину, и он заполняется компонентами и возвращается.

Параметры:

cspace - заданное цветовое пространство

compArray - массив, который этот метод заполняет компонентами цвета этого объекта Color в заданном цветовом пространстве

Возвращает:

компоненты цвета в массиве float.

getColorSpace

public ColorSpace getColorSpace()

Возвращает цветовое пространство этого объекта Color.

Возвращает:

цветовое пространство объекта Color.

createContext

public PaintContext createContext(ColorModel cm,
                                  Rectangle r,
                                  Rectangle2D r2d,
                                  AffineTransform xform,
                                  RenderingHints hints)

Создаёт и возвращает PaintContext, используемый для создания шаблона заливки твёрдым цветом. См. 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(java.awt.image.ColorModel, java.awt.Rectangle, java.awt.geom.Rectangle2D, java.awt.geom.AffineTransform, java.awt.RenderingHints)