midilib 3.1.0 → 4.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (99) hide show
  1. checksums.yaml +4 -4
  2. data/ChangeLog +12 -12
  3. data/Credits +7 -0
  4. data/README.rdoc +10 -1
  5. data/Rakefile +0 -1
  6. data/TODO.rdoc +8 -7
  7. data/lib/midilib/event.rb +2 -2
  8. data/lib/midilib/info.rb +3 -3
  9. data/lib/midilib/io/seqreader.rb +11 -27
  10. data/lib/midilib/io/seqwriter.rb +6 -4
  11. data/lib/midilib/track.rb +38 -6
  12. data/test/test_event.rb +12 -0
  13. data/test/test_io.rb +28 -2
  14. data/test/test_track.rb +65 -1
  15. metadata +3 -87
  16. data/html/MIDI/ActiveSense.html +0 -171
  17. data/html/MIDI/ChannelEvent.html +0 -190
  18. data/html/MIDI/ChannelPressure.html +0 -212
  19. data/html/MIDI/Clock.html +0 -171
  20. data/html/MIDI/Continue.html +0 -171
  21. data/html/MIDI/Controller.html +0 -224
  22. data/html/MIDI/Event.html +0 -349
  23. data/html/MIDI/IO/MIDIFile.html +0 -1392
  24. data/html/MIDI/IO/SeqReader.html +0 -642
  25. data/html/MIDI/IO/SeqWriter.html +0 -442
  26. data/html/MIDI/IO.html +0 -91
  27. data/html/MIDI/KeySig.html +0 -292
  28. data/html/MIDI/Marker.html +0 -138
  29. data/html/MIDI/Measure.html +0 -260
  30. data/html/MIDI/Measures.html +0 -222
  31. data/html/MIDI/MetaEvent.html +0 -353
  32. data/html/MIDI/NoteEvent.html +0 -255
  33. data/html/MIDI/NoteOff.html +0 -188
  34. data/html/MIDI/NoteOn.html +0 -188
  35. data/html/MIDI/PitchBend.html +0 -213
  36. data/html/MIDI/PolyPressure.html +0 -216
  37. data/html/MIDI/ProgramChange.html +0 -212
  38. data/html/MIDI/Realtime.html +0 -194
  39. data/html/MIDI/Sequence.html +0 -641
  40. data/html/MIDI/SongPointer.html +0 -213
  41. data/html/MIDI/SongSelect.html +0 -212
  42. data/html/MIDI/Start.html +0 -171
  43. data/html/MIDI/Stop.html +0 -171
  44. data/html/MIDI/SystemCommon.html +0 -138
  45. data/html/MIDI/SystemExclusive.html +0 -215
  46. data/html/MIDI/SystemReset.html +0 -171
  47. data/html/MIDI/Tempo.html +0 -292
  48. data/html/MIDI/TimeSig.html +0 -286
  49. data/html/MIDI/Track.html +0 -489
  50. data/html/MIDI/TuneRequest.html +0 -194
  51. data/html/MIDI/Utils.html +0 -178
  52. data/html/MIDI.html +0 -281
  53. data/html/Object.html +0 -197
  54. data/html/README_rdoc.html +0 -545
  55. data/html/TODO_rdoc.html +0 -123
  56. data/html/created.rid +0 -15
  57. data/html/css/fonts.css +0 -167
  58. data/html/css/rdoc.css +0 -639
  59. data/html/fonts/Lato-Light.ttf +0 -0
  60. data/html/fonts/Lato-LightItalic.ttf +0 -0
  61. data/html/fonts/Lato-Regular.ttf +0 -0
  62. data/html/fonts/Lato-RegularItalic.ttf +0 -0
  63. data/html/fonts/SourceCodePro-Bold.ttf +0 -0
  64. data/html/fonts/SourceCodePro-Regular.ttf +0 -0
  65. data/html/images/add.png +0 -0
  66. data/html/images/arrow_up.png +0 -0
  67. data/html/images/brick.png +0 -0
  68. data/html/images/brick_link.png +0 -0
  69. data/html/images/bug.png +0 -0
  70. data/html/images/bullet_black.png +0 -0
  71. data/html/images/bullet_toggle_minus.png +0 -0
  72. data/html/images/bullet_toggle_plus.png +0 -0
  73. data/html/images/date.png +0 -0
  74. data/html/images/delete.png +0 -0
  75. data/html/images/find.png +0 -0
  76. data/html/images/loadingAnimation.gif +0 -0
  77. data/html/images/macFFBgHack.png +0 -0
  78. data/html/images/package.png +0 -0
  79. data/html/images/page_green.png +0 -0
  80. data/html/images/page_white_text.png +0 -0
  81. data/html/images/page_white_width.png +0 -0
  82. data/html/images/plugin.png +0 -0
  83. data/html/images/ruby.png +0 -0
  84. data/html/images/tag_blue.png +0 -0
  85. data/html/images/tag_green.png +0 -0
  86. data/html/images/transparent.png +0 -0
  87. data/html/images/wrench.png +0 -0
  88. data/html/images/wrench_orange.png +0 -0
  89. data/html/images/zoom.png +0 -0
  90. data/html/index.html +0 -534
  91. data/html/js/darkfish.js +0 -84
  92. data/html/js/navigation.js +0 -105
  93. data/html/js/navigation.js.gz +0 -0
  94. data/html/js/search.js +0 -110
  95. data/html/js/search_index.js +0 -1
  96. data/html/js/search_index.js.gz +0 -0
  97. data/html/js/searcher.js +0 -229
  98. data/html/js/searcher.js.gz +0 -0
  99. data/html/table_of_contents.html +0 -1258
data/html/MIDI/Sequence.html DELETED
@@ -1,641 +0,0 @@
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
-