java.lang.IllegalArgumentException thrown in java.awt.Color constructor ...






Documentation Contents
p, li {font-family: arial; font-size: 10pt;}


java.lang.IllegalArgumentException Thrown in java.awt.Color Constructor

Symptoms

When running an applet in a browser using the Sun JavaTM Runtime Environment (JRETM) implementation, a java.lang.IllegalArgumentException
is thrown in the java.awt.Color constructor. The same applet
runs under the Microsoft Virtual Machine (VM).

Cause

This exception is caused by passing over-bound or under-bound values to
the Color constructor in the Sun JRE.
The Java class libraries in the Sun JRE have changed over time. Some APIs
have been clarified, some have been deprecated, and some have had their implementation
altered.
The result of passing values beyond the upper and lower bounds in the Color
constructor is not well defined. The Microsoft VM readjusts the values to maximum color values and minimum color values automatically. The Sun JRE uses a java.lang.IllegalArgumentException
to indicate that an out-of-bounds value is specified.

Resolution

Code to ensure that only valid color values are passed to the Color
constructor. For example, if you have the following structure of code:

  void Color newColor(int r, int g, int b)
{
return new Color(r, g, b);
}

Change the code to ensure that only valid color values are passed to the color constructor as shown below:



        int ensureColorRange(int v)
{
if (v < 0)
return 0;
else if (v > 255)
return 255;
else
return v;
}
void Color newColor(int r, int g, int b)
{
r = ensureColorRange(r);
g = ensureColorRange(g);
b = ensureColorRange(b);

return new Color(r, g, b);
}


Related Information

None.
 






Copyright © 1995-2010 Sun Microsystems, Inc. All Rights Reserved. Please send comments using this Feedback page.

Java Technology