public class

BogusColorSpace

extends ColorSpace
java.lang.Object
   ↳ java.awt.color.ColorSpace
     ↳ com.sun.imageio.plugins.common.BogusColorSpace

Class Overview

A dummy ColorSpace to enable ColorModel for image data which do not have an innate color representation.

Summary

[Expand]
Inherited Constants
From class java.awt.color.ColorSpace
Public Constructors
BogusColorSpace(int numComponents)
Constructs a bogus ColorSpace.
Public Methods
float[] fromCIEXYZ(float[] xyzvalue)
Transforms a color value assumed to be in the CS_CIEXYZ conversion color space into this ColorSpace.
float[] fromRGB(float[] rgbvalue)
Transforms a color value assumed to be in the default CS_sRGB color space into this ColorSpace.
float[] toCIEXYZ(float[] colorvalue)
Transforms a color value assumed to be in this ColorSpace into the CS_CIEXYZ conversion color space.
float[] toRGB(float[] colorvalue)
Transforms a color value assumed to be in this ColorSpace into a value in the default CS_sRGB color space.
[Expand]
Inherited Methods
From class java.awt.color.ColorSpace
From class java.lang.Object

Public Constructors

public BogusColorSpace (int numComponents)

Constructs a bogus ColorSpace.

Parameters
numComponents The number of components in the ColorSpace.
Throws
IllegalArgumentException if numComponents is less than 1.

Public Methods

public float[] fromCIEXYZ (float[] xyzvalue)

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

This method transforms color values using relative colorimetry, as defined by the International Color Consortium standard. This means that the XYZ argument values taken by this method are represented relative to the D50 white point of the CS_CIEXYZ color space. This representation is useful in a two-step color conversion process in which colors are transformed from an input color space to CS_CIEXYZ and then to an output color space. The color values returned by this method are not those that would produce the XYZ value passed to the method when measured by a colorimeter. If you have XYZ values corresponding to measurements made using current CIE recommended practices, they must be converted to D50 relative values before being passed to this method. See the fromCIEXYZ method of ICC_ColorSpace for further information.

Parameters
xyzvalue a float array with length of at least 3
Returns
  • a float array with length equal to the number of components in this ColorSpace

public float[] fromRGB (float[] rgbvalue)

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

This method transforms color values using algorithms designed to produce the best perceptual match between input and output colors. In order to do colorimetric conversion of color values, you should use the toCIEXYZ method of the CS_sRGB color space to first convert from the input color space to the CS_CIEXYZ color space, and then use the fromCIEXYZ method of this color space to convert from CS_CIEXYZ to the output color space. See toCIEXYZ and fromCIEXYZ for further information.

Parameters
rgbvalue a float array with length of at least 3
Returns
  • a float array with length equal to the number of components in this ColorSpace

public float[] toCIEXYZ (float[] colorvalue)

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

This method transforms color values using relative colorimetry, as defined by the International Color Consortium standard. This means that the XYZ values returned by this method are represented relative to the D50 white point of the CS_CIEXYZ color space. This representation is useful in a two-step color conversion process in which colors are transformed from an input color space to CS_CIEXYZ and then to an output color space. This representation is not the same as the XYZ values that would be measured from the given color value by a colorimeter. A further transformation is necessary to compute the XYZ values that would be measured using current CIE recommended practices. See the toCIEXYZ method of ICC_ColorSpace for further information.

Parameters
colorvalue a float array with length of at least the number of components in this ColorSpace
Returns
  • a float array of length 3

public float[] toRGB (float[] colorvalue)

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

This method transforms color values using algorithms designed to produce the best perceptual match between input and output colors. In order to do colorimetric conversion of color values, you should use the toCIEXYZ method of this color space to first convert from the input color space to the CS_CIEXYZ color space, and then use the fromCIEXYZ method of the CS_sRGB color space to convert from CS_CIEXYZ to the output color space. See toCIEXYZ and fromCIEXYZ for further information.

Parameters
colorvalue a float array with length of at least the number of components in this ColorSpace
Returns
  • a float array of length 3