| javax.media.jai.ColorSpaceJAI
All known Subclasses: javax.media.jai.IHSColorSpace,
| ColorSpaceJAI | | abstract public class ColorSpaceJAI extends ColorSpace (Code) | | An abstract subclass of ColorSpace which adds methods to
transform colors represented as pixels in a Raster between
a specific color space and either sRGB or a well-defined C.I.E. X,Y,Z
color space. As mentioned in the documentation of
ColorSpace ,
sRGB is a proposed standard default RGB color space for the Internet.
This class is particularly applicable for use with color
spaces which are mathematically defined and for which no I.C.C. profile
is readily available. (Note however that color conversions specified
by a simple matrix transformation might best be effected using the
"BandCombine" operation.) The JAI "ColorConvert" operation recognizes when
an instance of ColorSpaceJAI is present and uses the
Raster-based conversion methods to improve performance.
This is possible because without the ColorSpaceJAI definition,
a ColorSpace which was not an
ICC_ColorSpace would permit color conversion only by means of pixel-by-pixel invocations
of toCIEXYZ(float[]) and fromCIEXYZ(float[]) (or,
equivalently toRGB(float[]) and
fromRGB(float[])).
See Also: java.awt.color.ColorSpace
See Also: java.awt.color.ICC_ColorSpace
See Also: javax.media.jai.operator.ColorConvertDescriptor
See Also: javax.media.jai.operator.BandCombineDescriptor
since:
JAI 1.1 |
| Constructor Summary | |
| protected | ColorSpaceJAI(int type, int numComponents, boolean isRGBPreferredIntermediary)
Constructs a ColorSpaceJAI object given the color space
type, the number of components, and an indicator of the preferred
intermediary or connection color space. |
| Method Summary | |
| public static WritableRaster | CIEXYZToRGB(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)
Transforms the pixel data in the source Raster from
CIEXYZ to sRGB. | | static void | CIEXYZToRGBByte(UnpackedImageData src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)
| | static void | RGB2XYZ(float[] RGB, float[] XYZ)
| | public static WritableRaster | RGBToCIEXYZ(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)
Transforms the pixel data in the source Raster from
sRGB to CIEXYZ. | | static void | XYZ2RGB(float[] XYZ, float[] RGB)
| | protected static void | checkParameters(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)
Verify that the parameters are compatible with the limitations
of the static methods
ColorSpaceJAI.CIEXYZToRGB and
ColorSpaceJAI.RGBToCIEXYZ . | | static void | convertToSigned(double[] buf, int dataType)
After conversion, the range of a signed short is
[0, Short.MAX_Value-Short.MIN_VALUE] and that
of an integer is [0, 0xFFFFFFFFL]. | | abstract public WritableRaster | fromCIEXYZ(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)
Transforms the pixel data in the source Raster from
CIEXYZ values with respect to the CIE D50 white point to the color
space represented by this class. | | abstract public WritableRaster | fromRGB(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)
Transforms the pixel data in the source Raster from
sRGB to the color space represented by this class.
If the destination WritableRaster is null,
a new WritableRaster will be created. | | public boolean | isRGBPreferredIntermediary()
Whether sRGB is the preferred intermediary color space when converting
to another color space which is neither sRGB nor CIEXYZ. | | abstract public WritableRaster | toCIEXYZ(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)
Transforms the pixel data in the source Raster from
the color space represented by this class to CIEXYZ values with
respect to the CIE D50 white point. | | abstract public WritableRaster | toRGB(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)
Transforms the pixel data in the source Raster from
the color space represented by this class to sRGB.
If the destination WritableRaster is null,
a new WritableRaster will be created. |
| ColorSpaceJAI | | protected ColorSpaceJAI(int type, int numComponents, boolean isRGBPreferredIntermediary)(Code) | | Constructs a ColorSpaceJAI object given the color space
type, the number of components, and an indicator of the preferred
intermediary or connection color space.
Parameters:
type - The color space type (ColorSpace.TYPE_*).
Parameters:
numComponents - The number of color components.
Parameters:
isRGBPreferredIntermediary - Whether sRGB (true)or CIEXYZ (false) is the preferred connectioncolor space.
exception:
IllegalArgumentException - if numComponentsis non-positive. |
| CIEXYZToRGB | | public static WritableRaster CIEXYZToRGB(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)(Code) | | Transforms the pixel data in the source Raster from
CIEXYZ to sRGB. It is assumed that the input XYZ values are
represented relative to the CIE D50 white point of the
ColorSpace.CS_CIEXYZ color space. Integral data will
be normalized according to the number of bits specified for the
respective component; floating point data should be between 0.0 and
1.0 + (32767.0 / 32768.0). All integral data
are assumed to be unsigned; signed data should be shifted by the
caller before invoking this method.
The exact sequence of transformations applied is as follows:
- If the source data are integral, convert the digital codes to
CIE XYZ values in the range
[0.0, Fmax]
as:
Fd50 = Fmax * Isrc / 2Msrc
where
Isrc is the digital code of a source color component
Msrc is the number of significant bits per source color
component
Fmax is 1.0 + (32767.0 / 32768.0)
Fd50 is the corresponding CIE XYZ value relative to CIE D50
If the source data are floating point no scaling is performed and it
is assumed that the data are already clipped to the range
[0.0, 1.0 + (32767.0 / 32768.0)].
- Perform chromatic adaptation from the CIE D50 white point to the
CIE D65 white point as described in
ICC_ColorSpace.fromCIEXYZ :
Xd65 = Xd50 * (Xwd65 / Xwd50)
Yd65 = Yd50 * (Ywd65 / Ywd50)
Zd65 = Zd50 * (Zwd65 / Zwd50)
where
Xd50, Yd50, Zd50 are the XYZ values relative to CIE D50
Xwd65, Ywd65, Zwd65 are the CIE D65 white point values
Xwd50, Ywd50, Zwd50 are the CIE D50 white point values
Xd65, Yd65, Zd65 are the XYZ values relative to CIE D65
Substituting the actual CIE D50 and D65 white point values in the
above gives:
Xd65 = Xd50 * (0.3127/0.3457)
Yd65 = Yd50 * (0.3291/0.3585)
Zd65 = Zd50 * (0.3582/0.2958)
- Calculate sRGB tristimulus values as:
[ RsRGB ] [ 3.2406 -1.5372 -0.4986 ] [ Xd65 ]
[ GsRGB ] = [ -0.9689 1.8758 0.0415 ] [ Yd65 ]
[ BsRGB ] [ 0.0557 -0.2040 1.0570 ] [ Zd65 ]
-
Clip sRGB tristimulus values to the range
[0.0, 1.0].
- Transform sRGB tristimulus values to non-linear sR'G'B' values as:
C'sRGB = 12.92*CsRGB if CsRGB <= 0.0031308
C'sRGB = 1.055*CsRGB(1.0/2.4) - 0.055 if CsRGB > 0.0031308
where
CsRGB is a sRGB tristimulus value
C'sRGB is the corresponding non-linear sR'G'B' value
- If the destination data are integral, convert the non-linear
sR'G'B' values to digital codes as:
Idest = round(C'sRGB * 2Mdest)
where
C'sRGB is the a non-linear sR'G'B' value
Mdest is the number of significant bits per destination color
component
Idest is the digital code of a destination color component
If the destination data are floating point neither scaling nor rounding
is performed.
If the destination WritableRaster is null,
a new WritableRaster will be created. The
Rasters are treated as having no alpha channel, i.e.,
all bands are color bands.
This method is provided for the convenience of extenders defining
a color space for which the conversion is defined with respect to
CIEXYZ.
It should be noted that there is no official specification
of sRGB with respect to digital codes of depths other than 8 bits.
The present implementation for other bit depths is provided as an
extrapolation of the 8-bit sRGB standard and its use should be
recognized as such. The extrapolation is implemented by replacing
the white digital count (WDC) and black digital count
(KDC) in the 8-bit sRGB specification with values
corresponding to the extrema of the data type in question when
treated as unsigned. For all data types KDC is zero
and WDC is specified by the component size
parameters.
Parameters:
src - the source Raster to be converted.
Parameters:
srcComponentSize - array that specifies the number of significantbits per source color component; ignored for floating point data.If null defaults to the value returned bysrc.getSampleModel().getSampleSize().
Parameters:
dest - the destination WritableRaster,or null.
Parameters:
destComponentSize - array that specifies the number of significantbits per destination color component; ignored for floating pointdata. If null, defaults to the value returned bydest.getSampleModel().getSampleSize(), or the samplesize of the newly created destination WritableRaster if dest isnull. dest color converted from srcor a new, WritableRaster containing the convertedpixels if dest is null.
exception:
IllegalArgumentException - if src isnull, the number of source or destinationbands is not 3, or either component size arrayis non-null and has length not equal to 3. |
| CIEXYZToRGBByte | | static void CIEXYZToRGBByte(UnpackedImageData src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)(Code) | | |
| RGB2XYZ | | static void RGB2XYZ(float[] RGB, float[] XYZ)(Code) | | |
| RGBToCIEXYZ | | public static WritableRaster RGBToCIEXYZ(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)(Code) | | Transforms the pixel data in the source Raster from
sRGB to CIEXYZ. The output XYZ values are represented relative to
the CIE D50 white point of the ColorSpace.CS_CIEXYZ
color space. Integral data will be normalized according to the
number of bits specified for the respective component; floating
point data should be between 0.0 and 1.0. All integral data are
assumed to be unsigned; signed data should be shifted by the caller
before invoking this method.
The exact sequence of transformations applied is as follows:
- If the source data are integral, convert the digital codes to
non-linear sRGB values in the range
[0.0, 1.0] as:
C'sRGB = Isrc / 2Msrc
where
Isrc is the digital code of a source color component
Msrc is the number of significant bits per source color
component
C'sRGB is the corresponding sR'G'B' value
If the source data are floating point no scaling is performed and it
is assumed that the data are already clipped to the range
[0.0, 1.0].
- Transform non-linear sR'G'B' values to sRGB tristimulus values
as:
CsRGB = C'sRGB/12.92 if C'sRGB <= 0.04045
CsRGB = [(C'sRGB + 0.055)/1.055]2.4 if C'sRGB > 0.04045
where
C'sRGB is a non-linear sR'G'B' value
CsRGB is the corresponding sRGB tristimulus value
- Calculate CIE XYZ D65-relative values as:
[ Xd65 ] [ 0.4124 0.3576 0.1805 ] [ RsRGB ]
[ Yd65 ] = [ 0.2126 0.7152 0.0722 ] [ GsRGB ]
[ Zd65 ] [ 0.0193 0.1192 0.9505 ] [ BsRGB ]
- Perform chromatic adaptation from the CIE D65 white point to the
CIE D50 white point as described in
ICC_ColorSpace.toCIEXYZ :
Xd50 = Xd65 * (Xwd50 / Xwd65)
Yd50 = Yd65 * (Ywd50 / Ywd65)
Zd50 = Zd65 * (Zwd50 / Zwd65)
where
Xd65, Yd65, Zd65 are the XYZ values relative to CIE D65
Xwd50, Ywd50, Zwd50 are the CIE D50 white point values
Xwd65, Ywd65, Zwd65 are the CIE D65 white point values
Xd50, Yd50, Zd50 are the XYZ values relative to CIE D50
Substituting the actual CIE D50 and D65 white point values in the
above gives:
Xd50 = Xd65 * (0.3457/0.3127)
Yd50 = Yd65 * (0.3585/0.3291)
Zd50 = Zd65 * (0.2958/0.3582)
- If the destination data are integral, convert the CIE XYZ
values to digital codes as:
Idest = round(Fd50 * 2Mdest / Fmax)
where
Fd50 is a CIE XYZ value relative to CIE D50
Mdest is the number of significant bits per destination color
component
Fmax is 1.0 + (32767.0 / 32768.0)
Idest is the digital code of a destination color component
If the destination data are floating point neither scaling nor rounding
is performed.
If the destination WritableRaster is null,
a new WritableRaster will be created. The
Rasters are treated as having no alpha channel, i.e.,
all bands are color bands.
This method is provided for the convenience of extenders defining
a color space for which the conversion is defined with respect to
sRGB.
It should be noted that there is no official specification
of sRGB with respect to digital codes of depths other than 8 bits.
The present implementation for other bit depths is provided as an
extrapolation of the 8-bit sRGB standard and its use should be
recognized as such. The extrapolation is implemented by replacing
the white digital count (WDC) and black digital count
(KDC) in the 8-bit sRGB specification with values
corresponding to the extrema of the data type in question when
treated as unsigned. For all data types KDC is zero
and WDC is specified by the component size
parameters.
Parameters:
src - the source Raster to be converted.
Parameters:
srcComponentSize - array that specifies the number of significantbits per source color component; ignored for floating point data.If null defaults to the value returned bysrc.getSampleModel().getSampleSize().
Parameters:
dest - the destination WritableRaster,or null.
Parameters:
destComponentSize - array that specifies the number of significantbits per destination color component; ignored for floating pointdata. If null, defaults to the value returned bydest.getSampleModel().getSampleSize(), or the samplesize of the newly created destination WritableRaster if dest isnull. dest color converted from srcor a new, WritableRaster containing the convertedpixels if dest is null.
exception:
IllegalArgumentException - if src isnull, the number of source or destinationbands is not 3, or either component size arrayis non-null and has length not equal to 3. |
| XYZ2RGB | | static void XYZ2RGB(float[] XYZ, float[] RGB)(Code) | | |
| convertToSigned | | static void convertToSigned(double[] buf, int dataType)(Code) | | After conversion, the range of a signed short is
[0, Short.MAX_Value-Short.MIN_VALUE] and that
of an integer is [0, 0xFFFFFFFFL]. To avoid
clamping, convert the value to a signed integer with the same
binary bits. If the dataType parameter is either
DataBuffer.TYPE_SHORT or DataBuffer.TYPE_INT
then the array is modified in place; otherwise the method has no
effect.
Parameters:
buf - Array of post-conversion digital codes.
Parameters:
dataType - The data type: one of the constants TYPE_*defined in DataBuffer. |
| fromCIEXYZ | | abstract public WritableRaster fromCIEXYZ(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)(Code) | | Transforms the pixel data in the source Raster from
CIEXYZ values with respect to the CIE D50 white point to the color
space represented by this class. If the destination
WritableRaster is null, a new
WritableRaster will be created. The
Rasters are treated as having no alpha channel, i.e.,
all bands are color bands.
If required by the underlying transformation, integral data will
be normalized according to the number of bits of the respective
component; floating point data should be between 0.0 and
1.0 + (32767.0 / 32768.0).
All integral data are assumed to be unsigned; signed data should be
shifted by the caller before invoking this method.
Parameters:
src - the source Raster to be converted.
Parameters:
srcComponentSize - array that specifies the number of significantbits per source color component; ignored for floating point data.If null defaults to the value returned bysrc.getSampleModel().getSampleSize().
Parameters:
dest - the destination WritableRaster,or null.
Parameters:
destComponentSize - array that specifies the number of significantbits per destination color component; ignored for floating pointdata. If null, defaults to the value returned bydest.getSampleModel().getSampleSize(), or the samplesize of the newly created destination WritableRaster if dest isnull. dest color converted from srcor a new, WritableRaster containing the convertedpixels if dest is null.
exception:
IllegalArgumentException - if src isnull, the number of source or destinationbands does not equal the number of components of therespective color space, or either component size arrayis non-null and has length not equal to the number ofbands in the respective Raster. |
| fromRGB | | abstract public WritableRaster fromRGB(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)(Code) | | Transforms the pixel data in the source Raster from
sRGB to the color space represented by this class.
If the destination WritableRaster is null,
a new WritableRaster will be created. The
Rasters are treated as having no alpha channel, i.e.,
all bands are color bands.
If required by the underlying transformation, integral data will
be normalized according to the number of bits of the respective
component; floating point data should be between 0.0 and 1.0.
All integral data are assumed to be unsigned; signed data should be
shifted by the caller before invoking this method.
Parameters:
src - the source Raster to be converted.
Parameters:
srcComponentSize - array that specifies the number of significantbits per source color component; ignored for floating point data.If null defaults to the value returned bysrc.getSampleModel().getSampleSize().
Parameters:
dest - the destination WritableRaster,or null.
Parameters:
destComponentSize - array that specifies the number of significantbits per destination color component; ignored for floating pointdata. If null, defaults to the value returned bydest.getSampleModel().getSampleSize(), or the samplesize of the newly created destination WritableRaster if dest isnull. dest color converted from srcor a new, WritableRaster containing the convertedpixels if dest is null.
exception:
IllegalArgumentException - if src isnull, the number of source or destinationbands does not equal the number of components of therespective color space, or either component size arrayis non-null and has length not equal to the number ofbands in the respective Raster. |
| isRGBPreferredIntermediary | | public boolean isRGBPreferredIntermediary()(Code) | | Whether sRGB is the preferred intermediary color space when converting
to another color space which is neither sRGB nor CIEXYZ. This
serves to indicate the more efficient conversion pathway.
true if sRGB is preferred, or falseif CIEXYZ is preferred. |
| toCIEXYZ | | abstract public WritableRaster toCIEXYZ(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)(Code) | | Transforms the pixel data in the source Raster from
the color space represented by this class to CIEXYZ values with
respect to the CIE D50 white point. If the destination
WritableRaster is null, a new
WritableRaster will be created. The
Rasters are treated as having no alpha channel, i.e.,
all bands are color bands.
If required by the underlying transformation, integral data will
be normalized according to the number of bits of the respective
component; floating point data should be between 0.0 and 1.0.
All integral data are assumed to be unsigned; signed data should be
shifted by the caller before invoking this method.
Parameters:
src - the source Raster to be converted.
Parameters:
srcComponentSize - array that specifies the number of significantbits per source color component; ignored for floating point data.If null defaults to the value returned bysrc.getSampleModel().getSampleSize().
Parameters:
dest - the destination WritableRaster,or null.
Parameters:
destComponentSize - array that specifies the number of significantbits per destination color component; ignored for floating pointdata. If null, defaults to the value returned bydest.getSampleModel().getSampleSize(), or the samplesize of the newly created destination WritableRaster if dest isnull. dest color converted from srcor a new, WritableRaster containing the convertedpixels if dest is null.
exception:
IllegalArgumentException - if src isnull, the number of source or destinationbands does not equal the number of components of therespective color space, or either component size arrayis non-null and has length not equal to the number ofbands in the respective Raster. |
| toRGB | | abstract public WritableRaster toRGB(Raster src, int[] srcComponentSize, WritableRaster dest, int[] destComponentSize)(Code) | | Transforms the pixel data in the source Raster from
the color space represented by this class to sRGB.
If the destination WritableRaster is null,
a new WritableRaster will be created. The
Rasters are treated as having no alpha channel, i.e.,
all bands are color bands.
If required by the underlying transformation, integral data will
be normalized according to the number of bits of the respective
component; floating point data should be between 0.0 and 1.0.
All integral data are assumed to be unsigned; signed data should be
shifted by the caller before invoking this method.
Parameters:
src - the source Raster to be converted.
Parameters:
srcComponentSize - array that specifies the number of significantbits per source color component; ignored for floating point data.If null defaults to the value returned bysrc.getSampleModel().getSampleSize().
Parameters:
dest - the destination WritableRaster,or null.
Parameters:
destComponentSize - array that specifies the number of significantbits per destination color component; ignored for floating pointdata. If null, defaults to the value returned bydest.getSampleModel().getSampleSize(), or the samplesize of the newly created destination WritableRaster if dest isnull. dest color converted from srcor a new, WritableRaster containing the convertedpixels if dest is null.
exception:
IllegalArgumentException - if src isnull, the number of source or destinationbands does not equal the number of components of therespective color space, or either component size arrayis non-null and has length not equal to the number ofbands in the respective Raster. |
|
|