metric=string or name : the type of color distance to use

new = truefalse : option passed to GetColorNames if palette is not specified

number =  posint : the maximum number of nearby colors to return

palette : a palette or palette name, a list of palettes and/or palette names, or "all"

threshold = float : a maximum distance.  If number is not specified all results closer than this value will be returned.

The NearestNamedColor command locates one or more of the nearest named colors to the input color.

It returns one or more named colors, along with the distances from the input color. When there is only one result, that single nearest color name is output, along with the distance in the specified metric (cie94 by default).

When the number of outputs is greater than one, then the output is a list of the nearest colors and distances, closest first.

$\mathrm{with}\left(\mathrm{ColorTools}\right)\:$

$\mathrm{NearestNamedColor}\left(\left[255\,16\,0\right]\right)$

$\left[''Red''\,0.00538421830630291\right]$

$\mathrm{NearestNamedColor}\left(\left[255\,16\,0\right]\,\mathrm{metric}=''RGB''\right)$

$\left[''Red''\,0.03622589921\right]$

$\mathrm{NearestNamedColor}\left(''\#f10''\,\mathrm{new}=\mathrm{false}\right)$

$\left[''red''\,0.00582244455010256\right]$

$\mathrm{NearestNamedColor}\left(''\#f10''\,\mathrm{number}=3\,\mathrm{palette}=\left[''css''\,\mathrm{GetPalette}\left(''niagara''\right)\right]\right)$

$\left[\left[''CSS\; Red''\,0.00582244455010256\right]\,\left[''CSS\; Maroon''\,0.304924827107045\right]\,\left[''CSS\; Orange''\,0.320683392648266\right]\right]$

$\mathrm{NearestNamedColor}\left(''\#cab''\,\mathrm{number}=3\,\mathrm{palette}=''all''\right)$

$\left[\left[''Resene\; Lily''\,0.0219490766547210\right]\,\left[''Generic\; LightGrayishPurpleRed''\,0.0393340868515053\right]\,\left[''Generic\; LightGrayishRedPurple''\,0.0405215490441851\right]\right]$

The ColorTools:-NearestNamedColor command was introduced in Maple 16.

For more information on Maple 16 changes, see Updates in Maple 16.