Using an easing function with the AnimateProperties class in Flex and Flash Player 10

by Peter deHaan on August 12, 2008

in AnimateProperties, beta

The following example shows how you can apply an easing function to a property animation in Flex with the beta Gumbo SDK and Flash Player 10 by setting the easingFunction property on the AnimateProperties object instance.

Full code after the jump.

To use the following code, you must have Flash Player 10 and a Flex Gumbo SDK installed in your Flex Builder 3. For more information on downloading and installing the Gumbo SDK into Flex Builder 3, see “Using the beta Gumbo SDK in Flex Builder 3″.

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/08/12/using-an-easing-function-with-the-animateproperties-class-in-flex-and-flash-player-10/ -->
<Application name="AnimateProperties_easingFunction_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        xmlns:mx="library:adobe/flex/halo"
        layout="flex.layout.BasicLayout">

    <Declarations>
        <AnimateProperties id="animateProps"
                easingFunction="Elastic.easeOut"
                duration="4000">
            <propertyValuesList>
                <PropertyValuesHolder property="rotationY"
                        values="[0, 360]" />
            </propertyValuesList>
        </AnimateProperties>
    </Declarations>

    <Script>
        import mx.effects.easing.*;

        private function animateRotationY():void {
            animateProps.stop();
            animateProps.play([img]);
        }
    </Script>

    <Button label="Rotate y-axis"
            top="10"
            left="10"
            click="animateRotationY();" />

    <mx:Image id="img"
            source="@Embed('Fx.png')"
            width="100"
            height="100"
            horizontalCenter="0"
            verticalCenter="0" />

</Application>

View source is enabled in the following example.

You can also set the easingFunction property in ActionScript, as seen in the following example:

View MXML

<?xml version="1.0" encoding="utf-8"?>
<!-- http://blog.flexexamples.com/2008/08/12/using-an-easing-function-with-the-animateproperties-class-in-flex-and-flash-player-10/ -->
<Application name="AnimateProperties_easingFunction_test"
        xmlns="http://ns.adobe.com/mxml/2009"
        xmlns:mx="library:adobe/flex/halo"
        layout="flex.layout.BasicLayout"
        initialize="init();">

    <Script>
        import flex.effects.AnimateProperties;
        import flex.effects.PropertyValuesHolder;
        import mx.effects.easing.*;

        private var animateProps:AnimateProperties;

        private function init():void {
            var rotYProp:PropertyValuesHolder;
            rotYProp = new PropertyValuesHolder("rotationY", [0, 360]);
            animateProps = new AnimateProperties();
            animateProps.easingFunction = Elastic.easeOut;
            animateProps.duration = 4000; // ms
            animateProps.propertyValuesList = [rotYProp];
        }

        private function animateRotationY():void {
            animateProps.stop();
            animateProps.play([img]);
        }
    </Script>

    <Button label="Rotate y-axis"
            top="10"
            left="10"
            click="animateRotationY();" />

    <mx:Image id="img"
            source="@Embed('Fx.png')"
            width="100"
            height="100"
            horizontalCenter="0"
            verticalCenter="0" />

</Application>

{ 7 comments… read them below or add one }

1 Greg J August 12, 2008 at 8:38 am

There was a new commit to the trunk last night/this morning adding new effects and easing classes to Gumbo, so this syntax has changed.

AnimateProperties has been renamed to Animate, and the easingFunction property is now easer. I modified your example by adding a creationComplete handler to assign the easer property of the Animate function an instance of flex.effects.easing.Linear.

So adding

creationComplete="init()"

to the Application tag and:

<Script>
  <![CDATA[
    import flex.effects.easing.*;
    private function init():void { animateProps.easer = Linear.getInstance(); }
  ]]>
</Script>

then change <AnimateProperties> to <Animate>

Reply

2 peterd August 12, 2008 at 8:53 am

Well, it looks like this code may have been affected by a recent API change. If you’re using Gumbo SDK 4.0.0.2810 or newer, it appears that the AnimateProperties class has been renamed to Animate.

“Thanks Chet!” :)

Peter

Reply

3 peterd August 12, 2008 at 8:55 am

Greg J,

Thanks for the heads up. I’ll try and update the examples later today.

Peter

Reply

4 Frustrated August 12, 2008 at 9:19 pm

I’m new to Flex and am trying to understand if I need to learn it. These code examples are not helpful for me because I can’t see what you’re trying to build.

Reply

5 peterd August 13, 2008 at 7:00 am

Frustrated,

If you’re new to Flex, I would recommend reading the official Adobe Flex documentation first before playing with these examples (especially the Flex Gumbo beta examples).

http://www.adobe.com/support/documentation/en/flex/
http://learn.adobe.com/wiki/display/Flex/Getting+Started

Happy Flexing!
Peter

Reply

6 Greg August 13, 2008 at 11:49 am

Also @ Frustrated. If you can’t see these examples, make sure you’re using the newest version of Flash player 10.

http://labs.adobe.com/downloads/flashplayer10.html

Reply

7 Vitalik December 4, 2008 at 4:42 am

hi i am using easingFunction for canvas on which i placed 4 custom components and i move thet canvas whith move effect but it has bad behavior and all easing function didnt help to do that move slovly an whithout ow treting components in repainting … thancs a lot who halpe me=)

Reply

Leave a Comment

Sorry, this blog is terrible at eating HTML comments.
If you're pasting any HTML/XML/MXML code, you need to convert your < characters to &lt; and your > characters to &gt; .

You can use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> <pre lang="" line="" escaped="">

Anti-Spam Protection by WP-SpamFree

Previous post:

Next post: