Provides methods to analyze colors in an image
1.0
28
Introduced
Gecko 17.0
Inherits from:
nsISupports
Last changed in Gecko 17.0 (Firefox 17.0 / Thunderbird 17.0 / SeaMonkey 2.14)Method overview
void findRepresentativeColor(in nsIURI imageURI, in mozIRepresentativeColorCallback callback); |
Methods
Requires Gecko 17.0 (Firefox 17.0 / Thunderbird 17.0 / SeaMonkey 2.14)
findRepresentativeColor()
Given an image URI, find the most representative color for that image based on the frequency of each color. Preference is given to colors that are more interesting. It avoids the background color if it can be discerned and ignores sufficiently transparent colors.
This is intended to be used on favicon images. Larger images take longer to process, especially those with a larger number of unique colors. If imageURI points to an image that has more than 128^2 pixels, this method will fail for performance reasons before analyzing it.
void findRepresentativeColor( in nsIURI imageURI, in mozIRepresentativeColorCallback callback );
Parameters
-
imageURI
- A URI pointing to the image - ideally a data: URI, but any scheme that will load when setting the src attribute of a DOM img element should work.
-
callback
- Function to call when the representative color is found or an error occurs.
Remarks
Below are some images with the result of findRepresentativeColor:
Image | Representative color | |
---|---|---|
0xB28D3A | ||
0x502E1E | ||
0x53BA3F | ||
0x00A400 |