midilib 2.0.2 → 2.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. data/Credits +5 -0
  2. data/README.rdoc +35 -30
  3. data/examples/reader2text.rb +1 -0
  4. data/html/IO.html +259 -0
  5. data/html/MIDI.html +665 -0
  6. data/html/MIDI/ActiveSense.html +295 -0
  7. data/html/MIDI/ChannelEvent.html +319 -0
  8. data/html/MIDI/ChannelPressure.html +350 -0
  9. data/html/MIDI/Clock.html +295 -0
  10. data/html/MIDI/Continue.html +295 -0
  11. data/html/MIDI/Controller.html +365 -0
  12. data/html/MIDI/Event.html +573 -0
  13. data/html/MIDI/IO.html +207 -0
  14. data/html/MIDI/IO/MIDIFile.html +1996 -0
  15. data/html/MIDI/IO/SeqReader.html +946 -0
  16. data/html/MIDI/IO/SeqWriter.html +648 -0
  17. data/html/MIDI/KeySig.html +435 -0
  18. data/html/MIDI/MIDI.html +204 -0
  19. data/html/MIDI/MIDI/MIDI.html +204 -0
  20. data/html/MIDI/MIDI/MIDI/Array.html +353 -0
  21. data/html/MIDI/Marker.html +257 -0
  22. data/html/MIDI/Measure.html +423 -0
  23. data/html/MIDI/Measures.html +375 -0
  24. data/html/MIDI/MetaEvent.html +534 -0
  25. data/html/MIDI/NoteEvent.html +417 -0
  26. data/html/MIDI/NoteOff.html +316 -0
  27. data/html/MIDI/NoteOn.html +316 -0
  28. data/html/MIDI/PitchBend.html +351 -0
  29. data/html/MIDI/PolyPressure.html +360 -0
  30. data/html/MIDI/ProgramChange.html +350 -0
  31. data/html/MIDI/Realtime.html +328 -0
  32. data/html/MIDI/Sequence.html +961 -0
  33. data/html/MIDI/SongPointer.html +351 -0
  34. data/html/MIDI/SongSelect.html +350 -0
  35. data/html/MIDI/Start.html +295 -0
  36. data/html/MIDI/Stop.html +295 -0
  37. data/html/MIDI/SystemCommon.html +257 -0
  38. data/html/MIDI/SystemExclusive.html +353 -0
  39. data/html/MIDI/SystemReset.html +295 -0
  40. data/html/MIDI/Tempo.html +474 -0
  41. data/html/MIDI/TimeSig.html +467 -0
  42. data/html/MIDI/Track.html +769 -0
  43. data/html/MIDI/TuneRequest.html +328 -0
  44. data/html/MIDI/Utils.html +320 -0
  45. data/html/README_rdoc.html +751 -0
  46. data/html/TODO_rdoc.html +200 -0
  47. data/html/created.rid +14 -0
  48. data/html/images/add.png +0 -0
  49. data/html/images/brick.png +0 -0
  50. data/html/images/brick_link.png +0 -0
  51. data/html/images/bug.png +0 -0
  52. data/html/images/bullet_black.png +0 -0
  53. data/html/images/bullet_toggle_minus.png +0 -0
  54. data/html/images/bullet_toggle_plus.png +0 -0
  55. data/html/images/date.png +0 -0
  56. data/html/images/delete.png +0 -0
  57. data/html/images/find.png +0 -0
  58. data/html/images/loadingAnimation.gif +0 -0
  59. data/html/images/macFFBgHack.png +0 -0
  60. data/html/images/package.png +0 -0
  61. data/html/images/page_green.png +0 -0
  62. data/html/images/page_white_text.png +0 -0
  63. data/html/images/page_white_width.png +0 -0
  64. data/html/images/plugin.png +0 -0
  65. data/html/images/ruby.png +0 -0
  66. data/html/images/tag_blue.png +0 -0
  67. data/html/images/tag_green.png +0 -0
  68. data/html/images/transparent.png +0 -0
  69. data/html/images/wrench.png +0 -0
  70. data/html/images/wrench_orange.png +0 -0
  71. data/html/images/zoom.png +0 -0
  72. data/html/index.html +750 -0
  73. data/html/js/darkfish.js +153 -0
  74. data/html/js/jquery.js +18 -0
  75. data/html/js/navigation.js +142 -0
  76. data/html/js/search.js +94 -0
  77. data/html/js/search_index.js +1 -0
  78. data/html/js/searcher.js +228 -0
  79. data/html/rdoc.css +543 -0
  80. data/html/table_of_contents.html +652 -0
  81. data/lib/midilib/info.rb +1 -1
  82. data/lib/midilib/io/seqreader.rb +1 -1
  83. data/lib/midilib/sequence.rb +7 -0
  84. data/test/test_sequence.rb +11 -0
  85. metadata +80 -3
