midilib 3.0.1 → 3.1.0

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 (90) hide show
  1. checksums.yaml +4 -4
  2. data/Credits +5 -0
  3. data/html/MIDI/ActiveSense.html +171 -0
  4. data/html/MIDI/ChannelEvent.html +190 -0
  5. data/html/MIDI/ChannelPressure.html +212 -0
  6. data/html/MIDI/Clock.html +171 -0
  7. data/html/MIDI/Continue.html +171 -0
  8. data/html/MIDI/Controller.html +224 -0
  9. data/html/MIDI/Event.html +349 -0
  10. data/html/MIDI/IO/MIDIFile.html +1392 -0
  11. data/html/MIDI/IO/SeqReader.html +642 -0
  12. data/html/MIDI/IO/SeqWriter.html +442 -0
  13. data/html/MIDI/IO.html +91 -0
  14. data/html/MIDI/KeySig.html +292 -0
  15. data/html/MIDI/Marker.html +138 -0
  16. data/html/MIDI/Measure.html +260 -0
  17. data/html/MIDI/Measures.html +222 -0
  18. data/html/MIDI/MetaEvent.html +353 -0
  19. data/html/MIDI/NoteEvent.html +255 -0
  20. data/html/MIDI/NoteOff.html +188 -0
  21. data/html/MIDI/NoteOn.html +188 -0
  22. data/html/MIDI/PitchBend.html +213 -0
  23. data/html/MIDI/PolyPressure.html +216 -0
  24. data/html/MIDI/ProgramChange.html +212 -0
  25. data/html/MIDI/Realtime.html +194 -0
  26. data/html/MIDI/Sequence.html +641 -0
  27. data/html/MIDI/SongPointer.html +213 -0
  28. data/html/MIDI/SongSelect.html +212 -0
  29. data/html/MIDI/Start.html +171 -0
  30. data/html/MIDI/Stop.html +171 -0
  31. data/html/MIDI/SystemCommon.html +138 -0
  32. data/html/MIDI/SystemExclusive.html +215 -0
  33. data/html/MIDI/SystemReset.html +171 -0
  34. data/html/MIDI/Tempo.html +292 -0
  35. data/html/MIDI/TimeSig.html +286 -0
  36. data/html/MIDI/Track.html +489 -0
  37. data/html/MIDI/TuneRequest.html +194 -0
  38. data/html/MIDI/Utils.html +178 -0
  39. data/html/MIDI.html +281 -0
  40. data/html/Object.html +197 -0
  41. data/html/README_rdoc.html +545 -0
  42. data/html/TODO_rdoc.html +123 -0
  43. data/html/created.rid +15 -0
  44. data/html/css/fonts.css +167 -0
  45. data/html/css/rdoc.css +639 -0
  46. data/html/fonts/Lato-Light.ttf +0 -0
  47. data/html/fonts/Lato-LightItalic.ttf +0 -0
  48. data/html/fonts/Lato-Regular.ttf +0 -0
  49. data/html/fonts/Lato-RegularItalic.ttf +0 -0
  50. data/html/fonts/SourceCodePro-Bold.ttf +0 -0
  51. data/html/fonts/SourceCodePro-Regular.ttf +0 -0
  52. data/html/images/add.png +0 -0
  53. data/html/images/arrow_up.png +0 -0
  54. data/html/images/brick.png +0 -0
  55. data/html/images/brick_link.png +0 -0
  56. data/html/images/bug.png +0 -0
  57. data/html/images/bullet_black.png +0 -0
  58. data/html/images/bullet_toggle_minus.png +0 -0
  59. data/html/images/bullet_toggle_plus.png +0 -0
  60. data/html/images/date.png +0 -0
  61. data/html/images/delete.png +0 -0
  62. data/html/images/find.png +0 -0
  63. data/html/images/loadingAnimation.gif +0 -0
  64. data/html/images/macFFBgHack.png +0 -0
  65. data/html/images/package.png +0 -0
  66. data/html/images/page_green.png +0 -0
  67. data/html/images/page_white_text.png +0 -0
  68. data/html/images/page_white_width.png +0 -0
  69. data/html/images/plugin.png +0 -0
  70. data/html/images/ruby.png +0 -0
  71. data/html/images/tag_blue.png +0 -0
  72. data/html/images/tag_green.png +0 -0
  73. data/html/images/transparent.png +0 -0
  74. data/html/images/wrench.png +0 -0
  75. data/html/images/wrench_orange.png +0 -0
  76. data/html/images/zoom.png +0 -0
  77. data/html/index.html +534 -0
  78. data/html/js/darkfish.js +84 -0
  79. data/html/js/navigation.js +105 -0
  80. data/html/js/navigation.js.gz +0 -0
  81. data/html/js/search.js +110 -0
  82. data/html/js/search_index.js +1 -0
  83. data/html/js/search_index.js.gz +0 -0
  84. data/html/js/searcher.js +229 -0
  85. data/html/js/searcher.js.gz +0 -0
  86. data/html/table_of_contents.html +1258 -0
  87. data/lib/midilib/info.rb +2 -2
  88. data/lib/midilib/io/seqreader.rb +18 -5
  89. data/test/test_io.rb +18 -5
  90. metadata +85 -1
