annotate flax/Timeline.py @ 110:490843093506

all of this stuff is super rough and not well thought out yet. all of this stuff is super rough and not well thought out yet. i'm just checking in so we have some stuff to work with for the sprint tonight.
author dmcc
date Tue, 10 Jun 2003 10:31:57 +0000
parents ec82e1eea3c8
children 2ed9bfd1dd0e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
1 from TLUtility import make_attributes_from_args, dict_scale, dict_max, \
45b12307c695 Initial revision
drewp
parents:
diff changeset
2 DummyClass, last_less_than, first_greater_than
45b12307c695 Initial revision
drewp
parents:
diff changeset
3 from time import time
45b12307c695 Initial revision
drewp
parents:
diff changeset
4 from __future__ import division # "I'm sending you back to future!"
45b12307c695 Initial revision
drewp
parents:
diff changeset
5
45b12307c695 Initial revision
drewp
parents:
diff changeset
6 """
110
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
7 Quote of the Build (from Ghostbusters II)
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
8 Dana: Okay, but after dinner, I don't want you putting any of your old cheap
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
9 moves on me.
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
10 Peter: Ohhhh no! I've got all NEW cheap moves.
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
11
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
12 Timeline idea
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
13 =============
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
14 time | 0 1 2 3 4 5 6
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
15 ---------+-----------------------------
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
16 frame | F F F
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
17 blenders | \ b / \- b ----/
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
18
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
19 Update: this is more or less what happened. However, there are
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
20 TimelineTracks as well. FunctionFrames go on their own track.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
21 LevelFrames must have unique times, FunctionFrames do not.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
22
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
23 Level propagation
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
24 =================
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
25 Cue1 is a CueNode. CueNodes consist of a timeline with any number
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
26 of LevelFrame nodes and LinearBlenders connecting all the frames.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
27 At time 0, Cue1's timeline has LevelFrame1. At time 5, the timeline
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
28 has NodeFrame1. NodeFrame1 points to Node1, which has it's own sets
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
29 of levels. It could be a Cue, for all Cue1 cares. No matter what,
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
30 we always get down to LevelFrames holding the levels at the bottom,
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
31 then getting combined by Blenders.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
32
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
33 /------\
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
34 | Cue1 |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
35 |---------------\
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
36 | Timeline: |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
37 | 0 ... 5 |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
38 /--------- LF1 NF1 -------\
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
39 | | \ / | |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
40 | | LinearBlender | |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
41 | \---------------/ |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
42 | points to
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
43 /---------------\ a port in Cue1,
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
44 | blueleft : 20 | which connects to a Node
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
45 | redwash : 12 |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
46 | . |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
47 | : |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
48 | |
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
49 \---------------/
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
50
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
51 PS. blueleft and redwash are other nodes at the bottom of the tree.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
52 The include their real channel number for the DimmerNode to process.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
53
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
54 When Cue1 requests levels, the timeline looks at the current position.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
55 If it is directly over a Frame (or Frames), that frame is handled.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
56 If it is LevelFrame, those are the levels that it returns. If there is
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
57 a FunctionFrame, that function is activated. Thus, the order of Frames
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
58 at a specific time is very significant, since the FunctionFrame could
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
59 set the time to 5s in the future. If we are not currently over any
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
60 LevelFrames, we call upon a Blender to determine the value between.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
61 Say that we are at 2.3s. We use the LinearBlender with 2.3/5.0s = 0.46%
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
62 and it determines that the levels are 1 - 0.46% = 0.54% of LF1 and
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
63 0.46% of NF1. NF1 asks Node9 for its levels and this process starts
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
64 all over.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
65
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
66 Graph theory issues (node related issues, should be moved elsewhere)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
67 ====================================================================
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
68 1. We need to determine dependencies for updating (topological order).
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
69 2. We need to do cyclicity tests.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
70
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
71 Guess who wishes they had brought their theory book home?
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
72 I think we can do both with augmented DFS. An incremental version of both
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
73 would be very nice, though hopefully unnecessary.
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
74
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
75 """
45b12307c695 Initial revision
drewp
parents:
diff changeset
76
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
77 class InvalidFrameOperation(Exception):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
78 """You get these when you try to perform some operation on a frame
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
79 that doesn't make sense. The interface is advised to tell the user,
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
80 and indicate that a Blender or FunctionFramea should be disconnected
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
81 or fixed."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
82 pass
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
83
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
84 class MissingBlender(Exception):
45b12307c695 Initial revision
drewp
parents:
diff changeset
85 """Raised when a TimedEvent is missing a blender."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
86 def __init__(self, timedevent):
45b12307c695 Initial revision
drewp
parents:
diff changeset
87 make_attributes_from_args('timedevent')
45b12307c695 Initial revision
drewp
parents:
diff changeset
88 Exception.__init__(self, "%r is missing a blender." % \
45b12307c695 Initial revision
drewp
parents:
diff changeset
89 self.timedevent)
45b12307c695 Initial revision
drewp
parents:
diff changeset
90
45b12307c695 Initial revision
drewp
parents:
diff changeset
91 # these are chosen so we can multiply by -1 to reverse the direction,
45b12307c695 Initial revision
drewp
parents:
diff changeset
92 # and multiply direction by the time difference to determine new times.
45b12307c695 Initial revision
drewp
parents:
diff changeset
93 FORWARD = 1
45b12307c695 Initial revision
drewp
parents:
diff changeset
94 BACKWARD = -1
45b12307c695 Initial revision
drewp
parents:
diff changeset
95
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
96 class Frame:
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
97 """Frame is an event that happens at a specific time. There are two
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
98 types of frames: LevelFrames and FunctionFrames. LevelFrames provide
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
99 levels via their get_levels() function. FunctionFrames alter the
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
100 timeline (e.g. bouncing, looping, speed changes, etc.). They call
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
101 __call__'ed instead."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
102 def __init__(self, name):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
103 self.name = name
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
104 self.timeline = DummyClass(use_warnings=0, raise_exceptions=0)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
105 def set_timeline(self, timeline):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
106 """Tell the Frame who the controlling Timeline is"""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
107 self.timeline = timeline
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
108 def __mul__(self, percent):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
109 """Generate a new Frame by multiplying the 'effect' of this frame by
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
110 a percent."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
111 raise InvalidFrameOperation, "Can't use multiply this Frame"
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
112 def __add__(self, otherframe):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
113 """Combines this frame with another frame, generating a new one."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
114 raise InvalidFrameOperation, "Can't use add on this Frame"
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
115
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
116 class LevelFrame(Frame):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
117 """LevelFrames provide levels. They can also be combined with other
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
118 LevelFrames."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
119 def __init__(self, name, levels):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
120 Frame.__init__(self, name)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
121 self.levels = levels
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
122 def __mul__(self, percent):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
123 """Returns a new LevelFrame made by multiplying all levels by a
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
124 percentage. Percent is a float greater than 0.0"""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
125 newlevels = dict_scale(self.get_levels(), percent)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
126 return LevelFrame('(%s * %f)' % (self.name, percent), newlevels)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
127 def __add__(self, otherframe):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
128 """Combines this LevelFrame with another LevelFrame, generating a new
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
129 one. Values are max() together."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
130 theselevels, otherlevels = self.get_levels(), otherframe.get_levels()
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
131 return LevelFrame('(%s + %s)' % (self.name, otherframe.name),
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
132 dict_max(theselevels, otherlevels))
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
133 def get_levels(self):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
134 """This function returns the levels held by this frame."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
135 return self.levels
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
136 def __repr__(self):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
137 return "<%s %r %r>" % (str(self.__class__), self.name, self.levels)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
138
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
139 class EmptyFrame(LevelFrame):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
140 """An empty LevelFrame, for the purposes of extending the timeline."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
141 def __init__(self, name='Empty Frame'):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
142 EmptyFrame.__init__(self, name, {})
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
143
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
144 class NodeFrame(LevelFrame):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
145 """A LevelFrame that gets its levels from another Node. This must be
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
146 used from a Timeline that is enclosed in TimelineNode. Node is a string
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
147 describing the node requested."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
148 def __init__(self, name, node):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
149 LevelFrame.__init__(self, name, {})
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
150 self.node = node
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
151 def get_levels(self):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
152 """Ask the node that we point to for its levels"""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
153 node = self.timeline.get_node(self.node)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
154 self.levels = node.get_levels()
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
155 return self.levels
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
156
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
157 class FunctionFrame(Frame):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
158 def __init__(self, name):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
159 Frame.__init__(self, name)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
160 def __call__(self, timeline, timedevent, node):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
161 """Called when the FunctionFrame is activated. It is given a pointer
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
162 to it's master timeline, the TimedEvent containing it, and Node that
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
163 the timeline is contained in, if available."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
164 pass
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
165
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
166 # this is kinda broken
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
167 class BounceFunction(FunctionFrame):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
168 def __call__(self, timeline, timedevent, node):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
169 """Reverses the direction of play."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
170 timeline.reverse_direction()
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
171 print "boing! new dir:", timeline.direction
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
172
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
173 # this too
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
174 class LoopFunction(FunctionFrame):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
175 def __call__(self, timeline, timedevent, node):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
176 timeline.set_time(0)
110
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
177 # print 'looped!'
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
178
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
179 class DoubleTimeFunction(FunctionFrame):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
180 def __call__(self, timeline, timedevent, node):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
181 timeline.set_rate(2 * timeline.rate)
110
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
182 print 'doubled!', timeline.rate
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
183
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
184 class HalfTimeFunction(FunctionFrame):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
185 def __call__(self, timeline, timedevent, node):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
186 timeline.set_rate(0.5 * timeline.rate)
110
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
187 print 'halved!', timeline.rate
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
188
45b12307c695 Initial revision
drewp
parents:
diff changeset
189 class TimedEvent:
45b12307c695 Initial revision
drewp
parents:
diff changeset
190 """Container for a Frame which includes a time that it occurs at,
45b12307c695 Initial revision
drewp
parents:
diff changeset
191 and which blender occurs after it."""
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
192 def __init__(self, time, frame, blender=None):
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
193 make_attributes_from_args('time', 'frame')
45b12307c695 Initial revision
drewp
parents:
diff changeset
194 self.next_blender = blender
45b12307c695 Initial revision
drewp
parents:
diff changeset
195 def __float__(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
196 return self.time
45b12307c695 Initial revision
drewp
parents:
diff changeset
197 def __cmp__(self, other):
45b12307c695 Initial revision
drewp
parents:
diff changeset
198 if type(other) in (float, int):
45b12307c695 Initial revision
drewp
parents:
diff changeset
199 return cmp(self.time, other)
45b12307c695 Initial revision
drewp
parents:
diff changeset
200 else:
45b12307c695 Initial revision
drewp
parents:
diff changeset
201 return cmp(self.time, other.time)
45b12307c695 Initial revision
drewp
parents:
diff changeset
202 def __repr__(self):
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
203 return "<TimedEvent %s at %.2f, next blender=%s>" % \
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
204 (self.frame, self.time, self.next_blender)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
205 def get_levels(self):
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
206 """Return the Frame's levels. Hopefully frame is a LevelFrame or
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
207 descendent."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
208 return self.frame.get_levels()
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
209
45b12307c695 Initial revision
drewp
parents:
diff changeset
210 class Blender:
45b12307c695 Initial revision
drewp
parents:
diff changeset
211 """Blenders are functions that merge the effects of two LevelFrames."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
212 def __init__(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
213 pass
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
214 def __call__(self, startframe, endframe, blendtime):
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
215 """Return a LevelFrame combining two LevelFrames (startframe and
45b12307c695 Initial revision
drewp
parents:
diff changeset
216 endframe). blendtime is how much of the blend should be performed
45b12307c695 Initial revision
drewp
parents:
diff changeset
217 and will be expressed as a percentage divided by 100, i.e. a float
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
218 between 0.0 and 1.0.
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
219
45b12307c695 Initial revision
drewp
parents:
diff changeset
220 Very important note: Blenders will *not* be asked for values
45b12307c695 Initial revision
drewp
parents:
diff changeset
221 at end points (i.e. blendtime=0.0 and blendtime=1.0).
45b12307c695 Initial revision
drewp
parents:
diff changeset
222 The LevelFrames will be allowed to specify the values at
45b12307c695 Initial revision
drewp
parents:
diff changeset
223 those times. This is unfortunately for implemementation and
45b12307c695 Initial revision
drewp
parents:
diff changeset
224 simplicity purposes. In other words, if we didn't do this,
45b12307c695 Initial revision
drewp
parents:
diff changeset
225 we could have two blenders covering the same point in time and
45b12307c695 Initial revision
drewp
parents:
diff changeset
226 not know which one to ask for the value. Thus, this saves us
45b12307c695 Initial revision
drewp
parents:
diff changeset
227 a lot of messiness with minimal or no sacrifice."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
228 pass
45b12307c695 Initial revision
drewp
parents:
diff changeset
229 def __str__(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
230 """As a default, we'll just return the name of the class. Subclasses
45b12307c695 Initial revision
drewp
parents:
diff changeset
231 can add parameters on if they want."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
232 return str(self.__class__)
45b12307c695 Initial revision
drewp
parents:
diff changeset
233 def linear_blend(self, startframe, endframe, blendtime):
45b12307c695 Initial revision
drewp
parents:
diff changeset
234 """Utility function to help you produce linear combinations of two
45b12307c695 Initial revision
drewp
parents:
diff changeset
235 blends. blendtime is the percent/100 that the blend should
45b12307c695 Initial revision
drewp
parents:
diff changeset
236 completed. In other words, 0.25 means it should be 0.75 * startframe +
45b12307c695 Initial revision
drewp
parents:
diff changeset
237 0.25 * endframe. This function is included since many blenders are
45b12307c695 Initial revision
drewp
parents:
diff changeset
238 just functions on the percentage and still combine start and end frames
45b12307c695 Initial revision
drewp
parents:
diff changeset
239 in this way."""
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
240 return (startframe * (1.0 - blendtime)) + (endframe * blendtime)
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
241
45b12307c695 Initial revision
drewp
parents:
diff changeset
242 class InstantEnd(Blender):
45b12307c695 Initial revision
drewp
parents:
diff changeset
243 """Instant change from startframe to endframe at the end. In other words,
45b12307c695 Initial revision
drewp
parents:
diff changeset
244 the value returned will be the startframe all the way until the very end
45b12307c695 Initial revision
drewp
parents:
diff changeset
245 of the blend."""
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
246 def __call__(self, startframe, endframe, blendtime):
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
247 # "What!?" you say, "Why don't you care about blendtime?"
45b12307c695 Initial revision
drewp
parents:
diff changeset
248 # This is because Blenders never be asked for blenders at the endpoints
45b12307c695 Initial revision
drewp
parents:
diff changeset
249 # (after all, they wouldn't be blenders if they were). Please see
45b12307c695 Initial revision
drewp
parents:
diff changeset
250 # 'Very important note' in Blender.__doc__
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
251 return startframe
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
252
45b12307c695 Initial revision
drewp
parents:
diff changeset
253 class InstantStart(Blender):
45b12307c695 Initial revision
drewp
parents:
diff changeset
254 """Instant change from startframe to endframe at the beginning. In other
45b12307c695 Initial revision
drewp
parents:
diff changeset
255 words, the value returned will be the startframe at the very beginning
45b12307c695 Initial revision
drewp
parents:
diff changeset
256 and then be endframe at all times afterwards."""
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
257 def __call__(self, startframe, endframe, blendtime):
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
258 # "What!?" you say, "Why don't you care about blendtime?"
45b12307c695 Initial revision
drewp
parents:
diff changeset
259 # This is because Blenders never be asked for blenders at the endpoints
45b12307c695 Initial revision
drewp
parents:
diff changeset
260 # (after all, they wouldn't be blenders if they were). Please see
45b12307c695 Initial revision
drewp
parents:
diff changeset
261 # 'Very important note' in Blender.__doc__
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
262 return endframe
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
263
45b12307c695 Initial revision
drewp
parents:
diff changeset
264 class LinearBlender(Blender):
45b12307c695 Initial revision
drewp
parents:
diff changeset
265 """Linear fade from one frame to another"""
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
266 def __call__(self, startframe, endframe, blendtime):
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
267 return self.linear_blend(startframe, endframe, blendtime)
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
268 # return (startframe * (1.0 - blendtime)) + (endframe * blendtime)
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
269
45b12307c695 Initial revision
drewp
parents:
diff changeset
270 class ExponentialBlender(Blender):
45b12307c695 Initial revision
drewp
parents:
diff changeset
271 """Exponential fade fron one frame to another. You get to specify
45b12307c695 Initial revision
drewp
parents:
diff changeset
272 the exponent. If my math is correct, exponent=1 means the same thing
45b12307c695 Initial revision
drewp
parents:
diff changeset
273 as LinearBlender."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
274 def __init__(self, exponent):
45b12307c695 Initial revision
drewp
parents:
diff changeset
275 self.exponent = exponent
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
276 def __call__(self, startframe, endframe, blendtime):
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
277 blendtime = blendtime ** self.exponent
45b12307c695 Initial revision
drewp
parents:
diff changeset
278 return self.linear_blend(startframe, endframe, blendtime)
45b12307c695 Initial revision
drewp
parents:
diff changeset
279
45b12307c695 Initial revision
drewp
parents:
diff changeset
280 # 17:02:53 drewp: this makes a big difference for the SmoothBlender
45b12307c695 Initial revision
drewp
parents:
diff changeset
281 # (-x*x*(x-1.5)*2) function
45b12307c695 Initial revision
drewp
parents:
diff changeset
282 class SmoothBlender(Blender):
45b12307c695 Initial revision
drewp
parents:
diff changeset
283 """Drew's "Smoove" Blender function. Hopefully he'll document and
45b12307c695 Initial revision
drewp
parents:
diff changeset
284 parametrize it."""
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
285 def __call__(self, startframe, endframe, blendtime):
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
286 blendtime = (-1 * blendtime) * blendtime * (blendtime - 1.5) * 2
45b12307c695 Initial revision
drewp
parents:
diff changeset
287 return self.linear_blend(startframe, endframe, blendtime)
45b12307c695 Initial revision
drewp
parents:
diff changeset
288
45b12307c695 Initial revision
drewp
parents:
diff changeset
289 class TimelineTrack:
45b12307c695 Initial revision
drewp
parents:
diff changeset
290 """TimelineTrack is a single track in a Timeline. It consists of a
45b12307c695 Initial revision
drewp
parents:
diff changeset
291 list of TimedEvents and a name. Length is automatically the location
45b12307c695 Initial revision
drewp
parents:
diff changeset
292 of the last TimedEvent. To extend the Timeline past that, add an
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
293 EmptyTimedEvent."""
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
294 def __init__(self, name, *timedevents):
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
295 self.name = name
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
296 self.events = list(timedevents)
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
297 self.events.sort()
45b12307c695 Initial revision
drewp
parents:
diff changeset
298 def __str__(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
299 return "<TimelineTrack with events: %r>" % self.events
45b12307c695 Initial revision
drewp
parents:
diff changeset
300 def has_events(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
301 """Whether the TimelineTrack has anything in it. In general,
45b12307c695 Initial revision
drewp
parents:
diff changeset
302 empty level Tracks should be avoided. However, empty function tracks
45b12307c695 Initial revision
drewp
parents:
diff changeset
303 might be common."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
304 return len(self.events)
45b12307c695 Initial revision
drewp
parents:
diff changeset
305 def length(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
306 """Returns the length of this track in pseudosecond time units.
45b12307c695 Initial revision
drewp
parents:
diff changeset
307 This is done by finding the position of the last TimedEvent."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
308 return float(self.events[-1])
45b12307c695 Initial revision
drewp
parents:
diff changeset
309 def get(self, key, direction=FORWARD):
45b12307c695 Initial revision
drewp
parents:
diff changeset
310 """Returns the event at a specific time key. If there is no event
45b12307c695 Initial revision
drewp
parents:
diff changeset
311 at that time, a search will be performed in direction. Also note
45b12307c695 Initial revision
drewp
parents:
diff changeset
312 that if there are multiple events at one time, only the first will
45b12307c695 Initial revision
drewp
parents:
diff changeset
313 be returned. (Probably first in order of adding.) This is not
45b12307c695 Initial revision
drewp
parents:
diff changeset
314 a problem at the present since this method is intended for LevelFrames,
45b12307c695 Initial revision
drewp
parents:
diff changeset
315 which must exist at unique times."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
316 if direction == BACKWARD:
45b12307c695 Initial revision
drewp
parents:
diff changeset
317 func = last_less_than
45b12307c695 Initial revision
drewp
parents:
diff changeset
318 else:
45b12307c695 Initial revision
drewp
parents:
diff changeset
319 func = first_greater_than
45b12307c695 Initial revision
drewp
parents:
diff changeset
320
45b12307c695 Initial revision
drewp
parents:
diff changeset
321 return func(self.events, key)
45b12307c695 Initial revision
drewp
parents:
diff changeset
322 def get_range(self, i, j, direction=FORWARD):
45b12307c695 Initial revision
drewp
parents:
diff changeset
323 """Returns all events between i and j, exclusively. If direction
45b12307c695 Initial revision
drewp
parents:
diff changeset
324 is FORWARD, j will be included. If direction is BACKWARD, i will
45b12307c695 Initial revision
drewp
parents:
diff changeset
325 be included. This is because this is used to find FunctionFrames
45b12307c695 Initial revision
drewp
parents:
diff changeset
326 and we assume that any function frames at the start point (which
45b12307c695 Initial revision
drewp
parents:
diff changeset
327 could be i or j) have been processed."""
110
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
328 return [e for e in self.events if e >= i and e <= j]
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
329
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
330 if direction == FORWARD:
45b12307c695 Initial revision
drewp
parents:
diff changeset
331 return [e for e in self.events if e > i and e <= j]
45b12307c695 Initial revision
drewp
parents:
diff changeset
332 else:
45b12307c695 Initial revision
drewp
parents:
diff changeset
333 return [e for e in self.events if e >= i and e < j]
45b12307c695 Initial revision
drewp
parents:
diff changeset
334 def __getitem__(self, key):
45b12307c695 Initial revision
drewp
parents:
diff changeset
335 """Returns the event at or after a specific time key.
45b12307c695 Initial revision
drewp
parents:
diff changeset
336 For example: timeline[3] will get the first event at time 3.
45b12307c695 Initial revision
drewp
parents:
diff changeset
337
45b12307c695 Initial revision
drewp
parents:
diff changeset
338 If you want to get all events at time 3, you are in trouble, but
45b12307c695 Initial revision
drewp
parents:
diff changeset
339 you could achieve it with something like:
45b12307c695 Initial revision
drewp
parents:
diff changeset
340 timeline.get_range(2.99, 3.01, FORWARD)
45b12307c695 Initial revision
drewp
parents:
diff changeset
341 This is hopefully a bogus problem, since you can't have multiple
45b12307c695 Initial revision
drewp
parents:
diff changeset
342 LevelFrames at the same time."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
343 return self.get(key, direction=FORWARD)
45b12307c695 Initial revision
drewp
parents:
diff changeset
344 def get_surrounding_frames(self, time):
45b12307c695 Initial revision
drewp
parents:
diff changeset
345 """Returns frames before and after a specific time. This returns
45b12307c695 Initial revision
drewp
parents:
diff changeset
346 a 2-tuple: (previousframe, nextframe). If you have chosen the exact
45b12307c695 Initial revision
drewp
parents:
diff changeset
347 time of a frame, it will be both previousframe and nextframe."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
348 return self.get(time, direction=BACKWARD), \
45b12307c695 Initial revision
drewp
parents:
diff changeset
349 self.get(time, direction=FORWARD)
45b12307c695 Initial revision
drewp
parents:
diff changeset
350 def get_levels_at_time(self, time):
45b12307c695 Initial revision
drewp
parents:
diff changeset
351 """Returns a LevelFrame with the levels of this track at that time."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
352 before, after = self.get_surrounding_frames(time)
45b12307c695 Initial revision
drewp
parents:
diff changeset
353
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
354 if before == after:
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
355 return before.frame
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
356 else: # we have a blended value
45b12307c695 Initial revision
drewp
parents:
diff changeset
357 diff = after.time - before.time
45b12307c695 Initial revision
drewp
parents:
diff changeset
358 elapsed = time - before.time
45b12307c695 Initial revision
drewp
parents:
diff changeset
359 percent = elapsed / diff
45b12307c695 Initial revision
drewp
parents:
diff changeset
360 if not before.next_blender:
45b12307c695 Initial revision
drewp
parents:
diff changeset
361 raise MissingBlender, before
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
362 return before.next_blender(before.frame, after.frame, percent)
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
363
45b12307c695 Initial revision
drewp
parents:
diff changeset
364 class Timeline:
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
365 def __init__(self, tracks, functions, rate=1, direction=FORWARD):
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
366 """
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
367 Most of this is old:
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
368
45b12307c695 Initial revision
drewp
parents:
diff changeset
369 You can have multiple FunctionFrames at the same time. Their
45b12307c695 Initial revision
drewp
parents:
diff changeset
370 order is important though, since FunctionFrames will be applied
45b12307c695 Initial revision
drewp
parents:
diff changeset
371 in the order seen in this list. blenders is a list of Blenders.
45b12307c695 Initial revision
drewp
parents:
diff changeset
372 rate is the rate of playback. If set to 1, 1 unit inside the
45b12307c695 Initial revision
drewp
parents:
diff changeset
373 Timeline will be 1 second. direction is the initial direction.
45b12307c695 Initial revision
drewp
parents:
diff changeset
374 If you want to do have looping, place a LoopFunction at the end of
45b12307c695 Initial revision
drewp
parents:
diff changeset
375 the Timeline. Timelines don't have a set length. Their length
45b12307c695 Initial revision
drewp
parents:
diff changeset
376 is bounded by their last frame. You can put an EmptyFrame at
45b12307c695 Initial revision
drewp
parents:
diff changeset
377 some time if you want to extend a Timeline."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
378
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
379 make_attributes_from_args('tracks', 'rate', 'direction')
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
380 # the function track is a special track
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
381 self.fn_track = TimelineTrack('functions', *functions)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
382
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
383 self.current_time = 0
45b12307c695 Initial revision
drewp
parents:
diff changeset
384 self.last_clock_time = None
45b12307c695 Initial revision
drewp
parents:
diff changeset
385 self.stopped = 1
45b12307c695 Initial revision
drewp
parents:
diff changeset
386 def length(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
387 """Length of the timeline in pseudoseconds. This is determined by
45b12307c695 Initial revision
drewp
parents:
diff changeset
388 finding the length of the longest track."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
389 track_lengths = [track.length() for track in self.tracks]
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
390 track_lengths.append(self.fn_track.length())
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
391 return max(track_lengths)
45b12307c695 Initial revision
drewp
parents:
diff changeset
392 def play(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
393 """Activates the timeline. Future calls to tick() will advance the
45b12307c695 Initial revision
drewp
parents:
diff changeset
394 timeline in the appropriate direction."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
395 self.stopped = 0
45b12307c695 Initial revision
drewp
parents:
diff changeset
396 def stop(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
397 """The timeline will no longer continue in either direction, no
45b12307c695 Initial revision
drewp
parents:
diff changeset
398 FunctionFrames will be activated."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
399 self.stopped = 1
45b12307c695 Initial revision
drewp
parents:
diff changeset
400 self.last_clock_time = None
45b12307c695 Initial revision
drewp
parents:
diff changeset
401 def reset(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
402 """Resets the timeline to 0. Does not change the stoppedness of the
45b12307c695 Initial revision
drewp
parents:
diff changeset
403 timeline."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
404 self.current_time = 0
45b12307c695 Initial revision
drewp
parents:
diff changeset
405 def tick(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
406 """Updates the current_time and runs any FunctionFrames that the cursor
45b12307c695 Initial revision
drewp
parents:
diff changeset
407 passed over. This call is ignored if the timeline is stopped."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
408 if self.stopped:
45b12307c695 Initial revision
drewp
parents:
diff changeset
409 return
45b12307c695 Initial revision
drewp
parents:
diff changeset
410
45b12307c695 Initial revision
drewp
parents:
diff changeset
411 last_time = self.current_time
45b12307c695 Initial revision
drewp
parents:
diff changeset
412 last_clock = self.last_clock_time
45b12307c695 Initial revision
drewp
parents:
diff changeset
413
45b12307c695 Initial revision
drewp
parents:
diff changeset
414 # first, determine new time
45b12307c695 Initial revision
drewp
parents:
diff changeset
415 clock_time = time()
45b12307c695 Initial revision
drewp
parents:
diff changeset
416 if last_clock is None:
45b12307c695 Initial revision
drewp
parents:
diff changeset
417 last_clock = clock_time
45b12307c695 Initial revision
drewp
parents:
diff changeset
418 diff = clock_time - last_clock
45b12307c695 Initial revision
drewp
parents:
diff changeset
419 new_time = (self.direction * self.rate * diff) + last_time
45b12307c695 Initial revision
drewp
parents:
diff changeset
420
45b12307c695 Initial revision
drewp
parents:
diff changeset
421 # update the time
45b12307c695 Initial revision
drewp
parents:
diff changeset
422 self.last_clock_time = clock_time
45b12307c695 Initial revision
drewp
parents:
diff changeset
423 self.current_time = new_time
45b12307c695 Initial revision
drewp
parents:
diff changeset
424
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
425 # now, find out if we missed any functions
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
426 if self.fn_track.has_events():
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
427 lower_time, higher_time = last_time, new_time
110
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
428 if lower_time == higher_time: print "zarg!"
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
429 if lower_time > higher_time:
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
430 lower_time, higher_time = higher_time, lower_time
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
431
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
432 events_to_process = self.fn_track.get_range(lower_time,
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
433 higher_time, self.direction)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
434
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
435 for event in events_to_process:
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
436 # they better be FunctionFrames
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
437 event.frame(self, event, None) # the None should be a Node,
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
438 # but that part is coming later
110
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
439
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
440 # now we make sure we're in bounds (we don't do this before, since it
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
441 # can cause us to skip events that are at boundaries.
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
442 self.current_time = max(self.current_time, 0)
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
443 self.current_time = min(self.current_time, self.length())
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
444 def reverse_direction(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
445 """Reverses the direction of play for this node"""
45b12307c695 Initial revision
drewp
parents:
diff changeset
446 self.direction = self.direction * -1
45b12307c695 Initial revision
drewp
parents:
diff changeset
447 def set_direction(self, direction):
45b12307c695 Initial revision
drewp
parents:
diff changeset
448 """Sets the direction of playback."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
449 self.direction = direction
45b12307c695 Initial revision
drewp
parents:
diff changeset
450 def set_rate(self, new_rate):
45b12307c695 Initial revision
drewp
parents:
diff changeset
451 """Sets the rate of playback"""
45b12307c695 Initial revision
drewp
parents:
diff changeset
452 self.rate = new_rate
45b12307c695 Initial revision
drewp
parents:
diff changeset
453 def set_time(self, new_time):
45b12307c695 Initial revision
drewp
parents:
diff changeset
454 """Set the time to a new time."""
45b12307c695 Initial revision
drewp
parents:
diff changeset
455 self.current_time = new_time
45b12307c695 Initial revision
drewp
parents:
diff changeset
456 def get_levels(self):
45b12307c695 Initial revision
drewp
parents:
diff changeset
457 """Return the current levels from this timeline. This is done by
45b12307c695 Initial revision
drewp
parents:
diff changeset
458 adding all the non-functional tracks together."""
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
459 current_level_frame = LevelFrame('timeline sum', {})
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
460 for t in self.tracks:
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
461 current_level_frame += t.get_levels_at_time(self.current_time)
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
462
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
463 return current_level_frame.get_levels()
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
464
45b12307c695 Initial revision
drewp
parents:
diff changeset
465 if __name__ == '__main__':
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
466 scene1 = LevelFrame('scene1', {'red' : 50, 'blue' : 25})
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
467 scene2 = LevelFrame('scene2', {'red' : 10, 'blue' : 5, 'green' : 70})
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
468 scene3 = LevelFrame('scene3', {'yellow' : 10, 'blue' : 80, 'purple' : 70})
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
469
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
470 T = TimedEvent
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
471
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
472 linear = LinearBlender()
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
473 quad = ExponentialBlender(2)
45b12307c695 Initial revision
drewp
parents:
diff changeset
474 invquad = ExponentialBlender(0.5)
45b12307c695 Initial revision
drewp
parents:
diff changeset
475 smoove = SmoothBlender()
45b12307c695 Initial revision
drewp
parents:
diff changeset
476
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
477 track1 = TimelineTrack('lights',
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
478 T(0, scene1, blender=linear),
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
479 T(5, scene2, blender=quad),
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
480 T(10, scene3, blender=smoove),
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
481 T(15, scene2)) # last TimedEvent doesn't need a blender
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
482
110
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
483 halver = HalfTimeFunction('1/2x')
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
484 doubler = DoubleTimeFunction('2x')
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
485 if 0:
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
486 # bounce is semiworking
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
487 bouncer = BounceFunction('boing')
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
488 tl = Timeline([track1], [T(0, bouncer),
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
489 T(0, halver),
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
490 T(15, bouncer),
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
491 T(15, doubler)])
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
492 else:
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
493 looper = LoopFunction('loop1')
110
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
494 tl = Timeline([track1], [T(0, doubler),
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
495 T(5, halver),
490843093506 all of this stuff is super rough and not well thought out yet.
dmcc
parents: 109
diff changeset
496 T(14, looper)])
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
497 tl.play()
45b12307c695 Initial revision
drewp
parents:
diff changeset
498
45b12307c695 Initial revision
drewp
parents:
diff changeset
499 import Tix
45b12307c695 Initial revision
drewp
parents:
diff changeset
500 root = Tix.Tk()
45b12307c695 Initial revision
drewp
parents:
diff changeset
501 colorscalesframe = Tix.Frame(root)
45b12307c695 Initial revision
drewp
parents:
diff changeset
502 scalevars = {}
45b12307c695 Initial revision
drewp
parents:
diff changeset
503 # wow, this works out so well, it's almost like I planned it!
45b12307c695 Initial revision
drewp
parents:
diff changeset
504 # (actually, it's probably just Tk being as cool as it usually is)
45b12307c695 Initial revision
drewp
parents:
diff changeset
505 # ps. if this code ever turns into mainstream code for flax, I'll be
45b12307c695 Initial revision
drewp
parents:
diff changeset
506 # pissed (reason: we need to use classes, not this hacked crap!)
45b12307c695 Initial revision
drewp
parents:
diff changeset
507 colors = 'red', 'blue', 'green', 'yellow', 'purple'
45b12307c695 Initial revision
drewp
parents:
diff changeset
508 for color in colors:
45b12307c695 Initial revision
drewp
parents:
diff changeset
509 sv = Tix.DoubleVar()
45b12307c695 Initial revision
drewp
parents:
diff changeset
510 scalevars[color] = sv
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
511 scale = Tix.Scale(colorscalesframe, from_=100, to_=0, bg=color,
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
512 variable=sv)
45b12307c695 Initial revision
drewp
parents:
diff changeset
513 scale.pack(side=Tix.LEFT)
45b12307c695 Initial revision
drewp
parents:
diff changeset
514
45b12307c695 Initial revision
drewp
parents:
diff changeset
515 def set_timeline_time(time):
45b12307c695 Initial revision
drewp
parents:
diff changeset
516 tl.set_time(float(time))
45b12307c695 Initial revision
drewp
parents:
diff changeset
517 # print 'set_timeline_time', time
45b12307c695 Initial revision
drewp
parents:
diff changeset
518
45b12307c695 Initial revision
drewp
parents:
diff changeset
519 def update_scales():
45b12307c695 Initial revision
drewp
parents:
diff changeset
520 levels = tl.get_levels()
45b12307c695 Initial revision
drewp
parents:
diff changeset
521 for color in colors:
45b12307c695 Initial revision
drewp
parents:
diff changeset
522 scalevars[color].set(levels.get(color, 0))
45b12307c695 Initial revision
drewp
parents:
diff changeset
523
45b12307c695 Initial revision
drewp
parents:
diff changeset
524 colorscalesframe.pack()
109
ec82e1eea3c8 - initial checkin: run Timeline.py for a good time
dmcc
parents: 0
diff changeset
525 time_scale = Tix.Scale(root, from_=0, to_=track1.length(),
0
45b12307c695 Initial revision
drewp
parents:
diff changeset
526 orient=Tix.HORIZONTAL, res=0.01, command=set_timeline_time)
45b12307c695 Initial revision
drewp
parents:
diff changeset
527 time_scale.pack(side=Tix.BOTTOM, fill=Tix.X, expand=1)
45b12307c695 Initial revision
drewp
parents:
diff changeset
528
45b12307c695 Initial revision
drewp
parents:
diff changeset
529 def play_tl():
45b12307c695 Initial revision
drewp
parents:
diff changeset
530 tl.tick()
45b12307c695 Initial revision
drewp
parents:
diff changeset
531 update_scales()
45b12307c695 Initial revision
drewp
parents:
diff changeset
532 time_scale.set(tl.current_time)
45b12307c695 Initial revision
drewp
parents:
diff changeset
533 # print 'time_scale.set', tl.current_time
45b12307c695 Initial revision
drewp
parents:
diff changeset
534 root.after(10, play_tl)
45b12307c695 Initial revision
drewp
parents:
diff changeset
535
45b12307c695 Initial revision
drewp
parents:
diff changeset
536 controlwindow = Tix.Toplevel()
45b12307c695 Initial revision
drewp
parents:
diff changeset
537 Tix.Button(controlwindow, text='Stop',
45b12307c695 Initial revision
drewp
parents:
diff changeset
538 command=lambda: tl.stop()).pack(side=Tix.LEFT)
45b12307c695 Initial revision
drewp
parents:
diff changeset
539 Tix.Button(controlwindow, text='Play',
45b12307c695 Initial revision
drewp
parents:
diff changeset
540 command=lambda: tl.play()).pack(side=Tix.LEFT)
45b12307c695 Initial revision
drewp
parents:
diff changeset
541 Tix.Button(controlwindow, text='Reset',
45b12307c695 Initial revision
drewp
parents:
diff changeset
542 command=lambda: time_scale.set(0)).pack(side=Tix.LEFT)
45b12307c695 Initial revision
drewp
parents:
diff changeset
543 Tix.Button(controlwindow, text='Flip directions',
45b12307c695 Initial revision
drewp
parents:
diff changeset
544 command=lambda: tl.reverse_direction()).pack(side=Tix.LEFT)
45b12307c695 Initial revision
drewp
parents:
diff changeset
545 Tix.Button(controlwindow, text='1/2x',
45b12307c695 Initial revision
drewp
parents:
diff changeset
546 command=lambda: tl.set_rate(0.5 * tl.rate)).pack(side=Tix.LEFT)
45b12307c695 Initial revision
drewp
parents:
diff changeset
547 Tix.Button(controlwindow, text='2x',
45b12307c695 Initial revision
drewp
parents:
diff changeset
548 command=lambda: tl.set_rate(2 * tl.rate)).pack(side=Tix.LEFT)
45b12307c695 Initial revision
drewp
parents:
diff changeset
549
45b12307c695 Initial revision
drewp
parents:
diff changeset
550 root.after(100, play_tl)
45b12307c695 Initial revision
drewp
parents:
diff changeset
551
45b12307c695 Initial revision
drewp
parents:
diff changeset
552 # Timeline.set_time = trace(Timeline.set_time)
45b12307c695 Initial revision
drewp
parents:
diff changeset
553
45b12307c695 Initial revision
drewp
parents:
diff changeset
554 Tix.mainloop()