midilib 2.0.4 → 2.0.5
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.
- checksums.yaml +7 -0
 - data/README.rdoc +9 -4
 - data/Rakefile +2 -6
 - data/examples/from_scratch.rb +3 -5
 - data/examples/measures_mbt.rb +4 -4
 - data/examples/print_program_changes.rb +9 -9
 - data/examples/reader2text.rb +188 -188
 - data/examples/seq2text.rb +17 -17
 - data/examples/split.rb +19 -19
 - data/examples/strings.rb +14 -14
 - data/examples/transpose.rb +31 -31
 - data/html/IO.html +65 -169
 - data/html/MIDI.html +138 -256
 - data/html/MIDI/ActiveSense.html +89 -178
 - data/html/MIDI/ChannelEvent.html +95 -183
 - data/html/MIDI/ChannelPressure.html +105 -190
 - data/html/MIDI/Clock.html +89 -178
 - data/html/MIDI/Continue.html +89 -178
 - data/html/MIDI/Controller.html +107 -192
 - data/html/MIDI/Event.html +138 -222
 - data/html/MIDI/IO.html +45 -157
 - data/html/MIDI/IO/MIDIFile.html +596 -568
 - data/html/MIDI/IO/SeqReader.html +272 -314
 - data/html/MIDI/IO/SeqWriter.html +229 -305
 - data/html/MIDI/KeySig.html +129 -211
 - data/html/MIDI/MIDI.html +45 -154
 - data/html/MIDI/MIDI/MIDI.html +45 -154
 - data/html/MIDI/MIDI/MIDI/Array.html +87 -185
 - data/html/MIDI/Marker.html +71 -170
 - data/html/MIDI/Measure.html +95 -190
 - data/html/MIDI/Measures.html +103 -193
 - data/html/MIDI/MetaEvent.html +180 -253
 - data/html/MIDI/NoteEvent.html +118 -204
 - data/html/MIDI/NoteOff.html +95 -183
 - data/html/MIDI/NoteOn.html +95 -183
 - data/html/MIDI/PitchBend.html +106 -191
 - data/html/MIDI/PolyPressure.html +106 -189
 - data/html/MIDI/ProgramChange.html +105 -190
 - data/html/MIDI/Realtime.html +98 -184
 - data/html/MIDI/Sequence.html +246 -311
 - data/html/MIDI/SongPointer.html +106 -191
 - data/html/MIDI/SongSelect.html +105 -190
 - data/html/MIDI/Start.html +89 -178
 - data/html/MIDI/Stop.html +89 -178
 - data/html/MIDI/SystemCommon.html +71 -170
 - data/html/MIDI/SystemExclusive.html +108 -193
 - data/html/MIDI/SystemReset.html +89 -178
 - data/html/MIDI/Tempo.html +135 -213
 - data/html/MIDI/TimeSig.html +135 -214
 - data/html/MIDI/Track.html +217 -291
 - data/html/MIDI/TuneRequest.html +98 -184
 - data/html/MIDI/Utils.html +89 -189
 - data/html/README_rdoc.html +237 -257
 - data/html/TODO_rdoc.html +64 -139
 - data/html/created.rid +14 -14
 - data/html/css/fonts.css +167 -0
 - data/html/{rdoc.css → css/rdoc.css} +265 -218
 - data/html/fonts/Lato-Light.ttf +0 -0
 - data/html/fonts/Lato-LightItalic.ttf +0 -0
 - data/html/fonts/Lato-Regular.ttf +0 -0
 - data/html/fonts/Lato-RegularItalic.ttf +0 -0
 - data/html/fonts/SourceCodePro-Bold.ttf +0 -0
 - data/html/fonts/SourceCodePro-Regular.ttf +0 -0
 - data/html/images/add.png +0 -0
 - data/html/images/arrow_up.png +0 -0
 - data/html/images/delete.png +0 -0
 - data/html/images/tag_blue.png +0 -0
 - data/html/index.html +187 -169
 - data/html/js/darkfish.js +41 -33
 - data/html/js/jquery.js +4 -18
 - data/html/js/navigation.js.gz +0 -0
 - data/html/js/search.js +20 -5
 - data/html/js/search_index.js +1 -1
 - data/html/js/search_index.js.gz +0 -0
 - data/html/js/searcher.js.gz +0 -0
 - data/html/table_of_contents.html +1111 -498
 - data/install.rb +43 -32
 - data/lib/midilib/consts.rb +407 -407
 - data/lib/midilib/event.rb +295 -294
 - data/lib/midilib/info.rb +5 -5
 - data/lib/midilib/io/midifile.rb +266 -267
 - data/lib/midilib/io/seqreader.rb +106 -106
 - data/lib/midilib/io/seqwriter.rb +59 -60
 - data/lib/midilib/measure.rb +69 -69
 - data/lib/midilib/sequence.rb +68 -70
 - data/lib/midilib/track.rb +96 -102
 - data/lib/midilib/utils.rb +15 -15
 - data/test/event_equality.rb +50 -50
 - data/test/test_event.rb +120 -122
 - data/test/test_io.rb +35 -48
 - data/test/test_sequence.rb +60 -60
 - data/test/test_track.rb +154 -154
 - data/test/test_varlen.rb +23 -25
 - metadata +65 -57
 
    
        data/html/MIDI/NoteEvent.html
    CHANGED
    
    | 
         @@ -2,206 +2,99 @@ 
     | 
|
| 
       2 
2 
     | 
    
         | 
| 
       3 
3 
     | 
    
         
             
            <html>
         
     | 
| 
       4 
4 
     | 
    
         
             
            <head>
         
     | 
| 
       5 
     | 
    
         
            -
            <meta  
     | 
| 
      
 5 
     | 
    
         
            +
            <meta charset="UTF-8">
         
     | 
| 
       6 
6 
     | 
    
         | 
| 
       7 
7 
     | 
    
         
             
            <title>class MIDI::NoteEvent - midilib</title>
         
     | 
| 
       8 
8 
     | 
    
         | 
| 
       9 
     | 
    
         
            -
            <link type="text/css" media="screen" href="../rdoc.css" rel="stylesheet">
         
     | 
| 
       10 
     | 
    
         
            -
             
     | 
| 
       11 
9 
     | 
    
         
             
            <script type="text/javascript">
         
     | 
| 
       12 
