To create a new tint cache, you must pass in the tinting filter you wish to use. For example:

// during setup:
let tintCache = new TintCache(new TintFilter());
frontTinter.setImage(frontTintableImage);

// ...

// during drawing:
tintCache.setFactors(hueShift, saturationScale, brightnessScale);
let tintedImage = tintCache.getTintedImage();

Note that although the above code sets the new tint through the tint cache, doing so is not required. The cache can detect changes to the filter directly. However, the cache cannot detect changes to the source image. If the pixels of the source image are modified, you must force any cached result to be cleared using code similar to the following:

let tc = new TintCache(new TintFilter());
tc.setFactors(-0.25, 1, 0.8);
tc.setImage(source);

// ...

let tinted = TintCache.getTintedImage();

let g = source.createGraphics();
try {
    // modify the pixels in "source"
} finally {
    g.dispose();
}

// force clearing cached results before getting tinted version
// of the modified source image:
tc.setImage(null);
tc.setImage(source);

// this will now return a tinted version of the modified image
tinted = TintCache.getTintedImage();

The hue angle is measured using a scale in which 1 is equal to 360 degrees (a full circle). Values will normally range from -0.5 to +0.5 (-180 to +180 degrees), but values outside of this range are acceptable. A value of 0 leaves the original hue unchanged.

The saturation and brightness values are factors multiplied against the saturation and brightness of the source pixel. Factors less than 0 are treated as 0. Factors may be more than 1 (100%). If the scaled value for a given pixel is more than 1, it is clamped at 1 in the result.

If using an HSBPanel, it will always provide a hue between -0.5 and +0.5, and saturation and brightness values between 0 and 1. Depending on the saturation and brightness of the source image, you may wish to scale those values up or down before passing them to the TintCache. Otherwise, using the panel it will only be possible to decrease the brightness and saturation (or keep it the same). For example, if you wanted the maximum brightness scale to be 1.2 (120%), multiply the value returned from the HSBPanel by 1.2. When choosing the default brightness, use 1/1.2 if you want the default settings to work out to the original image (1/1.2 * 1.2 = 1).

For convenience, the class TintFilter.ScaledTintFilter can perform scaling for you:

// scale saturation to 120%, brightness to 200%
var f = new TintFilter.ScaledTintFilter(h, s, b, 1.2, 2.0);

A ScaledTintFilter gets and sets factors between 0 and 1 as usual, but internally applies the requested scaling factors.