Click here to Skip to main content
15,565,950 members
Articles / Multimedia / GDI+
Article
Posted 19 Feb 2013

Stats

179.1K views
28.2K downloads
223 bookmarked

Animator for WinForms

Rate me:
Please Sign up or sign in to vote.
4.96/5 (185 votes)
22 Feb 2013LGPL34 min read
The component allows you to animate any controls on your WinForms.
Image 1   Image 2
Image 3

Introduction

 
Can we make our WinForms application was animated, like WPF? Yep, of course we can!
The component Animator allows you to animate any controls on your WinForms.
 

How it works

 
Animator creates a temporary control DoubleBitmap over the target control. DoubleBitmap contains two images. First image is snapshot of background of the form, exclude target control. Second image contains snapshot of target control.

Image 4

Then animator periodically transforms top image of DoubleBitmap. As result – we get animated fake of target control.

Each transformation has some dependence on the current time. And Animator changes time and call transformation for new animation frame.

The Animator supports two kinds of transforms - linear transforms (scaling, shifting, rotating) and non-linear transforms (distortions, skews, etc). Also it can change transparency of animated bitmap.

Linear transformations are performed using matrix transformations of GDI+.
Example of the transformation Rotate:
 

C#
public static void DoRotate(TransfromNeededEventArg e, Animation animation)
{
    var rect = e.ClientRectangle;
    var center = new PointF(rect.Width / 2, rect.Height / 2);
 
    e.Matrix.Translate(center.X, center.Y);
    if (e.CurrentTime > animation.RotateLimit)
        e.Matrix.Rotate(360 * (e.CurrentTime - animation.RotateLimit) * animation.RotateCoeff);
    e.Matrix.Translate(-center.X, -center.Y);
}
 

Nonlinear transformations are little harder. First, it creates an array of pixels. And then there is a conversion each pixel in cycle. The Animator can change coordinates of the pixel, it's color and transparency. Below is an example of the transformation:
 

C#
public static void DoBlind(NonLinearTransfromNeededEventArg e, Animation animation)
{
    if (animation.BlindCoeff == PointF.Empty)
        return;
 
    var pixels = e.Pixels;
    var sx = e.ClientRectangle.Width;
    var sy = e.ClientRectangle.Height;
    var s = e.Stride;
    var kx = animation.BlindCoeff.X;
    var ky = animation.BlindCoeff.Y;
    var a = (int)((sx * kx + sy * ky) * (1 - e.CurrentTime));
 
    for (int x = 0; x < sx; x++)
        for (int y = 0; y < sy; y++)
        {
            int i = y * s + x * bytesPerPixel;
            if (x * kx + y * ky >= a)
                pixels[i + 3] = (byte)0;
        }
}
 

The Animator creates DoubleBitmap with correct z-order. So, if some controls were under target control, then they will be under DoubleBitmap control. Similarly – controls above target control:

Image 5


How to use

 
Simplest way to use Animator: dragging the Animator component onto your form.
To start animation – call method Animator.Show(targetControl) from your code.

Take to attention: the target control must be hidden (visible==false) before calling Show method. Otherwise animation will not take effect.

Similarly, you can hide the control using the method Animator.Hide(targetControl).

The Animator allows you to make animated changing of your visible control. Before updating you need to call Animator.BeginUpdate(targetControl), then update your control, and finally to call Animator.EndUpdate(targetControl). For example:

SQL
animator.BeginUpdateSync(dataGridView1, true);
dataGridView1[col, row].Value = newValue;
animator.EndUpdate(dataGridView1);
 

As result – the control will change its view with animation.

Animator has several built-in types of animation. It's Rotate, Scale, Leaf, Mosaic, Particles, Blind, etc. You can set built-in animation by property AnimationType.

In addition, Animator allows you to fine-tune the animation, as well as create custom animation.
For adjusting you can use property DefaultAnimation. Below described all properties of Animation class:
 

  • PointF SlideCoeff - Set (1,0) or (0,1) to slider effect.
  • float RotateCoeff - Adjusts rotation angle.
  • float RotateLimit - Parameter defines time of end of rotation
  • PointF ScaleCoeff - Adjusts horizontal and vertical scaling
  • float LeafCoeff - Set 1 to "leaf" effect
  • PointF MosaicCoeff - Adjusts deviation of mosaic
  • int MosaicSize - Mosaic square size (in pixels)
  • PointF MosaicShift - Shift of mosaic squares.
  • PointF BlindCoeff - Set (1,0) or (0,1) to "blind" effect.
  • float TransparencyCoeff - Set 1 if you want to make transparency of animation.
  • float TimeCoeff - Time coefficient
  • Padding Padding - Expands bounds of DoubleBitmap (it is useful for "wide" animations, like Rotate)
  • bool AnimateOnlyDifferences - Allows to animate only differences between start view of control and finish view (only for AnimationMode.Update). By default True.
 
To create custom animation, you need to handle events TransfromNeeded and/or NonLinearTransfromNeeded. The example see in demo application.
 