10 
     | 
    
         
             
              var rdoc_rel_prefix = "../";
         
     | 
| 
       13 
11 
     | 
    
         
             
            </script>
         
     | 
| 
       14 
12 
     | 
    
         | 
| 
       15 
     | 
    
         
            -
            <script  
     | 
| 
       16 
     | 
    
         
            -
            <script  
     | 
| 
       17 
     | 
    
         
            -
             
     | 
| 
       18 
     | 
    
         
            -
            < 
     | 
| 
       19 
     | 
    
         
            -
            < 
     | 
| 
       20 
     | 
    
         
            -
             
     | 
| 
      
 13 
     | 
    
         
            +
            <script src="../js/jquery.js"></script>
         
     | 
| 
      
 14 
     | 
    
         
            +
            <script src="../js/darkfish.js"></script>
         
     | 
| 
      
 15 
     | 
    
         
            +
             
     | 
| 
      
 16 
     | 
    
         
            +
            <link href="../css/fonts.css" rel="stylesheet">
         
     | 
| 
      
 17 
     | 
    
         
            +
            <link href="../css/rdoc.css" rel="stylesheet">
         
     | 
| 
      
 18 
     | 
    
         
            +
             
     | 
| 
      
 19 
     | 
    
         
            +
             
     | 
| 
       21 
20 
     | 
    
         | 
| 
      
 21 
     | 
    
         
            +
            <body id="top" role="document" class="class">
         
     | 
| 
      
 22 
     | 
    
         
            +
            <nav role="navigation">
         
     | 
| 
      
 23 
     | 
    
         
            +
              <div id="project-navigation">
         
     | 
| 
      
 24 
     | 
    
         
            +
                <div id="home-section" role="region" title="Quick navigation" class="nav-section">
         
     | 
| 
      
 25 
     | 
    
         
            +
              <h2>
         
     | 
| 
      
 26 
     | 
    
         
            +
                <a href="../index.html" rel="home">Home</a>
         
     | 
| 
      
 27 
     | 
    
         
            +
              </h2>
         
     | 
| 
       22 
28 
     | 
    
         | 
| 
       23 
     | 
    
         
            -
            < 
     | 
| 
       24 
     | 
    
         
            -
            < 
     | 
| 
       25 
     | 
    
         
            -
              <nav id="home-section" class="section">
         
     | 
| 
       26 
     | 
    
         
            -
              <h3 class="section-header">
         
     | 
| 
       27 
     | 
    
         
            -
                <a href="../index.html">Home</a>
         
     | 
| 
      
 29 
     | 
    
         
            +
              <div id="table-of-contents-navigation">
         
     | 
| 
      
 30 
     | 
    
         
            +
                <a href="../table_of_contents.html#pages">Pages</a>
         
     | 
| 
       28 
31 
     | 
    
         
             
                <a href="../table_of_contents.html#classes">Classes</a>
         
     | 
| 
       29 
32 
     | 
    
         
             
                <a href="../table_of_contents.html#methods">Methods</a>
         
     | 
| 
       30 
     | 
    
         
            -
              </ 
     | 
| 
       31 
     | 
    
         
            -
            </ 
     | 
| 
       32 
     | 
    
         
            -
             
     | 
| 
      
 33 
     | 
    
         
            +
              </div>
         
     | 
| 
      
 34 
     | 
    
         
            +
            </div>
         
     | 
| 
       33 
35 
     | 
    
         | 
| 
       34 
     | 
    
         
            -
             
     | 
| 
      
 36 
     | 
    
         
            +
                <div id="search-section" role="search" class="project-section initially-hidden">
         
     | 
| 
       35 
37 
     | 
    
         
             
              <form action="#" method="get" accept-charset="utf-8">
         
     | 
| 
       36 
     | 
    
         
            -
                < 
     | 
| 
       37 
     | 
    
         
            -
                  <input  
     | 
| 
      
 38 
     | 
    
         
            +
                <div id="search-field-wrapper">
         
     | 
| 
      
 39 
     | 
    
         
            +
                  <input id="search-field" role="combobox" aria-label="Search"
         
     | 
| 
      
 40 
     | 
    
         
            +
                         aria-autocomplete="list" aria-controls="search-results"
         
     | 
| 
      
 41 
     | 
    
         
            +
                         type="text" name="search" placeholder="Search" spellcheck="false"
         
     | 
| 
       38 
42 
     | 
    
         
             
                         title="Type to search, Up and Down to navigate, Enter to load">
         
     | 
| 
       39 
     | 
    
         
            -
                </ 
     | 
| 
       40 
     | 
    
         
            -
              </form>
         
     | 
| 
       41 
     | 
    
         
            -
             
     | 
| 
       42 
     | 
    
         
            -
              <ul id="search-results" class="initially-hidden"></ul>
         
     | 
| 
       43 
     | 
    
         
            -
            </nav>
         
     | 
| 
      
 43 
     | 
    
         
            +
                </div>
         
     | 
| 
       44 
44 
     | 
    
         | 
| 
      
 45 
     | 
    
         
            +
                <ul id="search-results" aria-label="Search Results"
         
     | 
| 
      
 46 
     | 
    
         
            +
                    aria-busy="false" aria-expanded="false"
         
     | 
| 
      
 47 
     | 
    
         
            +
                    aria-atomic="false" class="initially-hidden"></ul>
         
     | 
| 
      
 48 
     | 
    
         
            +
              </form>
         
     | 
| 
      
 49 
     | 
    
         
            +
            </div>
         
     | 
| 
       45 
50 
     | 
    
         | 
| 
       46 
     | 
    
         
            -
              <div id="file-metadata">
         
     | 
| 
       47 
     | 
    
         
            -
                <nav id="file-list-section" class="section">
         
     | 
| 
       48 
     | 
    
         
            -
              <h3 class="section-header">Defined In</h3>
         
     | 
| 
       49 
     | 
    
         
            -
              <ul>
         
     | 
| 
       50 
     | 
    
         
            -
                <li>lib/midilib/event.rb
         
     | 
| 
       51 
     | 
    
         
            -
              </ul>
         
     | 
| 
       52 
     | 
    
         
            -
            </nav>
         
     | 
| 
       53 
     | 
    
         
            -
             
     | 
| 
       54 
     | 
    
         
            -
                
         
     | 
| 
       55 
51 
     | 
    
         
             
              </div>
         
     | 