data/html/MIDI/Sequence.html ADDED
@@ -0,0 +1,641 @@
1
+ <!DOCTYPE html>
2
+
3
+ <html>
4
+ <head>
5
+ <meta charset="UTF-8">
6
+
7
+ <title>class MIDI::Sequence - midilib</title>
8
+
9
+ <script type="text/javascript">
10
+ var rdoc_rel_prefix = "../";
11
+ var index_rel_prefix = "../";
12
+ </script>
13
+
14
+ <script src="../js/navigation.js" defer></script>
15
+ <script src="../js/search.js" defer></script>
16
+ <script src="../js/search_index.js" defer></script>
17
+ <script src="../js/searcher.js" defer></script>
18
+ <script src="../js/darkfish.js" defer></script>
19
+
20
+ <link href="../css/fonts.css" rel="stylesheet">
21
+ <link href="../css/rdoc.css" rel="stylesheet">
22
+
23
+
24
+ <body id="top" role="document" class="class">
25
+ <nav role="navigation">
26
+ <div id="project-navigation">
27
+ <div id="home-section" role="region" title="Quick navigation" class="nav-section">
28
+ <h2>
29
+ <a href="../index.html" rel="home">Home</a>
30
+ </h2>
31
+
32
+ <div id="table-of-contents-navigation">
33
+ <a href="../table_of_contents.html#pages">Pages</a>
34
+ <a href="../table_of_contents.html#classes">Classes</a>
35
+ <a href="../table_of_contents.html#methods">Methods</a>
36
+ </div>
37
+ </div>
38
+
39
+ <div id="search-section" role="search" class="project-section initially-hidden">
40
+ <form action="#" method="get" accept-charset="utf-8">
41
+ <div id="search-field-wrapper">
42
+ <input id="search-field" role="combobox" aria-label="Search"
43
+ aria-autocomplete="list" aria-controls="search-results"
44
+ type="text" name="search" placeholder="Search" spellcheck="false"
45
+ title="Type to search, Up and Down to navigate, Enter to load">
46
+ </div>
47
+
48
+ <ul id="search-results" aria-label="Search Results"
49
+ aria-busy="false" aria-expanded="false"
50
+ aria-atomic="false" class="initially-hidden"></ul>
51
+ </form>
52
+ </div>
53
+
54
+ </div>
55
+
56
+
57
+
58
+ <div id="class-metadata">
59
+
60
+
61
+ <div id="parent-class-section" class="nav-section">
62
+ <h3>Parent</h3>
63
+
64
+ <p class="link"><a href="../Object.html">Object</a>
65
+ </div>
66
+
67
+
68
+ <div id="includes-section" class="nav-section">
69
+ <h3>Included Modules</h3>
70
+
71
+ <ul class="link-list">
72
+ <li><span class="include">Enumerable</span>
73
+ </ul>
74
+ </div>
75
+
76
+
77
+
78
+ <!-- Method Quickref -->
79
+ <div id="method-list-section" class="nav-section">
80
+ <h3>Methods</h3>
81
+
82
+ <ul class="link-list" role="directory">
83
+ <li ><a href="#method-c-new">::new</a>
84
+ <li ><a href="#method-i-beats_per_minute">#beats_per_minute</a>
85
+ <li ><a href="#method-i-bpm">#bpm</a>
86
+ <li ><a href="#method-i-each">#each</a>
87
+ <li ><a href="#method-i-get_measures">#get_measures</a>
88
+ <li ><a href="#method-i-length_to_delta">#length_to_delta</a>
89
+ <li ><a href="#method-i-name">#name</a>
90
+ <li ><a href="#method-i-name-3D">#name=</a>
91
+ <li ><a href="#method-i-note_to_delta">#note_to_delta</a>
92
+ <li ><a href="#method-i-note_to_length">#note_to_length</a>
93
+ <li ><a href="#method-i-pulses_to_seconds">#pulses_to_seconds</a>
94
+ <li ><a href="#method-i-read">#read</a>
95
+ <li ><a href="#method-i-tempo">#tempo</a>
96
+ <li ><a href="#method-i-time_signature">#time_signature</a>
97
+ <li ><a href="#method-i-write">#write</a>
98
+ </ul>
99
+ </div>
100
+
101
+ </div>
102
+ </nav>
103
+
104
+ <main role="main" aria-labelledby="class-MIDI::Sequence">
105
+ <h1 id="class-MIDI::Sequence" class="class">
106
+ class MIDI::Sequence
107
+ </h1>
108
+
109
+ <section class="description">
110
+
111
+ <p>A <a href="Sequence.html"><code>MIDI::Sequence</code></a> contains <a href="Track.html"><code>MIDI::Track</code></a> objects.</p>
112
+
113
+ </section>
114
+
115
+ <section id="5Buntitled-5D" class="documentation-section">
116
+
117
+
118
+ <section class="constants-list">
119
+ <header>
120
+ <h3>Constants</h3>
121
+ </header>
122
+ <dl>
123
+ <dt id="DEFAULT_TEMPO">DEFAULT_TEMPO
124
+ <dd>
125
+ <dt id="NOTE_TO_LENGTH">NOTE_TO_LENGTH
126
+ <dd>
127
+ <dt id="UNNAMED">UNNAMED
128
+ <dd>
129
+ </dl>
130
+ </section>
131
+
132
+ <section class="attribute-method-details" class="method-section">
133
+ <header>
134
+ <h3>Attributes</h3>
135
+ </header>
136
+
137
+ <div id="attribute-i-clocks" class="method-detail">
138
+ <div class="method-heading attribute-method-heading">
139
+ <span class="method-name">clocks</span><span
140
+ class="attribute-access-type">[RW]</span>
141
+ </div>
142
+
143
+ <div class="method-description">
144
+
145
+ </div>
146
+ </div>
147
+ <div id="attribute-i-denom" class="method-detail">
148
+ <div class="method-heading attribute-method-heading">
149
+ <span class="method-name">denom</span><span
150
+ class="attribute-access-type">[RW]</span>
151
+ </div>
152
+
153
+ <div class="method-description">
154
+
155
+ </div>
156
+ </div>
157
+ <div id="attribute-i-format" class="method-detail">
158
+ <div class="method-heading attribute-method-heading">
159
+ <span class="method-name">format</span><span
160
+ class="attribute-access-type">[RW]</span>
161
+ </div>
162
+
163
+ <div class="method-description">
164
+ <p>The <a href="../MIDI.html"><code>MIDI</code></a> file format (0, 1, or 2)</p>
165
+ </div>
166
+ </div>
167
+ <div id="attribute-i-numer" class="method-detail">
168
+ <div class="method-heading attribute-method-heading">
169
+ <span class="method-name">numer</span><span
170
+ class="attribute-access-type">[RW]</span>
171
+ </div>
172
+
173
+ <div class="method-description">
174
+
175
+ </div>
176
+ </div>
177
+ <div id="attribute-i-ppqn" class="method-detail">
178
+ <div class="method-heading attribute-method-heading">
179
+ <span class="method-name">ppqn</span><span
180
+ class="attribute-access-type">[RW]</span>
181
+ </div>
182
+
183
+ <div class="method-description">
184
+ <p>Pulses (i.e. clocks) Per Quarter Note resolution for the sequence</p>
185
+ </div>
186
+ </div>
187
+ <div id="attribute-i-qnotes" class="method-detail">
188
+ <div class="method-heading attribute-method-heading">
189
+ <span class="method-name">qnotes</span><span
190
+ class="attribute-access-type">[RW]</span>
191
+ </div>
192
+
193
+ <div class="method-description">
194
+
195
+ </div>
196
+ </div>
197
+ <div id="attribute-i-reader_class" class="method-detail">
198
+ <div class="method-heading attribute-method-heading">
199
+ <span class="method-name">reader_class</span><span
200
+ class="attribute-access-type">[RW]</span>
201
+ </div>
202
+
203
+ <div class="method-description">
204
+ <p>The class to use for reading <a href="../MIDI.html"><code>MIDI</code></a> from a stream. The default is <a href="IO/SeqReader.html"><code>MIDI::IO::SeqReader</code></a>. You can change this at any time.</p>
205
+ </div>
206
+ </div>
207
+ <div id="attribute-i-tracks" class="method-detail">
208
+ <div class="method-heading attribute-method-heading">
209
+ <span class="method-name">tracks</span><span
210
+ class="attribute-access-type">[RW]</span>
211
+ </div>
212
+
213
+ <div class="method-description">
214
+ <p>Array with all tracks for the sequence</p>
215
+ </div>
216
+ </div>
217
+ <div id="attribute-i-writer_class" class="method-detail">
218
+ <div class="method-heading attribute-method-heading">
219
+ <span class="method-name">writer_class</span><span
220
+ class="attribute-access-type">[RW]</span>
221
+ </div>
222
+
223
+ <div class="method-description">
224
+ <p>The class to use for writeing <a href="../MIDI.html"><code>MIDI</code></a> from a stream. The default is <a href="IO/SeqWriter.html"><code>MIDI::IO::SeqWriter</code></a>. You can change this at any time.</p>
225
+ </div>
226
+ </div>
227
+ </section>
228
+
229
+
230
+ <section id="public-class-5Buntitled-5D-method-details" class="method-section">
231
+ <header>
232
+ <h3>Public Class Methods</h3>
233
+ </header>
234
+
235
+ <div id="method-c-new" class="method-detail ">
236
+ <div class="method-heading">
237
+ <span class="method-name">new</span><span
238
+ class="method-args">()</span>
239
+ <span class="method-click-advice">click to toggle source</span>
240
+ </div>
241
+
242
+ <div class="method-description">
243
+
244
+
245
+ <div class="method-source-code" id="new-source">
246
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 43</span>
247
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">initialize</span>
248
+ <span class="ruby-ivar">@tracks</span> = []
249
+ <span class="ruby-ivar">@ppqn</span> = <span class="ruby-value">480</span>
250
+
251
+ <span class="ruby-comment"># Time signature</span>
252
+ <span class="ruby-ivar">@numer</span> = <span class="ruby-value">4</span> <span class="ruby-comment"># Numer + denom = 4/4 time default</span>
253
+ <span class="ruby-ivar">@denom</span> = <span class="ruby-value">2</span>
254
+ <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>
255
+ <span class="ruby-ivar">@qnotes</span> = <span class="ruby-value">8</span>
256
+
257
+ <span class="ruby-ivar">@reader_class</span> = <span class="ruby-constant">IO</span><span class="ruby-operator">::</span><span class="ruby-constant">SeqReader</span>
258
+ <span class="ruby-ivar">@writer_class</span> = <span class="ruby-constant">IO</span><span class="ruby-operator">::</span><span class="ruby-constant">SeqWriter</span>
259
+ <span class="ruby-keyword">end</span></pre>
260
+ </div>
261
+ </div>
262
+
263
+
264
+ </div>
265
+
266
+ </section>
267
+
268
+ <section id="public-instance-5Buntitled-5D-method-details" class="method-section">
269
+ <header>
270
+ <h3>Public Instance Methods</h3>
271
+ </header>
272
+
273
+ <div id="method-i-beats_per_minute" class="method-detail ">
274
+ <div class="method-heading">
275
+ <span class="method-name">beats_per_minute</span><span
276
+ class="method-args">()</span>
277
+ <span class="method-click-advice">click to toggle source</span>
278
+ </div>
279
+
280
+ <div class="method-description">
281
+ <p>Returns the song tempo in beats per minute.</p>
282
+
283
+ <div class="method-source-code" id="beats_per_minute-source">
284
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 66</span>
285
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">beats_per_minute</span>
286
+ <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>
287
+
288
+ <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> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">MIDI</span><span class="ruby-operator">::</span><span class="ruby-constant">Tempo</span>) }
289
+ <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>
290
+ <span class="ruby-keyword">end</span></pre>
291
+ </div>
292
+ </div>
293
+
294
+ <div class="aliases">
295
+ Also aliased as: <a href="Sequence.html#method-i-bpm">bpm</a>, <a href="Sequence.html#method-i-tempo">tempo</a>
296
+ </div>
297
+
298
+ </div>
299
+
300
+ <div id="method-i-bpm" class="method-detail method-alias">
301
+ <div class="method-heading">
302
+ <span class="method-name">bpm</span><span
303
+ class="method-args">()</span>
304
+ </div>
305
+
306
+ <div class="method-description">
307
+
308
+
309
+ </div>
310
+
311
+
312
+ <div class="aliases">
313
+ Alias for: <a href="Sequence.html#method-i-beats_per_minute">beats_per_minute</a>
314
+ </div>
315
+ </div>
316
+
317
+ <div id="method-i-each" class="method-detail ">
318
+ <div class="method-heading">
319
+ <span class="method-name">each</span><span
320
+ class="method-args">() { |track| ... }</span>
321
+ <span class="method-click-advice">click to toggle source</span>
322
+ </div>
323
+
324
+ <div class="method-description">
325
+ <p>Iterates over the tracks.</p>
326
+
327
+ <div class="method-source-code" id="each-source">
328
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 154</span>
329
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">each</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>) <span class="ruby-comment"># :yields: track</span>
330
+ <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">each</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
331
+ <span class="ruby-keyword">end</span></pre>
332
+ </div>
333
+ </div>
334
+
335
+
336
+ </div>
337
+
338
+ <div id="method-i-get_measures" class="method-detail ">
339
+ <div class="method-heading">
340
+ <span class="method-name">get_measures</span><span
341
+ class="method-args">()</span>
342
+ <span class="method-click-advice">click to toggle source</span>
343
+ </div>
344
+
345
+ <div class="method-description">
346
+ <p>Returns a <a href="Measures.html"><code>Measures</code></a> object, which is an array container for all measures in the sequence</p>
347
+
348
+ <div class="method-source-code" id="get_measures-source">
349
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 160</span>
350
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">get_measures</span>
351
+ <span class="ruby-comment"># Collect time sig events and scan for last event time</span>
352
+ <span class="ruby-identifier">time_sigs</span> = []
353
+ <span class="ruby-identifier">max_pos</span> = <span class="ruby-value">0</span>
354
+ <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">t</span><span class="ruby-operator">|</span>
355
+ <span class="ruby-identifier">t</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span>
356
+ <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">is_a?</span>(<span class="ruby-constant">MIDI</span><span class="ruby-operator">::</span><span class="ruby-constant">TimeSig</span>)
357
+ <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>
358
+ <span class="ruby-keyword">end</span>
359
+ <span class="ruby-keyword">end</span>
360
+ <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> }
361
+
362
+ <span class="ruby-comment"># Add a &quot;fake&quot; time sig event at the very last position of the sequence,</span>
363
+ <span class="ruby-comment"># just to make sure the whole sequence is calculated.</span>
364
+ <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>)
365
+ <span class="ruby-identifier">t</span>.<span class="ruby-identifier">time_from_start</span> = <span class="ruby-identifier">max_pos</span>
366
+ <span class="ruby-identifier">time_sigs</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">t</span>
367
+
368
+ <span class="ruby-comment"># Default to 4/4</span>
369
+ <span class="ruby-identifier">measure_length</span> = <span class="ruby-ivar">@ppqn</span> <span class="ruby-operator">*</span> <span class="ruby-value">4</span>
370
+ <span class="ruby-identifier">oldnumer</span> = <span class="ruby-value">4</span>
371
+ <span class="ruby-identifier">olddenom</span> = <span class="ruby-value">2</span>
372
+ <span class="ruby-identifier">oldbeats</span> = <span class="ruby-value">24</span>
373
+
374
+ <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>)
375
+ <span class="ruby-identifier">curr_pos</span> = <span class="ruby-value">0</span>
376
+ <span class="ruby-identifier">curr_meas_no</span> = <span class="ruby-value">1</span>
377
+ <span class="ruby-identifier">time_sigs</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">te</span><span class="ruby-operator">|</span>
378
+ <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>
379
+ <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>
380
+ <span class="ruby-value">1</span>.<span class="ruby-identifier">upto</span>(<span class="ruby-identifier">meas_count</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
381
+ <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>, <span class="ruby-identifier">curr_pos</span>, <span class="ruby-identifier">measure_length</span>,
382
+ <span class="ruby-identifier">oldnumer</span>, <span class="ruby-identifier">olddenom</span>, <span class="ruby-identifier">oldbeats</span>)
383
+ <span class="ruby-identifier">curr_meas_no</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
384
+ <span class="ruby-identifier">curr_pos</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">measure_length</span>
385
+ <span class="ruby-keyword">end</span>
386
+ <span class="ruby-identifier">oldnumer</span> = <span class="ruby-identifier">te</span>.<span class="ruby-identifier">numerator</span>
387
+ <span class="ruby-identifier">olddenom</span> = <span class="ruby-identifier">te</span>.<span class="ruby-identifier">denominator</span>
388
+ <span class="ruby-identifier">oldbeats</span> = <span class="ruby-identifier">te</span>.<span class="ruby-identifier">metronome_ticks</span>
389
+ <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>)
390
+ <span class="ruby-keyword">end</span>
391
+ <span class="ruby-identifier">measures</span>
392
+ <span class="ruby-keyword">end</span></pre>
393
+ </div>
394
+ </div>
395
+
396
+
397
+ </div>
398
+
399
+ <div id="method-i-length_to_delta" class="method-detail ">
400
+ <div class="method-heading">
401
+ <span class="method-name">length_to_delta</span><span
402
+ class="method-args">(length)</span>
403
+ <span class="method-click-advice">click to toggle source</span>
404
+ </div>
405
+
406
+ <div class="method-description">
407
+ <p>Translates <code>length</code> (a multiple of a quarter note) into a delta time. For example, 1 is a quarter note, 1.0/32.0 is a 32nd note, 1.5 is a dotted quarter, etc. Be aware when using division; 1/32 is zero due to integer mathematics and rounding. Use floating-point numbers like 1.0 and 32.0. This method always returns an integer by calling ‘.round` on the floating-point result.</p>
408
+
409
+ <p>See also <a href="Sequence.html#method-i-note_to_delta"><code>note_to_delta</code></a> and note_to_length.</p>
410
+
411
+ <div class="method-source-code" id="length_to_delta-source">
412
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 122</span>
413
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">length_to_delta</span>(<span class="ruby-identifier">length</span>)
414
+ (<span class="ruby-ivar">@ppqn</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">length</span>).<span class="ruby-identifier">round</span>
415
+ <span class="ruby-keyword">end</span></pre>
416
+ </div>
417
+ </div>
418
+
419
+
420
+ </div>
421
+
422
+ <div id="method-i-name" class="method-detail ">
423
+ <div class="method-heading">
424
+ <span class="method-name">name</span><span
425
+ class="method-args">()</span>
426
+ <span class="method-click-advice">click to toggle source</span>
427
+ </div>
428
+
429
+ <div class="method-description">
430
+ <p>Returns the name of the first track (track zero). If there are no tracks, returns <a href="Sequence.html#UNNAMED"><code>UNNAMED</code></a>.</p>
431
+
432
+ <div class="method-source-code" id="name-source">
433
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 128</span>
434
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">name</span>
435
+ <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>
436
+
437
+ <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">name</span>
438
+ <span class="ruby-keyword">end</span></pre>
439
+ </div>
440
+ </div>
441
+
442
+
443
+ </div>
444
+
445
+ <div id="method-i-name-3D" class="method-detail ">
446
+ <div class="method-heading">
447
+ <span class="method-name">name=</span><span
448
+ class="method-args">(name)</span>
449
+ <span class="method-click-advice">click to toggle source</span>
450
+ </div>
451
+
452
+ <div class="method-description">
453
+ <p>Hands the name to the first track. Does nothing if there are no tracks.</p>
454
+
455
+ <div class="method-source-code" id="name-3D-source">
456
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 135</span>
457
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">name=</span>(<span class="ruby-identifier">name</span>)
458
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">empty?</span>
459
+
460
+ <span class="ruby-ivar">@tracks</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">name</span> = <span class="ruby-identifier">name</span>
461
+ <span class="ruby-keyword">end</span></pre>
462
+ </div>
463
+ </div>
464
+
465
+
466
+ </div>
467
+
468
+ <div id="method-i-note_to_delta" class="method-detail ">
469
+ <div class="method-heading">
470
+ <span class="method-name">note_to_delta</span><span
471
+ class="method-args">(name)</span>
472
+ <span class="method-click-advice">click to toggle source</span>
473
+ </div>
474
+
475
+ <div class="method-description">
476
+ <p>Given a note length name like “whole”, “dotted quarter”, or “8th triplet”, return the length of that note in quarter notes as a delta time.</p>
477
+
478
+ <div class="method-source-code" id="note_to_delta-source">
479
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 85</span>
480
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">note_to_delta</span>(<span class="ruby-identifier">name</span>)
481
+ <span class="ruby-identifier">length_to_delta</span>(<span class="ruby-identifier">note_to_length</span>(<span class="ruby-identifier">name</span>))
482
+ <span class="ruby-keyword">end</span></pre>
483
+ </div>
484
+ </div>
485
+
486
+
487
+ </div>
488
+
489
+ <div id="method-i-note_to_length" class="method-detail ">
490
+ <div class="method-heading">
491
+ <span class="method-name">note_to_length</span><span
492
+ class="method-args">(name)</span>
493
+ <span class="method-click-advice">click to toggle source</span>
494
+ </div>
495
+
496
+ <div class="method-description">
497
+ <p>Given a note length name like “whole”, “dotted quarter”, or “8th triplet”, return the length of that note in quarter notes as a floating-point number, suitable for use as an argument to length_to_delta.</p>
498
+
499
+ <p>Legal names are any value in <a href="Sequence.html#NOTE_TO_LENGTH"><code>NOTE_TO_LENGTH</code></a>, optionally prefixed by “dotted_” and/or suffixed by “_triplet”. So, for example, “dotted_quarter_triplet” returns the length of a dotted quarter-note triplet and “32nd” returns 1/32.</p>
500
+
501
+ <div class="method-source-code" id="note_to_length-source">
502
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 98</span>
503
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">note_to_length</span>(<span class="ruby-identifier">name</span>)
504
+ <span class="ruby-identifier">name</span>.<span class="ruby-identifier">strip!</span>
505
+ <span class="ruby-identifier">name</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/^(dotted)?(.*?)(triplet)?$/</span>
506
+ <span class="ruby-identifier">dotted</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">last_match</span>(<span class="ruby-value">1</span>)
507
+ <span class="ruby-identifier">note_name</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">last_match</span>(<span class="ruby-value">2</span>)
508
+ <span class="ruby-identifier">triplet</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">last_match</span>(<span class="ruby-value">3</span>)
509
+ <span class="ruby-identifier">note_name</span>.<span class="ruby-identifier">strip!</span>
510
+ <span class="ruby-identifier">mult</span> = <span class="ruby-value">1.0</span>
511
+ <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>
512
+ <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>
513
+ <span class="ruby-identifier">len</span> = <span class="ruby-constant">NOTE_TO_LENGTH</span>[<span class="ruby-identifier">note_name</span>]
514
+ <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>
515
+
516
+ <span class="ruby-identifier">len</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">mult</span>
517
+ <span class="ruby-keyword">end</span></pre>
518
+ </div>
519
+ </div>
520
+
521
+
522
+ </div>
523
+
524
+ <div id="method-i-pulses_to_seconds" class="method-detail ">
525
+ <div class="method-heading">
526
+ <span class="method-name">pulses_to_seconds</span><span
527
+ class="method-args">(pulses)</span>
528
+ <span class="method-click-advice">click to toggle source</span>
529
+ </div>
530
+
531
+ <div class="method-description">
532
+ <p>Pulses (also called ticks) are the units of delta times and event time_from_start values. This method converts a number of pulses to a float value that is a time in seconds.</p>
533
+
534
+ <div class="method-source-code" id="pulses_to_seconds-source">
535
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 78</span>
536
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">pulses_to_seconds</span>(<span class="ruby-identifier">pulses</span>)
537
+ (<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-operator">*</span> <span class="ruby-value">60.0</span>
538
+ <span class="ruby-keyword">end</span></pre>
539
+ </div>
540
+ </div>
541
+
542
+
543
+ </div>
544
+
545
+ <div id="method-i-read" class="method-detail ">
546
+ <div class="method-heading">
547
+ <span class="method-name">read</span><span
548
+ class="method-args">(io) { |track, num_tracks, index| ... }</span>
549
+ <span class="method-click-advice">click to toggle source</span>
550
+ </div>
551
+
552
+ <div class="method-description">
553
+ <p>Reads a <a href="../MIDI.html"><code>MIDI</code></a> stream.</p>
554
+
555
+ <div class="method-source-code" id="read-source">
556
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 142</span>
557
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">read</span>(<span class="ruby-identifier">io</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>) <span class="ruby-comment"># :yields: track, num_tracks, index</span>
558
+ <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-operator">&amp;</span><span class="ruby-identifier">block</span>)
559
+ <span class="ruby-identifier">reader</span>.<span class="ruby-identifier">read_from</span>(<span class="ruby-identifier">io</span>)
560
+ <span class="ruby-keyword">end</span></pre>
561
+ </div>
562
+ </div>
563
+
564
+
565
+ </div>
566
+
567
+ <div id="method-i-tempo" class="method-detail method-alias">
568
+ <div class="method-heading">
569
+ <span class="method-name">tempo</span><span
570
+ class="method-args">()</span>
571
+ </div>
572
+
573
+ <div class="method-description">
574
+
575
+
576
+ </div>
577
+
578
+
579
+ <div class="aliases">
580
+ Alias for: <a href="Sequence.html#method-i-beats_per_minute">beats_per_minute</a>
581
+ </div>
582
+ </div>
583
+
584
+ <div id="method-i-time_signature" class="method-detail ">
585
+ <div class="method-heading">
586
+ <span class="method-name">time_signature</span><span
587
+ class="method-args">(numer, denom, clocks, qnotes)</span>
588
+ <span class="method-click-advice">click to toggle source</span>
589
+ </div>
590
+
591
+ <div class="method-description">
592
+ <p>Sets the time signature.</p>
593
+
594
+ <div class="method-source-code" id="time_signature-source">
595
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 58</span>
596
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">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>)
597
+ <span class="ruby-ivar">@numer</span> = <span class="ruby-identifier">numer</span>
598
+ <span class="ruby-ivar">@denom</span> = <span class="ruby-identifier">denom</span>
599
+ <span class="ruby-ivar">@clocks</span> = <span class="ruby-identifier">clocks</span>
600
+ <span class="ruby-ivar">@qnotes</span> = <span class="ruby-identifier">qnotes</span>
601
+ <span class="ruby-keyword">end</span></pre>
602
+ </div>
603
+ </div>
604
+
605
+
606
+ </div>
607
+
608
+ <div id="method-i-write" class="method-detail ">
609
+ <div class="method-heading">
610
+ <span class="method-name">write</span><span
611
+ class="method-args">(io, midi_format = 1) { |track, num_tracks, index| ... }</span>
612
+ <span class="method-click-advice">click to toggle source</span>
613
+ </div>
614
+
615
+ <div class="method-description">
616
+ <p>Writes to a <a href="../MIDI.html"><code>MIDI</code></a> stream. <code>midi_format</code> defaults to 1.</p>
617
+
618
+ <div class="method-source-code" id="write-source">
619
+ <pre><span class="ruby-comment"># File lib/midilib/sequence.rb, line 148</span>
620
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write</span>(<span class="ruby-identifier">io</span>, <span class="ruby-identifier">midi_format</span> = <span class="ruby-value">1</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>) <span class="ruby-comment"># :yields: track, num_tracks, index</span>
621
+ <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">midi_format</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
622
+ <span class="ruby-identifier">writer</span>.<span class="ruby-identifier">write_to</span>(<span class="ruby-identifier">io</span>)
623
+ <span class="ruby-keyword">end</span></pre>
624
+ </div>
625
+ </div>
626
+
627
+
628
+ </div>
629
+
630
+ </section>
631
+
632
+ </section>
633
+ </main>
634
+
635
+
636
+ <footer id="validator-badges" role="contentinfo">
637
+ <p><a href="https://validator.w3.org/check/referer">Validate</a>
638
+ <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.4.0.
639
+ <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
640
+ </footer>
641
+