com.jhlabs.image
Interface Quantizer

All Known Implementing Classes:
OctTreeQuantizer

public interface Quantizer

The interface for an image quantizer. The addColor method is called (repeatedly if necessary) with all the image pixels. A color table can then be returned by calling the buildColorTable method.


Method Summary
 void addPixels(int[] pixels, int offset, int count)
          Add pixels to the quantizer.
 int[] buildColorTable()
          Build a color table from the added pixels.
 int getIndexForColor(int rgb)
          Using the previously-built color table, return the index into that table for a pixel.
 void setup(int numColors)
          Initialize the quantizer.
 

Method Detail

setup

void setup(int numColors)
Initialize the quantizer. This should be called before adding any pixels.

Parameters:
numColors - the number of colors we're quantizing to.

addPixels

void addPixels(int[] pixels,
               int offset,
               int count)
Add pixels to the quantizer.

Parameters:
pixels - the array of ARGB pixels
offset - the offset into the array
count - the count of pixels

buildColorTable

int[] buildColorTable()
Build a color table from the added pixels.

Returns:
an array of ARGB pixels representing a color table

getIndexForColor

int getIndexForColor(int rgb)
Using the previously-built color table, return the index into that table for a pixel. This is guaranteed to return a valid index - returning the index of a color closer to that requested if necessary.

Parameters:
rgb - the pixel to find
Returns:
the pixel's index in the color table