| 
       56 
52 
     | 
    
         | 
| 
      
 53 
     | 
    
         
            +
              
         
     | 
| 
      
 54 
     | 
    
         
            +
             
     | 
| 
       57 
55 
     | 
    
         
             
              <div id="class-metadata">
         
     | 
| 
       58 
56 
     | 
    
         | 
| 
       59 
     | 
    
         
            -
                < 
     | 
| 
       60 
     | 
    
         
            -
              <h3 
     | 
| 
      
 57 
     | 
    
         
            +
                <div id="parent-class-section" class="nav-section">
         
     | 
| 
      
 58 
     | 
    
         
            +
              <h3>Parent</h3>
         
     | 
| 
      
 59 
     | 
    
         
            +
             
     | 
| 
       61 
60 
     | 
    
         | 
| 
       62 
61 
     | 
    
         
             
              <p class="link"><a href="ChannelEvent.html">MIDI::ChannelEvent</a>
         
     | 
| 
       63 
62 
     | 
    
         | 
| 
       64 
     | 
    
         
            -
            </ 
     | 
| 
      
 63 
     | 
    
         
            +
            </div>
         
     | 
| 
       65 
64 
     | 
    
         | 
| 
       66 
65 
     | 
    
         | 
| 
      
 66 
     | 
    
         
            +
                
         
     | 
| 
       67 
67 
     | 
    
         
             
                <!-- Method Quickref -->
         
     | 
| 
       68 
     | 
    
         
            -
            < 
     | 
| 
       69 
     | 
    
         
            -
              <h3 
     | 
| 
      
 68 
     | 
    
         
            +
            <div id="method-list-section" class="nav-section">
         
     | 
| 
      
 69 
     | 
    
         
            +
              <h3>Methods</h3>
         
     | 
| 
       70 
70 
     | 
    
         | 
| 
       71 
     | 
    
         
            -
              <ul class="link-list">
         
     | 
| 
      
 71 
     | 
    
         
            +
              <ul class="link-list" role="directory">
         
     | 
| 
       72 
72 
     | 
    
         | 
| 
       73 
     | 
    
         
            -
                <li><a href="#method-c-new">::new</a>
         
     | 
| 
      
 73 
     | 
    
         
            +
                <li class="calls-super" ><a href="#method-c-new">::new</a>
         
     | 
| 
       74 
74 
     | 
    
         | 
| 
       75 
     | 
    
         
            -
                <li><a href="#method-i-data_as_bytes">#data_as_bytes</a>
         
     | 
| 
      
 75 
     | 
    
         
            +
                <li ><a href="#method-i-data_as_bytes">#data_as_bytes</a>
         
     | 
| 
       76 
76 
     | 
    
         | 
| 
       77 
     | 
    
         
            -
                <li><a href="#method-i-note_to_s">#note_to_s</a>
         
     | 
| 
      
 77 
     | 
    
         
            +
                <li ><a href="#method-i-note_to_s">#note_to_s</a>
         
     | 
| 
       78 
78 
     | 
    
         | 
| 
       79 
     | 
    
         
            -
                <li><a href="#method-i-pch_oct">#pch_oct</a>
         
     | 
| 
      
 79 
     | 
    
         
            +
                <li ><a href="#method-i-pch_oct">#pch_oct</a>
         
     | 
| 
       80 
80 
     | 
    
         | 
| 
       81 
81 
     | 
    
         
             
              </ul>
         
     | 
| 
       82 
     | 
    
         
            -
            </ 
     | 
| 
      
 82 
     | 
    
         
            +
            </div>
         
     | 
| 
       83 
83 
     | 
    
         | 
| 
       84 
84 
     | 
    
         
             
              </div>
         
     | 
| 
       85 
     | 
    
         
            -
             
     | 
| 
       86 
     | 
    
         
            -
              <div id="project-metadata">
         
     | 
| 
       87 
     | 
    
         
            -
                <nav id="fileindex-section" class="section project-section">
         
     | 
| 
       88 
     | 
    
         
            -
              <h3 class="section-header">Pages</h3>
         
     | 
| 
       89 
     | 
    
         
            -
             
     | 
| 
       90 
     | 
    
         
            -
              <ul>
         
     | 
| 
       91 
     | 
    
         
            -
              
         
     | 
| 
       92 
     | 
    
         
            -
                <li class="file"><a href="../README_rdoc.html">README</a>
         
     | 
| 
       93 
     | 
    
         
            -
              
         
     | 
| 
       94 
     | 
    
         
            -
                <li class="file"><a href="../TODO_rdoc.html">TODO</a>
         
     | 
| 
       95 
     | 
    
         
            -
              
         
     | 
| 
       96 
     | 
    
         
            -
              </ul>
         
     | 
| 
       97 
85 
     | 
    
         
             
            </nav>
         
     | 
| 
       98 
86 
     | 
    
         | 
| 
       99 
     | 
    
         
            -
             
     | 
| 
       100 
     | 
    
         
            -
              < 
     | 
| 
      
 87 
     | 
    
         
            +
            <main role="main" aria-labelledby="class-MIDI::NoteEvent">
         
     | 
| 
      
 88 
     | 
    
         
            +
              <h1 id="class-MIDI::NoteEvent" class="class">
         
     | 
| 
      
 89 
     | 
    
         
            +
                class MIDI::NoteEvent
         
     | 
| 
      
 90 
     | 
    
         
            +
              </h1>
         
     | 
| 
       101 
91 
     | 
    
         | 
| 
       102 
     | 
    
         
            -
              < 
     | 
| 
       103 
     | 
    
         
            -
              
         
     | 
| 
       104 
     | 
    
         
            -
                <li><a href="../MIDI.html">MIDI</a>
         
     | 
| 
       105 
     | 
    
         
            -
              
         
     | 
| 
       106 
     | 
    
         
            -
                <li><a href="../MIDI/ActiveSense.html">MIDI::ActiveSense</a>
         
     | 
| 
       107 
     | 
    
         
            -
              
         
     | 
| 
       108 
     | 
    
         
            -
                <li><a href="../MIDI/ChannelEvent.html">MIDI::ChannelEvent</a>
         
     | 
| 
       109 
     | 
    
         
            -
              
         
     | 
| 
       110 
     | 
    
         
            -
                <li><a href="../MIDI/ChannelPressure.html">MIDI::ChannelPressure</a>
         
     | 
