API Documentation for: NEXT
Show:

Filter Class

Defined in: Filter:41
Module: EaselJS

Base class that all filters should inherit from. Appli

When on a regular Stage apply the Filters and then cache the object using the cache method. When a cached object changes, please use updateCache. When on a StageGL simply setting content in the .filters array will trigger an automatic and constantly updated cache.

Example

 myInstance.filters = [
     new createjs.ColorFilter(0, 0, 0, 1, 255, 0, 0),
     new createjs.BlurFilter(5, 5, 10)
 ];
 myInstance.cache(0,0, 100, 100);

Note that each filter can implement a getBounds method, which returns the margins that need to be applied in order to fully display the filter. For example, the BlurFilter will cause an object to feather outwards, resulting in a margin around the shape.

Any filter that consumes an external image stretches the image to cover the cached bounds. If this is an undesired visual result, then use an intermediary cache to properly size and layout your data before passing it to a filter.

EaselJS Filters

EaselJS comes with a number of pre-built filters:

Constructor

Filter

()

Defined in Filter:41

Methods

_applyFilter

(
  • imageData
)
Boolean

Defined in _applyFilter:206

Parameters:

  • imageData ImageData

    Target ImageData instance.

Returns:

applyFilter

(
  • ctx
  • x
  • y
  • width
  • height
  • [targetCtx=ctx]
)
Boolean

Defined in applyFilter:161

Applies the filter to the specified context.

Parameters:

  • ctx CanvasRenderingContext2D

    The 2D context to use as the source.

  • x Number

    The x position to use for the source rect.

  • y Number

    The y position to use for the source rect.

  • width Number

    The width to use for the source rect.

  • height Number

    The height to use for the source rect.

  • [targetCtx=ctx] CanvasRenderingContext2D optional

    The 2D context to draw the result to. Defaults to the context passed to ctx.

Returns:

Boolean:

If the filter was applied successfully.

clone

() Filter

Defined in clone:196

Returns a clone of this Filter instance.

Returns:

Filter:

A clone of the current Filter instance.

getBounds

(
  • [rect]
)
Rectangle

Defined in getBounds:142

Provides padding values for this filter. That is, how much the filter will extend the visual bounds of an object it is applied to.

Parameters:

  • [rect] Rectangle optional

    If specified, the provided Rectangle instance will be expanded by the padding amounts and returned.

Returns:

Rectangle:

If a rect param was provided, it is returned. If not, either a new rectangle with the padding values, or null if no padding is required for this filter.

shaderParamSetup

(
  • gl
  • stage
  • shaderProgram
)

Assign any unique uniforms or other setup functionality here.

Parameters:

  • gl WebGLContext

    The context associated with the stage performing the render.

  • stage StageGL

    The stage instance that will be rendering.

  • shaderProgram ShaderProgram

    The compiled shader that is going to be used to perform the render.

toString

() String

Defined in toString:187

Returns a string representation of this object.

Returns:

String:

a string representation of the instance.

Properties

_multiPass

Filter private

Defined in _multiPass:88

Another filter that is required to act as part of this filter and created and managed under the hood.

Default: null

FRAG_SHADER

String readonly

Defined in FRAG_SHADER:106

Pre-processed template shader code. It will be parsed before being fed in into the shader compiler. This should be based upon StageGL.SHADER_FRAGMENT_BODY_REGULAR

usesContext

Boolean

Defined in usesContext:80

A flag stating that this filter uses a context draw mode and cannot be batched into imageData processing.

Default: false

VTX_SHADER

String readonly

Defined in VTX_SHADER:97

Pre-processed template shader code. It will be parsed before being fed in into the shader compiler. This should be based upon StageGL.SHADER_VERTEX_BODY_REGULAR