Purpose:
Give the user the ability to get a rough approximation of the luminance of a specific 24-bit color.

Returns:
Returns a number which represents the luminance of the color.  The number will be greater than or equal to 0 and less than or equal to 255.  A light color has a high luminance value.  A dark color has a low luminance value.

Example #1:
The following will instantiate a color using three random decimal digits.  After that, the luminance of the constructed color will be displayed:

// Create a random color. var r = Math.round(255 * Math.random()); var g = Math.round(255 * Math.random()); var b = Math.round(255 * Math.random()); var aColor = new Color(r, g, b); // Display the color as this textbox's background. $("#tblEx1 TEXTAREA").setCSS("background-color", aColor); $("#tblEx1 TEXTAREA").setCSS("color", aColor.getSafeColor()); // Display the three random decimal values and the hexadecimal color code that // they produce. alert("When r = " + r + ", g = " + g + ", and b = " + b + ", the corresponding " + "luminance is " + aColor.getLuminance() + ".");

See also:

• new Color(hexColor)
• new Color(rgbColor)
• new Color(redValue, greenValue, blueValue)
• Color.combine(...)
• Color.getDarker(...)
• Color.getHexCode()
• Color.getLighter(...)
• Color.getOpposite()
• Color.getSafeColor()
• Color.setColor(...)
• Color.toGrayscale()
• Color.toString()