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.

Supported Platforms

Windows, Solaris, Linux

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.