Packagestarling.filters
Classpublic class CompositeFilter
InheritanceCompositeFilter Inheritance FragmentFilter Inheritance EventDispatcher Inheritance Object

The CompositeFilter class allows to combine several layers of textures into one texture. It's mainly used as a building block for more complex filters; e.g. the DropShadowFilter uses this class to draw the shadow (the result of a BlurFilter) behind an object.


Public Properties
 PropertyDefined By
 InheritedalwaysDrawToBackBuffer : Boolean
Indicates if the last filter pass is always drawn directly to the back buffer.
FragmentFilter
 InheritedantiAliasing : int
The anti-aliasing level.
FragmentFilter
 InheritedisCached : Boolean
[read-only] Indicates if the filter is cached (via the cache method).
FragmentFilter
 InheritednumPasses : int
[read-only] Indicates the number of rendering passes required for this filter.
FragmentFilter
 Inheritedpadding : Padding
Padding can extend the size of the filter texture in all directions.
FragmentFilter
 Inheritedresolution : Number
The resolution of the filter texture.
FragmentFilter
 InheritedtextureFormat : String
The format of the filter texture.
FragmentFilter
 InheritedtextureSmoothing : String
The smoothing mode of the filter texture.
FragmentFilter
Protected Properties
 PropertyDefined By
 Inheritedeffect : FilterEffect
[read-only] The effect instance returning the FilterEffect created via createEffect.
FragmentFilter
 InheritedindexData : IndexData
[read-only] The IndexData used to process the effect.
FragmentFilter
 InheritedmaintainResolutionAcrossPasses : Boolean
Indicates if the filter requires all passes to be processed with the exact same resolution.
FragmentFilter
 InheritedvertexData : VertexData
[read-only] The VertexData used to process the effect.
FragmentFilter
Public Methods
 MethodDefined By
  
CompositeFilter()
Creates a new instance.
CompositeFilter
 Inherited
addEventListener(type:String, listener:Function):void
Registers an event listener at a certain object.
EventDispatcher
 Inherited
cache():void
Caches the filter output into a texture.
FragmentFilter
 Inherited
clearCache():void
Clears the cached output of the filter.
FragmentFilter
 Inherited
dispatchEvent(event:Event):void
Dispatches an event to all objects that have registered listeners for its type.
EventDispatcher
 Inherited
dispatchEventWith(type:String, bubbles:Boolean = false, data:Object = null):void
Dispatches an event with the given parameters to all objects that have registered listeners for the given type.
EventDispatcher
 Inherited
dispose():void
Disposes all resources that have been created by the filter.
FragmentFilter
  
getAlphaAt(layerID:int):Number
Indicates the alpha value with which the layer is drawn.
CompositeFilter
  
getColorAt(layerID:int):uint
Returns the RGB color with which a layer is tinted when it is being drawn.
CompositeFilter
  
getInvertAlphaAt(layerID:int):Boolean
Indicates if the alpha value of the given layer's fragments should be inverted, effectively inverting the layer's silhouette.
CompositeFilter
  
getModeAt(layerID:int):String
The mode with which the layer is drawn.
CompositeFilter
  
getOffsetAt(layerID:int, out:Point = null):Point
Returns the position (in points) at which a certain layer will be drawn.
CompositeFilter
  
getReplaceColorAt(layerID:int):Boolean
Indicates if the color of the given layer is replaced (true) or tinted (false).
CompositeFilter
 Inherited
hasEventListener(type:String, listener:Function = null):Boolean
If called with one argument, figures out if there are any listeners registered for the given event type.
EventDispatcher
  
process(painter:Painter, helper:IFilterHelper, input0:Texture = null, input1:Texture = null, input2:Texture = null, input3:Texture = null):Texture
[override] Combines up to four input textures into one new texture, adhering to the properties of each layer.
CompositeFilter
 Inherited
removeEventListener(type:String, listener:Function):void
Removes an event listener from the object.
EventDispatcher
 Inherited
removeEventListeners(type:String = null):void
Removes all event listeners with a certain type, or all of them if type is null.
EventDispatcher
 Inherited
render(painter:Painter):void
Renders the filtered target object.
FragmentFilter
  
setAlphaAt(layerID:int, alpha:Number):void
Adjusts the alpha value with which the layer is drawn.
CompositeFilter
  