| 
       111 
     | 
    
         
            -
              
         
     | 
| 
       112 
     | 
    
         
            -
                <li><a href="../MIDI/Clock.html">MIDI::Clock</a>
         
     | 
| 
       113 
     | 
    
         
            -
              
         
     | 
| 
       114 
     | 
    
         
            -
                <li><a href="../MIDI/Continue.html">MIDI::Continue</a>
         
     | 
| 
       115 
     | 
    
         
            -
              
         
     | 
| 
       116 
     | 
    
         
            -
                <li><a href="../MIDI/Controller.html">MIDI::Controller</a>
         
     | 
| 
       117 
     | 
    
         
            -
              
         
     | 
| 
       118 
     | 
    
         
            -
                <li><a href="../MIDI/Event.html">MIDI::Event</a>
         
     | 
| 
       119 
     | 
    
         
            -
              
         
     | 
| 
       120 
     | 
    
         
            -
                <li><a href="../MIDI/IO.html">MIDI::IO</a>
         
     | 
| 
       121 
     | 
    
         
            -
              
         
     | 
| 
       122 
     | 
    
         
            -
                <li><a href="../MIDI/IO/MIDIFile.html">MIDI::IO::MIDIFile</a>
         
     | 
| 
       123 
     | 
    
         
            -
              
         
     | 
| 
       124 
     | 
    
         
            -
                <li><a href="../MIDI/IO/SeqReader.html">MIDI::IO::SeqReader</a>
         
     | 
| 
       125 
     | 
    
         
            -
              
         
     | 
| 
       126 
     | 
    
         
            -
                <li><a href="../MIDI/IO/SeqWriter.html">MIDI::IO::SeqWriter</a>
         
     | 
| 
       127 
     | 
    
         
            -
              
         
     | 
| 
       128 
     | 
    
         
            -
                <li><a href="../MIDI/KeySig.html">MIDI::KeySig</a>
         
     | 
| 
       129 
     | 
    
         
            -
              
         
     | 
| 
       130 
     | 
    
         
            -
                <li><a href="../MIDI/MIDI.html">MIDI::MIDI</a>
         
     | 
| 
       131 
     | 
    
         
            -
              
         
     | 
| 
       132 
     | 
    
         
            -
                <li><a href="../MIDI/MIDI/MIDI.html">MIDI::MIDI::MIDI</a>
         
     | 
| 
       133 
     | 
    
         
            -
              
         
     | 
| 
       134 
     | 
    
         
            -
                <li><a href="../MIDI/MIDI/MIDI/Array.html">MIDI::MIDI::MIDI::Array</a>
         
     | 
| 
       135 
     | 
    
         
            -
              
         
     | 
| 
       136 
     | 
    
         
            -
                <li><a href="../MIDI/Marker.html">MIDI::Marker</a>
         
     | 
| 
       137 
     | 
    
         
            -
              
         
     | 
| 
       138 
     | 
    
         
            -
                <li><a href="../MIDI/Measure.html">MIDI::Measure</a>
         
     | 
| 
       139 
     | 
    
         
            -
              
         
     | 
| 
       140 
     | 
    
         
            -
                <li><a href="../MIDI/Measures.html">MIDI::Measures</a>
         
     | 
| 
       141 
     | 
    
         
            -
              
         
     | 
| 
       142 
     | 
    
         
            -
                <li><a href="../MIDI/MetaEvent.html">MIDI::MetaEvent</a>
         
     | 
| 
       143 
     | 
    
         
            -
              
         
     | 
| 
       144 
     | 
    
         
            -
                <li><a href="../MIDI/NoteEvent.html">MIDI::NoteEvent</a>
         
     | 
| 
       145 
     | 
    
         
            -
              
         
     | 
| 
       146 
     | 
    
         
            -
                <li><a href="../MIDI/NoteOff.html">MIDI::NoteOff</a>
         
     | 
| 
       147 
     | 
    
         
            -
              
         
     | 
| 
       148 
     | 
    
         
            -
                <li><a href="../MIDI/NoteOff.html">MIDI::NoteOffEvent</a>
         
     | 
| 
       149 
     | 
    
         
            -
              
         
     | 
| 
       150 
     | 
    
         
            -
                <li><a href="../MIDI/NoteOn.html">MIDI::NoteOn</a>
         
     | 
| 
       151 
     | 
    
         
            -
              
         
     | 
| 
       152 
     | 
    
         
            -
                <li><a href="../MIDI/NoteOn.html">MIDI::NoteOnEvent</a>
         
     | 
| 
       153 
     | 
    
         
            -
              
         
     | 
| 
       154 
     | 
    
         
            -
                <li><a href="../MIDI/PitchBend.html">MIDI::PitchBend</a>
         
     | 
| 
       155 
     | 
    
         
            -
              
         
     | 
| 
       156 
     | 
    
         
            -
                <li><a href="../MIDI/PolyPressure.html">MIDI::PolyPressure</a>
         
     | 
| 
       157 
     | 
    
         
            -
              
         
     | 
| 
       158 
     | 
    
         
            -
                <li><a href="../MIDI/ProgramChange.html">MIDI::ProgramChange</a>
         
     | 
| 
       159 
     | 
    
         
            -
              
         
     | 
| 
       160 
     | 
    
         
            -
                <li><a href="../MIDI/Realtime.html">MIDI::Realtime</a>
         
     | 
| 
       161 
     | 
    
         
            -
              
         
     | 
| 
       162 
     | 
    
         
            -
                <li><a href="../MIDI/Sequence.html">MIDI::Sequence</a>
         
     | 
| 
       163 
     | 
    
         
            -
              
         
     | 
| 
       164 
     | 
    
         
            -
                <li><a href="../MIDI/SongPointer.html">MIDI::SongPointer</a>
         
     | 
| 
       165 
     | 
    
         
            -
              
         
     | 
| 
       166 
     | 
    
         
            -
                <li><a href="../MIDI/SongSelect.html">MIDI::SongSelect</a>
         
     | 
| 
       167 
     | 
    
         
            -
              
         
     | 
| 
       168 
     | 
    
         
            -
                <li><a href="../MIDI/Start.html">MIDI::Start</a>
         
     | 
| 
       169 
     | 
    
         
            -
              
         
     | 
