1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
/**
* Copyright (c) 2006, Sun Microsystems, Inc
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the following
* disclaimer in the documentation and/or other materials provided
* with the distribution.
* * Neither the name of the TimingFramework project nor the names of its
* contributors may be used to endorse or promote products derived
* from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
package org.jdesktop.animation.timing.triggers;
import org.jdesktop.animation.timing.*;
/**
* TimingTrigger handles timing events and starts the animator
* when those events occur. This class can be useful in sequencing different
* Animators. For example, one Animator can be set to start when another
* ends using this Trigger. For example, to have anim2 start when anim1 ends,
* one might write the following:
* <pre>
* TimingTrigger trigger =
* TimingTrigger.addTrigger(anim1, anim2, TimingTriggerEvent.STOP);
* </pre>
*
*
*
* @author Chet
*/
public class TimingTrigger extends Trigger implements TimingTarget {
private Animator source;
private TimingTriggerEvent event;
/**
* Creates a non-auto-reversing TimingTrigger and adds it as a target
* to the source Animator.
*
* @param source the Animator that will be listened to for events
* to start the target Animator
* @param target the Animator that will start when the event occurs
* @param event the TimingTriggerEvent that will cause targetAnimator
* to start
* @return TimingTrigger the resulting trigger
* @see org.jdesktop.animation.timing.Animator#addTarget(TimingTarget)
*/
public static TimingTrigger addTrigger(Animator source, Animator target,
TimingTriggerEvent event) {
return addTrigger(source, target, event, false);
}
/**
* Creates a TimingTrigger and adds it as a target
* to the source Animator.
*
*
* @param source the Animator that will be listened to for events
* to start the target Animator
* @param target the Animator that will start when the event occurs
* @param event the TimingTriggerEvent that will cause targetAnimator
* to start
* @param autoReverse flag to determine whether the animator should
* stop and reverse based on opposite triggerEvents.
* @return TimingTrigger the resulting trigger
* @see org.jdesktop.animation.timing.Animator#addTarget(TimingTarget)
*/
public static TimingTrigger addTrigger(Animator source, Animator target,
TimingTriggerEvent event, boolean autoReverse) {
TimingTrigger trigger = new TimingTrigger(target, event, autoReverse);
source.addTarget(trigger);
return trigger;
}
/**
* Creates a non-auto-reversing TimingTrigger, which should be added
* to an Animator which will generate the events sent to the
* trigger.
*/
public TimingTrigger(Animator animator, TimingTriggerEvent event) {
this(animator, event, false);
}
/**
* Creates a TimingTrigger, which should be added
* to an Animator which will generate the events sent to the
* trigger.
*/
public TimingTrigger(Animator animator, TimingTriggerEvent event,
boolean autoReverse) {
super(animator, event, autoReverse);
}
//
// TimingTarget implementation methods
//
/**
* Implementation of TimingTarget method; this method does nothing
* in this implementation since the events of TimingTrigger are limited
* to START, STOP, and REPEAT
*/
public void timingEvent(float fraction) {}
/**
* Called by Animator when starting. Sends the TimingTriggerEvent.START
* event to the Trigger.
*/
public void begin() {
fire(TimingTriggerEvent.START);
}
/**
* Called by Animator when ending. Sends the TimingTriggerEvent.STOP
* event to the Trigger.
*/
public void end() {
fire(TimingTriggerEvent.STOP);
}
/**
* Called by Animator when repeating. Sends the TimingTriggerEvent.REPEAT
* event to the Trigger.
*/
public void repeat() {
fire(TimingTriggerEvent.REPEAT);
}
}
|
