Packagecom.flashdynamix.motion.effects.core
Classpublic class CopyEffect
ImplementsIEffect

Copys a BitmapData onto another BitmapData, this method for drawing is an extremely efficient way of updating the display in Flash, although CopyEffect has limitations, which is part of the reason why it's so much faster. CopyEffect can only use a x,y position transform unlike the DrawEffect which can accept a matrix and color transformations. This means that scale, rotation, skew, alpha and color transformations can not be done with a CopyEffect.


Public Properties
 PropertyDefined by
  alphaBmd : BitmapData
The alphaBmd ALPHA channel to use when copying the BitmapData, if one is desired other than the ALPHA.
CopyEffect
  alphaPt : Point
The point to draw the ALPHA channel from using the alphaBmd.
CopyEffect
  mergeAlpha : Boolean
Whether both ALPHA channels are merged between the sourceBmd and the alphaBmd.
CopyEffect
  point : Point
The destination point to draw the sourceRect from.
CopyEffect
  sourceBmd : BitmapData
The source BitmapData to copy onto the destination BitmapData.
CopyEffect
  sourceRect : Rectangle
The clipping rectangle to use when drawing the source BitmapData onto the destination BitmapData.
CopyEffect
Public Methods
 MethodDefined by
  
CopyEffect(sourceBmd:BitmapData, sourceRect:Rectangle = null, point:Point = null, alphaBmd:BitmapData = null, alphaPt:Point = null, mergeAlpha:Boolean = false)
CopyEffect
  
render(bmd:BitmapData):void
Renders the CopyEffect to the specified BitmapData.
CopyEffect
Property detail
alphaBmdproperty
public var alphaBmd:BitmapData

The alphaBmd ALPHA channel to use when copying the BitmapData, if one is desired other than the ALPHA. channel in the sourceBmd

alphaPtproperty 
public var alphaPt:Point

The point to draw the ALPHA channel from using the alphaBmd.

mergeAlphaproperty 
public var mergeAlpha:Boolean

Whether both ALPHA channels are merged between the sourceBmd and the alphaBmd.

pointproperty 
public var point:Point

The destination point to draw the sourceRect from.

sourceBmdproperty 
public var sourceBmd:BitmapData

The source BitmapData to copy onto the destination BitmapData.

sourceRectproperty 
public var sourceRect:Rectangle

The clipping rectangle to use when drawing the source BitmapData onto the destination BitmapData.

Constructor detail
CopyEffect()constructor
public function CopyEffect(sourceBmd:BitmapData, sourceRect:Rectangle = null, point:Point = null, alphaBmd:BitmapData = null, alphaPt:Point = null, mergeAlpha:Boolean = false)

Parameters
sourceBmd:BitmapData — The source BitmapData to copy onto the destination BitmapData.
 
sourceRect:Rectangle (default = null) — The clipping rectangle to use when drawing the source BitmapData onto the destination BitmapData.
 
point:Point (default = null) — The destination point to draw the sourceRect from.
 
alphaBmd:BitmapData (default = null) — The alphaBmd ALPHA channel to use when copying the BitmapData if another is desired other than the ALPHA channel in the sourceBmd.
 
alphaPt:Point (default = null) — The point to draw the ALPHA channel from using the alphaBmd.
 
mergeAlpha:Boolean (default = false) — Whether both ALPHA channels are merged between the sourceBmd and the alphaBmd.
Method detail
render()method
public function render(bmd:BitmapData):void

Renders the CopyEffect to the specified BitmapData.

Parameters
bmd:BitmapData