| 
       170 
     | 
    
         
            -
                <li><a href="../MIDI/Stop.html">MIDI::Stop</a>
         
     | 
| 
       171 
     | 
    
         
            -
              
         
     | 
| 
       172 
     | 
    
         
            -
                <li><a href="../MIDI/SystemCommon.html">MIDI::SystemCommon</a>
         
     | 
| 
       173 
     | 
    
         
            -
              
         
     | 
| 
       174 
     | 
    
         
            -
                <li><a href="../MIDI/SystemExclusive.html">MIDI::SystemExclusive</a>
         
     | 
| 
       175 
     | 
    
         
            -
              
         
     | 
| 
       176 
     | 
    
         
            -
                <li><a href="../MIDI/SystemReset.html">MIDI::SystemReset</a>
         
     | 
| 
       177 
     | 
    
         
            -
              
         
     | 
| 
       178 
     | 
    
         
            -
                <li><a href="../MIDI/Tempo.html">MIDI::Tempo</a>
         
     | 
| 
       179 
     | 
    
         
            -
              
         
     | 
| 
       180 
     | 
    
         
            -
                <li><a href="../MIDI/TimeSig.html">MIDI::TimeSig</a>
         
     | 
| 
       181 
     | 
    
         
            -
              
         
     | 
| 
       182 
     | 
    
         
            -
                <li><a href="../MIDI/Track.html">MIDI::Track</a>
         
     | 
| 
       183 
     | 
    
         
            -
              
         
     | 
| 
       184 
     | 
    
         
            -
                <li><a href="../MIDI/TuneRequest.html">MIDI::TuneRequest</a>
         
     | 
| 
       185 
     | 
    
         
            -
              
         
     | 
| 
       186 
     | 
    
         
            -
                <li><a href="../MIDI/Utils.html">MIDI::Utils</a>
         
     | 
| 
       187 
     | 
    
         
            -
              
         
     | 
| 
       188 
     | 
    
         
            -
                <li><a href="../IO.html">IO</a>
         
     | 
| 
       189 
     | 
    
         
            -
              
         
     | 
| 
       190 
     | 
    
         
            -
              </ul>
         
     | 
| 
       191 
     | 
    
         
            -
            </nav>
         
     | 
| 
       192 
     | 
    
         
            -
             
     | 
| 
       193 
     | 
    
         
            -
              </div>
         
     | 
| 
       194 
     | 
    
         
            -
            </nav>
         
     | 
| 
       195 
     | 
    
         
            -
             
     | 
| 
       196 
     | 
    
         
            -
            <div id="documentation">
         
     | 
| 
       197 
     | 
    
         
            -
              <h1 class="class">class MIDI::NoteEvent</h1>
         
     | 
| 
       198 
     | 
    
         
            -
             
     | 
| 
       199 
     | 
    
         
            -
              <div id="description" class="description">
         
     | 
| 
      
 92 
     | 
    
         
            +
              <section class="description">
         
     | 
| 
       200 
93 
     | 
    
         | 
| 
       201 
94 
     | 
    
         
             
            <p>The abstract superclass of all note on, and note off, and polyphonic
         
     | 
| 
       202 
95 
     | 
    
         
             
            pressure events.</p>
         
     | 
| 
       203 
96 
     | 
    
         | 
| 
       204 
     | 
    
         
            -
              </ 
     | 
| 
      
 97 
     | 
    
         
            +
              </section>
         
     | 
| 
       205 
98 
     | 
    
         | 
| 
       206 
99 
     | 
    
         | 
| 
       207 
100 
     | 
    
         | 
| 
         @@ -212,14 +105,15 @@ pressure events.</p> 
     | 
|
| 
       212 
105 
     | 
    
         | 
| 
       213 
106 
     | 
    
         | 
| 
       214 
107 
     | 
    
         | 
| 
       215 
     | 
    
         
            -
                 
     | 
| 
       216 
     | 
    
         
            -
             
     | 
| 
       217 
     | 
    
         
            -
             
     | 
| 
      
 108 
     | 
    
         
            +
                <section class="constants-list">
         
     | 
| 
      
 109 
     | 
    
         
            +
                  <header>
         
     | 
| 
      
 110 
     | 
    
         
            +
                    <h3>Constants</h3>
         
     | 
| 
      
 111 
     | 
    
         
            +
                  </header>
         
     | 
| 
       218 
112 
     | 
    
         
             
                  <dl>
         
     | 
| 
       219 
113 
     | 
    
         | 
| 
       220 
114 
     | 
    
         
             
                    <dt id="PITCHES">PITCHES
         
     | 
| 
       221 
115 
     | 
    
         | 
| 
       222 
     | 
    
         
            -
                    <dd 
     | 
| 
      
 116 
     | 
    
         
            +
                    <dd>
         
     | 
| 
       223 
117 
     | 
    
         | 
| 
       224 
118 
     | 
    
         | 
| 
       225 
119 
     | 
    
         
             
                  </dl>
         
     | 
| 
         @@ -227,9 +121,10 @@ pressure events.</p> 
     | 
|
| 
       227 
121 
     | 
    
         | 
| 
       228 
122 
     | 
    
         | 
| 
       229 
123 
     | 
    
         | 
| 
       230 
     | 
    
         
            -
                 
     | 
| 
       231 
     | 
    
         
            -
             
     | 
| 
       232 
     | 
    
         
            -
             
     | 
| 
      
 124 
     | 
    
         
            +
                <section class="attribute-method-details" class="method-section">
         
     | 
| 
      
 125 
     | 
    
         
            +
                  <header>
         
     | 
| 
      
 126 
     | 
    
         
            +
                    <h3>Attributes</h3>
         
     | 
| 
      
 127 
     | 
    
         
            +
                  </header>
         
     | 
| 
       233 
128 
     | 
    
         | 
| 
       234 
129 
     | 
    
         | 
| 
       235 
130 
     | 
    
         
             
                  <div id="attribute-i-note" class="method-detail">
         
     | 
| 
         @@ -258,13 +153,14 @@ pressure events.</p> 
     | 
|
| 
       258 
153 
     | 
    
         
             
                    </div>
         
     | 
| 
       259 
154 
     | 
    
         
             
                  </div>
         
     | 
| 
       260 
155 
     | 
    
         | 
| 
       261 
     | 
    
         
            -
                </section 
     | 
