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
- произвольное число компонентов цвета, которое является совместимым с ColorSpace
alpha
- альфа-значение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 Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public boolean equals(Object obj)
Color
. Результат true
если и только если параметр не null
и a Color
объект, у которого есть та же самая краснота, зеленая, синяя, и альфа-значения как этот объект.
equals
в class Object
obj
- объект протестировать на равенство с этим Color
true
если объекты являются тем же самым; false
иначе.Object.hashCode()
, HashMap
public 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
- значение по умолчанию Color
Color
преобразованный из системного свойства, или указанного 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 из целочисленного значения, которое является тем же самым форматом, используемым методом
. Это целое число может быть предоставлено как параметр getRGB
Color
конструктор, который берет единственный целочисленный параметр.
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, или null
getRGB()
, 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
- указанное ColorSpace
compArray
- массив, который этот метод заполняет цветом и альфа-компонентами этого Color
в указанном ColorSpace
и возвратыfloat
массив.public float[] getColorComponents(ColorSpace cspace, float[] compArray)
float
массив, содержащий только компоненты цвета Color
в ColorSpace
определенный cspace
параметр. Если compArray
null
, массив с длиной, равной числу компонентов в cspace
создается для возвращаемого значения. Иначе, compArray
должен иметь, по крайней мере, эту длину, и это заполнено в компонентами и возвратилось.cspace
- указанное ColorSpace
compArray
- массив, который этот метод заполняет компонентами цвета этого Color
в указанном ColorSpace
float
массив.public ColorSpace getColorSpace()
ColorSpace
из этого Color
.Color
объект ColorSpace
.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
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)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92