A ColorMatrix filer that applies color correction depending on the masked area.

Uses masked objects red*alpha channels to determine the transition from original color and transformed color.

Hacking: Through accessing color matrix shader directly via @:privateAccess ambient.pass.shader.maskChannel it's possible to modify which channels affect the resulting transition value.

See also:


new(mask:Object, ?m:Matrix)

Create new Ambient filter.



An Object that will be used for masking. See AbstractMask.mask for limitations.


The color matrix that is applied to the area dictated by Ambient.invert.



Whether to apply ambient color correction inside masked (when enabled) area or outside of it (when disabled).


The exponent of the mask color values that affects transition speed.


Inherited Variables

Defined by AbstractMask


The Object contents of which serve as a mask to the filtered Object.

Masking Objects have following limitations: It cannot be a parent of the filtered Object. It should not contain any filters. It should be present in the object tree and precede the Object it masks in the rendering order (rendered before it). Same masking Object cannot be used by multiple mask filters.


When enabled, masking Object will be visible to the user. Hidden otherwise. ( default : false )

Defined by Filter

@:value(true)autoBounds:Bool = true

When enabled, rendering bounds of the filter will be expanded by Filter.boundsExtend in all directions. Otherwise filter should provide custom bounds through Filter.getBounds call.
Default : true.

@:value(0.)boundsExtend:Float = 0.

Rendering texture boundaries extent. Increases the rendering area by twice the Filter.boundsExtend value.
Automatically applied to object bounds when autoBounds = true or Filter.getBounds is not overridden.
Does not affect boundaries when autoBounds = true and boundsExtend is less than 0.

@:value(true)@:isVarenable:Bool = true

When filter is disabled, attached object will render as usual.

@:value(false)smooth:Bool = false

When enabled, some filters will use bilinear filtering on temporary textures.
Does not affect the majority of filters.

See also:

Inherited Methods

Defined by AbstractMask

Defined by Filter

getBounds(s:Object, bounds:Bounds):Void

Method should populate bounds with rendering boundaries of the Filter for Object s. Initial bounds contents are undefined and it's recommended to either clear them or call s.getBounds(s, bounds). Only used when Filter.autoBounds is false. By default uses given Object bounds and extends them with Filter.boundsExtend. Compared to autoBounds = true, negative boundsExtend is still applied, causing rendering area to shrink.