setColorAt(layerID:int, color:uint, replace:Boolean = false):void
Adjusts the RGB color with which a layer is tinted when it is being drawn.
CompositeFilter
  
setInvertAlphaAt(layerID:int, value:Boolean = true):void
Activate this setting to invert the alpha values of this layer's fragments, which will effectively invert the layer's silhouette.
CompositeFilter
  
setModeAt(layerID:int, mode:String):void
Sets the mode with which the layer is drawn.
CompositeFilter
  
setOffsetAt(layerID:int, x:Number, y:Number):void
Indicates the position (in points) at which a certain layer will be drawn.
CompositeFilter
Protected Methods
 MethodDefined By
 Inherited
createEffect():FilterEffect
Creates the effect that does the actual, low-level rendering.
FragmentFilter
 Inherited
onTargetAssigned(target:DisplayObject):void
Called when assigning a target display object.
FragmentFilter
 Inherited
setRequiresRedraw():void
Call this method when any of the filter's properties changes.
FragmentFilter
Events
 Event Summary Defined By
 Inherited
change
Dispatched when the settings change in a way that requires a redraw.FragmentFilter
 Inherited
enterFrame
Dispatched every frame on filters assigned to display objects connected to the stage.FragmentFilter
Constructor Detail
CompositeFilter()Constructor
public function CompositeFilter()

Creates a new instance.

Method Detail
getAlphaAt()method
public function getAlphaAt(layerID:int):Number

Indicates the alpha value with which the layer is drawn.

Parameters

layerID:int

Returns
Number
getColorAt()method 
public function getColorAt(layerID:int):uint

Returns the RGB color with which a layer is tinted when it is being drawn.

Parameters

layerID:int

Returns
uint
getInvertAlphaAt()method 
public function getInvertAlphaAt(layerID:int):Boolean

Indicates if the alpha value of the given layer's fragments should be inverted, effectively inverting the layer's silhouette.

Parameters

layerID:int

Returns
Boolean
getModeAt()method 
public function getModeAt(layerID:int):String

The mode with which the layer is drawn.

Parameters

layerID:int

Returns
String

See also

starling.filters.CompositeMode
getOffsetAt()method 
public function getOffsetAt(layerID:int, out:Point = null):Point

Returns the position (in points) at which a certain layer will be drawn.

Parameters

layerID:int
 
out:Point (default = null)

Returns
Point
getReplaceColorAt()method 
public function getReplaceColorAt(layerID:int):Boolean

Indicates if the color of the given layer is replaced (true) or tinted (false).

Parameters

layerID:int

Returns
Boolean
process()method 
override public function process(painter:Painter, helper:IFilterHelper, input0:Texture = null, input1:Texture = null, input2:Texture = null, input3:Texture = null):Texture

Combines up to four input textures into one new texture, adhering to the properties of each layer.

Parameters

painter:Painter
 
helper:IFilterHelper
 
input0:Texture (default = null)
 
input1:Texture (default = null)
 
input2:Texture (default = null)
 
input3:Texture (default = null)

Returns
Texture
setAlphaAt()method 
public function setAlphaAt(layerID:int, alpha:Number):void

Adjusts the alpha value with which the layer is drawn.

Parameters

layerID:int
 
alpha:Number

setColorAt()method 
public function setColorAt(layerID:int, color:uint, replace:Boolean = false):void

Adjusts the RGB color with which a layer is tinted when it is being drawn. If replace is enabled, the pixels are not tinted, but instead the RGB channels will replace the texture's color entirely.

Parameters

layerID:int
 
color:uint
 
replace:Boolean (default = false)

setInvertAlphaAt()method 
public function setInvertAlphaAt(layerID:int, value:Boolean = true):void

Activate this setting to invert the alpha values of this layer's fragments, which will effectively invert the layer's silhouette. Note that this setting is only applied if color replacement is activated on this layer.

Parameters

layerID:int
 
value:Boolean (default = true)

setModeAt()method 
public function setModeAt(layerID:int, mode:String):void

Sets the mode with which the layer is drawn.

Parameters

layerID:int
 
mode:String

See also

starling.filters.CompositeMode
setOffsetAt()method 
public function setOffsetAt(layerID:int, x:Number, y:Number):void

Indicates the position (in points) at which a certain layer will be drawn.

Parameters

layerID:int
 
x:Number
 
y:Number





Mon Jul 26 2021, 10:58 AM +02:00