|
Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Color extends Object implements Paint, Serializable
Color class используется, чтобы инкапсулировать цвета в значении по умолчанию sRGB цветовое пространство или цвета в произвольных цветовых пространствах, идентифицированных a ColorSpace. У каждого цвета есть неявное альфа-значение 1.0 или явный, обеспеченный в конструкторе. Альфа-значение определяет прозрачность цвета и может быть представлено значением плавающим в диапазоне 0.0 - 1.0 или 0 - 255. Альфа-значение 1.0 или 255 средств, что цвет абсолютно непрозрачен и альфа-значение 0 или 0.0 средств, что цвет абсолютно прозрачен. Создавая a Color с явной альфой или получением компонентов цвета/альфы a Color, компоненты цвета никогда не предварительно умножаются на альфа-компонент. Пространство цвета по умолчанию для Java, 2-D (ТМ) API, является sRGB, предложенным стандартным цветовым пространством RGB. Для дополнительной информации о sRGB см. .
ColorSpace, AlphaComposite, Сериализированная Форма| Модификатор и Тип | Поле и Описание |
|---|---|
static Color |
черный
Цветной афроамериканец.
|
static Color |
ЧЕРНЫЙ
Цветной афроамериканец.
|
static Color |
синий
Цветной синий цвет.
|
static Color |
СИНИЙ
Цветной синий цвет.
|
static Color |
синий
Синий цвет.
|
static Color |
СИНИЙ
Синий цвет.
|
static Color |
DARK_GRAY
Цветной темно-серый цвет.
|
static Color |
darkGray
Цветной темно-серый цвет.
|
static Color |
серый
Цветная серость.
|
static Color |
СЕРЫЙ
Цветная серость.
|
static Color |
зеленый
Цветной зеленый цвет.
|
static Color |
ЗЕЛЕНЫЙ
Цветной зеленый цвет.
|
static Color |
LIGHT_GRAY
Цветной светло-серый цвет.
|
static Color |
lightGray
Цветной светло-серый цвет.
|
static Color |
пурпурный
Пурпурный цвет.
|
static Color |
ПУРПУРНЫЙ
Пурпурный цвет.
|
static Color |
оранжевый
Оранжевый цвет.
|
static Color |
ОРАНЖЕВЫЙ
Оранжевый цвет.
|
static Color |
розовый
Цветная гвоздика.
|
static Color |
РОЗОВЫЙ
Цветная гвоздика.
|
static Color |
красный
Цветная краснота.
|
static Color |
КРАСНЫЙ
Цветная краснота.
|
static Color |
белый
Цветной белый.
|
static Color |
БЕЛЫЙ
Цветной белый.
|
static Color |
желтый
Цветной желтый цвет.
|
static Color |
ЖЕЛТЫЙ
Цветной желтый цвет.
|
BITMASK, OPAQUE, TRANSLUCENT| Конструктор и Описание |
|---|
Color(ColorSpace cspace, float[] components, float alpha)
Создает цвет в указанном
ColorSpace с компонентами цвета, определенными в float массив и указанная альфа. |
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 rgba, boolean hasalpha)
Создает цвет sRGB с указанным объединенным значением RGBA, состоящим из альфа-компонента в битах 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).
|
| Модификатор и Тип | Метод и Описание |
|---|---|
Цвет |
brighter()
Создает новое
Color это - более яркая версия этого Color. |
PaintContext |
createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints)
Создает и возвращает a
PaintContext используемый, чтобы генерировать полевой образец чистого цвета. |
Цвет |
darker()
Создает новое
Color это - более темная версия этого Color. |
static Color |
decode(String nm)
Преобразовывает a
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, Color v)
Находит цвет в системных свойствах.
|
static Color |
getColor(String nm, int v)
Находит цвет в системных свойствах.
|
float[] |
getColorComponents(ColorSpace cspace, float[] compArray)
Возвраты a
float массив, содержащий только компоненты цвета Color в ColorSpace определенный cspace параметр. |
float[] |
getColorComponents(float[] compArray)
Возвраты a
float массив, содержащий только компоненты цвета Color, в ColorSpace из Color. |
ColorSpace |
getColorSpace()
Возвраты
ColorSpace из этого Color. |
float[] |
getComponents(ColorSpace cspace, float[] compArray)
Возвраты a
float массив, содержащий цвет и альфа-компоненты Color, в ColorSpace определенный cspace параметр. |
float[] |
getComponents(float[] compArray)
Возвраты a
float массив, содержащий цвет и альфа-компоненты Color, в ColorSpace из Color. |
int |
getGreen()
Возвращает зеленый компонент в диапазоне 0-255 в значении по умолчанию sRGB пространство.
|
static Color |
getHSBColor(float h, float s, float b)
Создает a
Color основанный на объектах на указанных значениях для цветовой модели HSB. |
int |
getRed()
Возвращает красный компонент в диапазоне 0-255 в значении по умолчанию sRGB пространство.
|
int |
getRGB()
Возвращает значение RGB, представляющее цвет в значении по умолчанию sRGB
ColorModel. |
float[] |
getRGBColorComponents(float[] compArray)
Возвраты a
float массив, содержащий только компоненты цвета Color, в значении по умолчанию sRGB цветовое пространство. |
float[] |
getRGBComponents(float[] compArray)
Возвраты a
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.
|
Строка |
toString()
Возвращает строковое представление этого
Color. |
public static final Color white
public static final Color WHITE
public static final Color lightGray
public static final Color LIGHT_GRAY
public static final Color gray
public static final Color GRAY
public static final Color darkGray
public static final Color DARK_GRAY
public static final Color black
public static final Color BLACK
public static final Color red
public static final Color RED
public static final Color pink
public static final Color PINK
public static final Color orange
public static final Color ORANGE
public static final Color yellow
public static final Color YELLOW
public static final Color green
public static final Color GREEN
public static final Color magenta
public static final Color MAGENTA
public static final Color cyan
public static final Color CYAN
public static final Color blue
public static final Color BLUE
public Color(int r,
int g,
int b)
r - красный компонентg - зеленый компонентb - синий компонентIllegalArgumentException - если r, g или b за пределами диапазона от 0 до 255, включительноgetRed(), getGreen(), getBlue(), getRGB()@ConstructorProperties(value={"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, включительноgetRed(), getGreen(), getBlue(), getAlpha(), getRGB()public Color(int rgb)
rgb - объединенные компоненты RGBColorModel.getRGBdefault(), getRed(), getGreen(), getBlue(), getRGB()public Color(int rgba,
boolean hasalpha)
hasalpha параметр false, альфа принимается значение по умолчанию к 255.rgba - объединенные компоненты RGBAhasalpha - true если альфа-биты допустимы; false иначеColorModel.getRGBdefault(), getRed(), getGreen(), getBlue(), getAlpha(), getRGB()public Color(float r,
float g,
float b)
r - красный компонентg - зеленый компонентb - синий компонентIllegalArgumentException - если r, g или b за пределами диапазона 0.0 к 1.0, включительноgetRed(), getGreen(), getBlue(), getRGB()public Color(float r,
float g,
float b,
float a)
r - красный компонентg - зеленый компонентb - синий компонентa - альфа-компонентIllegalArgumentException - если r, g
b или a за пределами диапазона 0.0 к 1.0, включительноgetRed(), getGreen(), getBlue(), getAlpha(), getRGB()public Color(ColorSpace cspace, float[] components, float alpha)
ColorSpace с компонентами цвета, определенными в float массив и указанная альфа. Число компонентов определяется типом ColorSpace. Например, RGB требует 3 компонентов, но CMYK требует 4 компонентов.cspace - ColorSpace использоваться, чтобы интерпретировать компонентыcomponents - произвольное число компонентов цвета, которое является совместимым с ColorSpacealpha - альфа-значениеIllegalArgumentException - если любое из значений в components массив или alpha за пределами диапазона 0.0 к 1.0getComponents(float[]), getColorComponents(float[])public int getRed()
getRGB()public int getGreen()
getRGB()public int getBlue()
getRGB()public int getAlpha()
getRGB()public int getRGB()
ColorModel. (Биты 24-31 являются альфой, 16-23 являются красными, 8-15 зелены, 0-7 являются синими).ColorModel.ColorModel.getRGBdefault(), getRed(), getGreen(), getBlue()public Color brighter()
Color это - более яркая версия этого Color. Этот метод применяет произвольный масштабный коэффициент к каждому из трех компонентов RGB этого Color создать более яркую версию этого Color. alpha значение сохраняется. Хотя brighter и darker обратные операции, результаты серии вызовов этих двух методов могли бы быть непоследовательными из-за погрешностей округления.
Color объект, который является более яркой версией этого Color с тем же самым alpha значение.darker()public Color darker()
Color это - более темная версия этого Color. Этот метод применяет произвольный масштабный коэффициент к каждому из трех компонентов RGB этого Color создать более темную версию этого Color. alpha значение сохраняется. Хотя brighter и darker обратные операции, результаты серии вызовов этих двух методов могли бы быть непоследовательными из-за погрешностей округления.
Color объект, который является более темной версией этого Color с тем же самым alpha значение.brighter()public int hashCode()
Color.hashCode в class ObjectObject.equals(java.lang.Object), System.identityHashCode(java.lang.Object)public boolean equals(Object obj)
Color. Результат true если и только если параметр не null и a Color объект, у которого есть та же самая краснота, зеленая, синяя, и альфа-значения как этот объект.
equals в class Objectobj - объект протестировать на равенство с этим Colortrue если объекты являются тем же самым; false иначе.Object.hashCode(), HashMappublic String toString()
Color. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели. Контент и формат возвращенной строки могли бы измениться между реализациями. Возвращенная строка могла бы быть пустой, но не может быть null.public static Color decode(String nm) throws NumberFormatException
String к целому числу и возвратам указанное непрозрачное Color. Этот метод обрабатывает строковые форматы, которые используются, чтобы представить восьмеричные и шестнадцатеричные числа.nm - a String это представляет непрозрачный цвет как 24-разрядное целое числоColor объект.NumberFormatException - если указанная строка не может быть интерпретирована как десятичное, восьмеричное, или шестнадцатеричное целое число.Integer.decode(java.lang.String)public static Color getColor(String nm)
Параметр обрабатывается как имя системного свойства, которое будет получено. Строковое значение этого свойства тогда интерпретируется как целое число, которое тогда преобразовывается в a Color объект.
Если указанное свойство не находится или не могло бы быть проанализировано как целое число тогда null возвращается.
nm - имя свойства цветаColor преобразованный из системного свойства.System.getProperty(java.lang.String), Integer.getInteger(java.lang.String), Color(int)public static Color getColor(String nm, Color v)
Первый параметр обрабатывается как имя системного свойства, которое будет получено. Строковое значение этого свойства тогда интерпретируется как целое число, которое тогда преобразовывается в a Color объект.
Если указанное свойство не находится или не может быть проанализировано как целое число тогда Color определенный вторым параметром возвращается вместо этого.
nm - имя свойства цветаv - значение по умолчанию ColorColor преобразованный из системного свойства, или указанного Color.System.getProperty(java.lang.String), Integer.getInteger(java.lang.String), Color(int)public static Color getColor(String nm, int v)
Первый параметр обрабатывается как имя системного свойства, которое будет получено. Строковое значение этого свойства тогда интерпретируется как целое число, которое тогда преобразовывается в a Color объект.
Если указанное свойство не находится или не могло бы быть проанализировано как целое число тогда целочисленное значение v используется вместо этого, и преобразовывается в a Color объект.
nm - имя свойства цветаv - значение цвета по умолчанию, как целое числоColor преобразованный из системного свойства или Color преобразованный из указанного целого числа.System.getProperty(java.lang.String), Integer.getInteger(java.lang.String), Color(int)public static int HSBtoRGB(float hue,
float saturation,
float brightness)
saturation и brightness компоненты должны быть значениями с плавающей точкой между нулем и одним (числа в диапазоне 0.0-1.0). hue компонент может быть любым числом с плавающей точкой. Этаж этого числа вычитается из этого, чтобы создать часть между 0 и 1. Это дробное число тогда умножается на 360, чтобы произвести угол оттенка в цветовой модели HSB.
Целое число, которое возвращается HSBtoRGB кодирует значение цвета в битах 0-23 из целочисленного значения, которое является тем же самым форматом, используемым методом . Это целое число может быть предоставлено как параметр getRGBColor конструктор, который берет единственный целочисленный параметр.
hue - компонент оттенка цветаsaturation - насыщенность цветаbrightness - яркость цветаgetRGB(), Color(int), ColorModel.getRGBdefault()public static float[] RGBtoHSB(int r,
int g,
int b,
float[] hsbvals)
Если hsbvals параметр null, тогда новый массив выделяется, чтобы возвратить результат. Иначе, метод возвращает массив hsbvals, со значениями, помещенными в тот массив.
r - красный компонент цветаg - зеленый компонент цветаb - синий компонент цветаhsbvals - массив имел обыкновение возвращать три значения HSB, или nullgetRGB(), Color(int), ColorModel.getRGBdefault()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 объект с указанным оттенком, насыщенностью, и яркостью.public float[] getRGBComponents(float[] compArray)
float массив, содержащий цвет и альфа-компоненты Color, как представлено в значении по умолчанию sRGB цветовое пространство. Если compArray null, массив длины 4 создается для возвращаемого значения. Иначе, compArray должен иметь длину 4 или больше, и это заполнено в компонентами и возвратилось.compArray - массив, который этот метод заполняет цветом и альфа-компонентами и возвратамиfloat массив.public float[] getRGBColorComponents(float[] compArray)
float массив, содержащий только компоненты цвета Color, в значении по умолчанию sRGB цветовое пространство. Если compArray null, массив длины 3 создается для возвращаемого значения. Иначе, compArray должен иметь длину 3 или больше, и это заполнено в компонентами и возвратилось.compArray - массив, который этот метод заполняет компонентами цвета и возвратамиfloat массив.public float[] getComponents(float[] compArray)
float массив, содержащий цвет и альфа-компоненты Color, в ColorSpace из Color. Если compArray null, массив с длиной, равной числу компонентов в связанном ColorSpace плюс каждый создается для возвращаемого значения. Иначе, compArray должен иметь, по крайней мере, эту длину, и это заполнено в компонентами и возвратилось.compArray - массив, который этот метод заполняет цветом и альфа-компонентами этого Color в ColorSpace и возвратыfloat массив.public float[] getColorComponents(float[] compArray)
float массив, содержащий только компоненты цвета Color, в ColorSpace из Color. Если compArray null, массив с длиной, равной числу компонентов в связанном ColorSpace создается для возвращаемого значения. Иначе, compArray должен иметь, по крайней мере, эту длину, и это заполнено в компонентами и возвратилось.compArray - массив, который этот метод заполняет компонентами цвета этого Color в ColorSpace и возвратыfloat массив.public float[] getComponents(ColorSpace cspace, float[] compArray)
float массив, содержащий цвет и альфа-компоненты Color, в ColorSpace определенный cspace параметр. Если compArray null, массив с длиной, равной числу компонентов в cspace плюс каждый создается для возвращаемого значения. Иначе, compArray должен иметь, по крайней мере, эту длину, и это заполнено в компонентами и возвратилось.cspace - указанное ColorSpacecompArray - массив, который этот метод заполняет цветом и альфа-компонентами этого Color в указанном ColorSpace и возвратыfloat массив.public float[] getColorComponents(ColorSpace cspace, float[] compArray)
float массив, содержащий только компоненты цвета Color в ColorSpace определенный cspace параметр. Если compArray null, массив с длиной, равной числу компонентов в cspace создается для возвращаемого значения. Иначе, compArray должен иметь, по крайней мере, эту длину, и это заполнено в компонентами и возвратилось.cspace - указанное ColorSpacecompArray - массив, который этот метод заполняет компонентами цвета этого Color в указанном ColorSpacefloat массив.public ColorSpace getColorSpace()
ColorSpace из этого Color.Color объект ColorSpace.public PaintContext createContext(ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints)
PaintContext используемый, чтобы генерировать полевой образец чистого цвета. См. specification из метода в Paint интерфейс для информации о нулевой обработке параметра.createContext в интерфейсе Paintcm - привилегированное ColorModel который представляет самый удобный формат для вызывающей стороны, чтобы получить пиксельные данные, или null если нет никакого предпочтения.r - ограничивающий прямоугольник пространства устройства представляемого графического примитива.r2d - ограничивающий прямоугольник пространства пользователя представляемого графического примитива.xform - AffineTransform от пространства пользователя в пространство устройства.hints - набор подсказок, что объект контекста может использовать, чтобы выбрать между рендерингом альтернатив.PaintContext для того, чтобы генерировать цветные узоры.Paint, PaintContext, ColorModel, Rectangle, Rectangle2D, AffineTransform, RenderingHintspublic int getTransparency()
Color. Это обязано реализовывать Paint интерфейс.getTransparency в интерфейсе TransparencyColor режим прозрачности объекта.Paint, Transparency, createContext(java.awt.image.ColorModel, java.awt.Rectangle, java.awt.geom.Rectangle2D, java.awt.geom.AffineTransform, java.awt.RenderingHints)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92