com.esri.arcgis.display
Class CieLabConversion

java.lang.Object
  com.esri.arcgis.display.CieLabConversion

All Implemented Interfaces:

ICieLabConversion, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class CieLabConversion
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, ICieLabConversion

Use this class to convert colers from and to the device independent CIELab color space using the monitor settings.

Description

CieLabConversion can convert colors to and from CieLab in either the RGB or HSV color spaces.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Singleton:

This type is a singleton.

See Also:

Serialized Form

Constructor Summary

CieLabConversion()
Constructs a CieLabConversion using ArcGIS Engine.

CieLabConversion(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
CieLabConversion theCieLabConversion = (CieLabConversion) obj;

Method Summary

boolean	equals(Object o) Compare this object with another
static String	getClsid() getClsid.
double	getDistance(double l1, double a1, double b1, double l2, double a2, double b2) Gets visual difference between two CIELAB colors.
int	getSettingsVersion() The monitor settings version.
int	hashCode() the hashcode for this object
void	hsvToLab(short h, byte s, byte v, double[] l, double[] a, double[] b) Converts an RGB color to a CIELAB color.
void	labToHsv(short[] h, byte[] s, byte[] v, double l, double a, double b) Converts a CIELAB color to an RGB color.
void	labToRgb(int[] rGB, double l, double a, double b) Converts a CIELAB color to an RGB color.
void	reloadSettings() Reloads the monitor settings from the registry.
void	rgbToLab(int rGB, double[] l, double[] a, double[] b) Converts an RGB color to a CIELAB color.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef

getJintegraDispatch, release

Constructor Detail

CieLabConversion

public CieLabConversion()
                 throws IOException,
                        UnknownHostException

Constructs a CieLabConversion using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

CieLabConversion

public CieLabConversion(Object obj)
                 throws IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
CieLabConversion theCieLabConversion = (CieLabConversion) obj;

Construct a CieLabConversion using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to CieLabConversion.

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

IOException - if there are interop problems

Method Detail

getClsid

public static String getClsid()

getClsid.

equals

public boolean equals(Object o)

Compare this object with another

Overrides:

equals in class Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class Object

rgbToLab

public void rgbToLab(int rGB,
                     double[] l,
                     double[] a,
                     double[] b)
              throws IOException,
                     AutomationException

Converts an RGB color to a CIELAB color.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

rgbToLab in interface ICieLabConversion

Parameters:

rGB - The rGB (A COM typedef) (in)

l - The l (out: use single element array)

a - The a (in)

b - The b (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

labToRgb

public void labToRgb(int[] rGB,
                     double l,
                     double a,
                     double b)
              throws IOException,
                     AutomationException

Converts a CIELAB color to an RGB color.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

labToRgb in interface ICieLabConversion

Parameters:

rGB - The rGB (A COM typedef) (out: use single element array)

l - The l (in)

a - The a (in)

b - The b (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

hsvToLab

public void hsvToLab(short h,
                     byte s,
                     byte v,
                     double[] l,
                     double[] a,
                     double[] b)
              throws IOException,
                     AutomationException

Converts an RGB color to a CIELAB color.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

hsvToLab in interface ICieLabConversion

Parameters:

h - The h (in)

s - An unsigned byte (in)

v - An unsigned byte (in)

l - The l (out: use single element array)

a - The a (in)

b - The b (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

labToHsv

public void labToHsv(short[] h,
                     byte[] s,
                     byte[] v,
                     double l,
                     double a,
                     double b)
              throws IOException,
                     AutomationException

Converts a CIELAB color to an RGB color.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

labToHsv in interface ICieLabConversion

Parameters:

h - The h (out: use single element array)

s - An unsigned byte (out: use single element array)

v - An unsigned byte (out: use single element array)

l - The l (in)

a - The a (in)

b - The b (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDistance

public double getDistance(double l1,
                          double a1,
                          double b1,
                          double l2,
                          double a2,
                          double b2)
                   throws IOException,
                          AutomationException

Gets visual difference between two CIELAB colors.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

getDistance in interface ICieLabConversion

Parameters:

l1 - The l1 (in)

a1 - The a1 (in)

b1 - The b1 (in)

l2 - The l2 (in)

a2 - The a2 (in)

b2 - The b2 (in)

Returns:

The dist

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

reloadSettings

public void reloadSettings()
                    throws IOException,
                           AutomationException

Reloads the monitor settings from the registry.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

reloadSettings in interface ICieLabConversion

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSettingsVersion

public int getSettingsVersion()
                       throws IOException,
                              AutomationException

The monitor settings version.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

getSettingsVersion in interface ICieLabConversion

Returns:

The version

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.