This function is guaranteed to return a color index for a requested color, either the exact color or the closest possible alternative.
This function is guaranteed to return a color index for a requested color, either the exact color or the closest possible alternative.