ColorSpace JDK 1.6)

Description

publicabstract abstract class ColorSpace

This abstract class is used to serve as a color space tag to identify the specific color space of a Color object or, via a ColorModel object, of an Image, a BufferedImage, or a GraphicsDevice.

This abstract class is used to serve as a color space tag to identify the specific color space of a Color object or, via a ColorModel object, of an Image, a BufferedImage, or a GraphicsDevice. It contains methods that transform colors in a specific color space to/from sRGB and to/from a well-defined CIEXYZ color space.

For purposes of the methods in this class, colors are represented as arrays of color components represented as floats in a normalized range defined by each ColorSpace. For many ColorSpaces (e.g. sRGB), this range is 0.0 to 1.0. However, some ColorSpaces have components whose values have a different range. Methods are provided to inquire per component minimum and maximum normalized values.

Several variables are defined for purposes of referring to color space types (e.g. TYPE_RGB, TYPE_XYZ, etc.) and to refer to specific color spaces (e.g. CS_sRGB and CS_CIEXYZ). sRGB is a proposed standard RGB color space. For more information, see http://www.w3.org/pub/WWW/Graphics/Color/sRGB.html .

The purpose of the methods to transform to/from the well-defined CIEXYZ color space is to support conversions between any two color spaces at a reasonably high degree of accuracy. It is expected that particular implementations of subclasses of ColorSpace (e.g. ICC_ColorSpace) will support high performance conversion based on underlying platform color management systems.

The CS_CIEXYZ space used by the toCIEXYZ/fromCIEXYZ methods can be described as follows:


      CIEXYZ
      viewing illuminance: 200 lux
      viewing white point: CIE D50
      media white point: "that of a perfectly reflecting diffuser" -- D50 
      media black point: 0 lux or 0 Reflectance
      flare: 1 percent
      surround: 20percent of the media white point
      media description: reflection print (i.e., RLAB, Hunt viewing media)
      note: For developers creating an ICC profile for this conversion
            space, the following is applicable.  Use a simple Von Kries
            white point adaptation folded into the 3X3 matrix parameters
            and fold the flare and surround effects into the three
            one-dimensional lookup tables (assuming one uses the minimal
            model for monitors).

See also: ICC_ColorSpace

Methods

Hide/Show inherited methods

publicabstract float fromCIEXYZ (float[] colorvalue)

Transforms a color value assumed to be in the CS_CIEXYZ conversion color space into this ColorSpace.

publicabstract float fromRGB (float[] rgbvalue)

Transforms a color value assumed to be in the default CS_sRGB color space into this ColorSpace.

publicstatic ColorSpace getInstance (int colorspace)

Returns a ColorSpace representing one of the specific predefined color spaces.

Returns a ColorSpace representing one of the specific
predefined color spaces.
Returns: the requested ColorSpace object
Parameters:
- colorspace - a specific color space identified by one of the predefined class constants (e.g. CS_sRGB, CS_LINEAR_RGB, CS_CIEXYZ, CS_GRAY, or CS_PYCC)

public float getMaxValue (int component)

Returns the maximum normalized color component value for the specified component.

public float getMinValue (int component)

Returns the minimum normalized color component value for the specified component.

public String getName (int idx)

Returns the name of the component given the component index.

Returns the name of the component given the component index.
Returns: the name of the component at the specified index
Parameters:
- idx - the component index
Throws:
- IllegalArgumentException - if idx is less than 0 or greater than numComponents - 1

public int getNumComponents ()

Returns the number of components of this ColorSpace.

Returns the number of components of this ColorSpace.
Returns: The number of components in this ColorSpace.

public int getType ()

Returns the color space type of this ColorSpace (for example TYPE_RGB, TYPE_XYZ, ...).

Returns the color space type of this ColorSpace (for example
TYPE_RGB, TYPE_XYZ, ...). The type defines the
number of components of the color space and the interpretation,
e.g. TYPE_RGB identifies a color space with three components - red,
green, and blue. It does not define the particular color
characteristics of the space, e.g. the chromaticities of the
primaries.
Returns: the type constant that represents the type of this ColorSpace

pack-privatestatic boolean isCS_CIEXYZ (ColorSpace cspace)

public boolean isCS_sRGB ()

Returns true if the ColorSpace is CS_sRGB.

Returns true if the ColorSpace is CS_sRGB.
Returns: true if this is a CS_sRGB color space, false if it is not

publicabstract float toCIEXYZ (float[] colorvalue)

Transforms a color value assumed to be in this ColorSpace into the CS_CIEXYZ conversion color space.

publicabstract float toRGB (float[] colorvalue)

Transforms a color value assumed to be in this ColorSpace into a value in the default CS_sRGB color space.

Fields

Hide/Show inherited fields

publicfinalstatic int CS_CIEXYZ = "1001"

The CIEXYZ conversion color space defined above.

publicfinalstatic int CS_GRAY = "1003"

The built-in linear gray scale color space.

publicfinalstatic int CS_LINEAR_RGB = "1004"

A built-in linear RGB color space.

publicfinalstatic int CS_PYCC = "1002"

The Photo YCC conversion color space.

publicfinalstatic int CS_sRGB = "1000"

The sRGB color space defined at http://www.w3.org/pub/WWW/Graphics/Color/sRGB.html .

pack-privatefinalstatic long serialVersionUID = "-409452704308689724"

publicfinalstatic int TYPE_2CLR = "12"

Generic 2 component color spaces.

publicfinalstatic int TYPE_3CLR = "13"

Generic 3 component color spaces.

publicfinalstatic int TYPE_4CLR = "14"

Generic 4 component color spaces.

publicfinalstatic int TYPE_5CLR = "15"

Generic 5 component color spaces.

publicfinalstatic int TYPE_6CLR = "16"

Generic 6 component color spaces.

publicfinalstatic int TYPE_7CLR = "17"

Generic 7 component color spaces.

publicfinalstatic int TYPE_8CLR = "18"

Generic 8 component color spaces.

publicfinalstatic int TYPE_9CLR = "19"

Generic 9 component color spaces.

publicfinalstatic int TYPE_ACLR = "20"

Generic 10 component color spaces.

publicfinalstatic int TYPE_BCLR = "21"

Generic 11 component color spaces.

publicfinalstatic int TYPE_CCLR = "22"

Generic 12 component color spaces.

publicfinalstatic int TYPE_CMY = "11"

Any of the family of CMY color spaces.

publicfinalstatic int TYPE_CMYK = "9"

Any of the family of CMYK color spaces.

publicfinalstatic int TYPE_DCLR = "23"

Generic 13 component color spaces.

publicfinalstatic int TYPE_ECLR = "24"

Generic 14 component color spaces.

publicfinalstatic int TYPE_FCLR = "25"

Generic 15 component color spaces.

publicfinalstatic int TYPE_GRAY = "6"

Any of the family of GRAY color spaces.

publicfinalstatic int TYPE_HLS = "8"

Any of the family of HLS color spaces.

publicfinalstatic int TYPE_HSV = "7"

Any of the family of HSV color spaces.

publicfinalstatic int TYPE_Lab = "1"

Any of the family of Lab color spaces.

publicfinalstatic int TYPE_Luv = "2"

Any of the family of Luv color spaces.

publicfinalstatic int TYPE_RGB = "5"

Any of the family of RGB color spaces.

publicfinalstatic int TYPE_XYZ = "0"

Any of the family of XYZ color spaces.

publicfinalstatic int TYPE_YCbCr = "3"

Any of the family of YCbCr color spaces.

publicfinalstatic int TYPE_Yxy = "4"

Any of the family of Yxy color spaces.