mozIColorAnalyzer

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

See also

Document Tags and Contributors

Contributors to this page: Sheppy, kscarfone, ethertank, mnoorenberghe
Last updated by: Sheppy,