| 
      
 156 
     | 
    
         
            +
                </section>
         
     | 
| 
       262 
157 
     | 
    
         | 
| 
       263 
158 
     | 
    
         | 
| 
       264 
     | 
    
         
            -
                <!-- Methods -->
         
     | 
| 
       265 
159 
     | 
    
         | 
| 
       266 
     | 
    
         
            -
                 <section id="public-class-5Buntitled-5D-method-details" class="method-section 
     | 
| 
       267 
     | 
    
         
            -
             
     | 
| 
      
 160 
     | 
    
         
            +
                 <section id="public-class-5Buntitled-5D-method-details" class="method-section">
         
     | 
| 
      
 161 
     | 
    
         
            +
                   <header>
         
     | 
| 
      
 162 
     | 
    
         
            +
                     <h3>Public Class Methods</h3>
         
     | 
| 
      
 163 
     | 
    
         
            +
                   </header>
         
     | 
| 
       268 
164 
     | 
    
         | 
| 
       269 
165 
     | 
    
         | 
| 
       270 
166 
     | 
    
         
             
                  <div id="method-c-new" class="method-detail ">
         
     | 
| 
         @@ -272,7 +168,9 @@ pressure events.</p> 
     | 
|
| 
       272 
168 
     | 
    
         
             
                    <div class="method-heading">
         
     | 
| 
       273 
169 
     | 
    
         
             
                      <span class="method-name">new</span><span
         
     | 
| 
       274 
170 
     | 
    
         
             
                        class="method-args">(status, channel, note, velocity, delta_time)</span>
         
     | 
| 
      
 171 
     | 
    
         
            +
                      
         
     | 
| 
       275 
172 
     | 
    
         
             
                      <span class="method-click-advice">click to toggle source</span>
         
     | 
| 
      
 173 
     | 
    
         
            +
                      
         
     | 
| 
       276 
174 
     | 
    
         
             
                    </div>
         
     | 
| 
       277 
175 
     | 
    
         | 
| 
       278 
176 
     | 
    
         | 
| 
         @@ -280,29 +178,37 @@ pressure events.</p> 
     | 
|
| 
       280 
178 
     | 
    
         | 
| 
       281 
179 
     | 
    
         | 
| 
       282 
180 
     | 
    
         | 
| 
      
 181 
     | 
    
         
            +
                      
         
     | 
| 
      
 182 
     | 
    
         
            +
                        <div class="method-calls-super">
         
     | 
| 
      
 183 
     | 
    
         
            +
                          Calls superclass method
         
     | 
| 
      
 184 
     | 
    
         
            +
                          <a href="ChannelEvent.html#method-c-new">MIDI::ChannelEvent.new</a>
         
     | 
| 
      
 185 
     | 
    
         
            +
                        </div>
         
     | 
| 
      
 186 
     | 
    
         
            +
                      
         
     | 
| 
       283 
187 
     | 
    
         | 
| 
       284 
188 
     | 
    
         | 
| 
       285 
189 
     | 
    
         
             
                      <div class="method-source-code" id="new-source">
         
     | 
| 
       286 
     | 
    
         
            -
                        <pre><span class="ruby-comment"># File lib/midilib/event.rb, line  
     | 
| 
      
 190 
     | 
    
         
            +
                        <pre><span class="ruby-comment"># File lib/midilib/event.rb, line 104</span>
         
     | 
| 
       287 
191 
     | 
    
         
             
            <span class="ruby-keyword">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">status</span>, <span class="ruby-identifier">channel</span>, <span class="ruby-identifier">note</span>, <span class="ruby-identifier">velocity</span>, <span class="ruby-identifier">delta_time</span>)
         
     | 
| 
       288 
     | 
    
         
            -
             
     | 
| 
       289 
     | 
    
         
            -
             
     | 
| 
       290 
     | 
    
         
            -
             
     | 
| 
      
 192 
     | 
    
         
            +
              <span class="ruby-keyword">super</span>(<span class="ruby-identifier">status</span>, <span class="ruby-identifier">channel</span>, <span class="ruby-identifier">delta_time</span>)
         
     | 
| 
      
 193 
     | 
    
         
            +
              <span class="ruby-ivar">@note</span> = <span class="ruby-identifier">note</span>
         
     | 
| 
      
 194 
     | 
    
         
            +
              <span class="ruby-ivar">@velocity</span> = <span class="ruby-identifier">velocity</span>
         
     | 
| 
       291 
195 
     | 
    
         
             
            <span class="ruby-keyword">end</span></pre>
         
     | 
| 
       292 
     | 
    
         
            -
                      </div 
     | 
| 
      
 196 
     | 
    
         
            +
                      </div>
         
     | 
| 
       293 
197 
     | 
    
         | 
| 
       294 
198 
     | 
    
         
             
                    </div>
         
     | 
| 
       295 
199 
     | 
    
         | 
| 
       296 
200 
     | 
    
         | 
| 
       297 
201 
     | 
    
         | 
| 
       298 
202 
     | 
    
         | 
| 
       299 
     | 
    
         
            -
                  </div 
     | 
| 
      
 203 
     | 
    
         
            +
                  </div>
         
     | 
| 
       300 
204 
     | 
    
         | 
| 
       301 
205 
     | 
    
         | 
| 
       302 
     | 
    
         
            -
                </section 
     | 
| 
      
 206 
     | 
    
         
            +
                </section>
         
     | 
| 
       303 
207 
     | 
    
         | 
| 
       304 
     | 
    
         
            -
                 <section id="public-instance-5Buntitled-5D-method-details" class="method-section 
     | 
| 
       305 
     | 
    
         
            -
             
     | 
| 
      
 208 
     | 
    
         
            +
                 <section id="public-instance-5Buntitled-5D-method-details" class="method-section">
         
     | 
| 
      
 209 
     | 
    
         
            +
                   <header>
         
     | 
| 
      
 210 
     | 
    
         
            +
                     <h3>Public Instance Methods</h3>
         
     | 
| 
      
 211 
     | 
    
         
            +
                   </header>
         
     | 
| 
       306 
212 
     | 
    
         | 
| 
       307 
213 
     | 
    
         | 
| 
       308 
214 
     | 
    
         
             
                  <div id="method-i-data_as_bytes" class="method-detail ">
         
     | 
| 
         @@ -310,7 +216,9 @@ pressure events.</p> 
     | 
