KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > jgoodies > animation > AnimationUtils


1 /*
2  * Copyright (c) 2001-2004 JGoodies Karsten Lentzsch. All Rights Reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are met:
6  *
7  * o Redistributions of source code must retain the above copyright notice,
8  * this list of conditions and the following disclaimer.
9  *
10  * o Redistributions in binary form must reproduce the above copyright notice,
11  * this list of conditions and the following disclaimer in the documentation
12  * and/or other materials provided with the distribution.
13  *
14  * o Neither the name of JGoodies Karsten Lentzsch nor the names of
15  * its contributors may be used to endorse or promote products derived
16  * from this software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
20  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
22  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
27  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
28  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29  */
30
31 package com.jgoodies.animation;
32
33 import java.util.LinkedList JavaDoc;
34 import java.util.List JavaDoc;
35 import java.util.StringTokenizer JavaDoc;
36
37 import javax.swing.SwingUtilities JavaDoc;
38
39 /**
40  * Provides some behavior useful in the animation framework,
41  * or to implement custom animation functions and animations.
42  *
43  * @author Karsten Lentzsch
44  * @version $Revision: 1.3 $
45  */
46 public final class AnimationUtils {
47
48
49     private AnimationUtils() {
50         // Override the default constructor; prevents instantiation.
51 }
52
53     
54     /**
55      * Invokes the given runnable when the specified animation stopped.
56      *
57      * @param animation the animation that is observed
58      * @param runnable the runnable that will be executed on animation stop
59      */
60     public static void invokeOnStop(Animation animation, Runnable JavaDoc runnable) {
61         animation.addAnimationListener(new StopListener(runnable));
62     }
63
64     
65     /**
66      * Returns an array of strings by splitting a given text
67      * into tokens, that are separated by the '|' character.
68      *
69      * @param separatedTexts a string that encodes a bunch of texts
70      * separated by a | character
71      * @return an array of the separated texts
72      */
73     public static String JavaDoc[] splitTexts(String JavaDoc separatedTexts) {
74         StringTokenizer JavaDoc tokenizer = new StringTokenizer JavaDoc(separatedTexts, "|");
75         List JavaDoc texts = new LinkedList JavaDoc();
76         while (tokenizer.hasMoreTokens()) {
77             texts.add(tokenizer.nextToken());
78         }
79         return (String JavaDoc[]) texts.toArray(new String JavaDoc[texts.size()]);
80     }
81     
82     
83     // Helper Code ***********************************************************
84
85     // Performs a runnable at animation stop.
86 private static class StopListener extends AnimationAdapter {
87
88         private final Runnable JavaDoc runnable;
89
90         private StopListener(Runnable JavaDoc runnable) {
91             this.runnable = runnable;
92         }
93
94         public void animationStopped(AnimationEvent e) {
95             SwingUtilities.invokeLater(runnable);
96         }
97     }
98
99 }
Popular Tags