Merge change I736c525a into eclair-mr2

* changes:
  update dox to account for different behavior between AVOID and TARGET modes
This commit is contained in:
Android (Google) Code Review
2009-11-13 14:05:20 -08:00

View File

@@ -33,17 +33,20 @@ public class AvoidXfermode extends Xfermode {
final int nativeInt; final int nativeInt;
} }
/** /** This xfermode draws, or doesn't draw, based on the destination's
* This xfermode will draw the src everywhere except on top of the opColor * distance from an op-color.
* or, depending on the Mode, draw only on top of the opColor.
* *
* @param opColor The color to avoid (or to target depending on Mode). Note * There are two modes, and each mode interprets a tolerance value.
* that the alpha in opColor is ignored. *
* @param tolerance How closely we compare a pixel to the opColor. * AVOID: In this mode, drawing is allowed only on destination pixels that
* 0 - only operate if exact match * are different from the op-color.
* 255 - maximum gradation (blending) based on how * Tolerance near 0: avoid anything close to the op-color
* similar the pixel is to our opColor (max tolerance) * Tolerance near 255: avoid only colors very close to the op-color
* @param mode If we should avoid or target the opColor *
* TARGET: In this mode, drawing only occurs on destination pixels that
* are similar to the op-color
* Tolerance near 0: draw on colors that are very close to op-color
* Tolerance near 255: draw on colors that to the op-color
*/ */
public AvoidXfermode(int opColor, int tolerance, Mode mode) { public AvoidXfermode(int opColor, int tolerance, Mode mode) {
if (tolerance < 0 || tolerance > 255) { if (tolerance < 0 || tolerance > 255) {