Purpose:
Give the user the ability to get a darker version of a color.

Parameters:

Returns:
Returns a new color, a specified percentage closer to black.

Example #1:
The following code will create a random color in the left cell below the code.  After that, it will create a darker version of that color in the cell to the right of it:

var c = Color.random(); var c2 = c.getDarker(); with($("#tblEx1 TR:element(last) TD:element(first)")) { setCSS("background-color", c.toString()); setCSS("border", "1px solid " + c.toGrayscale()); setCSS("color", c.getSafeColor().toString()); setText("Original Color: " + c.toString()); } with($("#tblEx1 TR:element(last) TD:element(last)")) { setCSS("background-color", c2.toString()); setCSS("border", "1px solid " + c2.toGrayscale()); setCSS("color", c2.getSafeColor().toString()); setText("Darker Color: " + c2.toString()); }

Example #2:
The following example will mimic the above example but will use 50 as the percentage:

var c = Color.random(); var c2 = c.getDarker(50); with($("#tblEx2 TR:element(last) TD:element(first)")) { setCSS("background-color", c.toString()); setCSS("border", "1px solid " + c.toGrayscale()); setCSS("color", c.getSafeColor().toString()); setText("Original Color: " + c.toString()); } with($("#tblEx2 TR:element(last) TD:element(last)")) { setCSS("background-color", c2.toString()); setCSS("border", "1px solid " + c2.toGrayscale()); setCSS("color", c2.getSafeColor().toString()); setText("Darker Color: " + c2.toString()); }

See also:

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