midilib 3.0.1 → 3.1.0

Sign up to get free protection for your applications and to get access to all the features.
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/IO/SeqWriter.html ADDED
@@ -0,0 +1,442 @@
1
+ <!DOCTYPE html>
2
+
3
+ <html>
4
+ <head>
5
+ <meta charset="UTF-8">
6
+
7
+ <title>class MIDI::IO::SeqWriter - 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
+
69
+
70
+ <!-- Method Quickref -->
71
+ <div id="method-list-section" class="nav-section">
72
+ <h3>Methods</h3>
73
+
74
+ <ul class="link-list" role="directory">
75
+ <li ><a href="#method-c-new">::new</a>
76
+ <li ><a href="#method-i-possibly_munge_due_to_running_status_byte">#possibly_munge_due_to_running_status_byte</a>
77
+ <li ><a href="#method-i-write16">#write16</a>
78
+ <li ><a href="#method-i-write32">#write32</a>
79
+ <li ><a href="#method-i-write_bytes">#write_bytes</a>
80
+ <li ><a href="#method-i-write_header">#write_header</a>
81
+ <li ><a href="#method-i-write_instrument">#write_instrument</a>
82
+ <li ><a href="#method-i-write_to">#write_to</a>
83
+ <li ><a href="#method-i-write_track">#write_track</a>
84
+ <li ><a href="#method-i-write_var_len">#write_var_len</a>
85
+ </ul>
86
+ </div>
87
+
88
+ </div>
89
+ </nav>
90
+
91
+ <main role="main" aria-labelledby="class-MIDI::IO::SeqWriter">
92
+ <h1 id="class-MIDI::IO::SeqWriter" class="class">
93
+ class MIDI::IO::SeqWriter
94
+ </h1>
95
+
96
+ <section class="description">
97
+
98
+ </section>
99
+
100
+ <section id="5Buntitled-5D" class="documentation-section">
101
+
102
+
103
+
104
+
105
+
106
+ <section id="public-class-5Buntitled-5D-method-details" class="method-section">
107
+ <header>
108
+ <h3>Public Class Methods</h3>
109
+ </header>
110
+
111
+ <div id="method-c-new" class="method-detail ">
112
+ <div class="method-heading">
113
+ <span class="method-name">new</span><span
114
+ class="method-args">(seq, midi_format = 1) { |num_tracks, index| ... }</span>
115
+ <span class="method-click-advice">click to toggle source</span>
116
+ </div>
117
+
118
+ <div class="method-description">
119
+
120
+
121
+ <div class="method-source-code" id="new-source">
122
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 9</span>
123
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">initialize</span>(<span class="ruby-identifier">seq</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: num_tracks, index</span>
124
+ <span class="ruby-ivar">@seq</span> = <span class="ruby-identifier">seq</span>
125
+ <span class="ruby-ivar">@midi_format</span> = <span class="ruby-identifier">midi_format</span> <span class="ruby-operator">||</span> <span class="ruby-value">1</span>
126
+ <span class="ruby-ivar">@update_block</span> = <span class="ruby-identifier">block</span>
127
+ <span class="ruby-keyword">end</span></pre>
128
+ </div>
129
+ </div>
130
+
131
+
132
+ </div>
133
+
134
+ </section>
135
+
136
+ <section id="public-instance-5Buntitled-5D-method-details" class="method-section">
137
+ <header>
138
+ <h3>Public Instance Methods</h3>
139
+ </header>
140
+
141
+ <div id="method-i-possibly_munge_due_to_running_status_byte" class="method-detail ">
142
+ <div class="method-heading">
143
+ <span class="method-name">possibly_munge_due_to_running_status_byte</span><span
144
+ class="method-args">(data, prev_status)</span>
145
+ <span class="method-click-advice">click to toggle source</span>
146
+ </div>
147
+
148
+ <div class="method-description">
149
+ <p>If we can use a running status byte, delete the status byte from the given data. Return the status to remember for next time as the running status byte for this event.</p>
150
+
151
+ <div class="method-source-code" id="possibly_munge_due_to_running_status_byte-source">
152
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 84</span>
153
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">possibly_munge_due_to_running_status_byte</span>(<span class="ruby-identifier">data</span>, <span class="ruby-identifier">prev_status</span>)
154
+ <span class="ruby-identifier">status</span> = <span class="ruby-identifier">data</span>[<span class="ruby-value">0</span>]
155
+ <span class="ruby-keyword">return</span> <span class="ruby-identifier">status</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-value">0xf0</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">prev_status</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-value">0xf0</span>
156
+
157
+ <span class="ruby-identifier">chan</span> = (<span class="ruby-identifier">status</span> <span class="ruby-operator">&amp;</span> <span class="ruby-value">0x0f</span>)
158
+ <span class="ruby-keyword">return</span> <span class="ruby-identifier">status</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">chan</span> <span class="ruby-operator">!=</span> (<span class="ruby-identifier">prev_status</span> <span class="ruby-operator">&amp;</span> <span class="ruby-value">0x0f</span>)
159
+
160
+ <span class="ruby-identifier">status</span> = (<span class="ruby-identifier">status</span> <span class="ruby-operator">&amp;</span> <span class="ruby-value">0xf0</span>)
161
+ <span class="ruby-identifier">prev_status</span> = (<span class="ruby-identifier">prev_status</span> <span class="ruby-operator">&amp;</span> <span class="ruby-value">0xf0</span>)
162
+
163
+ <span class="ruby-comment"># Both events are on the same channel. If the two status bytes are</span>
164
+ <span class="ruby-comment"># exactly the same, the rest is trivial. If it&#39;s note on/note off,</span>
165
+ <span class="ruby-comment"># we can combine those further.</span>
166
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">prev_status</span>
167
+ <span class="ruby-identifier">data</span>[<span class="ruby-value">0</span>, <span class="ruby-value">1</span>] = [] <span class="ruby-comment"># delete status byte from data</span>
168
+ <span class="ruby-identifier">status</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">chan</span>
169
+ <span class="ruby-keyword">elsif</span> <span class="ruby-identifier">status</span> <span class="ruby-operator">==</span> <span class="ruby-constant">NOTE_OFF</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">data</span>[<span class="ruby-value">2</span>] <span class="ruby-operator">==</span> <span class="ruby-value">64</span>
170
+ <span class="ruby-comment"># If we see a note off and the velocity is 64, we can store</span>
171
+ <span class="ruby-comment"># a note on with a velocity of 0. If the velocity isn&#39;t 64</span>
172
+ <span class="ruby-comment"># then storing a note on would be bad because the would be</span>
173
+ <span class="ruby-comment"># changed to 64 when reading the file back in.</span>
174
+ <span class="ruby-identifier">data</span>[<span class="ruby-value">2</span>] = <span class="ruby-value">0</span> <span class="ruby-comment"># set vel to 0; do before possible shrinking</span>
175
+ <span class="ruby-identifier">status</span> = <span class="ruby-constant">NOTE_ON</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">chan</span>
176
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">prev_status</span> <span class="ruby-operator">==</span> <span class="ruby-constant">NOTE_ON</span>
177
+ <span class="ruby-identifier">data</span>[<span class="ruby-value">0</span>, <span class="ruby-value">1</span>] = [] <span class="ruby-comment"># delete status byte</span>
178
+ <span class="ruby-keyword">else</span>
179
+ <span class="ruby-identifier">data</span>[<span class="ruby-value">0</span>] = <span class="ruby-identifier">status</span>
180
+ <span class="ruby-keyword">end</span>
181
+ <span class="ruby-identifier">status</span>
182
+ <span class="ruby-keyword">else</span>
183
+ <span class="ruby-comment"># Can&#39;t compress data</span>
184
+ <span class="ruby-identifier">status</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">chan</span>
185
+ <span class="ruby-keyword">end</span>
186
+ <span class="ruby-keyword">end</span></pre>
187
+ </div>
188
+ </div>
189
+
190
+
191
+ </div>
192
+
193
+ <div id="method-i-write16" class="method-detail ">
194
+ <div class="method-heading">
195
+ <span class="method-name">write16</span><span
196
+ class="method-args">(val)</span>
197
+ <span class="method-click-advice">click to toggle source</span>
198
+ </div>
199
+
200
+ <div class="method-description">
201
+
202
+
203
+ <div class="method-source-code" id="write16-source">
204
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 133</span>
205
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write16</span>(<span class="ruby-identifier">val</span>)
206
+ <span class="ruby-identifier">val</span> = (<span class="ruby-operator">-</span><span class="ruby-identifier">val</span> <span class="ruby-operator">|</span> <span class="ruby-value">0x8000</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">val</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
207
+
208
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">putc</span>((<span class="ruby-identifier">val</span> <span class="ruby-operator">&gt;&gt;</span> <span class="ruby-value">8</span>) <span class="ruby-operator">&amp;</span> <span class="ruby-value">0xff</span>)
209
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">putc</span>(<span class="ruby-identifier">val</span> <span class="ruby-operator">&amp;</span> <span class="ruby-value">0xff</span>)
210
+ <span class="ruby-ivar">@bytes_written</span> <span class="ruby-operator">+=</span> <span class="ruby-value">2</span>
211
+ <span class="ruby-keyword">end</span></pre>
212
+ </div>
213
+ </div>
214
+
215
+
216
+ </div>
217
+
218
+ <div id="method-i-write32" class="method-detail ">
219
+ <div class="method-heading">
220
+ <span class="method-name">write32</span><span
221
+ class="method-args">(val)</span>
222
+ <span class="method-click-advice">click to toggle source</span>
223
+ </div>
224
+
225
+ <div class="method-description">
226
+
227
+
228
+ <div class="method-source-code" id="write32-source">
229
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 141</span>
230
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write32</span>(<span class="ruby-identifier">val</span>)
231
+ <span class="ruby-identifier">val</span> = (<span class="ruby-operator">-</span><span class="ruby-identifier">val</span> <span class="ruby-operator">|</span> <span class="ruby-value">0x80000000</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">val</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
232
+
233
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">putc</span>((<span class="ruby-identifier">val</span> <span class="ruby-operator">&gt;&gt;</span> <span class="ruby-value">24</span>) <span class="ruby-operator">&amp;</span> <span class="ruby-value">0xff</span>)
234
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">putc</span>((<span class="ruby-identifier">val</span> <span class="ruby-operator">&gt;&gt;</span> <span class="ruby-value">16</span>) <span class="ruby-operator">&amp;</span> <span class="ruby-value">0xff</span>)
235
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">putc</span>((<span class="ruby-identifier">val</span> <span class="ruby-operator">&gt;&gt;</span> <span class="ruby-value">8</span>) <span class="ruby-operator">&amp;</span> <span class="ruby-value">0xff</span>)
236
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">putc</span>(<span class="ruby-identifier">val</span> <span class="ruby-operator">&amp;</span> <span class="ruby-value">0xff</span>)
237
+ <span class="ruby-ivar">@bytes_written</span> <span class="ruby-operator">+=</span> <span class="ruby-value">4</span>
238
+ <span class="ruby-keyword">end</span></pre>
239
+ </div>
240
+ </div>
241
+
242
+
243
+ </div>
244
+
245
+ <div id="method-i-write_bytes" class="method-detail ">
246
+ <div class="method-heading">
247
+ <span class="method-name">write_bytes</span><span
248
+ class="method-args">(bytes)</span>
249
+ <span class="method-click-advice">click to toggle source</span>
250
+ </div>
251
+
252
+ <div class="method-description">
253
+
254
+
255
+ <div class="method-source-code" id="write_bytes-source">
256
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 151</span>
257
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write_bytes</span>(<span class="ruby-identifier">bytes</span>)
258
+ <span class="ruby-identifier">bytes</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">b</span><span class="ruby-operator">|</span> <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">putc</span>(<span class="ruby-identifier">b</span>) }
259
+ <span class="ruby-identifier">bytes</span>.<span class="ruby-identifier">length</span>
260
+ <span class="ruby-keyword">end</span></pre>
261
+ </div>
262
+ </div>
263
+
264
+
265
+ </div>
266
+
267
+ <div id="method-i-write_header" class="method-detail ">
268
+ <div class="method-heading">
269
+ <span class="method-name">write_header</span><span
270
+ class="method-args">()</span>
271
+ <span class="method-click-advice">click to toggle source</span>
272
+ </div>
273
+
274
+ <div class="method-description">
275
+
276
+
277
+ <div class="method-source-code" id="write_header-source">
278
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 38</span>
279
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write_header</span>
280
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">print</span> <span class="ruby-string">&#39;MThd&#39;</span>
281
+ <span class="ruby-identifier">write32</span>(<span class="ruby-value">6</span>)
282
+ <span class="ruby-identifier">write16</span>(<span class="ruby-ivar">@midi_format</span>) <span class="ruby-comment"># Ignore sequence format; write as format 1 or 0, default 1</span>
283
+ <span class="ruby-identifier">write16</span>(<span class="ruby-ivar">@seq</span>.<span class="ruby-identifier">tracks</span>.<span class="ruby-identifier">length</span>)
284
+ <span class="ruby-identifier">write16</span>(<span class="ruby-ivar">@seq</span>.<span class="ruby-identifier">ppqn</span>)
285
+ <span class="ruby-keyword">end</span></pre>
286
+ </div>
287
+ </div>
288
+
289
+
290
+ </div>
291
+
292
+ <div id="method-i-write_instrument" class="method-detail ">
293
+ <div class="method-heading">
294
+ <span class="method-name">write_instrument</span><span
295
+ class="method-args">(instrument)</span>
296
+ <span class="method-click-advice">click to toggle source</span>
297
+ </div>
298
+
299
+ <div class="method-description">
300
+
301
+
302
+ <div class="method-source-code" id="write_instrument-source">
303
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 119</span>
304
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write_instrument</span>(<span class="ruby-identifier">instrument</span>)
305
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">instrument</span>.<span class="ruby-identifier">nil?</span>
306
+
307
+ <span class="ruby-identifier">event</span> = <span class="ruby-constant">MetaEvent</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">META_INSTRUMENT</span>, <span class="ruby-identifier">instrument</span>)
308
+ <span class="ruby-identifier">write_var_len</span>(<span class="ruby-value">0</span>)
309
+ <span class="ruby-identifier">data</span> = <span class="ruby-identifier">event</span>.<span class="ruby-identifier">data_as_bytes</span>
310
+ <span class="ruby-ivar">@bytes_written</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">write_bytes</span>(<span class="ruby-identifier">data</span>)
311
+ <span class="ruby-keyword">end</span></pre>
312
+ </div>
313
+ </div>
314
+
315
+
316
+ </div>
317
+
318
+ <div id="method-i-write_to" class="method-detail ">
319
+ <div class="method-heading">
320
+ <span class="method-name">write_to</span><span
321
+ class="method-args">(io)</span>
322
+ <span class="method-click-advice">click to toggle source</span>
323
+ </div>
324
+
325
+ <div class="method-description">
326
+ <p>Writes a <a href="../../MIDI.html"><code>MIDI</code></a> format 1 file.</p>
327
+
328
+ <div class="method-source-code" id="write_to-source">
329
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 16</span>
330
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write_to</span>(<span class="ruby-identifier">io</span>)
331
+ <span class="ruby-keyword">if</span> <span class="ruby-ivar">@midi_format</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
332
+ <span class="ruby-comment"># merge tracks before writing</span>
333
+ <span class="ruby-identifier">merged_seq</span> = <span class="ruby-constant">Sequence</span>.<span class="ruby-identifier">new</span>
334
+ <span class="ruby-identifier">merged_track</span> = <span class="ruby-constant">Track</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">merged_seq</span>)
335
+ <span class="ruby-identifier">merged_seq</span>.<span class="ruby-identifier">tracks</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">merged_track</span>
336
+ <span class="ruby-ivar">@seq</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">track</span><span class="ruby-operator">|</span>
337
+ <span class="ruby-identifier">merged_track</span>.<span class="ruby-identifier">merge</span>(<span class="ruby-identifier">track</span>.<span class="ruby-identifier">events</span>)
338
+ <span class="ruby-keyword">end</span>
339
+ <span class="ruby-ivar">@seq</span> = <span class="ruby-identifier">merged_seq</span> <span class="ruby-comment"># replace</span>
340
+ <span class="ruby-keyword">end</span>
341
+
342
+ <span class="ruby-ivar">@io</span> = <span class="ruby-identifier">io</span>
343
+ <span class="ruby-ivar">@bytes_written</span> = <span class="ruby-value">0</span>
344
+ <span class="ruby-identifier">write_header</span>
345
+ <span class="ruby-ivar">@update_block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-keyword">nil</span>, <span class="ruby-ivar">@seq</span>.<span class="ruby-identifier">tracks</span>.<span class="ruby-identifier">length</span>, <span class="ruby-value">0</span>) <span class="ruby-keyword">if</span> <span class="ruby-ivar">@update_block</span>
346
+ <span class="ruby-ivar">@seq</span>.<span class="ruby-identifier">tracks</span>.<span class="ruby-identifier">each_with_index</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">track</span>, <span class="ruby-identifier">i</span><span class="ruby-operator">|</span>
347
+ <span class="ruby-identifier">write_track</span>(<span class="ruby-identifier">track</span>)
348
+ <span class="ruby-ivar">@update_block</span>.<span class="ruby-identifier">call</span>(<span class="ruby-identifier">track</span>, <span class="ruby-ivar">@seq</span>.<span class="ruby-identifier">tracks</span>.<span class="ruby-identifier">length</span>, <span class="ruby-identifier">i</span>) <span class="ruby-keyword">if</span> <span class="ruby-ivar">@update_block</span>
349
+ <span class="ruby-keyword">end</span>
350
+ <span class="ruby-keyword">end</span></pre>
351
+ </div>
352
+ </div>
353
+
354
+
355
+ </div>
356
+
357
+ <div id="method-i-write_track" class="method-detail ">
358
+ <div class="method-heading">
359
+ <span class="method-name">write_track</span><span
360
+ class="method-args">(track)</span>
361
+ <span class="method-click-advice">click to toggle source</span>
362
+ </div>
363
+
364
+ <div class="method-description">
365
+
366
+
367
+ <div class="method-source-code" id="write_track-source">
368
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 46</span>
369
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write_track</span>(<span class="ruby-identifier">track</span>)
370
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">print</span> <span class="ruby-string">&#39;MTrk&#39;</span>
371
+ <span class="ruby-identifier">track_size_file_pos</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">tell</span>
372
+ <span class="ruby-identifier">write32</span>(<span class="ruby-value">0</span>) <span class="ruby-comment"># Dummy byte count; overwritten later</span>
373
+ <span class="ruby-ivar">@bytes_written</span> = <span class="ruby-value">0</span> <span class="ruby-comment"># Reset after previous write</span>
374
+
375
+ <span class="ruby-identifier">write_instrument</span>(<span class="ruby-identifier">track</span>.<span class="ruby-identifier">instrument</span>)
376
+
377
+ <span class="ruby-identifier">prev_status</span> = <span class="ruby-value">0</span>
378
+ <span class="ruby-identifier">track</span>.<span class="ruby-identifier">events</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">event</span><span class="ruby-operator">|</span>
379
+ <span class="ruby-identifier">write_var_len</span>(<span class="ruby-identifier">event</span>.<span class="ruby-identifier">delta_time</span>) <span class="ruby-keyword">unless</span> <span class="ruby-identifier">event</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Realtime</span>)
380
+
381
+ <span class="ruby-identifier">data</span> = <span class="ruby-identifier">event</span>.<span class="ruby-identifier">data_as_bytes</span>
382
+ <span class="ruby-identifier">status</span> = <span class="ruby-identifier">data</span>[<span class="ruby-value">0</span>] <span class="ruby-comment"># status byte plus channel number, if any</span>
383
+
384
+ <span class="ruby-comment"># running status byte</span>
385
+ <span class="ruby-identifier">status</span> = <span class="ruby-identifier">possibly_munge_due_to_running_status_byte</span>(<span class="ruby-identifier">data</span>, <span class="ruby-identifier">prev_status</span>)
386
+
387
+ <span class="ruby-ivar">@bytes_written</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">write_bytes</span>(<span class="ruby-identifier">data</span>)
388
+
389
+ <span class="ruby-identifier">prev_status</span> = <span class="ruby-identifier">status</span>
390
+ <span class="ruby-keyword">end</span>
391
+
392
+ <span class="ruby-comment"># Write track end event.</span>
393
+ <span class="ruby-identifier">event</span> = <span class="ruby-constant">MetaEvent</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">META_TRACK_END</span>)
394
+ <span class="ruby-identifier">write_var_len</span>(<span class="ruby-value">0</span>)
395
+ <span class="ruby-ivar">@bytes_written</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">write_bytes</span>(<span class="ruby-identifier">event</span>.<span class="ruby-identifier">data_as_bytes</span>)
396
+
397
+ <span class="ruby-comment"># Go back to beginning of track data and write number of bytes,</span>
398
+ <span class="ruby-comment"># then come back here to end of file.</span>
399
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">seek</span>(<span class="ruby-identifier">track_size_file_pos</span>)
400
+ <span class="ruby-identifier">write32</span>(<span class="ruby-ivar">@bytes_written</span>)
401
+ <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">seek</span>(<span class="ruby-value">0</span>, <span class="ruby-operator">::</span><span class="ruby-constant">IO</span><span class="ruby-operator">::</span><span class="ruby-constant">SEEK_END</span>)
402
+ <span class="ruby-keyword">end</span></pre>
403
+ </div>
404
+ </div>
405
+
406
+
407
+ </div>
408
+
409
+ <div id="method-i-write_var_len" class="method-detail ">
410
+ <div class="method-heading">
411
+ <span class="method-name">write_var_len</span><span
412
+ class="method-args">(val)</span>
413
+ <span class="method-click-advice">click to toggle source</span>
414
+ </div>
415
+
416
+ <div class="method-description">
417
+
418
+
419
+ <div class="method-source-code" id="write_var_len-source">
420
+ <pre><span class="ruby-comment"># File lib/midilib/io/seqwriter.rb, line 128</span>
421
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write_var_len</span>(<span class="ruby-identifier">val</span>)
422
+ <span class="ruby-identifier">buffer</span> = <span class="ruby-constant">Utils</span>.<span class="ruby-identifier">as_var_len</span>(<span class="ruby-identifier">val</span>)
423
+ <span class="ruby-ivar">@bytes_written</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">write_bytes</span>(<span class="ruby-identifier">buffer</span>)
424
+ <span class="ruby-keyword">end</span></pre>
425
+ </div>
426
+ </div>
427
+
428
+
429
+ </div>
430
+
431
+ </section>
432
+
433
+ </section>
434
+ </main>
435
+
436
+
437
+ <footer id="validator-badges" role="contentinfo">
438
+ <p><a href="https://validator.w3.org/check/referer">Validate</a>
439
+ <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.4.0.
440
+ <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
441
+ </footer>
442
+
data/html/MIDI/IO.html ADDED
@@ -0,0 +1,91 @@
1
+ <!DOCTYPE html>
2
+
3
+ <html>
4
+ <head>
5
+ <meta charset="UTF-8">
6
+
7
+ <title>module MIDI::IO - 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="module">
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
+
62
+
63
+
64
+ </div>
65
+ </nav>
66
+
67
+ <main role="main" aria-labelledby="module-MIDI::IO">
68
+ <h1 id="module-MIDI::IO" class="module">
69
+ module MIDI::IO
70
+ </h1>
71
+
72
+ <section class="description">
73
+
74
+ </section>
75
+
76
+ <section id="5Buntitled-5D" class="documentation-section">
77
+
78
+
79
+
80
+
81
+
82
+ </section>
83
+ </main>
84
+
85
+
86
+ <footer id="validator-badges" role="contentinfo">
87
+ <p><a href="https://validator.w3.org/check/referer">Validate</a>
88
+ <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.4.0.
89
+ <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
90
+ </footer>
91
+