|
| 
       310 
216 
     | 
    
         
             
                    <div class="method-heading">
         
     | 
| 
       311 
217 
     | 
    
         
             
                      <span class="method-name">data_as_bytes</span><span
         
     | 
| 
       312 
218 
     | 
    
         
             
                        class="method-args">()</span>
         
     | 
| 
      
 219 
     | 
    
         
            +
                      
         
     | 
| 
       313 
220 
     | 
    
         
             
                      <span class="method-click-advice">click to toggle source</span>
         
     | 
| 
      
 221 
     | 
    
         
            +
                      
         
     | 
| 
       314 
222 
     | 
    
         
             
                    </div>
         
     | 
| 
       315 
223 
     | 
    
         | 
| 
       316 
224 
     | 
    
         | 
| 
         @@ -318,24 +226,25 @@ pressure events.</p> 
     | 
|
| 
       318 
226 
     | 
    
         | 
| 
       319 
227 
     | 
    
         | 
| 
       320 
228 
     | 
    
         | 
| 
      
 229 
     | 
    
         
            +
                      
         
     | 
| 
       321 
230 
     | 
    
         | 
| 
       322 
231 
     | 
    
         | 
| 
       323 
232 
     | 
    
         
             
                      <div class="method-source-code" id="data_as_bytes-source">
         
     | 
| 
       324 
     | 
    
         
            -
                        <pre><span class="ruby-comment"># File lib/midilib/event.rb, line  
     | 
| 
      
 233 
     | 
    
         
            +
                        <pre><span class="ruby-comment"># File lib/midilib/event.rb, line 126</span>
         
     | 
| 
       325 
234 
     | 
    
         
             
            <span class="ruby-keyword">def</span> <span class="ruby-identifier">data_as_bytes</span>
         
     | 
| 
       326 
     | 
    
         
            -
             
     | 
| 
       327 
     | 
    
         
            -
             
     | 
| 
       328 
     | 
    
         
            -
             
     | 
| 
       329 
     | 
    
         
            -
             
     | 
| 
      
 235 
     | 
    
         
            +
              <span class="ruby-identifier">data</span> = []
         
     | 
| 
      
 236 
     | 
    
         
            +
              <span class="ruby-identifier">data</span> <span class="ruby-operator"><<</span> (<span class="ruby-ivar">@status</span> <span class="ruby-operator">+</span> <span class="ruby-ivar">@channel</span>)
         
     | 
| 
      
 237 
     | 
    
         
            +
              <span class="ruby-identifier">data</span> <span class="ruby-operator"><<</span> <span class="ruby-ivar">@note</span>
         
     | 
| 
      
 238 
     | 
    
         
            +
              <span class="ruby-identifier">data</span> <span class="ruby-operator"><<</span> <span class="ruby-ivar">@velocity</span>
         
     | 
| 
       330 
239 
     | 
    
         
             
            <span class="ruby-keyword">end</span></pre>
         
     | 
| 
       331 
     | 
    
         
            -
                      </div 
     | 
| 
      
 240 
     | 
    
         
            +
                      </div>
         
     | 
| 
       332 
241 
     | 
    
         | 
| 
       333 
242 
     | 
    
         
             
                    </div>
         
     | 
| 
       334 
243 
     | 
    
         | 
| 
       335 
244 
     | 
    
         | 
| 
       336 
245 
     | 
    
         | 
| 
       337 
246 
     | 
    
         | 
| 
       338 
     | 
    
         
            -
                  </div 
     | 
| 
      
 247 
     | 
    
         
            +
                  </div>
         
     | 
| 
       339 
248 
     | 
    
         | 
| 
       340 
249 
     | 
    
         | 
| 
       341 
250 
     | 
    
         
             
                  <div id="method-i-note_to_s" class="method-detail ">
         
     | 
| 
         @@ -343,7 +252,9 @@ pressure events.</p> 
     | 
|
| 
       343 
252 
     | 
    
         
             
                    <div class="method-heading">
         
     | 
| 
       344 
253 
     | 
    
         
             
                      <span class="method-name">note_to_s</span><span
         
     | 
| 
       345 
254 
     | 
    
         
             
                        class="method-args">()</span>
         
     | 
| 
      
 255 
     | 
    
         
            +
                      
         
     | 
| 
       346 
256 
     | 
    
         
             
                      <span class="method-click-advice">click to toggle source</span>
         
     | 
| 
      
 257 
     | 
    
         
            +
                      
         
     | 
| 
       347 
258 
     | 
    
         
             
                    </div>
         
     | 
| 
       348 
259 
     | 
    
         | 
| 
       349 
260 
     | 
    
         | 
| 
         @@ -353,21 +264,22 @@ pressure events.</p> 
     | 
|
| 
       353 
264 
     | 
    
         
             
            href="NoteEvent.html#method-i-pch_oct">#pch_oct</a>(val) else returns value
         
     | 
| 
       354 
265 
     | 
    
         
             
            as a number using number_to_s.</p>
         
     | 
| 
       355 
266 
     | 
    
         | 
| 
      
 267 
     | 
    
         
            +
                      
         
     | 
| 
       356 
268 
     | 
    
         | 
| 
       357 
269 
     | 
    
         | 
| 
       358 
270 
     | 
    
         
             
                      <div class="method-source-code" id="note_to_s-source">
         
     | 
| 
       359 
     | 
    
         
            -
                        <pre><span class="ruby-comment"># File lib/midilib/event.rb, line  
     | 
| 
      
 271 
     | 
    
         
            +
                        <pre><span class="ruby-comment"># File lib/midilib/event.rb, line 122</span>
         
     | 
| 
       360 
272 
     | 
    
         
             
            <span class="ruby-keyword">def</span> <span class="ruby-identifier">note_to_s</span>
         
     | 
| 
       361 
     | 
    
         
            -
             
     | 
| 
      
 273 
     | 
    
         
            +
              <span class="ruby-keyword">return</span> <span class="ruby-ivar">@print_note_names</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">pch_oct</span>(<span class="ruby-ivar">@note</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">number_to_s</span>(<span class="ruby-ivar">@note</span>)
         
     | 
| 
       362 
274 
     | 
    
         
             
            <span class="ruby-keyword">end</span></pre>
         
     | 
| 
       363 
     | 
    
         
            -
                      </div 
     | 
| 
      
 275 
     | 
    
         
            +
                      </div>
         
     | 
| 
       364 
276 
     | 
    
         | 
| 
       365 
277 
     | 
    
         
             
                    </div>
         
     | 
| 
       366 
278 
     | 
    
         | 
| 
       367 
279 
     | 
    
         | 
| 
       368 
280 
     | 
    
         | 
| 
       369 
281 
     | 
    
         | 
| 
       370 
     | 
    
         
            -
                  </div 
     | 
| 
      
 282 
     | 
    
         
            +
                  </div>
         
     | 
| 
       371 
283 
     | 
    
         | 
| 
       372 
284 
     | 
    
         | 
| 
       373 
285 
     | 
    
         
             
                  <div id="method-i-pch_oct" class="method-detail ">
         
     | 
| 
         @@ -375,43 +287,45 @@ as a number using number_to_s.</p> 
     | 
|
| 
       375 
287 
     | 
    
         
             
                    <div class="method-heading">
         
     | 
| 
       376 
288 
     | 
    
         
             
                      <span class="method-name">pch_oct</span><span
         
     | 
| 
       377 
289 
     | 
    
         
             
                        class="method-args">(val=@note)</span>
         
     | 
| 
      
 290 
     | 
    
         
            +
                      
         
     | 
| 
       378 
291 
     | 
    
         
             
                      <span class="method-click-advice">click to toggle source</span>
         
     | 
| 
      
 292 
     | 
    
         
            +
                      
         
     | 
| 
       379 
293 
     | 
    
         
             
                    </div>
         
     | 
| 
       380 
294 
     | 
    
         | 
| 
       381 
295 
     | 
    
         | 
| 
       382 
296 
     | 
    
         
             
                    <div class="method-description">
         
     | 
| 
       383 
297 
     | 
    
         | 
| 
       384 
     | 
    
         
            -
                      <p>Returns note name as a pitch/octave string like  
     | 
| 
      
 298 
     | 
    
         
            +
                      <p>Returns note name as a pitch/octave string like “C4” or “F#6”.</p>
         
     | 
| 
      
 299 
     | 
    
         
            +
                      
         
     | 
| 
       385 
300 
     | 
    
         | 
| 
       386 
301 
     | 
    
         | 
| 
       387 
302 
     | 
    
         | 
| 
       388 
303 
     | 
    
         
             
                      <div class="method-source-code" id="pch_oct-source">
         
     | 
| 
       389 
     | 
    
         
            -
                        <pre><span class="ruby-comment"># File lib/midilib/event.rb, line  
     | 
| 
      
 304 
     | 
    
         
            +
                        <pre><span class="ruby-comment"># File lib/midilib/event.rb, line 114</span>
         
     | 
| 
       390 
305 
     | 
    
         
             
            <span class="ruby-keyword">def</span> <span class="ruby-identifier">pch_oct</span>(<span class="ruby-identifier">val</span>=<span class="ruby-ivar">@note</span>)
         
     | 
| 
       391 
     | 
    
         
            -
             
     | 
| 
       392 
     | 
    
         
            -
             
     | 
| 
       393 
     | 
    
         
            -
             
     | 
| 
      
 306 
     | 
    
         
            +
              <span class="ruby-identifier">pch</span> = <span class="ruby-identifier">val</span> <span class="ruby-operator">%</span> <span class="ruby-value">12</span>
         
     | 
| 
      
 307 
     | 
    
         
            +
              <span class="ruby-identifier">oct</span> = (<span class="ruby-identifier">val</span> <span class="ruby-operator">/</span> <span class="ruby-value">12</span>) <span class="ruby-operator">-</span> <span class="ruby-value">1</span>
         
     | 
| 
      
 308 
     | 
    
         
            +
              <span class="ruby-node">"#{PITCHES[pch]}#{oct}"</span>
         
     | 
| 
       394 
309 
     | 
    
         
             
            <span class="ruby-keyword">end</span></pre>
         
     | 
| 
       395 
     | 
    
         
            -
                      </div 
     | 
| 
      
 310 
     | 
    
         
            +
                      </div>
         
     | 
| 
       396 
311 
     | 
    
         | 
| 
       397 
312 
     | 
    
         
             
                    </div>
         
     | 
| 
       398 
313 
     | 
    
         | 
| 
       399 
314 
     | 
    
         | 
| 
       400 
315 
     | 
    
         | 
| 
       401 
316 
     | 
    
         | 
| 
       402 
     | 
    
         
            -
                  </div 
     | 
| 
      
 317 
     | 
    
         
            +
                  </div>
         
     | 
| 
       403 
318 
     | 
    
         | 
| 
       404 
319 
     | 
    
         | 
| 
       405 
     | 
    
         
            -
                </section 
     | 
| 
      
 320 
     | 
    
         
            +
                </section>
         
     | 
| 
       406 
321 
     | 
    
         | 
| 
       407 
     | 
    
         
            -
              </section 
     | 
| 
       408 
     | 
    
         
            -
             
     | 
| 
       409 
     | 
    
         
            -
            </div><!-- documentation -->
         
     | 
| 
      
 322 
     | 
    
         
            +
              </section>
         
     | 
| 
      
 323 
     | 
    
         
            +
            </main>
         
     | 
| 
       410 
324 
     | 
    
         | 
| 
       411 
325 
     | 
    
         | 
| 
       412 
     | 
    
         
            -
            <footer id="validator-badges">
         
     | 
| 
       413 
     | 
    
         
            -
              <p><a href="http://validator.w3.org/check/referer"> 
     | 
| 
       414 
     | 
    
         
            -
              <p>Generated by <a href=" 
     | 
| 
       415 
     | 
    
         
            -
              <p> 
     | 
| 
      
 326 
     | 
    
         
            +
            <footer id="validator-badges" role="contentinfo">
         
     | 
| 
      
 327 
     | 
    
         
            +
              <p><a href="http://validator.w3.org/check/referer">Validate</a>
         
     | 
| 
      
 328 
     | 
    
         
            +
              <p>Generated by <a href="http://docs.seattlerb.org/rdoc/">RDoc</a> 4.2.0.
         
     | 
| 
      
 329 
     | 
    
         
            +
              <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
         
     | 
| 
       416 
330 
     | 
    
         
             
            </footer>
         
     | 
| 
       417 
331 
     | 
    
         |