Applies an image filter to the canvas.
The preset options are:
INVERT Inverts the colors in the image. No parameter is used.
GRAY Converts the image to grayscale. No parameter is used.
THRESHOLD Converts the image to black and white. Pixels with a grayscale value above a given threshold are converted to white. The rest are converted to black. The threshold must be between 0.0 (black) and 1.0 (white). If no value is specified, 0.5 is used.
OPAQUE Sets the alpha channel to entirely opaque. No parameter is used.
POSTERIZE Limits the number of colors in the image. Each color channel is limited to the number of colors specified. Values between 2 and 255 are valid, but results are most noticeable with lower values. The default value is 4.
BLUR Blurs the image. The level of blurring is specified by a blur radius. Larger values increase the blur. The default value is 4. A gaussian blur is used in P2D mode. A box blur is used in WEBGL mode.
ERODE Reduces the light areas. No parameter is used.
DILATE Increases the light areas. No parameter is used.
filter() uses WebGL in the background by default because it's faster. This can be disabled in P2D mode by adding a false argument, as in filter(BLUR, false). This may be useful to keep computation off the GPU or to work around a lack of WebGL support.
In WebgL mode, filter() can also use custom shaders. See createFilterShader() for more information.
Examples
Syntax
filter(filterType, [filterParam], [useWebGL])filter(filterType, [useWebGL])filter(shaderFilter)Parameters
either THRESHOLD, GRAY, OPAQUE, INVERT, POSTERIZE, BLUR, ERODE, DILATE or BLUR.
parameter unique to each filter.
flag to control whether to use fast WebGL filters (GPU) or original image filters (CPU); defaults to true.
shader that's been loaded, with the frag shader using a tex0 uniform.