Animator has a good set of techniques to control the animation. Each method is asynchronous and synchronous versions. Asynchronous methods starts animation and returns immediately. Synchronous methods starts animation and wait while animation will be completed.

In addition the Animator supports queue of animated controls. You can use methods AddToQueue() and ClearQueue() for it.

Also, the Animator has methods to wait for all outstanding animations and methods to wait for the particular animation.

Moreover, the Animator has events AnimationCompleted and AllAnimationsCompleted that are invoked after any/all animation was completed.

Extended controls

The library contains extended TabControl. It is usual TabControl, but its tabs are animated:

Image 6

The TabControlEx conatins property Animation, where you can adjust animation of tabs.

Demo app

You can use the demo app for that would evaluate the possibilities of Animator:

Image 7

Decoration sample (BottomMirror mode):

Image 8

Restrictions

The Animator does not work with OLE-based controls (WebBrowser, RichTextBox). These controls do not paint itself when window is not visible. So we can not to grab bitmap from it.
 

History

 
19 Feb 2013 - First release.
20 Feb 2013 - TabControlEx was added, ClipRectangle is available for Update mode.
22 Feb 2013 - Performance was increased. Some bugs was fixed. Decoration sample was added.
 

License

This article, along with any associated source code and files, is licensed under The GNU Lesser General Public License (LGPLv3)


Written By
Software Developer Freelancer
Ukraine Ukraine
I am Pavеl Tоrgаshоv, and I live in Kyiv, Ukraine.
I've been developing software since 1998.
Main activities: processing of large volumes of data, statistics, computer vision and graphics.

Comments and Discussions

 
AnswerRe: C# --> VB Pin
Pavel Torgashov26-Feb-13 5:12
professionalPavel Torgashov26-Feb-13 5:12 
GeneralMy vote of 5 Pin
p_a_k25-Feb-13 21:58
p_a_k25-Feb-13 21:58 
GeneralMy vote of 5 Pin
Azziet25-Feb-13 19:55
Azziet25-Feb-13 19:55 
GeneralMy vote of 5 Pin
rspercy6525-Feb-13 13:44
rspercy6525-Feb-13 13:44 
GeneralMy vote of 5 Pin
trolichero25-Feb-13 9:54
trolichero25-Feb-13 9:54 
GeneralMy vote of 5 Pin
hamletaponte25-Feb-13 8:54
hamletaponte25-Feb-13 8:54 
GeneralMy vote of 5 Pin
_Vitor Garcia_25-Feb-13 2:16
_Vitor Garcia_25-Feb-13 2:16 
GeneralMy vote of 5 Pin
Armando Airo'25-Feb-13 2:09
Armando Airo'25-Feb-13 2:09 
Good
QuestionGreat Job but a small question Pin
Shof24-Feb-13 14:23
Shof24-Feb-13 14:23 
AnswerRe: Great Job but a small question Pin
Pavel Torgashov24-Feb-13 23:06
professionalPavel Torgashov24-Feb-13 23:06 
Generalgood Pin
Mohammad A Rahman24-Feb-13 13:59
Mohammad A Rahman24-Feb-13 13:59 
QuestionMy vote of 5 Pin
pham.quocduy22-Feb-13 10:50
pham.quocduy22-Feb-13 10:50 
QuestionNice job! Pin
Ravi Bhavnani22-Feb-13 7:42
professionalRavi Bhavnani22-Feb-13 7:42 
GeneralMy vote of 5 Pin
fjdiewornncalwe21-Feb-13 12:02
professionalfjdiewornncalwe21-Feb-13 12:02 
BugBug Pin
sash_kr21-Feb-13 4:36
sash_kr21-Feb-13 4:36 
GeneralRe: Bug Pin
Pavel Torgashov22-Feb-13 2:11
professionalPavel Torgashov22-Feb-13 2:11 
NewsGreat Idea Pin
.dan.g.20-Feb-13 13:03
professional.dan.g.20-Feb-13 13:03 
QuestionMy Vote of 5 Pin
Rafaelborges20-Feb-13 9:20
Rafaelborges20-Feb-13 9:20 
AnswerRe: My Vote of 5 Pin
Pavel Torgashov20-Feb-13 12:53
professionalPavel Torgashov20-Feb-13 12:53 
GeneralMy vote of 5 Pin
Sergio Andrés Gutiérrez Rojas20-Feb-13 7:41
Sergio Andrés Gutiérrez Rojas20-Feb-13 7:41 
GeneralMy vote of 5 Pin
nobodyxxxxx20-Feb-13 4:35
nobodyxxxxx20-Feb-13 4:35 
GeneralMy vote of 5 Pin
Amlanjyoti Saikia20-Feb-13 3:41
Amlanjyoti Saikia20-Feb-13 3:41 
QuestionWow Pin
redjes19-Feb-13 14:49
redjes19-Feb-13 14:49 
QuestionCool Pin
ahmet_uzun19-Feb-13 4:11
ahmet_uzun19-Feb-13 4:11 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.