Color JDK 1.6)

Constructors

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

Creates a color in the specified ColorSpace with the color components specified in the float array and the specified alpha.

Creates a color in the specified ColorSpace
with the color components specified in the float
array and the specified alpha. The number of components is
determined by the type of the ColorSpace. For
example, RGB requires 3 components, but CMYK requires 4
components.
Parameters:
- cspace - the ColorSpace to be used to interpret the components
- components - an arbitrary number of color components that is compatible with the ColorSpace
- alpha - alpha value
Throws:
- IllegalArgumentException - if any of the values in the components array or alpha is outside of the range 0.0 to 1.0
See Also: Color.getComponents(float[]), Color.getColorComponents(float[]),

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

Creates an opaque sRGB color with the specified red, green, and blue values in the range (0.0 - 1.0).

Creates an opaque sRGB color with the specified red, green, and blue
values in the range (0.0 - 1.0). Alpha is defaulted to 1.0. The
actual color used in rendering depends on finding the best
match given the color space available for a particular output
device.
Parameters:
- r - the red component
- g - the green component
- b - the blue component
Throws:
- IllegalArgumentException - if r, g or b are outside of the range 0.0 to 1.0, inclusive
See Also: Color.getRed(), Color.getGreen(), Color.getBlue(), Color.getRGB(),

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

Creates an sRGB color with the specified red, green, blue, and alpha values in the range (0.0 - 1.0).

Creates an sRGB color with the specified red, green, blue, and
alpha values in the range (0.0 - 1.0). The actual color
used in rendering depends on finding the best match given the
color space available for a particular output device.
Parameters:
- r - the red component
- g - the green component
- b - the blue component
- a - the alpha component
Throws:
- IllegalArgumentException - if r, g b or a are outside of the range 0.0 to 1.0, inclusive
See Also: Color.getRed(), Color.getGreen(), Color.getBlue(), Color.getAlpha(), Color.getRGB(),

public Color (int rgb)

Creates an opaque sRGB color with the specified combined RGB value consisting of the red component in bits 16-23, the green component in bits 8-15, and the blue component in bits 0-7.

public Color (int rgba, boolean hasalpha)

Creates an sRGB color with the specified combined RGBA value consisting
of the alpha component in bits 24-31, the red component in bits 16-23,
the green component in bits 8-15, and the blue component in bits 0-7.
If the hasalpha argument is false, alpha
is defaulted to 255.
Parameters:
- rgba - the combined RGBA components
- hasalpha - true if the alpha bits are valid; false otherwise
See Also: ColorModel.getRGBdefault(), Color.getRed(), Color.getGreen(), Color.getBlue(), Color.getAlpha(), Color.getRGB(),

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

Creates an opaque sRGB color with the specified red, green, and blue values in the range (0 - 255).

Creates an opaque sRGB color with the specified red, green,
and blue values in the range (0 - 255).
The actual color used in rendering depends
on finding the best match given the color space
available for a given output device.
Alpha is defaulted to 255.
Parameters:
- r - the red component
- g - the green component
- b - the blue component
Throws:
- IllegalArgumentException - if r, g or b are outside of the range 0 to 255, inclusive
See Also: Color.getRed(), Color.getGreen(), Color.getBlue(), Color.getRGB(),

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

Creates an sRGB color with the specified red, green, blue, and alpha values in the range (0 - 255).

Creates an sRGB color with the specified red, green, blue, and alpha
values in the range (0 - 255).
Parameters:
- r - the red component
- g - the green component
- b - the blue component
- a - the alpha component
Throws:
- IllegalArgumentException - if r, g, b or a are outside of the range 0 to 255, inclusive
See Also: Color.getRed(), Color.getGreen(), Color.getBlue(), Color.getAlpha(), Color.getRGB(),

Methods

Hide/Show inherited methods

public Color brighter ()

Creates a new Color that is a brighter version of this Color.

This method applies an arbitrary scale factor to each of the three RGB components of this Color to create a brighter version of this Color. Although brighter and darker are inverse operations, the results of a series of invocations of these two methods might be inconsistent because of rounding errors.
Returns: a new Color object that is a brighter version of this Color.
Since: JDK1.0
See Also: Color.darker(),

publicsynchronized PaintContext createContext (ColorModel cm, Rectangle r, Rectangle2D r2d, AffineTransform xform, RenderingHints hints) [Specified in Paint]

Creates and returns a PaintContext used to generate a solid color pattern.

Creates and returns a PaintContext used to generate a solid
color pattern. This enables a Color object to be used
as an argument to any method requiring an object implementing the
Paint interface.
The same PaintContext is returned, regardless of
whether or not r, r2d,
xform, or hints are null.
Returns: a PaintContext that is used to generate a solid color pattern.
Parameters:
- cm - the specified ColorModel
- r - the specified {@link Rectangle}
- r2d - the specified {@link Rectangle2D}
- xform - the specified {@link AffineTransform}
- hints - the specified {@link RenderingHints}
See Also: Paint, PaintContext, Graphics2D.setPaint(java.awt.Paint),

public Color darker ()

Creates a new Color that is a darker version of this Color.

This method applies an arbitrary scale factor to each of the three RGB components of this Color to create a darker version of this Color. Although brighter and darker are inverse operations, the results of a series of invocations of these two methods might be inconsistent because of rounding errors.
Returns: a new Color object that is a darker version of this Color.
Since: JDK1.0
See Also: Color.brighter(),

publicstatic Color decode (String nm) throws NumberFormatException

Converts a String to an integer and returns the specified opaque Color.

Converts a String to an integer and returns the
specified opaque Color. This method handles string
formats that are used to represent octal and hexidecimal numbers.
Returns: the new Color object.
Parameters:
- nm - a String that represents an opaque color as a 24-bit integer
Throws:
- NumberFormatException - if the specified string cannot be interpreted as a decimal, octal, or hexidecimal integer.
Since: JDK1.1
See Also: Integer.decode(java.lang.String),

public boolean equals (Object obj)

Determines whether another object is equal to this Color.

The result is true if and only if the argument is not null and is a Color object that has the same red, green, blue, and alpha values as this object.
Returns: true if the objects are the same; false otherwise.
Parameters:
- obj - the object to test for equality with this Color
Since: JDK1.0

public int getAlpha ()

Returns the alpha component in the range 0-255.

public int getBlue ()

Returns the blue component in the range 0-255 in the default sRGB space.

publicstatic Color getColor (String nm)

Finds a color in the system properties.

publicstatic Color getColor (String nm, Color v)

Finds a color in the system properties.

publicstatic Color getColor (String nm, int v)

Finds a color in the system properties.

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

Returns a float array containing only the color components of the Color in the ColorSpace specified by the cspace parameter.

Returns a float array containing only the color
components of the Color in the
ColorSpace specified by the cspace
parameter. If compArray is null, an array
with length equal to the number of components in
cspace is created for the return value. Otherwise,
compArray must have at least this length, and it is
filled in with the components and returned.
Returns: the color components in a float array.
Parameters:
- cspace - a specified ColorSpace
- compArray - an array that this method fills with the color components of this Color in the specified ColorSpace

public float getColorComponents (float[] compArray)

Returns a float array containing only the color components of the Color, in the ColorSpace of the Color.

Returns a float array containing only the color
components of the Color, in the
ColorSpace of the Color.
If compArray is null, an array with
length equal to the number of components in the associated
ColorSpace is created for
the return value. Otherwise, compArray must have at
least this length and it is filled in with the components and
returned.
Returns: the color components in a float array.
Parameters:
- compArray - an array that this method fills with the color components of this Color in its ColorSpace and returns

public ColorSpace getColorSpace ()

Returns the ColorSpace of this Color.

Returns the ColorSpace of this Color.
Returns: this Color object's ColorSpace.

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

Returns a float array containing the color and alpha components of the Color, in the ColorSpace specified by the cspace parameter.

