midilib 1.2.1 → 2.0.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 (100) hide show
  1. data/ChangeLog +3 -1
  2. data/Credits +6 -1
  3. data/README.rdoc +41 -15
  4. data/Rakefile +3 -11
  5. data/TODO.rdoc +4 -7
  6. data/examples/from_scratch.rb +2 -2
  7. data/examples/measures_mbt.rb +1 -1
  8. data/examples/print_program_changes.rb +1 -1
  9. data/examples/strings.rb +1 -1
  10. data/examples/transpose.rb +1 -1
  11. data/html/Array.html +382 -0
  12. data/html/IO.html +277 -0
  13. data/html/MIDI.html +829 -0
  14. data/html/MIDI/ActiveSense.html +317 -0
  15. data/html/MIDI/ChannelEvent.html +347 -0
  16. data/html/MIDI/ChannelPressure.html +379 -0
  17. data/html/MIDI/Clock.html +317 -0
  18. data/html/MIDI/Continue.html +317 -0
  19. data/html/MIDI/Controller.html +398 -0
  20. data/html/MIDI/Event.html +659 -0
  21. data/html/MIDI/IO.html +238 -0
  22. data/html/MIDI/IO/MIDIFile.html +2269 -0
  23. data/html/MIDI/IO/SeqReader.html +1051 -0
  24. data/html/MIDI/IO/SeqWriter.html +706 -0
  25. data/html/MIDI/KeySig.html +487 -0
  26. data/html/MIDI/Marker.html +275 -0
  27. data/html/MIDI/Measure.html +479 -0
  28. data/html/MIDI/Measures.html +416 -0
  29. data/html/MIDI/MetaEvent.html +617 -0
  30. data/html/MIDI/NoteEvent.html +459 -0
  31. data/html/MIDI/NoteOff.html +341 -0
  32. data/html/MIDI/NoteOn.html +341 -0
  33. data/html/MIDI/PitchBend.html +380 -0
  34. data/html/MIDI/PolyPressure.html +390 -0
  35. data/html/MIDI/ProgramChange.html +379 -0
  36. data/html/MIDI/Realtime.html +354 -0
  37. data/html/MIDI/Sequence.html +1063 -0
  38. data/html/MIDI/SongPointer.html +380 -0
  39. data/html/MIDI/SongSelect.html +379 -0
  40. data/html/MIDI/Start.html +317 -0
  41. data/html/MIDI/Stop.html +317 -0
  42. data/html/MIDI/SystemCommon.html +275 -0
  43. data/html/MIDI/SystemExclusive.html +382 -0
  44. data/html/MIDI/SystemReset.html +317 -0
  45. data/html/MIDI/Tempo.html +519 -0
  46. data/html/MIDI/TimeSig.html +524 -0
  47. data/html/MIDI/Track.html +859 -0
  48. data/html/MIDI/TuneRequest.html +354 -0
  49. data/html/MIDI/Utils.html +350 -0
  50. data/html/README_rdoc.html +882 -0
  51. data/html/TODO_rdoc.html +215 -0
  52. data/html/created.rid +14 -0
  53. data/html/images/brick.png +0 -0
  54. data/html/images/brick_link.png +0 -0
  55. data/html/images/bug.png +0 -0
  56. data/html/images/bullet_black.png +0 -0
  57. data/html/images/bullet_toggle_minus.png +0 -0
  58. data/html/images/bullet_toggle_plus.png +0 -0
  59. data/html/images/date.png +0 -0
  60. data/html/images/find.png +0 -0
  61. data/html/images/loadingAnimation.gif +0 -0
  62. data/html/images/macFFBgHack.png +0 -0
  63. data/html/images/package.png +0 -0
  64. data/html/images/page_green.png +0 -0
  65. data/html/images/page_white_text.png +0 -0
  66. data/html/images/page_white_width.png +0 -0
  67. data/html/images/plugin.png +0 -0
  68. data/html/images/ruby.png +0 -0
  69. data/html/images/tag_green.png +0 -0
  70. data/html/images/wrench.png +0 -0
  71. data/html/images/wrench_orange.png +0 -0
  72. data/html/images/zoom.png +0 -0
  73. data/html/index.html +1266 -0
  74. data/html/js/darkfish.js +116 -0
  75. data/html/js/jquery.js +32 -0
  76. data/html/js/quicksearch.js +114 -0
  77. data/html/js/thickbox-compressed.js +10 -0
  78. data/html/lib/midilib/consts_rb.html +55 -0
  79. data/html/lib/midilib/event_rb.html +56 -0
  80. data/html/lib/midilib/info_rb.html +52 -0
  81. data/html/lib/midilib/io/midifile_rb.html +54 -0
  82. data/html/lib/midilib/io/seqreader_rb.html +58 -0
  83. data/html/lib/midilib/io/seqwriter_rb.html +59 -0
  84. data/html/lib/midilib/measure_rb.html +54 -0
  85. data/html/lib/midilib/sequence_rb.html +58 -0
  86. data/html/lib/midilib/track_rb.html +54 -0
  87. data/html/lib/midilib/utils_rb.html +52 -0
  88. data/html/lib/midilib_rb.html +71 -0
  89. data/html/rdoc.css +706 -0
  90. data/install.rb +1 -1
  91. data/lib/midilib/event.rb +11 -77
  92. data/lib/midilib/info.rb +4 -4
  93. data/lib/midilib/io/seqreader.rb +2 -2
  94. data/lib/midilib/io/seqwriter.rb +1 -1
  95. data/lib/midilib/sequence.rb +1 -1
  96. data/lib/midilib/track.rb +54 -8
  97. data/test/test_event.rb +4 -62
  98. data/test/test_sequence.rb +1 -1
  99. data/test/test_track.rb +39 -5
  100. metadata +102 -9