@@ -0,0 +1,328 @@
1
+ <!DOCTYPE html>
2
+
3
+ <html>
4
+ <head>
5
+ <meta content="text/html; charset=US-ASCII" http-equiv="Content-Type">
6
+
7
+ <title>class MIDI::Realtime - midilib</title>
8
+
9
+ <link type="text/css" media="screen" href="../rdoc.css" rel="stylesheet">
10
+
11
+ <script type="text/javascript">
12
+ var rdoc_rel_prefix = "../";
13
+ </script>
14
+
15
+ <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
16
+ <script type="text/javascript" charset="utf-8" src="../js/navigation.js"></script>
17
+ <script type="text/javascript" charset="utf-8" src="../js/search_index.js"></script>
18
+ <script type="text/javascript" charset="utf-8" src="../js/search.js"></script>
19
+ <script type="text/javascript" charset="utf-8" src="../js/searcher.js"></script>
20
+ <script type="text/javascript" charset="utf-8" src="../js/darkfish.js"></script>
21
+
22
+
23
+ <body id="top" class="class">
24
+ <nav id="metadata">
25
+ <nav id="home-section" class="section">
26
+ <h3 class="section-header">
27
+ <a href="../index.html">Home</a>
28
+ <a href="../table_of_contents.html#classes">Classes</a>
29
+ <a href="../table_of_contents.html#methods">Methods</a>
30
+ </h3>
31
+ </nav>
32
+
33
+
34
+ <nav id="search-section" class="section project-section" class="initially-hidden">
35
+ <form action="#" method="get" accept-charset="utf-8">
36
+ <h3 class="section-header">
37
+ <input type="text" name="search" placeholder="Search" id="search-field"
38
+ title="Type to search, Up and Down to navigate, Enter to load">
39
+ </h3>
40
+ </form>
41
+
42
+ <ul id="search-results" class="initially-hidden"></ul>
43
+ </nav>
44
+
45
+
46
+ <div id="file-metadata">
47
+ <nav id="file-list-section" class="section">
48
+ <h3 class="section-header">Defined In</h3>
49
+ <ul>
50
+ <li>lib/midilib/event.rb
51
+ </ul>
52
+ </nav>
53
+
54
+
55
+ </div>
56
+
57
+ <div id="class-metadata">
58
+
59
+ <nav id="parent-class-section" class="section">
60
+ <h3 class="section-header">Parent</h3>
61
+
62
+ <p class="link"><a href="Event.html">MIDI::Event</a>
63
+
64
+ </nav>
65
+
66
+
67
+ <!-- Method Quickref -->
68
+ <nav id="method-list-section" class="section">
69
+ <h3 class="section-header">Methods</h3>
70
+
71
+ <ul class="link-list">
72
+
73
+ <li><a href="#method-c-new">::new</a>
74
+
75
+ <li><a href="#method-i-data_as_bytes">#data_as_bytes</a>
76
+
77
+ <li><a href="#method-i-to_s">#to_s</a>
78
+
79
+ </ul>
80
+ </nav>
81
+
82
+ </div>
83
+
84
+ <div id="project-metadata">
85
+ <nav id="fileindex-section" class="section project-section">
86
+ <h3 class="section-header">Pages</h3>
87
+
88
+ <ul>
89
+
90
+ <li class="file"><a href="../README_rdoc.html">README</a>
91
+
92
+ <li class="file"><a href="../TODO_rdoc.html">TODO</a>
93
+
94
+ </ul>
95
+ </nav>
96
+
97
+ <nav id="classindex-section" class="section project-section">
98
+ <h3 class="section-header">Class and Module Index</h3>
99
+
100
+ <ul class="link-list">
101
+
102
+ <li><a href="../MIDI.html">MIDI</a>
103
+
104
+ <li><a href="../MIDI/ActiveSense.html">MIDI::ActiveSense</a>
105
+
106
+ <li><a href="../MIDI/ChannelEvent.html">MIDI::ChannelEvent</a>
107
+
108
+ <li><a href="../MIDI/ChannelPressure.html">MIDI::ChannelPressure</a>
109
+
110
+ <li><a href="../MIDI/Clock.html">MIDI::Clock</a>
111
+
112
+ <li><a href="../MIDI/Continue.html">MIDI::Continue</a>
113
+
114
+ <li><a href="../MIDI/Controller.html">MIDI::Controller</a>
115
+
116
+ <li><a href="../MIDI/Event.html">MIDI::Event</a>
117
+
118
+ <li><a href="../MIDI/IO.html">MIDI::IO</a>
119
+
120
+ <li><a href="../MIDI/IO/MIDIFile.html">MIDI::IO::MIDIFile</a>
121
+
122
+ <li><a href="../MIDI/IO/SeqReader.html">MIDI::IO::SeqReader</a>
123
+
124
+ <li><a href="../MIDI/IO/SeqWriter.html">MIDI::IO::SeqWriter</a>
125
+
126
+ <li><a href="../MIDI/KeySig.html">MIDI::KeySig</a>
127
+
128
+ <li><a href="../MIDI/MIDI.html">MIDI::MIDI</a>
129
+
130
+ <li><a href="../MIDI/MIDI/MIDI.html">MIDI::MIDI::MIDI</a>
131
+
132
+ <li><a href="../MIDI/MIDI/MIDI/Array.html">MIDI::MIDI::MIDI::Array</a>
133
+
134
+ <li><a href="../MIDI/Marker.html">MIDI::Marker</a>
135
+
136
+ <li><a href="../MIDI/Measure.html">MIDI::Measure</a>
137
+
138
+ <li><a href="../MIDI/Measures.html">MIDI::Measures</a>
139
+
140
+ <li><a href="../MIDI/MetaEvent.html">MIDI::MetaEvent</a>
141
+
142
+ <li><a href="../MIDI/NoteEvent.html">MIDI::NoteEvent</a>
143
+
144
+ <li><a href="../MIDI/NoteOff.html">MIDI::NoteOff</a>
145
+
146
+ <li><a href="../MIDI/NoteOff.html">MIDI::NoteOffEvent</a>
147
+
148
+ <li><a href="../MIDI/NoteOn.html">MIDI::NoteOn</a>
149
+
150
+ <li><a href="../MIDI/NoteOn.html">MIDI::NoteOnEvent</a>
151
+
152
+ <li><a href="../MIDI/PitchBend.html">MIDI::PitchBend</a>
153
+
154
+ <li><a href="../MIDI/PolyPressure.html">MIDI::PolyPressure</a>
155
+
156
+ <li><a href="../MIDI/ProgramChange.html">MIDI::ProgramChange</a>
157
+
158
+ <li><a href="../MIDI/Realtime.html">MIDI::Realtime</a>
159
+
160
+ <li><a href="../MIDI/Sequence.html">MIDI::Sequence</a>
161
+
162
+ <li><a href="../MIDI/SongPointer.html">MIDI::SongPointer</a>
163
+
164
+ <li><a href="../MIDI/SongSelect.html">MIDI::SongSelect</a>
165
+
166
+ <li><a href="../MIDI/Start.html">MIDI::Start</a>
167
+
168
+ <li><a href="../MIDI/Stop.html">MIDI::Stop</a>
169
+
170
+ <li><a href="../MIDI/SystemCommon.html">MIDI::SystemCommon</a>
171
+
172
+ <li><a href="../MIDI/SystemExclusive.html">MIDI::SystemExclusive</a>
173
+
174
+ <li><a href="../MIDI/SystemReset.html">MIDI::SystemReset</a>
175
+
176
+ <li><a href="../MIDI/Tempo.html">MIDI::Tempo</a>
177
+
178
+ <li><a href="../MIDI/TimeSig.html">MIDI::TimeSig</a>
179
+
180
+ <li><a href="../MIDI/Track.html">MIDI::Track</a>
181
+
182
+ <li><a href="../MIDI/TuneRequest.html">MIDI::TuneRequest</a>
183
+
184
+ <li><a href="../MIDI/Utils.html">MIDI::Utils</a>
185
+
186
+ <li><a href="../IO.html">IO</a>
187
+
188
+ </ul>
189
+ </nav>
190
+
191
+ </div>
192
+ </nav>
193
+
194
+ <div id="documentation">
195
+ <h1 class="class">class MIDI::Realtime</h1>
196
+
197
+ <div id="description" class="description">
198
+
199
+ </div><!-- description -->
200
+
201
+
202
+
203
+
204
+ <section id="5Buntitled-5D" class="documentation-section">
205
+
206
+
207
+
208
+
209
+
210
+
211
+
212
+
213
+ <!-- Methods -->
214
+
215
+ <section id="public-class-5Buntitled-5D-method-details" class="method-section section">
216
+ <h3 class="section-header">Public Class Methods</h3>
217
+
218
+
219
+ <div id="method-c-new" class="method-detail ">
220
+
221
+ <div class="method-heading">
222
+ <span class="method-name">new</span><span
223
+ class="method-args">(status, delta_time)</span>
224
+ <span class="method-click-advice">click to toggle source</span>
225
+ </div>
226
+
227
+
228
+ <div class="method-description">
229
+
230
+
231
+
232
+
233
+
234
+ <div class="method-source-code" id="new-source">
235
+ <pre><span class="ruby-comment"># File lib/midilib/event.rb, line 342</span>
236
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">status</span>, <span class="ruby-identifier">delta_time</span>)
237
+ <span class="ruby-keyword">super</span>(<span class="ruby-identifier">status</span>, <span class="ruby-identifier">delta_time</span>)
238
+ <span class="ruby-keyword">end</span></pre>
239
+ </div><!-- new-source -->
240
+
241
+ </div>
242
+
243
+
244
+
245
+
246
+ </div><!-- new-method -->
247
+
248
+
249
+ </section><!-- public-class-method-details -->
250
+
251
+ <section id="public-instance-5Buntitled-5D-method-details" class="method-section section">
252
+ <h3 class="section-header">Public Instance Methods</h3>
253
+
254
+
255
+ <div id="method-i-data_as_bytes" class="method-detail ">
256
+
257
+ <div class="method-heading">
258
+ <span class="method-name">data_as_bytes</span><span
259
+ class="method-args">()</span>
260
+ <span class="method-click-advice">click to toggle source</span>
261
+ </div>
262
+
263
+
264
+ <div class="method-description">
265
+
266
+
267
+
268
+
269
+
270
+ <div class="method-source-code" id="data_as_bytes-source">
271
+ <pre><span class="ruby-comment"># File lib/midilib/event.rb, line 346</span>
272
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">data_as_bytes</span>
273
+ <span class="ruby-identifier">data</span> = []
274
+ <span class="ruby-identifier">data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@status</span>
275
+ <span class="ruby-keyword">end</span></pre>
276
+ </div><!-- data_as_bytes-source -->
277
+
278
+ </div>
279
+
280
+
281
+
282
+
283
+ </div><!-- data_as_bytes-method -->
284
+
285
+
286
+ <div id="method-i-to_s" class="method-detail ">
287
+
288
+ <div class="method-heading">
289
+ <span class="method-name">to_s</span><span
290
+ class="method-args">()</span>
291
+ <span class="method-click-advice">click to toggle source</span>
292
+ </div>
293
+
294
+
295
+ <div class="method-description">
296
+
297
+
298
+
299
+
300
+
301
+ <div class="method-source-code" id="to_s-source">
302
+ <pre><span class="ruby-comment"># File lib/midilib/event.rb, line 351</span>
303
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">to_s</span>
304
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">super</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-node">&quot;realtime #{number_to_s(@status)}&quot;</span>
305
+ <span class="ruby-keyword">end</span></pre>
306
+ </div><!-- to_s-source -->
307
+
308
+ </div>
309
+
310
+
311
+
312
+
313
+ </div><!-- to_s-method -->
314
+
315
+
316
+ </section><!-- public-instance-method-details -->
317
+
318
+ </section><!-- 5Buntitled-5D -->
319
+
320
+ </div><!-- documentation -->
321
+
322
+
323
+ <footer id="validator-badges">
324
+ <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
325
+ <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.
326
+ <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
327
+ </footer>
328
+
@@ -0,0 +1,961 @@
1
+ <!DOCTYPE html>
2
+
3
+ <html>
4
+ <head>
5
+ <meta content="text/html; charset=US-ASCII" http-equiv="Content-Type">
6
+
7
+ <title>class MIDI::Sequence - midilib</title>
8
+
9
+ <link type="text/css" media="screen" href="../rdoc.css" rel="stylesheet">
10
+
11
+ <script type="text/javascript">
12
+ var rdoc_rel_prefix = "../";
13
+ </script>
14
+
15
+ <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
16
+ <script type="text/javascript" charset="utf-8" src="../js/navigation.js"></script>
17
+ <script type="text/javascript" charset="utf-8" src="../js/search_index.js"></script>
18
+ <script type="text/javascript" charset="utf-8" src="../js/search.js"></script>
19
+ <script type="text/javascript" charset="utf-8" src="../js/searcher.js"></script>
20
+ <script type="text/javascript" charset="utf-8" src="../js/darkfish.js"></script>
21
+
22
+
23
+ <body id="top" class="class">
24
+ <nav id="metadata">
25
+ <nav id="home-section" class="section">
26
+ <h3 class="section-header">
27
+ <a href="../index.html">Home</a>
28
+ <a href="../table_of_contents.html#classes">Classes</a>
29
+ <a href="../table_of_contents.html#methods">Methods</a>
30
+ </h3>
31
+ </nav>
32
+
33
+
34
+ <nav id="search-section" class="section project-section" class="initially-hidden">
35
+ <form action="#" method="get" accept-charset="utf-8">
36
+ <h3 class="section-header">
37
+ <input type="text" name="search" placeholder="Search" id="search-field"
38
+ title="Type to search, Up and Down to navigate, Enter to load">
39
+ </h3>
40
+ </form>
41
+
42
+ <ul id="search-results" class="initially-hidden"></ul>
43
+ </nav>
44
+
45
+
46
+ <div id="file-metadata">
47
+ <nav id="file-list-section" class="section">
48
+ <h3 class="section-header">Defined In</h3>
49
+ <ul>
50
+ <li>lib/midilib/sequence.rb
51
+ </ul>
52
+ </nav>
53
+
54
+
55
+ </div>
56
+
57
+ <div id="class-metadata">
58
+
59
+ <nav id="parent-class-section" class="section">
60
+ <h3 class="section-header">Parent</h3>
61
+
62
+ <p class="link">Object
63
+
64
+ </nav>
65
+
66
+ <!-- Included Modules -->
67
+ <nav id="includes-section" class="section">
68
+ <h3 class="section-header">Included Modules</h3>
69
+
70
+ <ul class="link-list">
71
+
72
+
73
+ <li><span class="include">Enumerable</span>
74
+
75
+
76
+ </ul>
77
+ </nav>
78
+
79
+ <!-- Method Quickref -->
80
+ <nav id="method-list-section" class="section">
81
+ <h3 class="section-header">Methods</h3>
82
+
83
+ <ul class="link-list">
84
+
85
+ <li><a href="#method-c-new">::new</a>
86
+
87
+ <li><a href="#method-i-beats_per_minute">#beats_per_minute</a>
88
+
89
+ <li><a href="#method-i-bpm">#bpm</a>
90
+
91
+ <li><a href="#method-i-each">#each</a>
92
+
93
+ <li><a href="#method-i-get_measures">#get_measures</a>
94
+
95
+ <li><a href="#method-i-length_to_delta">#length_to_delta</a>
96
+
97
+ <li><a href="#method-i-name">#name</a>
98
+
99
+ <li><a href="#method-i-name-3D">#name=</a>
100
+
101
+ <li><a href="#method-i-note_to_delta">#note_to_delta</a>
102
+
103
+ <li><a href="#method-i-note_to_length">#note_to_length</a>
104
+
105
+ <li><a href="#method-i-pulses_to_seconds">#pulses_to_seconds</a>
106
+
107
+ <li><a href="#method-i-read">#read</a>
108
+
109
+ <li><a href="#method-i-tempo">#tempo</a>
110
+
111
+ <li><a href="#method-i-time_signature">#time_signature</a>
112
+
113
+ <li><a href="#method-i-write">#write</a>
114
+
115
+ </ul>
116
+ </nav>
117
+
118
+ </div>
119
+
120
+ <div id="project-metadata">
121
+ <nav id="fileindex-section" class="section project-section">
122
+ <h3 class="section-header">Pages</h3>
123
+
124
+ <ul>
125
+
126
+ <li class="file"><a href="../README_rdoc.html">README</a>
127
+
128
+ <li class="file"><a href="../TODO_rdoc.html">TODO</a>
129
+
130
+ </ul>
131
+ </nav>
132
+
133
+ <nav id="classindex-section" class="section project-section">
134
+ <h3 class="section-header">Class and Module Index</h3>
135
+
136
+ <ul class="link-list">
137
+
138
+ <li><a href="../MIDI.html">MIDI</a>
139
+
140
+ <li><a href="../MIDI/ActiveSense.html">MIDI::ActiveSense</a>
141
+
142
+ <li><a href="../MIDI/ChannelEvent.html">MIDI::ChannelEvent</a>
143
+
144
+ <li><a href="../MIDI/ChannelPressure.html">MIDI::ChannelPressure</a>
145
+
146
+ <li><a href="../MIDI/Clock.html">MIDI::Clock</a>
147
+
148
+ <li><a href="../MIDI/Continue.html">MIDI::Continue</a>
149
+
150
+ <li><a href="../MIDI/Controller.html">MIDI::Controller</a>
151
+
152
+ <li><a href="../MIDI/Event.html">MIDI::Event</a>
153
+
154
+ <li><a href="../MIDI/IO.html">MIDI::IO</a>
155
+
156
+ <li><a href="../MIDI/IO/MIDIFile.html">MIDI::IO::MIDIFile</a>
157
+
158
+ <li><a href="../MIDI/IO/SeqReader.html">MIDI::IO::SeqReader</a>
159
+
160
+ <li><a href="../MIDI/IO/SeqWriter.html">MIDI::IO::SeqWriter</a>
161
+
162
+ <li><a href="../MIDI/KeySig.html">MIDI::KeySig</a>
163
+
164
+ <li><a href="../MIDI/MIDI.html">MIDI::MIDI</a>
165
+
166
+ <li><a href="../MIDI/MIDI/MIDI.html">MIDI::MIDI::MIDI</a>
167
+
168
+ <li><a href="../MIDI/MIDI/MIDI/Array.html">MIDI::MIDI::MIDI::Array</a>
169
+
170
+ <li><a href="../MIDI/Marker.html">MIDI::Marker</a>
171
+
172
+ <li><a href="../MIDI/Measure.html">MIDI::Measure</a>
173
+
174
+ <li><a href="../MIDI/Measures.html">MIDI::Measures</a>
175
+
176
+ <li><a href="../MIDI/MetaEvent.html">MIDI::MetaEvent</a>
177
+
178
+ <li><a href="../MIDI/NoteEvent.html">MIDI::NoteEvent</a>
179
+
180
+ <li><a href="../MIDI/NoteOff.html">MIDI::NoteOff</a>
181
+
182
+ <li><a href="../MIDI/NoteOff.html">MIDI::NoteOffEvent</a>
183
+
184
+ <li><a href="../MIDI/NoteOn.html">MIDI::NoteOn</a>
185
+
186
+ <li><a href="../MIDI/NoteOn.html">MIDI::NoteOnEvent</a>
187
+
188
+ <li><a href="../MIDI/PitchBend.html">MIDI::PitchBend</a>
189
+
190
+ <li><a href="../MIDI/PolyPressure.html">MIDI::PolyPressure</a>
191
+
192
+ <li><a href="../MIDI/ProgramChange.html">MIDI::ProgramChange</a>
193
+
194
+ <li><a href="../MIDI/Realtime.html">MIDI::Realtime</a>
195
+
196
+ <li><a href="../MIDI/Sequence.html">MIDI::Sequence</a>
197
+
198
+ <li><a href="../MIDI/SongPointer.html">MIDI::SongPointer</a>
199
+
200
+ <li><a href="../MIDI/SongSelect.html">MIDI::SongSelect</a>
201
+
202
+ <li><a href="../MIDI/Start.html">MIDI::Start</a>
203
+
204
+ <li><a href="../MIDI/Stop.html">MIDI::Stop</a>
205
+
206
+ <li><a href="../MIDI/SystemCommon.html">MIDI::SystemCommon</a>
207
+
208
+ <li><a href="../MIDI/SystemExclusive.html">MIDI::SystemExclusive</a>
209
+
210
+ <li><a href="../MIDI/SystemReset.html">MIDI::SystemReset</a>
211
+
212
+ <li><a href="../MIDI/Tempo.html">MIDI::Tempo</a>
213
+
214
+ <li><a href="../MIDI/TimeSig.html">MIDI::TimeSig</a>
215
+
216
+ <li><a href="../MIDI/Track.html">MIDI::Track</a>
217
+
218
+ <li><a href="../MIDI/TuneRequest.html">MIDI::TuneRequest</a>
219
+
220
+ <li><a href="../MIDI/Utils.html">MIDI::Utils</a>
221
+
222
+ <li><a href="../IO.html">IO</a>
223
+
224
+ </ul>
225
+ </nav>
226
+
227
+ </div>
228
+ </nav>
229
+
230
+ <div id="documentation">
231
+ <h1 class="class">class MIDI::Sequence</h1>
232
+
233
+ <div id="description" class="description">
234
+
235
+ <p>A <a href="Sequence.html">MIDI::Sequence</a> contains <a
236
+ href="Track.html">MIDI::Track</a> objects.</p>
237
+
238
+ </div><!-- description -->
239
+
240
+
241
+
242
+
243
+ <section id="5Buntitled-5D" class="documentation-section">
244
+
245
+
246
+
247
+
248
+
249
+ <!-- Constants -->
250
+ <section id="constants-list" class="section">
251
+ <h3 class="section-header">Constants</h3>
252
+ <dl>
253
+
254
+ <dt id="DEFAULT_TEMPO">DEFAULT_TEMPO
255
+
256
+ <dd class="description">
257
+
258
+
259
+ <dt id="NOTE_TO_LENGTH">NOTE_TO_LENGTH
260
+
261
+ <dd class="description">
262
+
263
+
264
+ <dt id="UNNAMED">UNNAMED
265
+
266
+ <dd class="description">
267
+
268
+
269
+ </dl>
270
+ </section>
271
+
272
+
273
+
274
+ <!-- Attributes -->
275
+ <section id="attribute-method-details" class="method-section section">
276
+ <h3 class="section-header">Attributes</h3>
277
+
278
+
279
+ <div id="attribute-i-clocks" class="method-detail">
280
+ <div class="method-heading attribute-method-heading">
281
+ <span class="method-name">clocks</span><span
282
+ class="attribute-access-type">[RW]</span>
283
+ </div>
284
+
285
+ <div class="method-description">
286
+
287
+
288
+
289
+ </div>
290
+ </div>
291
+
292
+ <div id="attribute-i-denom" class="method-detail">
293
+ <div class="method-heading attribute-method-heading">
294
+ <span class="method-name">denom</span><span
295
+ class="attribute-access-type">[RW]</span>
296
+ </div>
297
+
298
+ <div class="method-description">
299
+
300
+
301
+
302
+ </div>
303
+ </div>
304
+
305
+ <div id="attribute-i-format" class="method-detail">
306
+ <div class="method-heading attribute-method-heading">
307
+ <span class="method-name">format</span><span
308
+ class="attribute-access-type">[RW]</span>
309
+ </div>
310
+
311
+ <div class="method-description">
312
+
313
+ <p>The <a href="MIDI.html">MIDI</a> file format (0, 1, or 2)</p>
314
+
315
+ </div>
316
+ </div>
317
+
318
+ <div id="attribute-i-numer" class="method-detail">
319
+ <div class="method-heading attribute-method-heading">
320
+ <span class="method-name">numer</span><span
321
+ class="attribute-access-type">[RW]</span>
322
+ </div>
323
+
324
+ <div class="method-description">
325
+
326
+
327
+
328
+ </div>
329
+ </div>
330
+
331
+ <div id="attribute-i-ppqn" class="method-detail">
332
+ <div class="method-heading attribute-method-heading">
333
+ <span class="method-name">ppqn</span><span
334
+ class="attribute-access-type">[RW]</span>
335
+ </div>
336
+
337
+ <div class="method-description">
338
+
339
+ <p>Pulses (i.e. clocks) Per Quarter Note resolution for the sequence</p>
340
+
341
+ </div>
342
+ </div>
343
+
344
+ <div id="attribute-i-qnotes" class="method-detail">
345
+ <div class="method-heading attribute-method-heading">
346
+ <span class="method-name">qnotes</span><span
347
+ class="attribute-access-type">[RW]</span>
348
+ </div>
349
+
350
+ <div class="method-description">
351
+
352
+
353
+
354
+ </div>
355
+ </div>
356
+
357
+ <div id="attribute-i-reader_class" class="method-detail">
358
+ <div class="method-heading attribute-method-heading">
359
+ <span class="method-name">reader_class</span><span
360
+ class="attribute-access-type">[RW]</span>
361
+ </div>
362
+
363
+ <div class="method-description">
364
+
365
+ <p>The class to use for reading <a href="MIDI.html">MIDI</a> from a stream.
366
+ The default is <a href="IO/SeqReader.html">MIDI::IO::SeqReader</a>. You can
367
+ change this at any time.</p>
368
+
369
+ </div>
370
+ </div>
371
+
372
+ <div id="attribute-i-tracks" class="method-detail">
373
+ <div class="method-heading attribute-method-heading">
374
+ <span class="method-name">tracks</span><span
375
+ class="attribute-access-type">[RW]</span>
376
+ </div>
377
+
378
+ <div class="method-description">
379
+
380
+ <p>Array with all tracks for the sequence</p>
381
+
382
+ </div>
383
+ </div>
384
+
385
+ <div id="attribute-i-writer_class" class="method-detail">
386
+ <div class="method-heading attribute-method-heading">
387
+ <span class="method-name">writer_class</span><span
388
+ class="attribute-access-type">[RW]</span>
389
+ </div>
390
+
391
+ <div class="method-description">
392
+
393
+ <p>The class to use for writeing <a href="MIDI.html">MIDI</a> from a stream.
394
+ The default is <a href="IO/SeqWriter.html">MIDI::IO::SeqWriter</a>. You can
395
+ change this at any time.</p>
396
+
397
+ </div>
398
+ </div>
399
+
400
+ </section><!-- attribute-method-details -->
401
+
402
+
403
+ <!-- Methods -->
404
+
405
+ <section id="public-class-5Buntitled-5D-method-details" class="method-section section">
406
+ <h3 class="section-header">Public Class Methods</h3>
407
+
408
+
409
+ <div id="method-c-new" class="method-detail ">
410
+
411
+ <div class="method-heading">
412
+ <span class="method-name">new</span><span
413
+ class="method-args">()</span>
414
+ <span class="method-click-advice">click to toggle source</span>
415
+ </div>
416
+
417
+
418
+ <div class="method-description">
419
+
420
+
421
+
422
+
423
+
424
+ <div class="method-source-code" id="new-source">
425
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 45</span>
426
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">initialize</span>
427
+ <span class="ruby-ivar">@tracks</span> = <span class="ruby-constant">Array</span>.<span class="ruby-identifier">new</span>()
428
+ <span class="ruby-ivar">@ppqn</span> = <span class="ruby-value">480</span>
429
+
430
+ <span class="ruby-comment"># Time signature</span>
431
+ <span class="ruby-ivar">@numer</span> = <span class="ruby-value">4</span> <span class="ruby-comment"># Numer + denom = 4/4 time default</span>
432
+ <span class="ruby-ivar">@denom</span> = <span class="ruby-value">2</span>
433
+ <span class="ruby-ivar">@clocks</span> = <span class="ruby-value">24</span> <span class="ruby-comment"># Bug fix Nov 11, 2007 - this is not the same as ppqn!</span>
434
+ <span class="ruby-ivar">@qnotes</span> = <span class="ruby-value">8</span>
435
+
436
+ <span class="ruby-ivar">@reader_class</span> = <span class="ruby-constant">IO</span><span class="ruby-operator">::</span><span class="ruby-constant">SeqReader</span>
437
+ <span class="ruby-ivar">@writer_class</span> = <span class="ruby-constant">IO</span><span class="ruby-operator">::</span><span class="ruby-constant">SeqWriter</span>
438
+ <span class="ruby-keyword">end</span></pre>
439
+ </div><!-- new-source -->
440
+
441
+ </div>
442
+
443
+
444
+
445
+
446
+ </div><!-- new-method -->
447
+
448
+
449
+ </section><!-- public-class-method-details -->
450
+
451
+ <section id="public-instance-5Buntitled-5D-method-details" class="method-section section">
452
+ <h3 class="section-header">Public Instance Methods</h3>
453
+
454
+
455
+ <div id="method-i-beats_per_minute" class="method-detail ">
456
+
457
+ <div class="method-heading">
458
+ <span class="method-name">beats_per_minute</span><span
459
+ class="method-args">()</span>
460
+ <span class="method-click-advice">click to toggle source</span>
461
+ </div>
462
+
463
+
464
+ <div class="method-description">
465
+
466
+ <p>Returns the song tempo in beats per minute.</p>
467
+
468
+
469
+
470
+ <div class="method-source-code" id="beats_per_minute-source">
471
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 68</span>
472
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">beats_per_minute</span>
473
+ <span class="ruby-keyword">return</span> <span class="ruby-constant">DEFAULT_TEMPO</span> <span class="ruby-keyword">if</span> <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">||</span> <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">empty?</span>
474
+ <span class="ruby-identifier">event</span> = <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">events</span>.<span class="ruby-identifier">detect</span> { <span class="ruby-operator">|</span> <span class="ruby-identifier">e</span> <span class="ruby-operator">|</span>
475
+ <span class="ruby-identifier">e</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">MIDI</span><span class="ruby-operator">::</span><span class="ruby-constant">Tempo</span>)
476
+ }
477
+ <span class="ruby-keyword">return</span> <span class="ruby-identifier">event</span> <span class="ruby-operator">?</span> (<span class="ruby-constant">Tempo</span>.<span class="ruby-identifier">mpq_to_bpm</span>(<span class="ruby-identifier">event</span>.<span class="ruby-identifier">tempo</span>)) <span class="ruby-operator">:</span> <span class="ruby-constant">DEFAULT_TEMPO</span>
478
+ <span class="ruby-keyword">end</span></pre>
479
+ </div><!-- beats_per_minute-source -->
480
+
481
+ </div>
482
+
483
+
484
+ <div class="aliases">
485
+ Also aliased as: <a href="Sequence.html#method-i-bpm">bpm</a>, <a href="Sequence.html#method-i-tempo">tempo</a>
486
+ </div>
487
+
488
+
489
+
490
+ </div><!-- beats_per_minute-method -->
491
+
492
+
493
+ <div id="method-i-bpm" class="method-detail method-alias">
494
+
495
+ <div class="method-heading">
496
+ <span class="method-name">bpm</span><span
497
+ class="method-args">()</span>
498
+ <span class="method-click-advice">click to toggle source</span>
499
+ </div>
500
+
501
+
502
+ <div class="method-description">
503
+
504
+
505
+
506
+
507
+
508
+ </div>
509
+
510
+
511
+
512
+
513
+ <div class="aliases">
514
+ Alias for: <a href="Sequence.html#method-i-beats_per_minute">beats_per_minute</a>
515
+ </div>
516
+
517
+ </div><!-- bpm-method -->
518
+
519
+
520
+ <div id="method-i-each" class="method-detail ">
521
+
522
+ <div class="method-heading">
523
+ <span class="method-name">each</span><span
524
+ class="method-args">() { |track| ... }</span>
525
+ <span class="method-click-advice">click to toggle source</span>
526
+ </div>
527
+
528
+
529
+ <div class="method-description">
530
+
531
+ <p>Iterates over the tracks.</p>
532
+
533
+
534
+
535
+ <div class="method-source-code" id="each-source">
536
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 151</span>
537
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">each</span> <span class="ruby-comment"># :yields: track</span>
538
+ <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span> <span class="ruby-identifier">track</span> <span class="ruby-operator">|</span> <span class="ruby-keyword">yield</span> <span class="ruby-identifier">track</span> }
539
+ <span class="ruby-keyword">end</span></pre>
540
+ </div><!-- each-source -->
541
+
542
+ </div>
543
+
544
+
545
+
546
+
547
+ </div><!-- each-method -->
548
+
549
+
550
+ <div id="method-i-get_measures" class="method-detail ">
551
+
552
+ <div class="method-heading">
553
+ <span class="method-name">get_measures</span><span
554
+ class="method-args">()</span>
555
+ <span class="method-click-advice">click to toggle source</span>
556
+ </div>
557
+
558
+
559
+ <div class="method-description">
560
+
561
+ <p>Returns a <a href="Measures.html">Measures</a> object, which is an array
562
+ container for all measures in the sequence</p>
563
+
564
+
565
+
566
+ <div class="method-source-code" id="get_measures-source">
567
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 157</span>
568
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">get_measures</span>
569
+ <span class="ruby-comment"># Collect time sig events and scan for last event time</span>
570
+ <span class="ruby-identifier">time_sigs</span> = []
571
+ <span class="ruby-identifier">max_pos</span> = <span class="ruby-value">0</span>
572
+ <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">t</span><span class="ruby-operator">|</span>
573
+ <span class="ruby-identifier">t</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span>
574
+ <span class="ruby-identifier">time_sigs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">e</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">MIDI</span><span class="ruby-operator">::</span><span class="ruby-constant">TimeSig</span>)
575
+ <span class="ruby-identifier">max_pos</span> = <span class="ruby-identifier">e</span>.<span class="ruby-identifier">time_from_start</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">time_from_start</span> <span class="ruby-operator">&gt;</span> <span class="ruby-identifier">max_pos</span>
576
+ }
577
+ }
578
+ <span class="ruby-identifier">time_sigs</span>.<span class="ruby-identifier">sort</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">x</span>,<span class="ruby-identifier">y</span><span class="ruby-operator">|</span> <span class="ruby-identifier">x</span>.<span class="ruby-identifier">time_from_start</span> <span class="ruby-operator">&lt;=&gt;</span> <span class="ruby-identifier">y</span>.<span class="ruby-identifier">time_from_start</span> }
579
+
580
+ <span class="ruby-comment"># Add a &quot;fake&quot; time sig event at the very last position of the sequence,</span>
581
+ <span class="ruby-comment"># just to make sure the whole sequence is calculated.</span>
582
+ <span class="ruby-identifier">t</span> = <span class="ruby-constant">MIDI</span><span class="ruby-operator">::</span><span class="ruby-constant">TimeSig</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value">4</span>, <span class="ruby-value">2</span>, <span class="ruby-value">24</span>, <span class="ruby-value">8</span>, <span class="ruby-value">0</span>)
583
+ <span class="ruby-identifier">t</span>.<span class="ruby-identifier">time_from_start</span> = <span class="ruby-identifier">max_pos</span>
584
+ <span class="ruby-identifier">time_sigs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">t</span>
585
+
586
+ <span class="ruby-comment"># Default to 4/4</span>
587
+ <span class="ruby-identifier">measure_length</span> = <span class="ruby-ivar">@ppqn</span> * <span class="ruby-value">4</span>
588
+ <span class="ruby-identifier">oldnumer</span>, <span class="ruby-identifier">olddenom</span>, <span class="ruby-identifier">oldbeats</span> = <span class="ruby-value">4</span>, <span class="ruby-value">2</span>, <span class="ruby-value">24</span>
589
+
590
+ <span class="ruby-identifier">measures</span> = <span class="ruby-constant">MIDI</span><span class="ruby-operator">::</span><span class="ruby-constant">Measures</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">max_pos</span>, <span class="ruby-ivar">@ppqn</span>)
591
+ <span class="ruby-identifier">curr_pos</span> = <span class="ruby-value">0</span>
592
+ <span class="ruby-identifier">curr_meas_no</span> = <span class="ruby-value">1</span>
593
+ <span class="ruby-identifier">time_sigs</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">te</span><span class="ruby-operator">|</span>
594
+ <span class="ruby-identifier">meas_count</span> = (<span class="ruby-identifier">te</span>.<span class="ruby-identifier">time_from_start</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">curr_pos</span>) <span class="ruby-operator">/</span> <span class="ruby-identifier">measure_length</span>
595
+ <span class="ruby-identifier">meas_count</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span> <span class="ruby-keyword">if</span> (<span class="ruby-identifier">te</span>.<span class="ruby-identifier">time_from_start</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">curr_pos</span>) <span class="ruby-operator">%</span> <span class="ruby-identifier">measure_length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
596
+ <span class="ruby-value">1</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-identifier">meas_count</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
597
+ <span class="ruby-identifier">measures</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-constant">MIDI</span><span class="ruby-operator">::</span><span class="ruby-constant">Measure</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">curr_meas_no</span>,
598
+ <span class="ruby-identifier">curr_pos</span>, <span class="ruby-identifier">measure_length</span>, <span class="ruby-identifier">oldnumer</span>, <span class="ruby-identifier">olddenom</span>, <span class="ruby-identifier">oldbeats</span>)
599
+ <span class="ruby-identifier">curr_meas_no</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
600
+ <span class="ruby-identifier">curr_pos</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">measure_length</span>
601
+ }
602
+ <span class="ruby-identifier">oldnumer</span>, <span class="ruby-identifier">olddenom</span>, <span class="ruby-identifier">oldbeats</span> = <span class="ruby-identifier">te</span>.<span class="ruby-identifier">numerator</span>, <span class="ruby-identifier">te</span>.<span class="ruby-identifier">denominator</span>, <span class="ruby-identifier">te</span>.<span class="ruby-identifier">metronome_ticks</span>
603
+ <span class="ruby-identifier">measure_length</span> = <span class="ruby-identifier">te</span>.<span class="ruby-identifier">measure_duration</span>(<span class="ruby-ivar">@ppqn</span>)
604
+ }
605
+ <span class="ruby-identifier">measures</span>
606
+ <span class="ruby-keyword">end</span></pre>
607
+ </div><!-- get_measures-source -->
608
+
609
+ </div>
610
+
611
+
612
+
613
+
614
+ </div><!-- get_measures-method -->
615
+
616
+
617
+ <div id="method-i-length_to_delta" class="method-detail ">
618
+
619
+ <div class="method-heading">
620
+ <span class="method-name">length_to_delta</span><span
621
+ class="method-args">(length)</span>
622
+ <span class="method-click-advice">click to toggle source</span>
623
+ </div>
624
+
625
+
626
+ <div class="method-description">
627
+
628
+ <p>Translates <code>length</code> (a multiple of a quarter note) into a delta
629
+ time. For example, 1 is a quarter note, 1.0/32.0 is a 32nd note, 1.5 is a
630
+ dotted quarter, etc. Be aware when using division; 1/32 is zero due to
631
+ integer mathematics and rounding. Use floating-point numbers like 1.0 and
632
+ 32.0. This method always returns an integer.</p>
633
+
634
+ <p>See also <a href="Sequence.html#method-i-note_to_delta">#note_to_delta</a>
635
+ and note_to_length.</p>
636
+
637
+
638
+
639
+ <div class="method-source-code" id="length_to_delta-source">
640
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 121</span>
641
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">length_to_delta</span>(<span class="ruby-identifier">length</span>)
642
+ <span class="ruby-keyword">return</span> (<span class="ruby-ivar">@ppqn</span> * <span class="ruby-identifier">length</span>).<span class="ruby-identifier">to_i</span>
643
+ <span class="ruby-keyword">end</span></pre>
644
+ </div><!-- length_to_delta-source -->
645
+
646
+ </div>
647
+
648
+
649
+
650
+
651
+ </div><!-- length_to_delta-method -->
652
+
653
+
654
+ <div id="method-i-name" class="method-detail ">
655
+
656
+ <div class="method-heading">
657
+ <span class="method-name">name</span><span
658
+ class="method-args">()</span>
659
+ <span class="method-click-advice">click to toggle source</span>
660
+ </div>
661
+
662
+
663
+ <div class="method-description">
664
+
665
+ <p>Returns the name of the first track (track zero). If there are no tracks,
666
+ returns <a href="Sequence.html#UNNAMED">UNNAMED</a>.</p>
667
+
668
+
669
+
670
+ <div class="method-source-code" id="name-source">
671
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 127</span>
672
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">name</span>
673
+ <span class="ruby-keyword">return</span> <span class="ruby-constant">UNNAMED</span> <span class="ruby-keyword">if</span> <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">empty?</span>
674
+ <span class="ruby-keyword">return</span> <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">name</span>()
675
+ <span class="ruby-keyword">end</span></pre>
676
+ </div><!-- name-source -->
677
+
678
+ </div>
679
+
680
+
681
+
682
+
683
+ </div><!-- name-method -->
684
+
685
+
686
+ <div id="method-i-name-3D" class="method-detail ">
687
+
688
+ <div class="method-heading">
689
+ <span class="method-name">name=</span><span
690
+ class="method-args">(name)</span>
691
+ <span class="method-click-advice">click to toggle source</span>
692
+ </div>
693
+
694
+
695
+ <div class="method-description">
696
+
697
+ <p>Hands the name to the first track. Does nothing if there are no tracks.</p>
698
+
699
+
700
+
701
+ <div class="method-source-code" id="name-3D-source">
702
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 133</span>
703
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">name=</span>(<span class="ruby-identifier">name</span>)
704
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">empty?</span>
705
+ <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">name</span> = <span class="ruby-identifier">name</span>
706
+ <span class="ruby-keyword">end</span></pre>
707
+ </div><!-- name-3D-source -->
708
+
709
+ </div>
710
+
711
+
712
+
713
+
714
+ </div><!-- name-3D-method -->
715
+
716
+
717
+ <div id="method-i-note_to_delta" class="method-detail ">
718
+
719
+ <div class="method-heading">
720
+ <span class="method-name">note_to_delta</span><span
721
+ class="method-args">(name)</span>
722
+ <span class="method-click-advice">click to toggle source</span>
723
+ </div>
724
+
725
+
726
+ <div class="method-description">
727
+
728
+ <p>Given a note length name like "whole", "dotted quarter", or "8th triplet",
729
+ return the length of that note in quarter notes as a delta time.</p>
730
+
731
+
732
+
733
+ <div class="method-source-code" id="note_to_delta-source">
734
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 88</span>
735
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">note_to_delta</span>(<span class="ruby-identifier">name</span>)
736
+ <span class="ruby-keyword">return</span> <span class="ruby-identifier">length_to_delta</span>(<span class="ruby-identifier">note_to_length</span>(<span class="ruby-identifier">name</span>))
737
+ <span class="ruby-keyword">end</span></pre>
738
+ </div><!-- note_to_delta-source -->
739
+
740
+ </div>
741
+
742
+
743
+
744
+
745
+ </div><!-- note_to_delta-method -->
746
+
747
+
748
+ <div id="method-i-note_to_length" class="method-detail ">
749
+
750
+ <div class="method-heading">
751
+ <span class="method-name">note_to_length</span><span
752
+ class="method-args">(name)</span>
753
+ <span class="method-click-advice">click to toggle source</span>
754
+ </div>
755
+
756
+
757
+ <div class="method-description">
758
+
759
+ <p>Given a note length name like "whole", "dotted quarter", or "8th triplet",
760
+ return the length of that note in quarter notes as a floating-point number,
761
+ suitable for use as an argument to length_to_delta.</p>
762
+
763
+ <p>Legal names are any value in <a
764
+ href="Sequence.html#NOTE_TO_LENGTH">NOTE_TO_LENGTH</a>, optionally prefixed
765
+ by "dotted_" and/or suffixed by "_triplet". So, for example,
766
+ "dotted_quarter_triplet" returns the length of a dotted quarter-note
767
+ triplet and "32nd" returns 1/32.</p>
768
+
769
+
770
+
771
+ <div class="method-source-code" id="note_to_length-source">
772
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 101</span>
773
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">note_to_length</span>(<span class="ruby-identifier">name</span>)
774
+ <span class="ruby-identifier">name</span>.<span class="ruby-identifier">strip!</span>
775
+ <span class="ruby-identifier">name</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">%r^(dotted)?(.*?)(triplet)?$/</span>
776
+ <span class="ruby-identifier">dotted</span>, <span class="ruby-identifier">note_name</span>, <span class="ruby-identifier">triplet</span> = <span class="ruby-node">$1</span>, <span class="ruby-node">$2</span>, <span class="ruby-node">$3</span>
777
+ <span class="ruby-identifier">note_name</span>.<span class="ruby-identifier">strip!</span>
778
+ <span class="ruby-identifier">mult</span> = <span class="ruby-value">1.0</span>
779
+ <span class="ruby-identifier">mult</span> = <span class="ruby-value">1.5</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">dotted</span>
780
+ <span class="ruby-identifier">mult</span> <span class="ruby-operator">/=</span> <span class="ruby-value">3.0</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">triplet</span>
781
+ <span class="ruby-identifier">len</span> = <span class="ruby-constant">NOTE_TO_LENGTH</span>[<span class="ruby-identifier">note_name</span>]
782
+ <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Sequence.note_to_length: \&quot;#{note_name}\&quot; not understood in \&quot;#{name}\&quot;&quot;</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">len</span>
783
+ <span class="ruby-keyword">return</span> <span class="ruby-identifier">len</span> * <span class="ruby-identifier">mult</span>
784
+ <span class="ruby-keyword">end</span></pre>
785
+ </div><!-- note_to_length-source -->
786
+
787
+ </div>
788
+
789
+
790
+
791
+
792
+ </div><!-- note_to_length-method -->
793
+
794
+
795
+ <div id="method-i-pulses_to_seconds" class="method-detail ">
796
+
797
+ <div class="method-heading">
798
+ <span class="method-name">pulses_to_seconds</span><span
799
+ class="method-args">(pulses)</span>
800
+ <span class="method-click-advice">click to toggle source</span>
801
+ </div>
802
+
803
+
804
+ <div class="method-description">
805
+
806
+ <p>Pulses (also called ticks) are the units of delta times and event
807
+ time_from_start values. This method converts a number of pulses to a float
808
+ value that is a time in seconds.</p>
809
+
810
+
811
+
812
+ <div class="method-source-code" id="pulses_to_seconds-source">
813
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 81</span>
814
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">pulses_to_seconds</span>(<span class="ruby-identifier">pulses</span>)
815
+ (<span class="ruby-identifier">pulses</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-ivar">@ppqn</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-identifier">beats_per_minute</span>()) * <span class="ruby-value">60.0</span>
816
+ <span class="ruby-keyword">end</span></pre>
817
+ </div><!-- pulses_to_seconds-source -->
818
+
819
+ </div>
820
+
821
+
822
+
823
+
824
+ </div><!-- pulses_to_seconds-method -->
825
+
826
+
827
+ <div id="method-i-read" class="method-detail ">
828
+
829
+ <div class="method-heading">
830
+ <span class="method-name">read</span><span
831
+ class="method-args">(io, proc = nil) { |track, num_tracks, index| ... }</span>
832
+ <span class="method-click-advice">click to toggle source</span>
833
+ </div>
834
+
835
+
836
+ <div class="method-description">
837
+
838
+ <p>Reads a <a href="MIDI.html">MIDI</a> stream.</p>
839
+
840
+
841
+
842
+ <div class="method-source-code" id="read-source">
843
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 139</span>
844
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">read</span>(<span class="ruby-identifier">io</span>, <span class="ruby-identifier">proc</span> = <span class="ruby-keyword">nil</span>) <span class="ruby-comment"># :yields: track, num_tracks, index</span>
845
+ <span class="ruby-identifier">reader</span> = <span class="ruby-ivar">@reader_class</span>.<span class="ruby-identifier">new</span>(<span class="ruby-keyword">self</span>, <span class="ruby-identifier">block_given?</span>() <span class="ruby-operator">?</span> <span class="ruby-constant">Proc</span>.<span class="ruby-identifier">new</span>() <span class="ruby-operator">:</span> <span class="ruby-identifier">proc</span>)
846
+ <span class="ruby-identifier">reader</span>.<span class="ruby-identifier">read_from</span>(<span class="ruby-identifier">io</span>)
847
+ <span class="ruby-keyword">end</span></pre>
848
+ </div><!-- read-source -->
849
+
850
+ </div>
851
+
852
+
853
+
854
+
855
+ </div><!-- read-method -->
856
+
857
+
858
+ <div id="method-i-tempo" class="method-detail method-alias">
859
+
860
+ <div class="method-heading">
861
+ <span class="method-name">tempo</span><span
862
+ class="method-args">()</span>
863
+ <span class="method-click-advice">click to toggle source</span>
864
+ </div>
865
+
866
+
867
+ <div class="method-description">
868
+
869
+
870
+
871
+
872
+
873
+ </div>
874
+
875
+
876
+
877
+
878
+ <div class="aliases">
879
+ Alias for: <a href="Sequence.html#method-i-beats_per_minute">beats_per_minute</a>
880
+ </div>
881
+
882
+ </div><!-- tempo-method -->
883
+
884
+
885
+ <div id="method-i-time_signature" class="method-detail ">
886
+
887
+ <div class="method-heading">
888
+ <span class="method-name">time_signature</span><span
889
+ class="method-args">(numer, denom, clocks, qnotes)</span>
890
+ <span class="method-click-advice">click to toggle source</span>
891
+ </div>
892
+
893
+
894
+ <div class="method-description">
895
+
896
+ <p>Sets the time signature.</p>
897
+
898
+
899
+
900
+ <div class="method-source-code" id="time_signature-source">
901
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 60</span>
902
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">time_signature</span>(<span class="ruby-identifier">numer</span>, <span class="ruby-identifier">denom</span>, <span class="ruby-identifier">clocks</span>, <span class="ruby-identifier">qnotes</span>)
903
+ <span class="ruby-ivar">@numer</span> = <span class="ruby-identifier">numer</span>
904
+ <span class="ruby-ivar">@denom</span> = <span class="ruby-identifier">denom</span>
905
+ <span class="ruby-ivar">@clocks</span> = <span class="ruby-identifier">clocks</span>
906
+ <span class="ruby-ivar">@qnotes</span> = <span class="ruby-identifier">qnotes</span>
907
+ <span class="ruby-keyword">end</span></pre>
908
+ </div><!-- time_signature-source -->
909
+
910
+ </div>
911
+
912
+
913
+
914
+
915
+ </div><!-- time_signature-method -->
916
+
917
+
918
+ <div id="method-i-write" class="method-detail ">
919
+
920
+ <div class="method-heading">
921
+ <span class="method-name">write</span><span
922
+ class="method-args">(io, proc = nil) { |track, num_tracks, index| ... }</span>
923
+ <span class="method-click-advice">click to toggle source</span>
924
+ </div>
925
+
926
+
927
+ <div class="method-description">
928
+
929
+ <p>Writes to a <a href="MIDI.html">MIDI</a> stream.</p>
930
+
931
+
932
+
933
+ <div class="method-source-code" id="write-source">
934
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 145</span>
935
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">write</span>(<span class="ruby-identifier">io</span>, <span class="ruby-identifier">proc</span> = <span class="ruby-keyword">nil</span>) <span class="ruby-comment"># :yields: track, num_tracks, index</span>
936
+ <span class="ruby-identifier">writer</span> = <span class="ruby-ivar">@writer_class</span>.<span class="ruby-identifier">new</span>(<span class="ruby-keyword">self</span>, <span class="ruby-identifier">block_given?</span>() <span class="ruby-operator">?</span> <span class="ruby-constant">Proc</span>.<span class="ruby-identifier">new</span>() <span class="ruby-operator">:</span> <span class="ruby-identifier">proc</span>)
937
+ <span class="ruby-identifier">writer</span>.<span class="ruby-identifier">write_to</span>(<span class="ruby-identifier">io</span>)
938
+ <span class="ruby-keyword">end</span></pre>
939
+ </div><!-- write-source -->
940
+
941
+ </div>
942
+
943
+
944
+
945
+
946
+ </div><!-- write-method -->
947
+
948
+
949
+ </section><!-- public-instance-method-details -->
950
+
951
+ </section><!-- 5Buntitled-5D -->
952
+
953
+ </div><!-- documentation -->
954
+
955
+
956
+ <footer id="validator-badges">
957
+ <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
958
+ <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.
959
+ <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
960
+ </footer>
961
+