Apache Flex 4.16.1 API Reference | All Packages | All Classes | Index | Frames No Frames |
AnimateTransitionShaderInstance

Package | spark.effects.supportClasses
Class | public class AnimateTransitionShaderInstance
Inheritance | AnimateTransitionShaderInstance AnimateInstance EffectInstance flash.events.EventDispatcher

Language Version : | ActionScript 3.0

Product Version : | Flex 4

Runtime Versions : | Flash Player 10, AIR 1.5

The AnimateTransitionShaderInstance class implements the instance class for the AnimateTransitionShader effect. Flex creates an instance of this class when it plays a AnimateTransitionShader effect; you do not create one yourself.

See also

spark.effects.AnimateTransitionShader

Public Properties
Hide Inherited Public Properties
Show Inherited Public Properties

| Property | Defined By
--- | --- | ---
|  | bitmapFrom : BitmapData The bitmap data representing the start state of this effect. | AnimateTransitionShaderInstance
|  | bitmapTo : BitmapData The bitmap data representing the end state of this effect. | AnimateTransitionShaderInstance
|  | className : String [read-only] The name of the effect class, such as "FadeInstance". | EffectInstance
|  | disableLayout : Boolean If true, the effect disables layout on its targets' parent containers, setting the containers autoLayout property to false, and also disables any layout constraints on the target objects. | AnimateInstance
|  | duration : Number The duration of the effect, in milliseconds. | EffectInstance
|  | easer : IEaser The easing behavior for this effect. | AnimateInstance
|  | effect : IEffect The IEffect object that created this IEffectInstance object. | EffectInstance
|  | effectTargetHost : IEffectTargetHost A property that lets you access the target list-based control of a data effect. | EffectInstance
|  | hideFocusRing : Boolean Determines whether the effect should hide the focus ring when starting the effect. | EffectInstance
|  | interpolator : IInterpolator The interpolator used by this effect to calculate values between the start and end values of a property. | AnimateInstance
|  | motionPaths : Vector.<MotionPath> A Vector of MotionPath objects, each of which holds the name of a property being animated and the values that the property takes during the animation. | AnimateInstance
|  | playheadTime : Number [override] Current time position of the effect. | AnimateInstance
|  | propertyChanges : PropertyChanges Specifies the PropertyChanges object containing the start and end values for the set of properties relevant to the effect's targets. | EffectInstance
|  | repeatBehavior : String The behavior of a repeating effect, which means an effect with repeatCount equal to either 0 or > 1. | AnimateInstance
|  | repeatCount : int Number of times to repeat the effect. | EffectInstance
|  | repeatDelay : int Amount of time, in milliseconds, to wait before repeating the effect. | EffectInstance
|  | shaderByteCode : ByteArray The bytecode for the pixel-shader program that the effect uses to animate between the two bitmaps. | AnimateTransitionShaderInstance
|  | shaderProperties : Object A map of parameter name/value pairs passed to the pixel-shader program before playing. | AnimateTransitionShaderInstance
|  | startDelay : int Amount of time, in milliseconds, to wait before starting the effect. | EffectInstance
|  | suspendBackgroundProcessing : Boolean If true, blocks all background processing while the effect is playing. | EffectInstance
|  | target : Object The UIComponent object to which this effect is applied. | EffectInstance
|  | triggerEvent : Event The event, if any, which triggered the playing of the effect. | EffectInstance

Protected Properties
Hide Inherited Protected Properties
Show Inherited Protected Properties

| Property | Defined By
--- | --- | ---
|  | autoRemoveTarget : Boolean = false If true, the effect retains its target during a transition and removes it when finished. | AnimateInstance
|  | playCount : int = 0 Number of times that the instance has been played. | EffectInstance
|  | shader : Shader The Shader that is created using the shaderByteCode property as the underlying byte code. | AnimateTransitionShaderInstance
|  | shaderFilter : ShaderFilter The filter wrapped around the instance's shader property. | AnimateTransitionShaderInstance

Public Methods
Hide Inherited Public Methods
Show Inherited Public Methods