data/html/MIDI/IO.html ADDED
@@ -0,0 +1,238 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
+ <head>
6
+ <meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
7
+
8
+ <title>Module: MIDI::IO</title>
9
+
10
+ <link rel="stylesheet" href="../rdoc.css" type="text/css" media="screen" />
11
+
12
+ <script src="../js/jquery.js" type="text/javascript"
13
+ charset="utf-8"></script>
14
+ <script src="../js/thickbox-compressed.js" type="text/javascript"
15
+ charset="utf-8"></script>
16
+ <script src="../js/quicksearch.js" type="text/javascript"
17
+ charset="utf-8"></script>
18
+ <script src="../js/darkfish.js" type="text/javascript"
19
+ charset="utf-8"></script>
20
+
21
+ </head>
22
+ <body class="module">
23
+
24
+ <div id="metadata">
25
+ <div id="home-metadata">
26
+ <div id="home-section" class="section">
27
+ <h3 class="section-header">
28
+ <a href="../index.html">Home</a>
29
+ <a href="../index.html#classes">Classes</a>
30
+ <a href="../index.html#methods">Methods</a>
31
+ </h3>
32
+ </div>
33
+ </div>
34
+
35
+ <div id="file-metadata">
36
+ <div id="file-list-section" class="section">
37
+ <h3 class="section-header">In Files</h3>
38
+ <div class="section-body">
39
+ <ul>
40
+
41
+ <li><a href="../lib/midilib/io/midifile_rb.html?TB_iframe=true&amp;height=550&amp;width=785"
42
+ class="thickbox" title="lib/midilib/io/midifile.rb">lib/midilib/io/midifile.rb</a></li>
43
+
44
+ <li><a href="../lib/midilib/io/seqreader_rb.html?TB_iframe=true&amp;height=550&amp;width=785"
45
+ class="thickbox" title="lib/midilib/io/seqreader.rb">lib/midilib/io/seqreader.rb</a></li>
46
+
47
+ <li><a href="../lib/midilib/io/seqwriter_rb.html?TB_iframe=true&amp;height=550&amp;width=785"
48
+ class="thickbox" title="lib/midilib/io/seqwriter.rb">lib/midilib/io/seqwriter.rb</a></li>
49
+
50
+ </ul>
51
+ </div>
52
+ </div>
53
+
54
+
55
+ </div>
56
+
57
+ <div id="class-metadata">
58
+
59
+ <!-- Parent Class -->
60
+
61
+
62
+ <!-- Namespace Contents -->
63
+
64
+ <div id="namespace-list-section" class="section">
65
+ <h3 class="section-header">Namespace</h3>
66
+ <ul class="link-list">
67
+
68
+ <li><span class="type">CLASS</span> <a href="IO/MIDIFile.html">MIDI::IO::MIDIFile</a></li>
69
+
70
+ <li><span class="type">CLASS</span> <a href="IO/SeqReader.html">MIDI::IO::SeqReader</a></li>
71
+
72
+ <li><span class="type">CLASS</span> <a href="IO/SeqWriter.html">MIDI::IO::SeqWriter</a></li>
73
+
74
+ </ul>
75
+ </div>
76
+
77
+
78
+ <!-- Method Quickref -->
79
+
80
+
81
+ <!-- Included Modules -->
82
+
83
+ </div>
84
+
85
+ <div id="project-metadata">
86
+
87
+
88
+ <div id="fileindex-section" class="section project-section">
89
+ <h3 class="section-header">Files</h3>
90
+ <ul>
91
+
92
+ <li class="file"><a href="../README_rdoc.html">README.rdoc</a></li>
93
+
94
+ <li class="file"><a href="../TODO_rdoc.html">TODO.rdoc</a></li>
95
+
96
+ </ul>
97
+ </div>
98
+
99
+
100
+ <div id="classindex-section" class="section project-section">
101
+ <h3 class="section-header">Class Index
102
+ <span class="search-toggle"><img src="../images/find.png"
103
+ height="16" width="16" alt="[+]"
104
+ title="show/hide quicksearch" /></span></h3>
105
+ <form action="#" method="get" accept-charset="utf-8" class="initially-hidden">
106
+ <fieldset>
107
+ <legend>Quicksearch</legend>
108
+ <input type="text" name="quicksearch" value=""
109
+ class="quicksearch-field" />
110
+ </fieldset>
111
+ </form>
112
+
113
+ <ul class="link-list">
114
+
115
+ <li><a href="../MIDI.html">MIDI</a></li>
116
+
117
+ <li><a href="../MIDI/ActiveSense.html">MIDI::ActiveSense</a></li>
118
+
119
+ <li><a href="../MIDI/ChannelEvent.html">MIDI::ChannelEvent</a></li>
120
+
121
+ <li><a href="../MIDI/ChannelPressure.html">MIDI::ChannelPressure</a></li>
122
+
123
+ <li><a href="../MIDI/Clock.html">MIDI::Clock</a></li>
124
+
125
+ <li><a href="../MIDI/Continue.html">MIDI::Continue</a></li>
126
+
127
+ <li><a href="../MIDI/Controller.html">MIDI::Controller</a></li>
128
+
129
+ <li><a href="../MIDI/Event.html">MIDI::Event</a></li>
130
+
131
+ <li><a href="../MIDI/IO.html">MIDI::IO</a></li>
132
+
133
+ <li><a href="../MIDI/IO/MIDIFile.html">MIDI::IO::MIDIFile</a></li>
134
+
135
+ <li><a href="../MIDI/IO/SeqReader.html">MIDI::IO::SeqReader</a></li>
136
+
137
+ <li><a href="../MIDI/IO/SeqWriter.html">MIDI::IO::SeqWriter</a></li>
138
+
139
+ <li><a href="../MIDI/KeySig.html">MIDI::KeySig</a></li>
140
+
141
+ <li><a href="../MIDI/Marker.html">MIDI::Marker</a></li>
142
+
143
+ <li><a href="../MIDI/Measure.html">MIDI::Measure</a></li>
144
+
145
+ <li><a href="../MIDI/Measures.html">MIDI::Measures</a></li>
146
+
147
+ <li><a href="../MIDI/MetaEvent.html">MIDI::MetaEvent</a></li>
148
+
149
+ <li><a href="../MIDI/NoteEvent.html">MIDI::NoteEvent</a></li>
150
+
151
+ <li><a href="../MIDI/NoteOff.html">MIDI::NoteOff</a></li>
152
+
153
+ <li><a href="../MIDI/NoteOff.html">MIDI::NoteOff</a></li>
154
+
155
+ <li><a href="../MIDI/NoteOn.html">MIDI::NoteOn</a></li>
156
+
157
+ <li><a href="../MIDI/NoteOn.html">MIDI::NoteOn</a></li>
158
+
159
+ <li><a href="../MIDI/PitchBend.html">MIDI::PitchBend</a></li>
160
+
161
+ <li><a href="../MIDI/PolyPressure.html">MIDI::PolyPressure</a></li>
162
+
163
+ <li><a href="../MIDI/ProgramChange.html">MIDI::ProgramChange</a></li>
164
+
165
+ <li><a href="../MIDI/Realtime.html">MIDI::Realtime</a></li>
166
+
167
+ <li><a href="../MIDI/Sequence.html">MIDI::Sequence</a></li>
168
+
169
+ <li><a href="../MIDI/SongPointer.html">MIDI::SongPointer</a></li>
170
+
171
+ <li><a href="../MIDI/SongSelect.html">MIDI::SongSelect</a></li>
172
+
173
+ <li><a href="../MIDI/Start.html">MIDI::Start</a></li>
174
+
175
+ <li><a href="../MIDI/Stop.html">MIDI::Stop</a></li>
176
+
177
+ <li><a href="../MIDI/SystemCommon.html">MIDI::SystemCommon</a></li>
178
+
179
+ <li><a href="../MIDI/SystemExclusive.html">MIDI::SystemExclusive</a></li>
180
+
181
+ <li><a href="../MIDI/SystemReset.html">MIDI::SystemReset</a></li>
182
+
183
+ <li><a href="../MIDI/Tempo.html">MIDI::Tempo</a></li>
184
+
185
+ <li><a href="../MIDI/TimeSig.html">MIDI::TimeSig</a></li>
186
+
187
+ <li><a href="../MIDI/Track.html">MIDI::Track</a></li>
188
+
189
+ <li><a href="../MIDI/TuneRequest.html">MIDI::TuneRequest</a></li>
190
+
191
+ <li><a href="../MIDI/Utils.html">MIDI::Utils</a></li>
192
+
193
+ <li><a href="../Array.html">Array</a></li>
194
+
195
+ <li><a href="../IO.html">IO</a></li>
196
+
197
+ </ul>
198
+ <div id="no-class-search-results" style="display: none;">No matching classes.</div>
199
+ </div>
200
+
201
+
202
+ </div>
203
+ </div>
204
+
205
+ <div id="documentation">
206
+ <h1 class="module">MIDI::IO</h1>
207
+
208
+ <div id="description">
209
+
210
+ </div>
211
+
212
+ <!-- Constants -->
213
+
214
+
215
+ <!-- Attributes -->
216
+
217
+
218
+ <!-- Methods -->
219
+
220
+
221
+ </div>
222
+
223
+
224
+ <div id="rdoc-debugging-section-dump" class="debugging-section">
225
+
226
+ <p>Disabled; run with --debug to generate this.</p>
227
+
228
+ </div>
229
+
230
+ <div id="validator-badges">
231
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
232
+ <p><small>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish
233
+ Rdoc Generator</a> 1.1.6</small>.</p>
234
+ </div>
235
+
236
+ </body>
237
+ </html>
238
+
data/html/MIDI/IO/MIDIFile.html ADDED
@@ -0,0 +1,2269 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
+ <head>
6
+ <meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
7
+
8
+ <title>Class: MIDI::IO::MIDIFile</title>
9
+
10
+ <link rel="stylesheet" href="../../rdoc.css" type="text/css" media="screen" />
11
+
12
+ <script src="../../js/jquery.js" type="text/javascript"
13
+ charset="utf-8"></script>
14
+ <script src="../../js/thickbox-compressed.js" type="text/javascript"
15
+ charset="utf-8"></script>
16
+ <script src="../../js/quicksearch.js" type="text/javascript"
17
+ charset="utf-8"></script>
18
+ <script src="../../js/darkfish.js" type="text/javascript"
19
+ charset="utf-8"></script>
20
+
21
+ </head>
22
+ <body class="class">
23
+
24
+ <div id="metadata">
25
+ <div id="home-metadata">
26
+ <div id="home-section" class="section">
27
+ <h3 class="section-header">
28
+ <a href="../../index.html">Home</a>
29
+ <a href="../../index.html#classes">Classes</a>
30
+ <a href="../../index.html#methods">Methods</a>
31
+ </h3>
32
+ </div>
33
+ </div>
34
+
35
+ <div id="file-metadata">
36
+ <div id="file-list-section" class="section">
37
+ <h3 class="section-header">In Files</h3>
38
+ <div class="section-body">
39
+ <ul>
40
+
41
+ <li><a href="../../lib/midilib/io/midifile_rb.html?TB_iframe=true&amp;height=550&amp;width=785"
42
+ class="thickbox" title="lib/midilib/io/midifile.rb">lib/midilib/io/midifile.rb</a></li>
43
+
44
+ </ul>
45
+ </div>
46
+ </div>
47
+
48
+
49
+ </div>
50
+
51
+ <div id="class-metadata">
52
+
53
+ <!-- Parent Class -->
54
+
55
+ <div id="parent-class-section" class="section">
56
+ <h3 class="section-header">Parent</h3>
57
+
58
+ <p class="link">Object</p>
59
+
60
+ </div>
61
+
62
+
63
+ <!-- Namespace Contents -->
64
+
65
+
66
+ <!-- Method Quickref -->
67
+
68
+ <div id="method-list-section" class="section">
69
+ <h3 class="section-header">Methods</h3>
70
+ <ul class="link-list">
71
+
72
+ <li><a href="#method-c-new">::new</a></li>
73
+
74
+ <li><a href="#method-i-arbitrary">#arbitrary</a></li>
75
+
76
+ <li><a href="#method-i-bad_byte">#bad_byte</a></li>
77
+
78
+ <li><a href="#method-i-chan_message">#chan_message</a></li>
79
+
80
+ <li><a href="#method-i-chan_pressure">#chan_pressure</a></li>
81
+
82
+ <li><a href="#method-i-controller">#controller</a></li>
83
+
84
+ <li><a href="#method-i-end_track">#end_track</a></li>
85
+
86
+ <li><a href="#method-i-eot">#eot</a></li>
87
+
88
+ <li><a href="#method-i-error">#error</a></li>
89
+
90
+ <li><a href="#method-i-get_bytes">#get_bytes</a></li>
91
+
92
+ <li><a href="#method-i-getc">#getc</a></li>
93
+
94
+ <li><a href="#method-i-handle_arbitrary">#handle_arbitrary</a></li>
95
+
96
+ <li><a href="#method-i-handle_sysex">#handle_sysex</a></li>
97
+
98
+ <li><a href="#method-i-header">#header</a></li>
99
+
100
+ <li><a href="#method-i-key_signature">#key_signature</a></li>
101
+
102
+ <li><a href="#method-i-meta_event">#meta_event</a></li>
103
+
104
+ <li><a href="#method-i-meta_misc">#meta_misc</a></li>
105
+
106
+ <li><a href="#method-i-msg">#msg</a></li>
107
+
108
+ <li><a href="#method-i-msg_add">#msg_add</a></li>
109
+
110
+ <li><a href="#method-i-msg_init">#msg_init</a></li>
111
+
112
+ <li><a href="#method-i-msg_read">#msg_read</a></li>
113
+
114
+ <li><a href="#method-i-note_off">#note_off</a></li>
115
+
116
+ <li><a href="#method-i-note_on">#note_on</a></li>
117
+
118
+ <li><a href="#method-i-pitch_bend">#pitch_bend</a></li>
119
+
120
+ <li><a href="#method-i-pressure">#pressure</a></li>
121
+
122
+ <li><a href="#method-i-program">#program</a></li>
123
+
124
+ <li><a href="#method-i-read16">#read16</a></li>
125
+
126
+ <li><a href="#method-i-read32">#read32</a></li>
127
+
128
+ <li><a href="#method-i-read_from">#read_from</a></li>
129
+
130
+ <li><a href="#method-i-read_header">#read_header</a></li>
131
+
132
+ <li><a href="#method-i-read_mt_header_string">#read_mt_header_string</a></li>
133
+
134
+ <li><a href="#method-i-read_track">#read_track</a></li>
135
+
136
+ <li><a href="#method-i-read_var_len">#read_var_len</a></li>
137
+
138
+ <li><a href="#method-i-sequence_number">#sequence_number</a></li>
139
+
140
+ <li><a href="#method-i-sequencer_specific">#sequencer_specific</a></li>
141
+
142
+ <li><a href="#method-i-smpte">#smpte</a></li>
143
+
144
+ <li><a href="#method-i-start_track">#start_track</a></li>
145
+
146
+ <li><a href="#method-i-sysex">#sysex</a></li>
147
+
148
+ <li><a href="#method-i-tempo">#tempo</a></li>
149
+
150
+ <li><a href="#method-i-text">#text</a></li>
151
+
152
+ <li><a href="#method-i-time_signature">#time_signature</a></li>
153
+
154
+ <li><a href="#method-i-write16">#write16</a></li>
155
+
156
+ <li><a href="#method-i-write32">#write32</a></li>
157
+
158
+ <li><a href="#method-i-write_var_len">#write_var_len</a></li>
159
+
160
+ </ul>
161
+ </div>
162
+
163
+
164
+ <!-- Included Modules -->
165
+
166
+ </div>
167
+
168
+ <div id="project-metadata">
169
+
170
+
171
+ <div id="fileindex-section" class="section project-section">
172
+ <h3 class="section-header">Files</h3>
173
+ <ul>
174
+
175
+ <li class="file"><a href="../../README_rdoc.html">README.rdoc</a></li>
176
+
177
+ <li class="file"><a href="../../TODO_rdoc.html">TODO.rdoc</a></li>
178
+
179
+ </ul>
180
+ </div>
181
+
182
+
183
+ <div id="classindex-section" class="section project-section">
184
+ <h3 class="section-header">Class Index
185
+ <span class="search-toggle"><img src="../../images/find.png"
186
+ height="16" width="16" alt="[+]"
187
+ title="show/hide quicksearch" /></span></h3>
188
+ <form action="#" method="get" accept-charset="utf-8" class="initially-hidden">
189
+ <fieldset>
190
+ <legend>Quicksearch</legend>
191
+ <input type="text" name="quicksearch" value=""
192
+ class="quicksearch-field" />
193
+ </fieldset>
194
+ </form>
195
+
196
+ <ul class="link-list">
197
+
198
+ <li><a href="../../MIDI.html">MIDI</a></li>
199
+
200
+ <li><a href="../../MIDI/ActiveSense.html">MIDI::ActiveSense</a></li>
201
+
202
+ <li><a href="../../MIDI/ChannelEvent.html">MIDI::ChannelEvent</a></li>
203
+
204
+ <li><a href="../../MIDI/ChannelPressure.html">MIDI::ChannelPressure</a></li>
205
+
206
+ <li><a href="../../MIDI/Clock.html">MIDI::Clock</a></li>
207
+
208
+ <li><a href="../../MIDI/Continue.html">MIDI::Continue</a></li>
209
+
210
+ <li><a href="../../MIDI/Controller.html">MIDI::Controller</a></li>
211
+
212
+ <li><a href="../../MIDI/Event.html">MIDI::Event</a></li>
213
+
214
+ <li><a href="../../MIDI/IO.html">MIDI::IO</a></li>
215
+
216
+ <li><a href="../../MIDI/IO/MIDIFile.html">MIDI::IO::MIDIFile</a></li>
217
+
218
+ <li><a href="../../MIDI/IO/SeqReader.html">MIDI::IO::SeqReader</a></li>
219
+
220
+ <li><a href="../../MIDI/IO/SeqWriter.html">MIDI::IO::SeqWriter</a></li>
221
+
222
+ <li><a href="../../MIDI/KeySig.html">MIDI::KeySig</a></li>
223
+
224
+ <li><a href="../../MIDI/Marker.html">MIDI::Marker</a></li>
225
+
226
+ <li><a href="../../MIDI/Measure.html">MIDI::Measure</a></li>
227
+
228
+ <li><a href="../../MIDI/Measures.html">MIDI::Measures</a></li>
229
+
230
+ <li><a href="../../MIDI/MetaEvent.html">MIDI::MetaEvent</a></li>
231
+
232
+ <li><a href="../../MIDI/NoteEvent.html">MIDI::NoteEvent</a></li>
233
+
234
+ <li><a href="../../MIDI/NoteOff.html">MIDI::NoteOff</a></li>
235
+
236
+ <li><a href="../../MIDI/NoteOff.html">MIDI::NoteOff</a></li>
237
+
238
+ <li><a href="../../MIDI/NoteOn.html">MIDI::NoteOn</a></li>
239
+
240
+ <li><a href="../../MIDI/NoteOn.html">MIDI::NoteOn</a></li>
241
+
242
+ <li><a href="../../MIDI/PitchBend.html">MIDI::PitchBend</a></li>
243
+
244
+ <li><a href="../../MIDI/PolyPressure.html">MIDI::PolyPressure</a></li>
245
+
246
+ <li><a href="../../MIDI/ProgramChange.html">MIDI::ProgramChange</a></li>
247
+
248
+ <li><a href="../../MIDI/Realtime.html">MIDI::Realtime</a></li>
249
+
250
+ <li><a href="../../MIDI/Sequence.html">MIDI::Sequence</a></li>
251
+
252
+ <li><a href="../../MIDI/SongPointer.html">MIDI::SongPointer</a></li>
253
+
254
+ <li><a href="../../MIDI/SongSelect.html">MIDI::SongSelect</a></li>
255
+
256
+ <li><a href="../../MIDI/Start.html">MIDI::Start</a></li>
257
+
258
+ <li><a href="../../MIDI/Stop.html">MIDI::Stop</a></li>
259
+
260
+ <li><a href="../../MIDI/SystemCommon.html">MIDI::SystemCommon</a></li>
261
+
262
+ <li><a href="../../MIDI/SystemExclusive.html">MIDI::SystemExclusive</a></li>
263
+
264
+ <li><a href="../../MIDI/SystemReset.html">MIDI::SystemReset</a></li>
265
+
266
+ <li><a href="../../MIDI/Tempo.html">MIDI::Tempo</a></li>
267
+
268
+ <li><a href="../../MIDI/TimeSig.html">MIDI::TimeSig</a></li>
269
+
270
+ <li><a href="../../MIDI/Track.html">MIDI::Track</a></li>
271
+
272
+ <li><a href="../../MIDI/TuneRequest.html">MIDI::TuneRequest</a></li>
273
+
274
+ <li><a href="../../MIDI/Utils.html">MIDI::Utils</a></li>
275
+
276
+ <li><a href="../../Array.html">Array</a></li>
277
+
278
+ <li><a href="../../IO.html">IO</a></li>
279
+
280
+ </ul>
281
+ <div id="no-class-search-results" style="display: none;">No matching classes.</div>
282
+ </div>
283
+
284
+
285
+ </div>
286
+ </div>
287
+
288
+ <div id="documentation">
289
+ <h1 class="class">MIDI::IO::MIDIFile</h1>
290
+
291
+ <div id="description">
292
+ <p>
293
+ A <a href="MIDIFile.html">MIDIFile</a> parses a <a
294
+ href="../../MIDI.html">MIDI</a> file and calls methods when it sees <a
295
+ href="../../MIDI.html">MIDI</a> events. Most of the methods are stubs. To
296
+ do anything interesting with the events, override these methods (those
297
+ between the &#8220;The rest of these are NOPs by default&#8221; and
298
+ &#8220;End of NOPs&#8221; comments).
299
+ </p>
300
+ <p>
301
+ See <a href="SeqReader.html">SeqReader</a> for a subclass that uses these
302
+ methods to create <a href="../Event.html">Event</a> objects.
303
+ </p>
304
+
305
+ </div>
306
+
307
+ <!-- Constants -->
308
+
309
+ <div id="constants-list" class="section">
310
+ <h3 class="section-header">Constants</h3>
311
+ <dl>
312
+
313
+ <dt><a name="MThd_BYTE_ARRAY">MThd_BYTE_ARRAY</a></dt>
314
+
315
+ <dd class="description"></dd>
316
+
317
+
318
+ <dt><a name="MTrk_BYTE_ARRAY">MTrk_BYTE_ARRAY</a></dt>
319
+
320
+ <dd class="description"></dd>
321
+
322
+
323
+ <dt><a name="NUM_DATA_BYTES">NUM_DATA_BYTES</a></dt>
324
+
325
+ <dd class="description"><p>
326
+ This array is indexed by the high half of a status byte. Its value is
327
+ either the number of bytes needed (1 or 2) for a channel message, or 0 if
328
+ it&#8217;s not a channel message.
329
+ </p></dd>
330
+
331
+
332
+ </dl>
333
+ </div>
334
+
335
+
336
+ <!-- Attributes -->
337
+
338
+ <div id="attribute-method-details" class="method-section section">
339
+ <h3 class="section-header">Attributes</h3>
340
+
341
+
342
+ <div id="curr-ticks-attribute-method" class="method-detail">
343
+ <a name="curr_ticks"></a>
344
+
345
+ <a name="curr_ticks="></a>
346
+
347
+ <div class="method-heading attribute-method-heading">
348
+ <span class="method-name">curr_ticks</span><span
349
+ class="attribute-access-type">[RW]</span>
350
+ </div>
351
+
352
+ <div class="method-description">
353
+
354
+
355
+
356
+ </div>
357
+ </div>
358
+
359
+ <div id="ticks-so-far-attribute-method" class="method-detail">
360
+ <a name="ticks_so_far"></a>
361
+
362
+ <a name="ticks_so_far="></a>
363
+
364
+ <div class="method-heading attribute-method-heading">
365
+ <span class="method-name">ticks_so_far</span><span
366
+ class="attribute-access-type">[RW]</span>
367
+ </div>
368
+
369
+ <div class="method-description">
370
+
371
+
372
+
373
+ </div>
374
+ </div>
375
+
376
+ <div id="bytes-to-be-read-attribute-method" class="method-detail">
377
+ <a name="bytes_to_be_read"></a>
378
+
379
+ <a name="bytes_to_be_read="></a>
380
+
381
+ <div class="method-heading attribute-method-heading">
382
+ <span class="method-name">bytes_to_be_read</span><span
383
+ class="attribute-access-type">[RW]</span>
384
+ </div>
385
+
386
+ <div class="method-description">
387
+
388
+
389
+
390
+ </div>
391
+ </div>
392
+
393
+ <div id="no-merge-attribute-method" class="method-detail">
394
+ <a name="no_merge"></a>
395
+
396
+ <a name="no_merge="></a>
397
+
398
+ <div class="method-heading attribute-method-heading">
399
+ <span class="method-name">no_merge</span><span
400
+ class="attribute-access-type">[RW]</span>
401
+ </div>
402
+
403
+ <div class="method-description">
404
+
405
+
406
+
407
+ </div>
408
+ </div>
409
+
410
+ <div id="skip-init-attribute-method" class="method-detail">
411
+ <a name="skip_init"></a>
412
+
413
+ <a name="skip_init="></a>
414
+
415
+ <div class="method-heading attribute-method-heading">
416
+ <span class="method-name">skip_init</span><span
417
+ class="attribute-access-type">[RW]</span>
418
+ </div>
419
+
420
+ <div class="method-description">
421
+
422
+
423
+
424
+ </div>
425
+ </div>
426
+
427
+ <div id="raw-time-stamp-data-attribute-method" class="method-detail">
428
+ <a name="raw_time_stamp_data"></a>
429
+
430
+ <a name="raw_time_stamp_data="></a>
431
+
432
+ <div class="method-heading attribute-method-heading">
433
+ <span class="method-name">raw_time_stamp_data</span><span
434
+ class="attribute-access-type">[RW]</span>
435
+ </div>
436
+
437
+ <div class="method-description">
438
+
439
+ <p>
440
+ Raw data info
441
+ </p>
442
+
443
+ </div>
444
+ </div>
445
+
446
+ <div id="raw-var-num-data-attribute-method" class="method-detail">
447
+ <a name="raw_var_num_data"></a>
448
+
449
+ <a name="raw_var_num_data="></a>
450
+
451
+ <div class="method-heading attribute-method-heading">
452
+ <span class="method-name">raw_var_num_data</span><span
453
+ class="attribute-access-type">[RW]</span>
454
+ </div>
455
+
456
+ <div class="method-description">
457
+
458
+
459
+
460
+ </div>
461
+ </div>
462
+
463
+ <div id="raw-data-attribute-method" class="method-detail">
464
+ <a name="raw_data"></a>
465
+
466
+ <a name="raw_data="></a>
467
+
468
+ <div class="method-heading attribute-method-heading">
469
+ <span class="method-name">raw_data</span><span
470
+ class="attribute-access-type">[RW]</span>
471
+ </div>
472
+
473
+ <div class="method-description">
474
+
475
+
476
+
477
+ </div>
478
+ </div>
479
+
480
+ </div>
481
+
482
+
483
+ <!-- Methods -->
484
+
485
+ <div id="public-class-method-details" class="method-section section">
486
+ <h3 class="section-header">Public Class Methods</h3>
487
+
488
+
489
+ <div id="new-method" class="method-detail ">
490
+ <a name="method-c-new"></a>
491
+
492
+ <div class="method-heading">
493
+
494
+ <span class="method-name">new</span><span
495
+ class="method-args">()</span>
496
+ <span class="method-click-advice">click to toggle source</span>
497
+
498
+ </div>
499
+
500
+ <div class="method-description">
501
+
502
+
503
+
504
+
505
+
506
+ <div class="method-source-code"
507
+ id="new-source">
508
+ <pre>
509
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 49</span>
510
+ 49: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>
511
+ 50: <span class="ruby-ivar">@no_merge</span> = <span class="ruby-keyword kw">false</span>
512
+ 51: <span class="ruby-ivar">@skip_init</span> = <span class="ruby-keyword kw">true</span>
513
+ 52: <span class="ruby-ivar">@io</span> = <span class="ruby-keyword kw">nil</span>
514
+ 53: <span class="ruby-ivar">@bytes_to_be_read</span> = <span class="ruby-value">0</span>
515
+ 54: <span class="ruby-ivar">@msg_buf</span> = <span class="ruby-keyword kw">nil</span>
516
+ 55: <span class="ruby-keyword kw">end</span></pre>
517
+ </div>
518
+
519
+ </div>
520
+
521
+
522
+
523
+
524
+ </div>
525
+
526
+
527
+ </div>
528
+
529
+ <div id="public-instance-method-details" class="method-section section">
530
+ <h3 class="section-header">Public Instance Methods</h3>
531
+
532
+
533
+ <div id="arbitrary-method" class="method-detail ">
534
+ <a name="method-i-arbitrary"></a>
535
+
536
+ <div class="method-heading">
537
+
538
+ <span class="method-name">arbitrary</span><span
539
+ class="method-args">(msg)</span>
540
+ <span class="method-click-advice">click to toggle source</span>
541
+
542
+ </div>
543
+
544
+ <div class="method-description">
545
+
546
+
547
+
548
+
549
+
550
+ <div class="method-source-code"
551
+ id="arbitrary-source">
552
+ <pre>
553
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 152</span>
554
+ 152: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">arbitrary</span>(<span class="ruby-identifier">msg</span>)
555
+ 153: <span class="ruby-keyword kw">end</span></pre>
556
+ </div>
557
+
558
+ </div>
559
+
560
+
561
+
562
+
563
+ </div>
564
+
565
+
566
+ <div id="bad-byte-method" class="method-detail ">
567
+ <a name="method-i-bad_byte"></a>
568
+
569
+ <div class="method-heading">
570
+
571
+ <span class="method-name">bad_byte</span><span
572
+ class="method-args">(c)</span>
573
+ <span class="method-click-advice">click to toggle source</span>
574
+
575
+ </div>
576
+
577
+ <div class="method-description">
578
+
579
+ <p>
580
+ Handle an unexpected byte.
581
+ </p>
582
+
583
+
584
+
585
+ <div class="method-source-code"
586
+ id="bad-byte-source">
587
+ <pre>
588
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 294</span>
589
+ 294: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">bad_byte</span>(<span class="ruby-identifier">c</span>)
590
+ 295: <span class="ruby-identifier">error</span>(<span class="ruby-identifier">sprintf</span>(<span class="ruby-value str">&quot;unexpected byte: 0x%02x&quot;</span>, <span class="ruby-identifier">c</span>))
591
+ 296: <span class="ruby-keyword kw">end</span></pre>
592
+ </div>
593
+
594
+ </div>
595
+
596
+
597
+
598
+
599
+ </div>
600
+
601
+
602
+ <div id="chan-message-method" class="method-detail ">
603
+ <a name="method-i-chan_message"></a>
604
+
605
+ <div class="method-heading">
606
+
607
+ <span class="method-name">chan_message</span><span
608
+ class="method-args">(running, status, c1, c2)</span>
609
+ <span class="method-click-advice">click to toggle source</span>
610
+
611
+ </div>
612
+
613
+ <div class="method-description">
614
+
615
+ <p>
616
+ Handle a channel message (note on, note off, etc.)
617
+ </p>
618
+
619
+
620
+
621
+ <div class="method-source-code"
622
+ id="chan-message-source">
623
+ <pre>
624
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 335</span>
625
+ 335: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chan_message</span>(<span class="ruby-identifier">running</span>, <span class="ruby-identifier">status</span>, <span class="ruby-identifier">c1</span>, <span class="ruby-identifier">c2</span>)
626
+ 336: <span class="ruby-ivar">@raw_data</span> = []
627
+ 337: <span class="ruby-ivar">@raw_data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">status</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">running</span>
628
+ 338: <span class="ruby-ivar">@raw_data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">c1</span>
629
+ 339: <span class="ruby-ivar">@raw_data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">c2</span>
630
+ 340:
631
+ 341: <span class="ruby-identifier">chan</span> = <span class="ruby-identifier">status</span> &amp; <span class="ruby-value">0x0f</span>
632
+ 342:
633
+ 343: <span class="ruby-keyword kw">case</span> (<span class="ruby-identifier">status</span> &amp; <span class="ruby-value">0xf0</span>)
634
+ 344: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">NOTE_OFF</span>
635
+ 345: <span class="ruby-identifier">note_off</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">c1</span>, <span class="ruby-identifier">c2</span>)
636
+ 346: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">NOTE_ON</span>
637
+ 347: <span class="ruby-identifier">note_on</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">c1</span>, <span class="ruby-identifier">c2</span>)
638
+ 348: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">POLY_PRESSURE</span>
639
+ 349: <span class="ruby-identifier">pressure</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">c1</span>, <span class="ruby-identifier">c2</span>)
640
+ 350: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">CONTROLLER</span>
641
+ 351: <span class="ruby-identifier">controller</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">c1</span>, <span class="ruby-identifier">c2</span>)
642
+ 352: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">PITCH_BEND</span>
643
+ 353: <span class="ruby-identifier">pitch_bend</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">c1</span>, <span class="ruby-identifier">c2</span>)
644
+ 354: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">PROGRAM_CHANGE</span>
645
+ 355: <span class="ruby-identifier">program</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">c1</span>)
646
+ 356: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">CHANNEL_PRESSURE</span>
647
+ 357: <span class="ruby-identifier">chan_pressure</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">c1</span>)
648
+ 358: <span class="ruby-keyword kw">else</span>
649
+ 359: <span class="ruby-identifier">error</span>(<span class="ruby-node">&quot;illegal chan message 0x#{'%02x' % (status &amp; 0xf0)}\n&quot;</span>)
650
+ 360: <span class="ruby-keyword kw">end</span>
651
+ 361: <span class="ruby-keyword kw">end</span></pre>
652
+ </div>
653
+
654
+ </div>
655
+
656
+
657
+
658
+
659
+ </div>
660
+
661
+
662
+ <div id="chan-pressure-method" class="method-detail ">
663
+ <a name="method-i-chan_pressure"></a>
664
+
665
+ <div class="method-heading">
666
+
667
+ <span class="method-name">chan_pressure</span><span
668
+ class="method-args">(chan, press)</span>
669
+ <span class="method-click-advice">click to toggle source</span>
670
+
671
+ </div>
672
+
673
+ <div class="method-description">
674
+
675
+
676
+
677
+
678
+
679
+ <div class="method-source-code"
680
+ id="chan-pressure-source">
681
+ <pre>
682
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 119</span>
683
+ 119: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">chan_pressure</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">press</span>)
684
+ 120: <span class="ruby-keyword kw">end</span></pre>
685
+ </div>
686
+
687
+ </div>
688
+
689
+
690
+
691
+
692
+ </div>
693
+
694
+
695
+ <div id="controller-method" class="method-detail ">
696
+ <a name="method-i-controller"></a>
697
+
698
+ <div class="method-heading">
699
+
700
+ <span class="method-name">controller</span><span
701
+ class="method-args">(chan, control, value)</span>
702
+ <span class="method-click-advice">click to toggle source</span>
703
+
704
+ </div>
705
+
706
+ <div class="method-description">
707
+
708
+
709
+
710
+
711
+
712
+ <div class="method-source-code"
713
+ id="controller-source">
714
+ <pre>
715
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 110</span>
716
+ 110: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">controller</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">control</span>, <span class="ruby-identifier">value</span>)
717
+ 111: <span class="ruby-keyword kw">end</span></pre>
718
+ </div>
719
+
720
+ </div>
721
+
722
+
723
+
724
+
725
+ </div>
726
+
727
+
728
+ <div id="end-track-method" class="method-detail ">
729
+ <a name="method-i-end_track"></a>
730
+
731
+ <div class="method-heading">
732
+
733
+ <span class="method-name">end_track</span><span
734
+ class="method-args">()</span>
735
+ <span class="method-click-advice">click to toggle source</span>
736
+
737
+ </div>
738
+
739
+ <div class="method-description">
740
+
741
+
742
+
743
+
744
+
745
+ <div class="method-source-code"
746
+ id="end-track-source">
747
+ <pre>
748
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 98</span>
749
+ 98: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">end_track</span>()
750
+ 99: <span class="ruby-keyword kw">end</span></pre>
751
+ </div>
752
+
753
+ </div>
754
+
755
+
756
+
757
+
758
+ </div>
759
+
760
+
761
+ <div id="eot-method" class="method-detail ">
762
+ <a name="method-i-eot"></a>
763
+
764
+ <div class="method-heading">
765
+
766
+ <span class="method-name">eot</span><span
767
+ class="method-args">()</span>
768
+ <span class="method-click-advice">click to toggle source</span>
769
+
770
+ </div>
771
+
772
+ <div class="method-description">
773
+
774
+
775
+
776
+
777
+
778
+ <div class="method-source-code"
779
+ id="eot-source">
780
+ <pre>
781
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 137</span>
782
+ 137: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">eot</span>()
783
+ 138: <span class="ruby-keyword kw">end</span></pre>
784
+ </div>
785
+
786
+ </div>
787
+
788
+
789
+
790
+
791
+ </div>
792
+
793
+
794
+ <div id="error-method" class="method-detail ">
795
+ <a name="method-i-error"></a>
796
+
797
+ <div class="method-heading">
798
+
799
+ <span class="method-name">error</span><span
800
+ class="method-args">(str)</span>
801
+ <span class="method-click-advice">click to toggle source</span>
802
+
803
+ </div>
804
+
805
+ <div class="method-description">
806
+
807
+ <p>
808
+ The default error handler.
809
+ </p>
810
+
811
+
812
+
813
+ <div class="method-source-code"
814
+ id="error-source">
815
+ <pre>
816
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 84</span>
817
+ 84: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">error</span>(<span class="ruby-identifier">str</span>)
818
+ 85: <span class="ruby-identifier">loc</span> = <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">tell</span>() <span class="ruby-operator">-</span> <span class="ruby-value">1</span>
819
+ 86: <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;#{self.class.name} error at byte #{loc} (0x#{'%02x' % loc}): #{str}&quot;</span>
820
+ 87: <span class="ruby-keyword kw">end</span></pre>
821
+ </div>
822
+
823
+ </div>
824
+
825
+
826
+
827
+
828
+ </div>
829
+
830
+
831
+ <div id="get-bytes-method" class="method-detail ">
832
+ <a name="method-i-get_bytes"></a>
833
+
834
+ <div class="method-heading">
835
+
836
+ <span class="method-name">get_bytes</span><span
837
+ class="method-args">(n)</span>
838
+ <span class="method-click-advice">click to toggle source</span>
839
+
840
+ </div>
841
+
842
+ <div class="method-description">
843
+
844
+ <p>
845
+ Return the next <tt>n</tt> bytes from @io as an array.
846
+ </p>
847
+
848
+
849
+
850
+ <div class="method-source-code"
851
+ id="get-bytes-source">
852
+ <pre>
853
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 77</span>
854
+ 77: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_bytes</span>(<span class="ruby-identifier">n</span>)
855
+ 78: <span class="ruby-identifier">buf</span> = []
856
+ 79: <span class="ruby-identifier">n</span>.<span class="ruby-identifier">times</span> { <span class="ruby-identifier">buf</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">getc</span>() }
857
+ 80: <span class="ruby-identifier">buf</span>
858
+ 81: <span class="ruby-keyword kw">end</span></pre>
859
+ </div>
860
+
861
+ </div>
862
+
863
+
864
+
865
+
866
+ </div>
867
+
868
+
869
+ <div id="getc-method" class="method-detail ">
870
+ <a name="method-i-getc"></a>
871
+
872
+ <div class="method-heading">
873
+
874
+ <span class="method-name">getc</span><span
875
+ class="method-args">()</span>
876
+ <span class="method-click-advice">click to toggle source</span>
877
+
878
+ </div>
879
+
880
+ <div class="method-description">
881
+
882
+ <p>
883
+ This default getc implementation tries to read a single byte from io and
884
+ returns it as an integer.
885
+ </p>
886
+
887
+
888
+
889
+ <div class="method-source-code"
890
+ id="getc-source">
891
+ <pre>
892
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 71</span>
893
+ 71: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">getc</span>
894
+ 72: <span class="ruby-ivar">@bytes_to_be_read</span> <span class="ruby-operator">-=</span> <span class="ruby-value">1</span>
895
+ 73: <span class="ruby-ivar">@io</span>.<span class="ruby-identifier">readbyte</span>()
896
+ 74: <span class="ruby-keyword kw">end</span></pre>
897
+ </div>
898
+
899
+ </div>
900
+
901
+
902
+
903
+
904
+ </div>
905
+
906
+
907
+ <div id="handle-arbitrary-method" class="method-detail ">
908
+ <a name="method-i-handle_arbitrary"></a>
909
+
910
+ <div class="method-heading">
911
+
912
+ <span class="method-name">handle_arbitrary</span><span
913
+ class="method-args">(msg)</span>
914
+ <span class="method-click-advice">click to toggle source</span>
915
+
916
+ </div>
917
+
918
+ <div class="method-description">
919
+
920
+ <p>
921
+ Copy message into raw data array, then call arbitrary().
922
+ </p>
923
+
924
+
925
+
926
+ <div class="method-source-code"
927
+ id="handle-arbitrary-source">
928
+ <pre>
929
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 370</span>
930
+ 370: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">handle_arbitrary</span>(<span class="ruby-identifier">msg</span>)
931
+ 371: <span class="ruby-ivar">@raw_data</span> = <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">dup</span>()
932
+ 372: <span class="ruby-identifier">arbitrary</span>(<span class="ruby-identifier">msg</span>)
933
+ 373: <span class="ruby-keyword kw">end</span></pre>
934
+ </div>
935
+
936
+ </div>
937
+
938
+
939
+
940
+
941
+ </div>
942
+
943
+
944
+ <div id="handle-sysex-method" class="method-detail ">
945
+ <a name="method-i-handle_sysex"></a>
946
+
947
+ <div class="method-heading">
948
+
949
+ <span class="method-name">handle_sysex</span><span
950
+ class="method-args">(msg)</span>
951
+ <span class="method-click-advice">click to toggle source</span>
952
+
953
+ </div>
954
+
955
+ <div class="method-description">
956
+
957
+ <p>
958
+ Copy message into raw data array, then call sysex().
959
+ </p>
960
+
961
+
962
+
963
+ <div class="method-source-code"
964
+ id="handle-sysex-source">
965
+ <pre>
966
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 364</span>
967
+ 364: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">handle_sysex</span>(<span class="ruby-identifier">msg</span>)
968
+ 365: <span class="ruby-ivar">@raw_data</span> = <span class="ruby-identifier">msg</span>.<span class="ruby-identifier">dup</span>()
969
+ 366: <span class="ruby-identifier">sysex</span>(<span class="ruby-identifier">msg</span>)
970
+ 367: <span class="ruby-keyword kw">end</span></pre>
971
+ </div>
972
+
973
+ </div>
974
+
975
+
976
+
977
+
978
+ </div>
979
+
980
+
981
+ <div id="header-method" class="method-detail ">
982
+ <a name="method-i-header"></a>
983
+
984
+ <div class="method-heading">
985
+
986
+ <span class="method-name">header</span><span
987
+ class="method-args">(format, ntrks, division)</span>
988
+ <span class="method-click-advice">click to toggle source</span>
989
+
990
+ </div>
991
+
992
+ <div class="method-description">
993
+
994
+ <p>
995
+ <a href="../../MIDI.html">MIDI</a> header.
996
+ </p>
997
+
998
+
999
+
1000
+ <div class="method-source-code"
1001
+ id="header-source">
1002
+ <pre>
1003
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 92</span>
1004
+ 92: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">header</span>(<span class="ruby-identifier">format</span>, <span class="ruby-identifier">ntrks</span>, <span class="ruby-identifier">division</span>)
1005
+ 93: <span class="ruby-keyword kw">end</span></pre>
1006
+ </div>
1007
+
1008
+ </div>
1009
+
1010
+
1011
+
1012
+
1013
+ </div>
1014
+
1015
+
1016
+ <div id="key-signature-method" class="method-detail ">
1017
+ <a name="method-i-key_signature"></a>
1018
+
1019
+ <div class="method-heading">
1020
+
1021
+ <span class="method-name">key_signature</span><span
1022
+ class="method-args">(sharpflat, is_minor)</span>
1023
+ <span class="method-click-advice">click to toggle source</span>
1024
+
1025
+ </div>
1026
+
1027
+ <div class="method-description">
1028
+
1029
+
1030
+
1031
+
1032
+
1033
+ <div class="method-source-code"
1034
+ id="key-signature-source">
1035
+ <pre>
1036
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 149</span>
1037
+ 149: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">key_signature</span>(<span class="ruby-identifier">sharpflat</span>, <span class="ruby-identifier">is_minor</span>)
1038
+ 150: <span class="ruby-keyword kw">end</span></pre>
1039
+ </div>
1040
+
1041
+ </div>
1042
+
1043
+
1044
+
1045
+
1046
+ </div>
1047
+
1048
+
1049
+ <div id="meta-event-method" class="method-detail ">
1050
+ <a name="method-i-meta_event"></a>
1051
+
1052
+ <div class="method-heading">
1053
+
1054
+ <span class="method-name">meta_event</span><span
1055
+ class="method-args">(type)</span>
1056
+ <span class="method-click-advice">click to toggle source</span>
1057
+
1058
+ </div>
1059
+
1060
+ <div class="method-description">
1061
+
1062
+ <p>
1063
+ Handle a meta event.
1064
+ </p>
1065
+
1066
+
1067
+
1068
+ <div class="method-source-code"
1069
+ id="meta-event-source">
1070
+ <pre>
1071
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 299</span>
1072
+ 299: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">meta_event</span>(<span class="ruby-identifier">type</span>)
1073
+ 300: <span class="ruby-identifier">m</span> = <span class="ruby-identifier">msg</span>() <span class="ruby-comment cmt"># Copy of internal message buffer</span>
1074
+ 301:
1075
+ 302: <span class="ruby-comment cmt"># Create raw data array</span>
1076
+ 303: <span class="ruby-ivar">@raw_data</span> = []
1077
+ 304: <span class="ruby-ivar">@raw_data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-constant">META_EVENT</span>
1078
+ 305: <span class="ruby-ivar">@raw_data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">type</span>
1079
+ 306: <span class="ruby-ivar">@raw_data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-ivar">@raw_var_num_data</span>
1080
+ 307: <span class="ruby-ivar">@raw_data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">m</span>
1081
+ 308: <span class="ruby-ivar">@raw_data</span>.<span class="ruby-identifier">flatten!</span>
1082
+ 309:
1083
+ 310: <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">type</span>
1084
+ 311: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">META_SEQ_NUM</span>
1085
+ 312: <span class="ruby-identifier">sequence_number</span>((<span class="ruby-identifier">m</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">8</span>) <span class="ruby-operator">+</span> <span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>])
1086
+ 313: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">META_TEXT</span>, <span class="ruby-constant">META_COPYRIGHT</span>, <span class="ruby-constant">META_SEQ_NAME</span>, <span class="ruby-constant">META_INSTRUMENT</span>,
1087
+ 314: <span class="ruby-constant">META_LYRIC</span>, <span class="ruby-constant">META_MARKER</span>, <span class="ruby-constant">META_CUE</span>, <span class="ruby-value">0x08</span>, <span class="ruby-value">0x09</span>, <span class="ruby-value">0x0a</span>,
1088
+ 315: <span class="ruby-value">0x0b</span>, <span class="ruby-value">0x0c</span>, <span class="ruby-value">0x0d</span>, <span class="ruby-value">0x0e</span>, <span class="ruby-value">0x0f</span>
1089
+ 316: <span class="ruby-identifier">text</span>(<span class="ruby-identifier">type</span>, <span class="ruby-identifier">m</span>)
1090
+ 317: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">META_TRACK_END</span>
1091
+ 318: <span class="ruby-identifier">eot</span>()
1092
+ 319: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">META_SET_TEMPO</span>
1093
+ 320: <span class="ruby-identifier">tempo</span>((<span class="ruby-identifier">m</span>[<span class="ruby-value">0</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">16</span>) <span class="ruby-operator">+</span> (<span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>] <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">8</span>) <span class="ruby-operator">+</span> <span class="ruby-identifier">m</span>[<span class="ruby-value">2</span>])
1094
+ 321: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">META_SMPTE</span>
1095
+ 322: <span class="ruby-identifier">smpte</span>(<span class="ruby-identifier">m</span>[<span class="ruby-value">0</span>], <span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>], <span class="ruby-identifier">m</span>[<span class="ruby-value">2</span>], <span class="ruby-identifier">m</span>[<span class="ruby-value">3</span>], <span class="ruby-identifier">m</span>[<span class="ruby-value">4</span>])
1096
+ 323: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">META_TIME_SIG</span>
1097
+ 324: <span class="ruby-identifier">time_signature</span>(<span class="ruby-identifier">m</span>[<span class="ruby-value">0</span>], <span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>], <span class="ruby-identifier">m</span>[<span class="ruby-value">2</span>], <span class="ruby-identifier">m</span>[<span class="ruby-value">3</span>])
1098
+ 325: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">META_KEY_SIG</span>
1099
+ 326: <span class="ruby-identifier">key_signature</span>(<span class="ruby-identifier">m</span>[<span class="ruby-value">0</span>], <span class="ruby-identifier">m</span>[<span class="ruby-value">1</span>] <span class="ruby-operator">==</span> <span class="ruby-value">0</span> <span class="ruby-operator">?</span> <span class="ruby-keyword kw">false</span> <span class="ruby-operator">:</span> <span class="ruby-keyword kw">true</span>)
1100
+ 327: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">META_SEQ_SPECIF</span>
1101
+ 328: <span class="ruby-identifier">sequencer_specific</span>(<span class="ruby-identifier">type</span>, <span class="ruby-identifier">m</span>)
1102
+ 329: <span class="ruby-keyword kw">else</span>
1103
+ 330: <span class="ruby-identifier">meta_misc</span>(<span class="ruby-identifier">type</span>, <span class="ruby-identifier">m</span>)
1104
+ 331: <span class="ruby-keyword kw">end</span>
1105
+ 332: <span class="ruby-keyword kw">end</span></pre>
1106
+ </div>
1107
+
1108
+ </div>
1109
+
1110
+
1111
+
1112
+
1113
+ </div>
1114
+
1115
+
1116
+ <div id="meta-misc-method" class="method-detail ">
1117
+ <a name="method-i-meta_misc"></a>
1118
+
1119
+ <div class="method-heading">
1120
+
1121
+ <span class="method-name">meta_misc</span><span
1122
+ class="method-args">(type, msg)</span>
1123
+ <span class="method-click-advice">click to toggle source</span>
1124
+
1125
+ </div>
1126
+
1127
+ <div class="method-description">
1128
+
1129
+
1130
+
1131
+
1132
+
1133
+ <div class="method-source-code"
1134
+ id="meta-misc-source">
1135
+ <pre>
1136
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 125</span>
1137
+ 125: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">meta_misc</span>(<span class="ruby-identifier">type</span>, <span class="ruby-identifier">msg</span>)
1138
+ 126: <span class="ruby-keyword kw">end</span></pre>
1139
+ </div>
1140
+
1141
+ </div>
1142
+
1143
+
1144
+
1145
+
1146
+ </div>
1147
+
1148
+
1149
+ <div id="msg-method" class="method-detail ">
1150
+ <a name="method-i-msg"></a>
1151
+
1152
+ <div class="method-heading">
1153
+
1154
+ <span class="method-name">msg</span><span
1155
+ class="method-args">()</span>
1156
+ <span class="method-click-advice">click to toggle source</span>
1157
+
1158
+ </div>
1159
+
1160
+ <div class="method-description">
1161
+
1162
+ <p>
1163
+ Return a copy of the internal message buffer.
1164
+ </p>
1165
+
1166
+
1167
+
1168
+ <div class="method-source-code"
1169
+ id="msg-source">
1170
+ <pre>
1171
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 460</span>
1172
+ 460: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">msg</span>
1173
+ 461: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@msg_buf</span>.<span class="ruby-identifier">dup</span>()
1174
+ 462: <span class="ruby-keyword kw">end</span></pre>
1175
+ </div>
1176
+
1177
+ </div>
1178
+
1179
+
1180
+
1181
+
1182
+ </div>
1183
+
1184
+
1185
+ <div id="msg-add-method" class="method-detail ">
1186
+ <a name="method-i-msg_add"></a>
1187
+
1188
+ <div class="method-heading">
1189
+
1190
+ <span class="method-name">msg_add</span><span
1191
+ class="method-args">(c)</span>
1192
+ <span class="method-click-advice">click to toggle source</span>
1193
+
1194
+ </div>
1195
+
1196
+ <div class="method-description">
1197
+
1198
+ <p>
1199
+ Add a byte to the current message buffer.
1200
+ </p>
1201
+
1202
+
1203
+
1204
+ <div class="method-source-code"
1205
+ id="msg-add-source">
1206
+ <pre>
1207
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 442</span>
1208
+ 442: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">msg_add</span>(<span class="ruby-identifier">c</span>)
1209
+ 443: <span class="ruby-ivar">@msg_buf</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">c</span>
1210
+ 444: <span class="ruby-keyword kw">end</span></pre>
1211
+ </div>
1212
+
1213
+ </div>
1214
+
1215
+
1216
+
1217
+
1218
+ </div>
1219
+
1220
+
1221
+ <div id="msg-init-method" class="method-detail ">
1222
+ <a name="method-i-msg_init"></a>
1223
+
1224
+ <div class="method-heading">
1225
+
1226
+ <span class="method-name">msg_init</span><span
1227
+ class="method-args">()</span>
1228
+ <span class="method-click-advice">click to toggle source</span>
1229
+
1230
+ </div>
1231
+
1232
+ <div class="method-description">
1233
+
1234
+ <p>
1235
+ Initialize the internal message buffer.
1236
+ </p>
1237
+
1238
+
1239
+
1240
+ <div class="method-source-code"
1241
+ id="msg-init-source">
1242
+ <pre>
1243
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 455</span>
1244
+ 455: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">msg_init</span>
1245
+ 456: <span class="ruby-ivar">@msg_buf</span> = []
1246
+ 457: <span class="ruby-keyword kw">end</span></pre>
1247
+ </div>
1248
+
1249
+ </div>
1250
+
1251
+
1252
+
1253
+
1254
+ </div>
1255
+
1256
+
1257
+ <div id="msg-read-method" class="method-detail ">
1258
+ <a name="method-i-msg_read"></a>
1259
+
1260
+ <div class="method-heading">
1261
+
1262
+ <span class="method-name">msg_read</span><span
1263
+ class="method-args">(n_bytes)</span>
1264
+ <span class="method-click-advice">click to toggle source</span>
1265
+
1266
+ </div>
1267
+
1268
+ <div class="method-description">
1269
+
1270
+ <p>
1271
+ Read and add a number of bytes to the message buffer. Return the last byte
1272
+ (so we can see if it&#8217;s an EOX or not).
1273
+ </p>
1274
+
1275
+
1276
+
1277
+ <div class="method-source-code"
1278
+ id="msg-read-source">
1279
+ <pre>
1280
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 448</span>
1281
+ 448: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">msg_read</span>(<span class="ruby-identifier">n_bytes</span>)
1282
+ 449: <span class="ruby-ivar">@msg_buf</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">get_bytes</span>(<span class="ruby-identifier">n_bytes</span>)
1283
+ 450: <span class="ruby-ivar">@msg_buf</span>.<span class="ruby-identifier">flatten!</span>
1284
+ 451: <span class="ruby-keyword kw">return</span> <span class="ruby-ivar">@msg_buf</span>[<span class="ruby-value">1</span>]
1285
+ 452: <span class="ruby-keyword kw">end</span></pre>
1286
+ </div>
1287
+
1288
+ </div>
1289
+
1290
+
1291
+
1292
+
1293
+ </div>
1294
+
1295
+
1296
+ <div id="note-off-method" class="method-detail ">
1297
+ <a name="method-i-note_off"></a>
1298
+
1299
+ <div class="method-heading">
1300
+
1301
+ <span class="method-name">note_off</span><span
1302
+ class="method-args">(chan, note, vel)</span>
1303
+ <span class="method-click-advice">click to toggle source</span>
1304
+
1305
+ </div>
1306
+
1307
+ <div class="method-description">
1308
+
1309
+
1310
+
1311
+
1312
+
1313
+ <div class="method-source-code"
1314
+ id="note-off-source">
1315
+ <pre>
1316
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 104</span>
1317
+ 104: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">note_off</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">note</span>, <span class="ruby-identifier">vel</span>)
1318
+ 105: <span class="ruby-keyword kw">end</span></pre>
1319
+ </div>
1320
+
1321
+ </div>
1322
+
1323
+
1324
+
1325
+
1326
+ </div>
1327
+
1328
+
1329
+ <div id="note-on-method" class="method-detail ">
1330
+ <a name="method-i-note_on"></a>
1331
+
1332
+ <div class="method-heading">
1333
+
1334
+ <span class="method-name">note_on</span><span
1335
+ class="method-args">(chan, note, vel)</span>
1336
+ <span class="method-click-advice">click to toggle source</span>
1337
+
1338
+ </div>
1339
+
1340
+ <div class="method-description">
1341
+
1342
+
1343
+
1344
+
1345
+
1346
+ <div class="method-source-code"
1347
+ id="note-on-source">
1348
+ <pre>
1349
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 101</span>
1350
+ 101: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">note_on</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">note</span>, <span class="ruby-identifier">vel</span>)
1351
+ 102: <span class="ruby-keyword kw">end</span></pre>
1352
+ </div>
1353
+
1354
+ </div>
1355
+
1356
+
1357
+
1358
+
1359
+ </div>
1360
+
1361
+
1362
+ <div id="pitch-bend-method" class="method-detail ">
1363
+ <a name="method-i-pitch_bend"></a>
1364
+
1365
+ <div class="method-heading">
1366
+
1367
+ <span class="method-name">pitch_bend</span><span
1368
+ class="method-args">(chan, msb, lsb)</span>
1369
+ <span class="method-click-advice">click to toggle source</span>
1370
+
1371
+ </div>
1372
+
1373
+ <div class="method-description">
1374
+
1375
+
1376
+
1377
+
1378
+
1379
+ <div class="method-source-code"
1380
+ id="pitch-bend-source">
1381
+ <pre>
1382
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 113</span>
1383
+ 113: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pitch_bend</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">msb</span>, <span class="ruby-identifier">lsb</span>)
1384
+ 114: <span class="ruby-keyword kw">end</span></pre>
1385
+ </div>
1386
+
1387
+ </div>
1388
+
1389
+
1390
+
1391
+
1392
+ </div>
1393
+
1394
+
1395
+ <div id="pressure-method" class="method-detail ">
1396
+ <a name="method-i-pressure"></a>
1397
+
1398
+ <div class="method-heading">
1399
+
1400
+ <span class="method-name">pressure</span><span
1401
+ class="method-args">(chan, note, press)</span>
1402
+ <span class="method-click-advice">click to toggle source</span>
1403
+
1404
+ </div>
1405
+
1406
+ <div class="method-description">
1407
+
1408
+
1409
+
1410
+
1411
+
1412
+ <div class="method-source-code"
1413
+ id="pressure-source">
1414
+ <pre>
1415
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 107</span>
1416
+ 107: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">pressure</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">note</span>, <span class="ruby-identifier">press</span>)
1417
+ 108: <span class="ruby-keyword kw">end</span></pre>
1418
+ </div>
1419
+
1420
+ </div>
1421
+
1422
+
1423
+
1424
+
1425
+ </div>
1426
+
1427
+
1428
+ <div id="program-method" class="method-detail ">
1429
+ <a name="method-i-program"></a>
1430
+
1431
+ <div class="method-heading">
1432
+
1433
+ <span class="method-name">program</span><span
1434
+ class="method-args">(chan, program)</span>
1435
+ <span class="method-click-advice">click to toggle source</span>
1436
+
1437
+ </div>
1438
+
1439
+ <div class="method-description">
1440
+
1441
+
1442
+
1443
+
1444
+
1445
+ <div class="method-source-code"
1446
+ id="program-source">
1447
+ <pre>
1448
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 116</span>
1449
+ 116: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">program</span>(<span class="ruby-identifier">chan</span>, <span class="ruby-identifier">program</span>)
1450
+ 117: <span class="ruby-keyword kw">end</span></pre>
1451
+ </div>
1452
+
1453
+ </div>
1454
+
1455
+
1456
+
1457
+
1458
+ </div>
1459
+
1460
+
1461
+ <div id="read--method" class="method-detail ">
1462
+ <a name="method-i-read16"></a>
1463
+
1464
+ <div class="method-heading">
1465
+
1466
+ <span class="method-name">read16</span><span
1467
+ class="method-args">()</span>
1468
+ <span class="method-click-advice">click to toggle source</span>
1469
+
1470
+ </div>
1471
+
1472
+ <div class="method-description">
1473
+
1474
+ <p>
1475
+ Read and return a sixteen bit value.
1476
+ </p>
1477
+
1478
+
1479
+
1480
+ <div class="method-source-code"
1481
+ id="read--source">
1482
+ <pre>
1483
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 376</span>
1484
+ 376: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read16</span>
1485
+ 377: <span class="ruby-identifier">val</span> = (<span class="ruby-identifier">getc</span>() <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">8</span>) <span class="ruby-operator">+</span> <span class="ruby-identifier">getc</span>()
1486
+ 378: <span class="ruby-identifier">val</span> = <span class="ruby-operator">-</span>(<span class="ruby-identifier">val</span> &amp; <span class="ruby-value">0x7fff</span>) <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">val</span> &amp; <span class="ruby-value">0x8000</span>).<span class="ruby-identifier">nonzero?</span>
1487
+ 379: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">val</span>
1488
+ 380: <span class="ruby-keyword kw">end</span></pre>
1489
+ </div>
1490
+
1491
+ </div>
1492
+
1493
+
1494
+
1495
+
1496
+ </div>
1497
+
1498
+
1499
+ <div id="read--method" class="method-detail ">
1500
+ <a name="method-i-read32"></a>
1501
+
1502
+ <div class="method-heading">
1503
+
1504
+ <span class="method-name">read32</span><span
1505
+ class="method-args">()</span>
1506
+ <span class="method-click-advice">click to toggle source</span>
1507
+
1508
+ </div>
1509
+
1510
+ <div class="method-description">
1511
+
1512
+ <p>
1513
+ Read and return a 32-bit value.
1514
+ </p>
1515
+
1516
+
1517
+
1518
+ <div class="method-source-code"
1519
+ id="read--source">
1520
+ <pre>
1521
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 383</span>
1522
+ 383: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read32</span>
1523
+ 384: <span class="ruby-identifier">val</span> = (<span class="ruby-identifier">getc</span>() <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">24</span>) <span class="ruby-operator">+</span> (<span class="ruby-identifier">getc</span>() <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">16</span>) <span class="ruby-operator">+</span> (<span class="ruby-identifier">getc</span>() <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">8</span>) <span class="ruby-operator">+</span>
1524
+ 385: <span class="ruby-identifier">getc</span>()
1525
+ 386: <span class="ruby-identifier">val</span> = <span class="ruby-operator">-</span>(<span class="ruby-identifier">val</span> &amp; <span class="ruby-value">0x7fffffff</span>) <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">val</span> &amp; <span class="ruby-value">0x80000000</span>).<span class="ruby-identifier">nonzero?</span>
1526
+ 387: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">val</span>
1527
+ 388: <span class="ruby-keyword kw">end</span></pre>
1528
+ </div>
1529
+
1530
+ </div>
1531
+
1532
+
1533
+
1534
+
1535
+ </div>
1536
+
1537
+
1538
+ <div id="read-from-method" class="method-detail ">
1539
+ <a name="method-i-read_from"></a>
1540
+
1541
+ <div class="method-heading">
1542
+
1543
+ <span class="method-name">read_from</span><span
1544
+ class="method-args">(io)</span>
1545
+ <span class="method-click-advice">click to toggle source</span>
1546
+
1547
+ </div>
1548
+
1549
+ <div class="method-description">
1550
+
1551
+ <p>
1552
+ The only public method. Each <a href="../../MIDI.html">MIDI</a> event in
1553
+ the file causes a method to be called.
1554
+ </p>
1555
+
1556
+
1557
+
1558
+ <div class="method-source-code"
1559
+ id="read-from-source">
1560
+ <pre>
1561
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 59</span>
1562
+ 59: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_from</span>(<span class="ruby-identifier">io</span>)
1563
+ 60: <span class="ruby-identifier">error</span>(<span class="ruby-value str">'must specify non-nil input stream'</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">io</span>.<span class="ruby-identifier">nil?</span>
1564
+ 61: <span class="ruby-ivar">@io</span> = <span class="ruby-identifier">io</span>
1565
+ 62:
1566
+ 63: <span class="ruby-identifier">ntrks</span> = <span class="ruby-identifier">read_header</span>()
1567
+ 64: <span class="ruby-identifier">error</span>(<span class="ruby-value str">'No tracks!'</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ntrks</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-value">0</span>
1568
+ 65:
1569
+ 66: <span class="ruby-identifier">ntrks</span>.<span class="ruby-identifier">times</span> { <span class="ruby-identifier">read_track</span>() }
1570
+ 67: <span class="ruby-keyword kw">end</span></pre>
1571
+ </div>
1572
+
1573
+ </div>
1574
+
1575
+
1576
+
1577
+
1578
+ </div>
1579
+
1580
+
1581
+ <div id="read-header-method" class="method-detail ">
1582
+ <a name="method-i-read_header"></a>
1583
+
1584
+ <div class="method-heading">
1585
+
1586
+ <span class="method-name">read_header</span><span
1587
+ class="method-args">()</span>
1588
+ <span class="method-click-advice">click to toggle source</span>
1589
+
1590
+ </div>
1591
+
1592
+ <div class="method-description">
1593
+
1594
+ <p>
1595
+ Read a header chunk.
1596
+ </p>
1597
+
1598
+
1599
+
1600
+ <div class="method-source-code"
1601
+ id="read-header-source">
1602
+ <pre>
1603
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 190</span>
1604
+ 190: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_header</span>
1605
+ 191: <span class="ruby-ivar">@bytes_to_be_read</span> = <span class="ruby-value">0</span>
1606
+ 192: <span class="ruby-identifier">read_mt_header_string</span>(<span class="ruby-constant">MThd_BYTE_ARRAY</span>, <span class="ruby-ivar">@skip_init</span>) <span class="ruby-comment cmt"># &quot;MThd&quot;</span>
1607
+ 193:
1608
+ 194: <span class="ruby-ivar">@bytes_to_be_read</span> = <span class="ruby-identifier">read32</span>()
1609
+ 195: <span class="ruby-identifier">format</span> = <span class="ruby-identifier">read16</span>()
1610
+ 196: <span class="ruby-identifier">ntrks</span> = <span class="ruby-identifier">read16</span>()
1611
+ 197: <span class="ruby-identifier">division</span> = <span class="ruby-identifier">read16</span>()
1612
+ 198:
1613
+ 199: <span class="ruby-identifier">header</span>(<span class="ruby-identifier">format</span>, <span class="ruby-identifier">ntrks</span>, <span class="ruby-identifier">division</span>)
1614
+ 200:
1615
+ 201: <span class="ruby-comment cmt"># Flush any extra stuff, in case the length of the header is not 6</span>
1616
+ 202: <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@bytes_to_be_read</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
1617
+ 203: <span class="ruby-identifier">get_bytes</span>(<span class="ruby-ivar">@bytes_to_be_read</span>)
1618
+ 204: <span class="ruby-ivar">@bytes_to_be_read</span> = <span class="ruby-value">0</span>
1619
+ 205: <span class="ruby-keyword kw">end</span>
1620
+ 206:
1621
+ 207: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">ntrks</span>
1622
+ 208: <span class="ruby-keyword kw">end</span></pre>
1623
+ </div>
1624
+
1625
+ </div>
1626
+
1627
+
1628
+
1629
+
1630
+ </div>
1631
+
1632
+
1633
+ <div id="read-mt-header-string-method" class="method-detail ">
1634
+ <a name="method-i-read_mt_header_string"></a>
1635
+
1636
+ <div class="method-heading">
1637
+
1638
+ <span class="method-name">read_mt_header_string</span><span
1639
+ class="method-args">(bytes, skip)</span>
1640
+ <span class="method-click-advice">click to toggle source</span>
1641
+
1642
+ </div>
1643
+
1644
+ <div class="method-description">
1645
+
1646
+ <p>
1647
+ Read through &#8216;MThd&#8217; or &#8216;MTrk&#8217; header string. If
1648
+ skip is true, attempt to skip initial trash. If there is an error, <a
1649
+ href="MIDIFile.html#method-i-error">#</a> is called.
1650
+ </p>
1651
+
1652
+
1653
+
1654
+ <div class="method-source-code"
1655
+ id="read-mt-header-string-source">
1656
+ <pre>
1657
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 160</span>
1658
+ 160: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_mt_header_string</span>(<span class="ruby-identifier">bytes</span>, <span class="ruby-identifier">skip</span>)
1659
+ 161: <span class="ruby-identifier">b</span> = []
1660
+ 162: <span class="ruby-identifier">bytes_to_read</span> = <span class="ruby-value">4</span>
1661
+ 163: <span class="ruby-keyword kw">while</span> <span class="ruby-keyword kw">true</span>
1662
+ 164: <span class="ruby-identifier">data</span> = <span class="ruby-identifier">get_bytes</span>(<span class="ruby-identifier">bytes_to_read</span>)
1663
+ 165: <span class="ruby-identifier">b</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">data</span>
1664
+ 166: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">b</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">4</span>
1665
+ 167: <span class="ruby-identifier">error</span>(<span class="ruby-value str">&quot;unexpected EOF while trying to read header&quot;</span> <span class="ruby-operator">+</span>
1666
+ 168: <span class="ruby-node">&quot; string #{s}&quot;</span>)
1667
+ 169: <span class="ruby-keyword kw">end</span>
1668
+ 170:
1669
+ 171: <span class="ruby-comment cmt"># See if we found the bytes we're looking for</span>
1670
+ 172: <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">b</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">bytes</span>
1671
+ 173:
1672
+ 174: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">skip</span> <span class="ruby-comment cmt"># Try again with the next char</span>
1673
+ 175: <span class="ruby-identifier">i</span> = <span class="ruby-identifier">b</span>[<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">1</span>].<span class="ruby-identifier">index</span>(<span class="ruby-identifier">bytes</span>[<span class="ruby-value">0</span>])
1674
+ 176: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">i</span>.<span class="ruby-identifier">nil?</span>
1675
+ 177: <span class="ruby-identifier">b</span> = []
1676
+ 178: <span class="ruby-identifier">bytes_to_read</span> = <span class="ruby-value">4</span>
1677
+ 179: <span class="ruby-keyword kw">else</span>
1678
+ 180: <span class="ruby-identifier">b</span> = <span class="ruby-identifier">b</span>[<span class="ruby-identifier">i</span><span class="ruby-operator">..</span><span class="ruby-value">1</span>]
1679
+ 181: <span class="ruby-identifier">bytes_to_read</span> = <span class="ruby-value">4</span> <span class="ruby-operator">-</span> <span class="ruby-identifier">i</span>
1680
+ 182: <span class="ruby-keyword kw">end</span>
1681
+ 183: <span class="ruby-keyword kw">else</span>
1682
+ 184: <span class="ruby-identifier">error</span>(<span class="ruby-node">&quot;header string #{bytes.collect{|b| b.chr}.join} not found&quot;</span>)
1683
+ 185: <span class="ruby-keyword kw">end</span>
1684
+ 186: <span class="ruby-keyword kw">end</span>
1685
+ 187: <span class="ruby-keyword kw">end</span></pre>
1686
+ </div>
1687
+
1688
+ </div>
1689
+
1690
+
1691
+
1692
+
1693
+ </div>
1694
+
1695
+
1696
+ <div id="read-track-method" class="method-detail ">
1697
+ <a name="method-i-read_track"></a>
1698
+
1699
+ <div class="method-heading">
1700
+
1701
+ <span class="method-name">read_track</span><span
1702
+ class="method-args">()</span>
1703
+ <span class="method-click-advice">click to toggle source</span>
1704
+
1705
+ </div>
1706
+
1707
+ <div class="method-description">
1708
+
1709
+ <p>
1710
+ Read a track chunk.
1711
+ </p>
1712
+
1713
+
1714
+
1715
+ <div class="method-source-code"
1716
+ id="read-track-source">
1717
+ <pre>
1718
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 211</span>
1719
+ 211: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_track</span>
1720
+ 212: <span class="ruby-identifier">c</span> = <span class="ruby-identifier">c1</span> = <span class="ruby-identifier">type</span> = <span class="ruby-identifier">needed</span> = <span class="ruby-value">0</span>
1721
+ 213: <span class="ruby-identifier">sysex_continue</span> = <span class="ruby-keyword kw">false</span> <span class="ruby-comment cmt"># True if last msg was unfinished</span>
1722
+ 214: <span class="ruby-identifier">running</span> = <span class="ruby-keyword kw">false</span> <span class="ruby-comment cmt"># True when running status used</span>
1723
+ 215: <span class="ruby-identifier">status</span> = <span class="ruby-value">0</span> <span class="ruby-comment cmt"># (Possibly running) status byte</span>
1724
+ 216:
1725
+ 217: <span class="ruby-ivar">@bytes_to_be_read</span> = <span class="ruby-value">0</span>
1726
+ 218: <span class="ruby-identifier">read_mt_header_string</span>(<span class="ruby-constant">MTrk_BYTE_ARRAY</span>, <span class="ruby-keyword kw">false</span>)
1727
+ 219:
1728
+ 220: <span class="ruby-ivar">@bytes_to_be_read</span> = <span class="ruby-identifier">read32</span>()
1729
+ 221: <span class="ruby-ivar">@curr_ticks</span> = <span class="ruby-ivar">@ticks_so_far</span> = <span class="ruby-value">0</span>
1730
+ 222:
1731
+ 223: <span class="ruby-identifier">start_track</span>()
1732
+ 224:
1733
+ 225: <span class="ruby-keyword kw">while</span> <span class="ruby-ivar">@bytes_to_be_read</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
1734
+ 226: <span class="ruby-ivar">@curr_ticks</span> = <span class="ruby-identifier">read_var_len</span>() <span class="ruby-comment cmt"># Delta time</span>
1735
+ 227: <span class="ruby-ivar">@ticks_so_far</span> <span class="ruby-operator">+=</span> <span class="ruby-ivar">@curr_ticks</span>
1736
+ 228:
1737
+ 229: <span class="ruby-comment cmt"># Copy raw var num data into raw time stamp data</span>
1738
+ 230: <span class="ruby-ivar">@raw_time_stamp_data</span> = <span class="ruby-ivar">@raw_var_num_data</span>.<span class="ruby-identifier">dup</span>()
1739
+ 231:
1740
+ 232: <span class="ruby-identifier">c</span> = <span class="ruby-identifier">getc</span>() <span class="ruby-comment cmt"># Read first byte</span>
1741
+ 233:
1742
+ 234: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">sysex_continue</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">c</span> <span class="ruby-operator">!=</span> <span class="ruby-constant">EOX</span>
1743
+ 235: <span class="ruby-identifier">error</span>(<span class="ruby-value str">&quot;didn't find expected continuation of a sysex&quot;</span>)
1744
+ 236: <span class="ruby-keyword kw">end</span>
1745
+ 237:
1746
+ 238: <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">c</span> &amp; <span class="ruby-value">0x80</span>).<span class="ruby-identifier">zero?</span> <span class="ruby-comment cmt"># Running status?</span>
1747
+ 239: <span class="ruby-identifier">error</span>(<span class="ruby-value str">'unexpected running status'</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">status</span>.<span class="ruby-identifier">zero?</span>
1748
+ 240: <span class="ruby-identifier">running</span> = <span class="ruby-keyword kw">true</span>
1749
+ 241: <span class="ruby-keyword kw">else</span>
1750
+ 242: <span class="ruby-identifier">status</span> = <span class="ruby-identifier">c</span>
1751
+ 243: <span class="ruby-identifier">running</span> = <span class="ruby-keyword kw">false</span>
1752
+ 244: <span class="ruby-keyword kw">end</span>
1753
+ 245:
1754
+ 246: <span class="ruby-identifier">needed</span> = <span class="ruby-constant">NUM_DATA_BYTES</span>[(<span class="ruby-identifier">status</span> <span class="ruby-operator">&gt;&gt;</span> <span class="ruby-value">4</span>) &amp; <span class="ruby-value">0x0f</span>]
1755
+ 247:
1756
+ 248: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">needed</span>.<span class="ruby-identifier">nonzero?</span> <span class="ruby-comment cmt"># i.e., is it a channel message?</span>
1757
+ 249: <span class="ruby-identifier">c1</span> = <span class="ruby-identifier">running</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">c</span> <span class="ruby-operator">:</span> (<span class="ruby-identifier">getc</span>() &amp; <span class="ruby-value">0x7f</span>)
1758
+ 250:
1759
+ 251: <span class="ruby-comment cmt"># The &quot;&amp; 0x7f&quot; here may seem unnecessary, but I've seen</span>
1760
+ 252: <span class="ruby-comment cmt"># &quot;bad&quot; MIDI files that had, for example, volume bytes</span>
1761
+ 253: <span class="ruby-comment cmt"># with the upper bit set. This code should not harm</span>
1762
+ 254: <span class="ruby-comment cmt"># proper data.</span>
1763
+ 255: <span class="ruby-identifier">chan_message</span>(<span class="ruby-identifier">running</span>, <span class="ruby-identifier">status</span>, <span class="ruby-identifier">c1</span>,
1764
+ 256: (<span class="ruby-identifier">needed</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">1</span>) <span class="ruby-operator">?</span> (<span class="ruby-identifier">getc</span>() &amp; <span class="ruby-value">0x7f</span>) <span class="ruby-operator">:</span> <span class="ruby-value">0</span>)
1765
+ 257: <span class="ruby-keyword kw">next</span>
1766
+ 258: <span class="ruby-keyword kw">end</span>
1767
+ 259:
1768
+ 260: <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">c</span>
1769
+ 261: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">META_EVENT</span> <span class="ruby-comment cmt"># Meta event</span>
1770
+ 262: <span class="ruby-identifier">type</span> = <span class="ruby-identifier">getc</span>()
1771
+ 263: <span class="ruby-identifier">msg_init</span>()
1772
+ 264: <span class="ruby-identifier">msg_read</span>(<span class="ruby-identifier">read_var_len</span>())
1773
+ 265: <span class="ruby-identifier">meta_event</span>(<span class="ruby-identifier">type</span>)
1774
+ 266: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">SYSEX</span> <span class="ruby-comment cmt"># Start of system exclusive</span>
1775
+ 267: <span class="ruby-identifier">msg_init</span>()
1776
+ 268: <span class="ruby-identifier">msg_add</span>(<span class="ruby-constant">SYSEX</span>)
1777
+ 269: <span class="ruby-identifier">c</span> = <span class="ruby-identifier">msg_read</span>(<span class="ruby-identifier">read_var_len</span>())
1778
+ 270:
1779
+ 271: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">c</span> <span class="ruby-operator">==</span> <span class="ruby-constant">EOX</span> <span class="ruby-operator">||</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@no_merge</span>
1780
+ 272: <span class="ruby-identifier">handle_sysex</span>(<span class="ruby-identifier">msg</span>())
1781
+ 273: <span class="ruby-keyword kw">else</span>
1782
+ 274: <span class="ruby-identifier">sysex_continue</span> = <span class="ruby-keyword kw">true</span>
1783
+ 275: <span class="ruby-keyword kw">end</span>
1784
+ 276: <span class="ruby-keyword kw">when</span> <span class="ruby-constant">EOX</span> <span class="ruby-comment cmt"># Sysex continuation or arbitrary stuff</span>
1785
+ 277: <span class="ruby-identifier">msg_init</span>() <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">sysex_continue</span>
1786
+ 278: <span class="ruby-identifier">c</span> = <span class="ruby-identifier">msg_read</span>(<span class="ruby-identifier">read_var_len</span>())
1787
+ 279:
1788
+ 280: <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">sysex_continue</span>
1789
+ 281: <span class="ruby-identifier">handle_arbitrary</span>(<span class="ruby-identifier">msg</span>())
1790
+ 282: <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">c</span> <span class="ruby-operator">==</span> <span class="ruby-constant">EOX</span>
1791
+ 283: <span class="ruby-identifier">handle_sysex</span>(<span class="ruby-identifier">msg</span>())
1792
+ 284: <span class="ruby-identifier">sysex_continue</span> = <span class="ruby-keyword kw">false</span>
1793
+ 285: <span class="ruby-keyword kw">end</span>
1794
+ 286: <span class="ruby-keyword kw">else</span>
1795
+ 287: <span class="ruby-identifier">bad_byte</span>(<span class="ruby-identifier">c</span>)
1796
+ 288: <span class="ruby-keyword kw">end</span>
1797
+ 289: <span class="ruby-keyword kw">end</span>
1798
+ 290: <span class="ruby-identifier">end_track</span>()
1799
+ 291: <span class="ruby-keyword kw">end</span></pre>
1800
+ </div>
1801
+
1802
+ </div>
1803
+
1804
+
1805
+
1806
+
1807
+ </div>
1808
+
1809
+
1810
+ <div id="read-var-len-method" class="method-detail ">
1811
+ <a name="method-i-read_var_len"></a>
1812
+
1813
+ <div class="method-heading">
1814
+
1815
+ <span class="method-name">read_var_len</span><span
1816
+ class="method-args">()</span>
1817
+ <span class="method-click-advice">click to toggle source</span>
1818
+
1819
+ </div>
1820
+
1821
+ <div class="method-description">
1822
+
1823
+ <p>
1824
+ Read a varlen value.
1825
+ </p>
1826
+
1827
+
1828
+
1829
+ <div class="method-source-code"
1830
+ id="read-var-len-source">
1831
+ <pre>
1832
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 391</span>
1833
+ 391: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">read_var_len</span>
1834
+ 392: <span class="ruby-ivar">@raw_var_num_data</span> = []
1835
+ 393: <span class="ruby-identifier">c</span> = <span class="ruby-identifier">getc</span>()
1836
+ 394: <span class="ruby-ivar">@raw_var_num_data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">c</span>
1837
+ 395: <span class="ruby-identifier">val</span> = <span class="ruby-identifier">c</span>
1838
+ 396: <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">val</span> &amp; <span class="ruby-value">0x80</span>).<span class="ruby-identifier">nonzero?</span>
1839
+ 397: <span class="ruby-identifier">val</span> <span class="ruby-operator">&amp;=</span> <span class="ruby-value">0x7f</span>
1840
+ 398: <span class="ruby-keyword kw">while</span> <span class="ruby-keyword kw">true</span>
1841
+ 399: <span class="ruby-identifier">c</span> = <span class="ruby-identifier">getc</span>()
1842
+ 400: <span class="ruby-ivar">@raw_var_num_data</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">c</span>
1843
+ 401: <span class="ruby-identifier">val</span> = (<span class="ruby-identifier">val</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-value">7</span>) <span class="ruby-operator">+</span> (<span class="ruby-identifier">c</span> &amp; <span class="ruby-value">0x7f</span>)
1844
+ 402: <span class="ruby-keyword kw">break</span> <span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">c</span> &amp; <span class="ruby-value">0x80</span>).<span class="ruby-identifier">zero?</span>
1845
+ 403: <span class="ruby-keyword kw">end</span>
1846
+ 404: <span class="ruby-keyword kw">end</span>
1847
+ 405: <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">val</span>
1848
+ 406: <span class="ruby-keyword kw">end</span></pre>
1849
+ </div>
1850
+
1851
+ </div>
1852
+
1853
+
1854
+
1855
+
1856
+ </div>
1857
+
1858
+
1859
+ <div id="sequence-number-method" class="method-detail ">
1860
+ <a name="method-i-sequence_number"></a>
1861
+
1862
+ <div class="method-heading">
1863
+
1864
+ <span class="method-name">sequence_number</span><span
1865
+ class="method-args">(num)</span>
1866
+ <span class="method-click-advice">click to toggle source</span>
1867
+
1868
+ </div>
1869
+
1870
+ <div class="method-description">
1871
+
1872
+
1873
+
1874
+
1875
+
1876
+ <div class="method-source-code"
1877
+ id="sequence-number-source">
1878
+ <pre>
1879
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 131</span>
1880
+ 131: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sequence_number</span>(<span class="ruby-identifier">num</span>)
1881
+ 132: <span class="ruby-keyword kw">end</span></pre>
1882
+ </div>
1883
+
1884
+ </div>
1885
+
1886
+
1887
+
1888
+
1889
+ </div>
1890
+
1891
+
1892
+ <div id="sequencer-specific-method" class="method-detail ">
1893
+ <a name="method-i-sequencer_specific"></a>
1894
+
1895
+ <div class="method-heading">
1896
+
1897
+ <span class="method-name">sequencer_specific</span><span
1898
+ class="method-args">(type, msg)</span>
1899
+ <span class="method-click-advice">click to toggle source</span>
1900
+
1901
+ </div>
1902
+
1903
+ <div class="method-description">
1904
+
1905
+
1906
+
1907
+
1908
+
1909
+ <div class="method-source-code"
1910
+ id="sequencer-specific-source">
1911
+ <pre>
1912
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 128</span>
1913
+ 128: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sequencer_specific</span>(<span class="ruby-identifier">type</span>, <span class="ruby-identifier">msg</span>)
1914
+ 129: <span class="ruby-keyword kw">end</span></pre>
1915
+ </div>
1916
+
1917
+ </div>
1918
+
1919
+
1920
+
1921
+
1922
+ </div>
1923
+
1924
+
1925
+ <div id="smpte-method" class="method-detail ">
1926
+ <a name="method-i-smpte"></a>
1927
+
1928
+ <div class="method-heading">
1929
+
1930
+ <span class="method-name">smpte</span><span
1931
+ class="method-args">(hour, min, sec, frame, fract)</span>
1932
+ <span class="method-click-advice">click to toggle source</span>
1933
+
1934
+ </div>
1935
+
1936
+ <div class="method-description">
1937
+
1938
+
1939
+
1940
+
1941
+
1942
+ <div class="method-source-code"
1943
+ id="smpte-source">
1944
+ <pre>
1945
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 143</span>
1946
+ 143: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">smpte</span>(<span class="ruby-identifier">hour</span>, <span class="ruby-identifier">min</span>, <span class="ruby-identifier">sec</span>, <span class="ruby-identifier">frame</span>, <span class="ruby-identifier">fract</span>)
1947
+ 144: <span class="ruby-keyword kw">end</span></pre>
1948
+ </div>
1949
+
1950
+ </div>
1951
+
1952
+
1953
+
1954
+
1955
+ </div>
1956
+
1957
+
1958
+ <div id="start-track-method" class="method-detail ">
1959
+ <a name="method-i-start_track"></a>
1960
+
1961
+ <div class="method-heading">
1962
+
1963
+ <span class="method-name">start_track</span><span
1964
+ class="method-args">(bytes_to_be_read)</span>
1965
+ <span class="method-click-advice">click to toggle source</span>
1966
+
1967
+ </div>
1968
+
1969
+ <div class="method-description">
1970
+
1971
+
1972
+
1973
+
1974
+
1975
+ <div class="method-source-code"
1976
+ id="start-track-source">
1977
+ <pre>
1978
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 95</span>
1979
+ 95: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">start_track</span>(<span class="ruby-identifier">bytes_to_be_read</span>)
1980
+ 96: <span class="ruby-keyword kw">end</span></pre>
1981
+ </div>
1982
+
1983
+ </div>
1984
+
1985
+
1986
+
1987
+
1988
+ </div>
1989
+
1990
+
1991
+ <div id="sysex-method" class="method-detail ">
1992
+ <a name="method-i-sysex"></a>
1993
+
1994
+ <div class="method-heading">
1995
+
1996
+ <span class="method-name">sysex</span><span
1997
+ class="method-args">(msg)</span>
1998
+ <span class="method-click-advice">click to toggle source</span>
1999
+
2000
+ </div>
2001
+
2002
+ <div class="method-description">
2003
+
2004
+
2005
+
2006
+
2007
+
2008
+ <div class="method-source-code"
2009
+ id="sysex-source">
2010
+ <pre>
2011
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 122</span>
2012
+ 122: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sysex</span>(<span class="ruby-identifier">msg</span>)
2013
+ 123: <span class="ruby-keyword kw">end</span></pre>
2014
+ </div>
2015
+
2016
+ </div>
2017
+
2018
+
2019
+
2020
+
2021
+ </div>
2022
+
2023
+
2024
+ <div id="tempo-method" class="method-detail ">
2025
+ <a name="method-i-tempo"></a>
2026
+
2027
+ <div class="method-heading">
2028
+
2029
+ <span class="method-name">tempo</span><span
2030
+ class="method-args">(microsecs)</span>
2031
+ <span class="method-click-advice">click to toggle source</span>
2032
+
2033
+ </div>
2034
+
2035
+ <div class="method-description">
2036
+
2037
+
2038
+
2039
+
2040
+
2041
+ <div class="method-source-code"
2042
+ id="tempo-source">
2043
+ <pre>
2044
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 146</span>
2045
+ 146: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">tempo</span>(<span class="ruby-identifier">microsecs</span>)
2046
+ 147: <span class="ruby-keyword kw">end</span></pre>
2047
+ </div>
2048
+
2049
+ </div>
2050
+
2051
+
2052
+
2053
+
2054
+ </div>
2055
+
2056
+
2057
+ <div id="text-method" class="method-detail ">
2058
+ <a name="method-i-text"></a>
2059
+
2060
+ <div class="method-heading">
2061
+
2062
+ <span class="method-name">text</span><span
2063
+ class="method-args">(type, msg)</span>
2064
+ <span class="method-click-advice">click to toggle source</span>
2065
+
2066
+ </div>
2067
+
2068
+ <div class="method-description">
2069
+
2070
+
2071
+
2072
+
2073
+
2074
+ <div class="method-source-code"
2075
+ id="text-source">
2076
+ <pre>
2077
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 134</span>
2078
+ 134: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">text</span>(<span class="ruby-identifier">type</span>, <span class="ruby-identifier">msg</span>)
2079
+ 135: <span class="ruby-keyword kw">end</span></pre>
2080
+ </div>
2081
+
2082
+ </div>
2083
+
2084
+
2085
+
2086
+
2087
+ </div>
2088
+
2089
+
2090
+ <div id="time-signature-method" class="method-detail ">
2091
+ <a name="method-i-time_signature"></a>
2092
+
2093
+ <div class="method-heading">
2094
+
2095
+ <span class="method-name">time_signature</span><span
2096
+ class="method-args">(numer, denom, clocks, qnotes)</span>
2097
+ <span class="method-click-advice">click to toggle source</span>
2098
+
2099
+ </div>
2100
+
2101
+ <div class="method-description">
2102
+
2103
+
2104
+
2105
+
2106
+
2107
+ <div class="method-source-code"
2108
+ id="time-signature-source">
2109
+ <pre>
2110
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 140</span>
2111
+ 140: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">time_signature</span>(<span class="ruby-identifier">numer</span>, <span class="ruby-identifier">denom</span>, <span class="ruby-identifier">clocks</span>, <span class="ruby-identifier">qnotes</span>)
2112
+ 141: <span class="ruby-keyword kw">end</span></pre>
2113
+ </div>
2114
+
2115
+ </div>
2116
+
2117
+
2118
+
2119
+
2120
+ </div>
2121
+
2122
+
2123
+ <div id="write--method" class="method-detail ">
2124
+ <a name="method-i-write16"></a>
2125
+
2126
+ <div class="method-heading">
2127
+
2128
+ <span class="method-name">write16</span><span
2129
+ class="method-args">(val)</span>
2130
+ <span class="method-click-advice">click to toggle source</span>
2131
+
2132
+ </div>
2133
+
2134
+ <div class="method-description">
2135
+
2136
+ <p>
2137
+ Write a sixteen-bit value.
2138
+ </p>
2139
+
2140
+
2141
+
2142
+ <div class="method-source-code"
2143
+ id="write--source">
2144
+ <pre>
2145
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 409</span>
2146
+ 409: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write16</span>(<span class="ruby-identifier">val</span>)
2147
+ 410: <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 kw">if</span> <span class="ruby-identifier">val</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
2148
+ 411: <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>) &amp; <span class="ruby-value">0xff</span>)
2149
+ 412: <span class="ruby-identifier">putc</span>(<span class="ruby-identifier">val</span> &amp; <span class="ruby-value">0xff</span>)
2150
+ 413: <span class="ruby-keyword kw">end</span></pre>
2151
+ </div>
2152
+
2153
+ </div>
2154
+
2155
+
2156
+
2157
+
2158
+ </div>
2159
+
2160
+
2161
+ <div id="write--method" class="method-detail ">
2162
+ <a name="method-i-write32"></a>
2163
+
2164
+ <div class="method-heading">
2165
+
2166
+ <span class="method-name">write32</span><span
2167
+ class="method-args">(val)</span>
2168
+ <span class="method-click-advice">click to toggle source</span>
2169
+
2170
+ </div>
2171
+
2172
+ <div class="method-description">
2173
+
2174
+ <p>
2175
+ Write a 32-bit value.
2176
+ </p>
2177
+
2178
+
2179
+
2180
+ <div class="method-source-code"
2181
+ id="write--source">
2182
+ <pre>
2183
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 416</span>
2184
+ 416: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write32</span>(<span class="ruby-identifier">val</span>)
2185
+ 417: <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 kw">if</span> <span class="ruby-identifier">val</span> <span class="ruby-operator">&lt;</span> <span class="ruby-value">0</span>
2186
+ 418: <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>) &amp; <span class="ruby-value">0xff</span>)
2187
+ 419: <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>) &amp; <span class="ruby-value">0xff</span>)
2188
+ 420: <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>) &amp; <span class="ruby-value">0xff</span>)
2189
+ 421: <span class="ruby-identifier">putc</span>(<span class="ruby-identifier">val</span> &amp; <span class="ruby-value">0xff</span>)
2190
+ 422: <span class="ruby-keyword kw">end</span></pre>
2191
+ </div>
2192
+
2193
+ </div>
2194
+
2195
+
2196
+
2197
+
2198
+ </div>
2199
+
2200
+
2201
+ <div id="write-var-len-method" class="method-detail ">
2202
+ <a name="method-i-write_var_len"></a>
2203
+
2204
+ <div class="method-heading">
2205
+
2206
+ <span class="method-name">write_var_len</span><span
2207
+ class="method-args">(val)</span>
2208
+ <span class="method-click-advice">click to toggle source</span>
2209
+
2210
+ </div>
2211
+
2212
+ <div class="method-description">
2213
+
2214
+ <p>
2215
+ Write a variable length value.
2216
+ </p>
2217
+
2218
+
2219
+
2220
+ <div class="method-source-code"
2221
+ id="write-var-len-source">
2222
+ <pre>
2223
+ <span class="ruby-comment cmt"># File lib/midilib/io/midifile.rb, line 425</span>
2224
+ 425: <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">write_var_len</span>(<span class="ruby-identifier">val</span>)
2225
+ 426: <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">val</span>.<span class="ruby-identifier">zero?</span>
2226
+ 427: <span class="ruby-identifier">putc</span>(<span class="ruby-value">0</span>)
2227
+ 428: <span class="ruby-keyword kw">return</span>
2228
+ 429: <span class="ruby-keyword kw">end</span>
2229
+ 430:
2230
+ 431: <span class="ruby-identifier">buf</span> = []
2231
+ 432:
2232
+ 433: <span class="ruby-identifier">buf</span> <span class="ruby-operator">&lt;&lt;</span> (<span class="ruby-identifier">val</span> &amp; <span class="ruby-value">0x7f</span>)
2233
+ 434: <span class="ruby-keyword kw">while</span> (<span class="ruby-identifier">value</span> <span class="ruby-operator">&gt;&gt;=</span> <span class="ruby-value">7</span>) <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
2234
+ 435: <span class="ruby-identifier">buf</span> <span class="ruby-operator">&lt;&lt;</span> (<span class="ruby-identifier">val</span> &amp; <span class="ruby-value">0x7f</span>) <span class="ruby-operator">|</span> <span class="ruby-value">0x80</span>
2235
+ 436: <span class="ruby-keyword kw">end</span>
2236
+ 437:
2237
+ 438: <span class="ruby-identifier">buf</span>.<span class="ruby-identifier">reverse</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-identifier">putc</span>(<span class="ruby-identifier">b</span>) }
2238
+ 439: <span class="ruby-keyword kw">end</span></pre>
2239
+ </div>
2240
+
2241
+ </div>
2242
+
2243
+
2244
+
2245
+
2246
+ </div>
2247
+
2248
+
2249
+ </div>
2250
+
2251
+
2252
+ </div>
2253
+
2254
+
2255
+ <div id="rdoc-debugging-section-dump" class="debugging-section">
2256
+
2257
+ <p>Disabled; run with --debug to generate this.</p>
2258
+
2259
+ </div>
2260
+
2261
+ <div id="validator-badges">
2262
+ <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
2263
+ <p><small>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish
2264
+ Rdoc Generator</a> 1.1.6</small>.</p>
2265
+ </div>
2266
+
2267
+ </body>
2268
+ </html>
2269
+