Class ColorSpaces

java.lang.Object

com.twelvemonkeys.imageio.color.ColorSpaces

public final class ColorSpaces
extends Object

A helper class for working with ICC color profiles and color spaces.

Standard ICC color profiles are read from system-specific locations for known operating systems.

Color profiles may be configured by placing a property-file com/twelvemonkeys/imageio/color/icc_profiles.properties on the classpath, specifying the full path to the profiles. ICC color profiles are probably already present on your system, or can be downloaded from ICC, Adobe or other places. *

Example property file:

# icc_profiles.properties
ADOBE_RGB_1998=/path/to/Adobe RGB 1998.icc
GENERIC_CMYK=/path/to/Generic CMYK.icc

Version:

$Id: ColorSpaces.java,v 1.0 24.01.11 17.51 haraldk Exp$

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	ColorSpaces.Key

Field Summary

Fields

Modifier and Type	Field	Description
private static WeakReference<ICC_Profile>	adobeRGB1998
private static final Map<ColorSpaces.Key, ICC_ColorSpace>	cache
static final int	CS_ADOBE_RGB_1998	The Adobe RGB 1998 (or compatible) color space.
static final int	CS_GENERIC_CMYK	A best-effort "generic" CMYK color space.
(package private) static final boolean	DEBUG
private static WeakReference<ICC_Profile>	genericCMYK

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ColorSpaces()

Method Summary

Modifier and Type	Method	Description
static ICC_ColorSpace	createColorSpace(ICC_Profile profile)	Creates an ICC color space from the given ICC color profile.
(package private) static ICC_ColorSpace	getCachedCS(byte[] profileHeader)
private static ICC_ColorSpace	getCachedCS(ColorSpaces.Key profileKey)
private static ICC_ColorSpace	getCachedOrCreateCS(ICC_Profile profile, byte[] profileHeader)
static ColorSpace	getColorSpace(int colorSpace)	Returns the color space specified by the given color space constant.
(package private) static ICC_ColorSpace	getInternalCS(int profileCSType, byte[] profileHeader)
static boolean	isCS_GRAY(ICC_Profile profile)	Deprecated. Use ColorProfiles.isCS_GRAY(ICC_Profile) instead.
static boolean	isCS_sRGB(ICC_Profile profile)	Deprecated. Use ColorProfiles.isCS_sRGB(ICC_Profile) instead.
(package private) static void	validateColorSpace(ICC_ColorSpace cs)
static ICC_Profile	validateProfile(ICC_Profile profile)	Deprecated. Use ColorProfiles.validateProfile(ICC_Profile) instead.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DEBUG

static final boolean DEBUG

CS_ADOBE_RGB_1998

public static final int CS_ADOBE_RGB_1998

The Adobe RGB 1998 (or compatible) color space. Either read from disk or built-in.

See Also:

• Constant Field Values

CS_GENERIC_CMYK

public static final int CS_GENERIC_CMYK

A best-effort "generic" CMYK color space. Either read from disk or built-in.

See Also:

• Constant Field Values

adobeRGB1998

private static WeakReference<ICC_Profile> adobeRGB1998

genericCMYK

private static WeakReference<ICC_Profile> genericCMYK

cache

private static final Map<ColorSpaces.Key, ICC_ColorSpace> cache

Constructor Details

ColorSpaces

private ColorSpaces()

Method Details

createColorSpace

public static ICC_ColorSpace createColorSpace(ICC_Profile profile)

Creates an ICC color space from the given ICC color profile.

For standard Java color spaces, the built-in instance is returned. Otherwise, color spaces are looked up from cache and created on demand.

Parameters:

profile - the ICC color profile. May not be null.

Returns:

an ICC color space

Throws:

IllegalArgumentException - if profile is null.

CMMException - if profile is invalid.

getInternalCS

static ICC_ColorSpace getInternalCS(int profileCSType,
 byte[] profileHeader)

getCachedOrCreateCS

private static ICC_ColorSpace getCachedOrCreateCS(ICC_Profile profile,
 byte[] profileHeader)

getCachedCS

private static ICC_ColorSpace getCachedCS(ColorSpaces.Key profileKey)

getCachedCS

static ICC_ColorSpace getCachedCS(byte[] profileHeader)

validateColorSpace

static void validateColorSpace(ICC_ColorSpace cs)

isCS_sRGB

@Deprecated
public static boolean isCS_sRGB(ICC_Profile profile)

Deprecated.

Use ColorProfiles.isCS_sRGB(ICC_Profile) instead.

isCS_GRAY

@Deprecated
public static boolean isCS_GRAY(ICC_Profile profile)

Deprecated.

Use ColorProfiles.isCS_GRAY(ICC_Profile) instead.

validateProfile

@Deprecated
public static ICC_Profile validateProfile(ICC_Profile profile)

Deprecated.

Use ColorProfiles.validateProfile(ICC_Profile) instead.

getColorSpace

public static ColorSpace getColorSpace(int colorSpace)

Returns the color space specified by the given color space constant.

For standard Java color spaces, the built-in instance is returned. Otherwise, color spaces are looked up from cache and created on demand.

Parameters:

colorSpace - the color space constant.

Returns:

the ColorSpace specified by the color space constant.

Throws:

IllegalArgumentException - if colorSpace is not one of the defined color spaces (CS_*).

See Also:

• ColorSpace
• CS_ADOBE_RGB_1998
• CS_GENERIC_CMYK