com.esri.arcgis.display
Interface ICieLabConversion

All Superinterfaces:

Serializable

All Known Implementing Classes:

CieLabConversion

public interface ICieLabConversion
extends Serializable

Provides access to members that control the CIE Lab conversion.

Description

The CieLabConversion coclass provides information about the location of colors within the CIELAB color space, the device-independent color model used internally by ArcObjects. Colors can be converted from RGB and HSV models to the CIELAB model. It can also be used to compare the visual difference between two colors.

The ICieLabConversion interface provides four methods for converting colors to and from the CIELAB color model (these methods are the ones used by the IColor interface's SetCIELab and GetCIELab methods).

Product Availability

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

See Also:

ICmykColor, IColor, IEnumColors, ICieLabConversion

Method Summary

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.
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.

Method Detail

rgbToLab

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

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

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

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

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

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

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

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

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

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSettingsVersion

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

Returns:

The version

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.