| Method | Defined By
--- | --- | ---
|  | AnimateTransitionShaderInstance(target:Object) Constructor. | AnimateTransitionShaderInstance
|  | end():void Interrupts an effect instance that is currently playing, and jumps immediately to the end of the effect. | EffectInstance
|  | finishEffect():void Called by the end() method when the effect finishes playing. | EffectInstance
|  | finishRepeat():void Called after each iteration of a repeated effect finishes playing. | EffectInstance
|  | initEffect(event:Event):void This method is called if the effect was triggered by the EffectManager. | EffectInstance
|  | pause():void Pauses the effect until you call the resume() method. | EffectInstance
|  | play():void Plays the effect instance on the target. | EffectInstance
|  | resume():void Resumes the effect after it has been paused by a call to the pause() method. | EffectInstance
|  | reverse():void Plays the effect in reverse, starting from the current position of the effect. | EffectInstance
|  | startEffect():void Plays the effect instance on the target after the startDelay period has elapsed. | EffectInstance
|  | stop():void Stops the effect, leaving the target in its current state. | EffectInstance

Property Detail

bitmapFrom | property

`public var bitmapFrom:BitmapData`

Language Version : | ActionScript 3.0

Product Version : | Flex 4

Runtime Versions : | Flash Player 10, AIR 1.5

The bitmap data representing the start state of this effect. If this property is not set, it is calculated automatically when the effect is played by taking a snapshot of the target object, or by using a transparent bitmap if the object does not exist in the start view state of a transition.

bitmapTo | property |

`public var bitmapTo:BitmapData`

Language Version : | ActionScript 3.0

Product Version : | Flex 4

Runtime Versions : | Flash Player 10, AIR 1.5

The bitmap data representing the end state of this effect. If this property is not set, it is calculated automatically when the effect is played by taking a snapshot of the target object, or by using a transparent bitmap if the object does not exist in the end view state of a transition.

shader | property |

`protected var shader:Shader`

Language Version : | ActionScript 3.0

Product Version : | Flex 4

Runtime Versions : | Flash Player 10, AIR 1.5

The Shader that is created using the `shaderByteCode` property as the underlying byte code. Each instance needs its own separate Shader, but can share the byte code. When each instance is played, create the Shader that the instance uses.

shaderByteCode | property |

`public var shaderByteCode:ByteArray`

Language Version : | ActionScript 3.0

Product Version : | Flex 4

Runtime Versions : | Flash Player 10, AIR 1.5

The bytecode for the pixel-shader program that the effect uses to animate between the two bitmaps. This property can be represented as either a ByteArray or as a Class representing a ByteArray (which is what results when you embed a resource).

The pixel-shader program can have arbitrary functionality and inputs, but must, at a minimum, have three `image4` inputs. The first input, which can be named anything, should go unused by your pixel-shader program code - it exists only to satisfy the Flash requirement of assigning a filtered object to the first input. Note that inputs that go completely unused in a pixel-shader program might be optimized out, so your code should at least reference this input once.

There must be at least two other input bitmaps named `from` and `to` which represent the before and after bitmap images. Finally, you must define one `float` parameter named `progress` that contains the elapsed fraction of the effect.

You can specify two optional parameters, `width` and `height`. If they exist, they are automatically set to the width and height of the effect target.

See the Pixel Bender Toolkit documentation for more information on writing pixel-shader programs for Flash. You can also look at the source code for the CrossFade.pbk file in the frameworks\projects\flex4\src\spark\effects directory of the Flex source code.

shaderFilter | property |

`protected var shaderFilter:ShaderFilter`

Language Version : | ActionScript 3.0

Product Version : | Flex 4

Runtime Versions : | Flash Player 10, AIR 1.5

The filter wrapped around the instance's `shader` property. This filter is assigned to the `filters` property of the target object with every update during the animation, so that animated updates to the underlying shader are reflected in the filter applied to the display object that the user sees.

shaderProperties | property |

`public var shaderProperties:Object`

Language Version : | ActionScript 3.0

Product Version : | Flex 4

Runtime Versions : | Flash Player 10, AIR 1.5

A map of parameter name/value pairs passed to the pixel-shader program before playing. For example, to set a parameter named `direction` in a shader with a Pixel Bender pbj file in Wipe.pbj, the calling code could do the following:

           [Embed(source="Wipe.pbj", mimeType="application/octet-stream")]
           private var WipeCodeClass:Class;
           var shaderEffect = new AnimateTransitionShader();
           shaderEffect.shaderByteCode = WipeCodeClass;
           shaderEffect.shaderProperties = {direction : 1};

Constructor Detail

AnimateTransitionShaderInstance | () | Constructor

`public function AnimateTransitionShaderInstance(target:Object)`

Language Version : | ActionScript 3.0

Product Version : | Flex 4

Runtime Versions : | Flash Player 10, AIR 1.5

Constructor.

Parameters

| `target:Object` — The Object to animate with this effect.

Wed Nov 15 2017, 09:50 AM +01:00