Returns a float array containing the color and alpha
components of the Color, in the
ColorSpace specified by the cspace
parameter. If compArray is null, an
array with length equal to the number of components in
cspace plus one is created for the return value.
Otherwise, compArray must have at least this
length, and it is filled in with the components and returned.
Returns: the color and alpha components in a float array.
Parameters:
- cspace - a specified ColorSpace
- compArray - an array that this method fills with the color and alpha components of this Color in the specified ColorSpace and returns

public float getComponents (float[] compArray)

Returns a float array containing the color and alpha components of the Color, in the ColorSpace of the Color.

Returns a float array containing the color and alpha
components of the Color, in the
ColorSpace of the Color.
If compArray is null, an array with
length equal to the number of components in the associated
ColorSpace plus one is created for
the return value. Otherwise, compArray must have at
least this length and it is filled in with the components and
returned.
Returns: the color and alpha components in a float array.
Parameters:
- compArray - an array that this method fills with the color and alpha components of this Color in its ColorSpace and returns

public int getGreen ()

Returns the green component in the range 0-255 in the default sRGB space.

publicstatic Color getHSBColor (float h, float s, float b)

Creates a Color object based on the specified values for the HSB color model.

The s and b components should be floating-point values between zero and one (numbers in the range 0.0-1.0). The h component can be any floating-point number. The floor of this number is subtracted from it to create a fraction between 0 and 1. This fractional number is then multiplied by 360 to produce the hue angle in the HSB color model.
Returns: a Color object with the specified hue, saturation, and brightness.
Parameters:
- h - the hue component
- s - the saturation of the color
- b - the brightness of the color
Since: JDK1.0

public int getRed ()

Returns the red component in the range 0-255 in the default sRGB space.

public int getRGB ()

Returns the RGB value representing the color in the default sRGB ColorModel.

Returns the RGB value representing the color in the default sRGB
ColorModel.
(Bits 24-31 are alpha, 16-23 are red, 8-15 are green, 0-7 are
blue).
Returns: the RGB value of the color in the default sRGB ColorModel.
Since: JDK1.0
See Also: ColorModel.getRGBdefault(), Color.getRed(), Color.getGreen(), Color.getBlue(),

public float getRGBColorComponents (float[] compArray)

Returns a float array containing only the color components of the Color, in the default sRGB color space.

Returns a float array containing only the color
components of the Color, in the default sRGB color
space. If compArray is null, an array of
length 3 is created for the return value. Otherwise,
compArray must have length 3 or greater, and it is
filled in with the components and returned.
Returns: the RGB components in a float array.
Parameters:
- compArray - an array that this method fills with color components and returns

public float getRGBComponents (float[] compArray)

Returns a float array containing the color and alpha components of the Color, as represented in the default sRGB color space.

Returns a float array containing the color and alpha
components of the Color, as represented in the default
sRGB color space.
If compArray is null, an array of length
4 is created for the return value. Otherwise,
compArray must have length 4 or greater,
and it is filled in with the components and returned.
Returns: the RGBA components in a float array.
Parameters:
- compArray - an array that this method fills with color and alpha components and returns

public int getTransparency ()

Returns the transparency mode for this Color.

Returns the transparency mode for this Color. This is
required to implement the Paint interface.
Returns: this Color object's transparency mode.
See Also: Paint, Transparency,

Color.createContext(java.awt.image.ColorModel, java.awt.Rectangle, java.awt.geom.Rectangle2D, java.awt.geom.AffineTransform, java.awt.RenderingHints)

public int hashCode ()

Computes the hash code for this Color.

Computes the hash code for this Color.
Returns: a hash code value for this object.
Since: JDK1.0

publicstatic int HSBtoRGB (float hue, float saturation, float brightness)

Converts the components of a color, as specified by the HSB model, to an equivalent set of values for the default RGB model.

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

Converts the components of a color, as specified by the default RGB model, to an equivalent set of values for hue, saturation, and brightness that are the three components of the HSB model.

public String toString ()

Returns a string representation of this Color.

Returns a string representation of this Color. This
method is intended to be used only for debugging purposes. The
content and format of the returned string might vary between
implementations. The returned string might be empty but cannot
be null.
Returns: a string representation of this Color.