home *** CD-ROM | disk | FTP | other *** search
/ Sound, Music & MIDI Collection 2 / SMMVOL2.bin / DOS / DOS_MIS / PIANO15.ZIP / PIANO.INF (.txt) < prev   
Encoding:
OS/2 Help File  |  1995-08-03  |  33.1 KB  |  839 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. Piano is a Presentation Manager application (for OS/2 2.x) that turns your 
  5. computer into a MIDI controller.  In other words, it allows you to play notes 
  6. on external MIDI sound modules from your computer's keyboard and mouse via a 
  7. MIDI Interface.  If you have a sound card with a built-in sound module that is 
  8. triggered via MIDI notes (such as a Turtle Beach MultiSound or Roland RAP-10, 
  9. SCC-1, or other such cards, with appropriate OS/2 driver), then you can play 
  10. those like musical instruments as well.  Piano also allows you to generate many 
  11. other types of MIDI data such as Volume, Pan, Effects Level, Chorus Level, 
  12. Pitch Wheel, Modulation Wheel, AfterTouch (Key Pressure), and Channel Pressure 
  13. so that if your MIDI sound module supports these MIDI messages, you can control 
  14. the module appropriately. 
  15.  
  16.  
  17. Some of the words in this manual are highlighted in bold text, such as Program 
  18. Change.  These are words that refer to controls (ie, buttons, sliders, 
  19. checkboxes) which you manipulate in Piano's window.  Other words are in colored 
  20. text such as Channel Pressure.  These refer to MIDI messages (ie, data). 
  21. Underlined words, such as Pitch Wheel, refer to hardware, such as if I was 
  22. referring to the Pitch Wheel on your MIDI unit.  Words that are in colored text 
  23. such as Read This are meant to be emphasized.  Words in italics refer to 
  24. aspects of OS/2. 
  25.  
  26. Piano is version 1.5, copyright 1995 by Jeff Glatt.  Piano is freely 
  27. redistributable, provided that no internal modifications are made to PIANO.EXE, 
  28. or this document. 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 2. Driver Requirements and Setup ΓòÉΓòÉΓòÉ
  32.  
  33. Piano requires that your MIDI interface or Sound Card has an OS/2 driver. 
  34. Information sent to this driver via DosWrite() must be interpreted as MIDI 
  35. data.  (It would have to be a rather strange driver if it didn't interpret data 
  36. in this way, but if you're using a sound card with WAVE playback in addition to 
  37. a MIDI interface, it's conceivable that the Sound Card might interpret 
  38. DosWrite() data to be WAVE data). 
  39.  
  40. You must also know your driver's internal name (which might be different than 
  41. the filename of the driver).  Often, this is the driver filename minus the .SYS 
  42. extension.  For example, I use a Roland RAP-10 audio card which has an MPU-401 
  43. compatible MIDI interface built into it.  There is a shareware OS/2 driver 
  44. available for the MPU-401 by the following manufacturer: 
  45.  
  46. Delta Music Systems 
  47. 2615 Ginghamsburg-Frederick Rd. 
  48. Tipp City, OH 45371 
  49.  
  50. This driver's internal name is MPU401.  It properly interprets DosWrite() data 
  51. as MIDI data, and ships it out of any MPU-401 compatible interface.  So, you 
  52. can use this driver with Piano, and any card that has an MPU-401 compatible 
  53. interface (in hardware, not just a software driver simulation). 
  54.  
  55. By default, Piano will use that driver, and so you don't have to supply it with 
  56. that name.  If you want Piano to use a different driver, then you must supply 
  57. the name of the driver to Piano.  If you run piano from an OS/2 Command Prompt, 
  58. then simply type the name of your driver as an argument. 
  59.  
  60. If you run Piano from a Desktop icon, open up the Settings menu for that 
  61. program.  In the Parameters field, type the name of your driver.  Now whenever 
  62. you run Piano from the Desktop, it will use that driver. 
  63.  
  64. Note:  Remember to omit the .SYS extension from the driver name.
  65.  
  66. If Piano can't open the specified driver, it will display an error dialog box. 
  67. At this point, the program will run, but it won't really do anything. 
  68.  
  69. Note:  Piano is not an MMPM app.  It doesn't use MMPM drivers.  It only uses 
  70.        drivers that follow the same scheme as the DMS driver.  Tell IBM to fix 
  71.        up their Physical Device Driver model so that it isn't an archaic 16-bit 
  72.        thing harking back to the days of MS-DOS 2.0's driver scheme, and maybe 
  73.        I'll do something with MMPM drivers.
  74.  
  75. Piano also requires that GENMIDI.DLL (included in this archive) be copied to 
  76. some directory along the path specified by the LIBPATH statement in your 
  77. config.sys file.  Often, placing it in the same directory to which PIANO.EXE is 
  78. copied will suffice. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 3. Options ΓòÉΓòÉΓòÉ
  82.  
  83. When starting Piano, there are a number of optional parameters that can be 
  84. specified.  If running Piano from a Command Prompt Window, then add the 
  85. parameters to the command line.  If running Piano from a Presentation Manager 
  86. Object (ie, icon), then open up the Settings menu for that object, and in the 
  87. Parameters field, type the desired options (ie, where you also put the driver 
  88. name).  Now whenever you run Piano from the Desktop, it will use those options. 
  89. You could even create several program objects (by copying the Program object in 
  90. OS/2's Template folder), and give each one different options tailored for 
  91. various MIDI devices (and also give each object a unique name).  For example, 
  92. to specify the driver MPU401 with channel 7: 
  93.  
  94. MPU401 /C7 
  95.  
  96. If not using the Delta Music Systems driver, then specify the /N option.  This 
  97. will cause Piano to skip some MPU-401 initialization code for that driver.  For 
  98. example, to use a driver called "RAP10", skipping initialization. 
  99.  
  100. RAP10 /N 
  101.  
  102. Some sound cards, such as the RAP-10, have a built-in General MIDI (GM) sound 
  103. module.  The module will not play MIDI messages sent to it until it receives a 
  104. "Turn GM Sound On" MIDI System Exclusive Message (although the card may still 
  105. pass MIDI messages on to its MIDI OUT jack).  Initially, Piano will send such a 
  106. MIDI message unless you specify the /G option.  This will prevent Piano from 
  107. turning on the GM Sound Module (if you desire) of a card that supports this 
  108. MIDI message. 
  109.  
  110. By default, Piano starts with only MIDI channel 1 selected.  You can override 
  111. this, and specify which MIDI channel(s) that Piano should select upon startup. 
  112. You specify the /C option, and then follow this with the desired MIDI channels 
  113. to select, each separated by a comma.  For example, to select channels 3 and 4 
  114. initially: 
  115.  
  116. /C3,4 
  117.  
  118. By default, Piano starts with mouse button 2 emulating a Hold Pedal.  You can 
  119. specify a different controller for mouse button 2 to emulate via the /B2 
  120. option.  Follow the option with a comma, and then the new controller number (in 
  121. decimal).  For example, to specify the Hold2 Pedal Controller (ie, 69) for 
  122. mouse button 2: 
  123.  
  124. /B2,69 
  125.  
  126. By default, Piano starts with mouse button 3 emulating a Portamento On/Off 
  127. switch.  You can specify a different controller for mouse button 3 to emulate 
  128. via the /B3 option.  Follow the option with a comma, and then the new 
  129. controller number (in decimal).  For example, to specify the Data Increment 
  130. (Button) Controller (ie, 96) for mouse button 3: 
  131.  
  132. /B3,96 
  133.  
  134. By default, Piano starts with the "Effect" slider (ie, 2nd slider from the top 
  135. of the window) set to send Effects Level Controller (#91).  You can specify a 
  136. different controller for this slider via the /B1 option.  Follow the option 
  137. with a comma, and then the new controller number (in decimal).  For example, to 
  138. specify the Breath (ie, Wind) Coarse Controller (ie, 2) for this slider: 
  139.  
  140. /B1,2 
  141.  
  142. For the mouse button 2 and 3, and "Effect" slider, you can also specify the 
  143. controller name (ie, as it appears in Piano's drop down list).  For example, 
  144. instead of controller #69, you can specify "Hold2".  If the controller name has 
  145. an imbedded space, such as "Genr 1", then enclose the option in parentheses, 
  146. such as: 
  147.  
  148. "/B1,Genr 1" 
  149.  
  150. Initially, Piano also sends out All Notes Off and Reset Controllers MIDI 
  151. messages on the selected MIDI channels.  On MIDI devices that acknowledge these 
  152. messages, this turns off any sounding notes, and usually resets the Pitch Wheel 
  153. to center, the MOD wheel to 0 (ie, off), releases the Hold Pedal, turns off any 
  154. Pressure or Aftertouch effects, and may reset other controllers.  (Check your 
  155. device's MIDI implementation chart for its response to the Reset Controllers 
  156. MIDI message).  If you don't want Piano to send these messages initially, then 
  157. specify the /Z option.  If you specify this option, note that the state of 
  158. Piano's sliders and Program may not reflect the true state of the MIDI device. 
  159. Of course, you can always press Piano's Reset button to force the MIDI device 
  160. to be set to the state of Piano's sliders and buttons, but this also sets the 
  161. sliders to default values as well as turning off the controllers associated 
  162. with Mouse 2 and Mouse 3. 
  163.  
  164. Note:  You can specify options (and the driver name) in any order.  For options 
  165.        that require additional text, such as the /M option, you must not leave 
  166.        blank spaces between the option and additional text, unless you enclose 
  167.        the entire option in quotes.
  168.  
  169.  
  170. ΓòÉΓòÉΓòÉ 4. MultiTimbral Modules ΓòÉΓòÉΓòÉ
  171.  
  172. Some MIDI modules are "multi-timbral".  This means that the module can listen 
  173. to all 16 MIDI channels, and play any 16 of its "patches" simultaneously, with 
  174. each of the 16 patches set to a different MIDI channel.  It's as if the module 
  175. had 16 smaller modules inside of it, with each being able to play a patch on 
  176. its own MIDI channel. 
  177.  
  178. So is there a name for these 16 "sub-modules" inside of your MIDI module? 
  179. Well, different manufacturers refer to them in different ways, and I'm going to 
  180. use the Roland preference, a Part.  A Roland multi-timbral module has 16 Parts 
  181. inside of it, and each usually has its own settings for such things as Volume, 
  182. Panning, Reverb and Chorus levels, Brightness, and its MIDI channel (ie, which 
  183. MIDI data the Part "plays").  Furthermore, each Part has its own way of 
  184. reacting to MIDI data such as Channel Pressure (often used to adjust volume or 
  185. brightness), MOD Wheel controller (often used for a vibrato effect), and Pitch 
  186. Wheel (used to slide the pitch up and down).  For example, one Part can cause 
  187. its patch to sound brighter when it receives Channel Pressure messages that 
  188. increase in value.  On the other hand, another Part could make its volume 
  189. increase when it receives increasing Channel Pressure messages.  These Parts 
  190. are completely independent of each other.  Just because one Part is receiving a 
  191. Pitch Wheel message and bending its pitch doesn't mean that another Part has to 
  192. do the same. 
  193.  
  194.  
  195. ΓòÉΓòÉΓòÉ 5. General MIDI Standard ΓòÉΓòÉΓòÉ
  196.  
  197. Nowadays, most MIDI modules have specific Patches setup in a specific order 
  198. according to a standard known as General MIDI (or GM).  All this means is that 
  199. on every GM module, a Piano patch must be the very first patch.  Patch #49 must 
  200. be a Flute.  Patch #25 must be a Nylon String Guitar.  Etc.  There are 128 
  201. defined patches that a GM module must have, in the proper order. 
  202.  
  203. Note:  When you drop down the list box for Piano's Program, you'll see all 128 
  204.        GM Patch names.
  205.  
  206. Furthermore, all patches must sound a middle C when receiving a MIDI note 
  207. number of 60.  This corresponds to setting the QWERTY Octave to 6 and pressing 
  208. the z key. 
  209.  
  210. If the GM module also has a built-in "drum module" (ie, usually one of 16 
  211. Parts), then each of that Drum Part's MIDI notes triggers a different drum 
  212. sound.  Particular drum sounds are assigned to particular MIDI note numbers. 
  213. For example, a Closed HiHat sound is set to note number 42.  The Drum Part is 
  214. usually set to receive MIDI data on channel 10, and some devices with a 
  215. built-in drum module have this module permanently set to MIDI channel 10. 
  216.  
  217. Note:  The QWERTY keyboard counts its octaves from 1.  Most MIDI devices count 
  218.        their octaves from -2.  What this means is that, to play the Snare 1 
  219.        sound, which is a D2 (ie, a D note in octave 2), set the QWERTY keyboard 
  220.        to octave 4 (ie, 2 octaves higher than written) and play the z key (ie, 
  221.        a D note).
  222.  
  223.  
  224. ΓòÉΓòÉΓòÉ 6. Piano Window ΓòÉΓòÉΓòÉ
  225.  
  226. When run, Piano opens a Presentation Manager window that has a number of 
  227. controls that you can operate to do 2 things: 
  228.  
  229.  1. Setup how the QWERTY (computer) keyboard operates.  These controls don't 
  230.     change settings on your MIDI modules, but rather, affect how your computer 
  231.     controls those modules.  In other words, if your computer was a real MIDI 
  232.     controller, it would need some means of setting itself to a particular MIDI 
  233.     channel(s), and perhaps offer features such as being able to transpose its 
  234.     "piano keyboard" (if it were a keyboard controller), etc.  These controls 
  235.     setup the controller, rather than the external modules that are slaved to 
  236.     the controller. 
  237.  
  238.  2. Directly generate MIDI events with sliders, buttons, and the QWERTY 
  239.     keyboard.  These MIDI events are what control and change settings on the 
  240.     external modules. 
  241.  
  242. You exit Piano by selecting Close from its System Menu, or double-clicking on 
  243. the window upper left corner icon. 
  244.  
  245.  
  246. ΓòÉΓòÉΓòÉ 6.1. QWERTY Keyboard ΓòÉΓòÉΓòÉ
  247.  
  248. The QWERTY keyboard is just the bottom 2 rows of your computer keyboard, which 
  249. are setup as if they were the black and white keys on a piano keyboard.  The z 
  250. key corresponds to a D note.  Therefore, the x key next to it would correspond 
  251. to a E note.  You'll note that the s key is above and inbetween the z and x 
  252. keys.  As you might expect, this would be a D# key.  The left SHIFT key is the 
  253. C key.  This physical piano keyboard extends all of the way up to the right 
  254. SHIFT key which represents a high G.  In other words, it has an octave and a 
  255. half range. 
  256.  
  257. When you press down one of these keys, it sends a MIDI Note On message to your 
  258. MIDI interface on each of the MIDI channels that you have selected.  The net 
  259. result is that it will play this one note on each sound module that is assigned 
  260. to one of those selected MIDI channels. 
  261.  
  262. Note:  By default, the QWERTY keyboard is set to output MIDI data on only MIDI 
  263.        Channel 1 (unless you specify the /C option when starting Piano).  If 
  264.        your external module allows you to set its MIDI channel, make sure that 
  265.        it is set to the same channel as the QWERTY keyboard (or vice versa).
  266.  
  267. You can even press down several keys simultaneously and play a chord.  For 
  268. example, press the left SHIFT, x, and v keys simultaneously to hear a C Major 
  269. chord.  When you release the keys, the QWERTY keyboard sends the appropriate 
  270. Note Off messages to your MIDI interface on each of the selected MIDI channels. 
  271.  
  272. You'll notice that there is a picture of a piano keyboard in the QWERTY window. 
  273. You can move the mouse pointer over one of the keys on this graphical piano, 
  274. and click the mouse button 1 to sound that note (ie, in lieu of using the 
  275. computer keyboard).  When you release the mouse button, the note stops playing. 
  276. (ie, A Note Off is sent). 
  277.  
  278. There is a checkbox for each of the 16 MIDI Channels.  Make sure that a 
  279. channel's box is checked if you want the QWERTY keyboard to output upon that 
  280. channel.  You can check as many of those channels as desired, and the QWERTY 
  281. keyboard will broadcast its notes on all of those channels simultaneously. 
  282. Because the QWERTY keyboard is "multi-channel", it allows you to play any 
  283. combination of sound modules (set to various MIDI channels), at any time.  So, 
  284. you could use the QWERTY keyboard to easily play all of your MIDI modules or 
  285. check the setup of those modules. 
  286.  
  287. Note:  You must have at least one channel selected in order for any MIDI 
  288.        messages to be sent.
  289.  
  290. By default, the left SHIFT key is middle C, but you can change the octave that 
  291. the QWERTY keyboard plays within by using the Octave spin button.  Click on 
  292. either the up or down arrows to increment/decrement the octave, or click into 
  293. the text field, type the desired octave (1 to 10), and press ENTER. 
  294.  
  295. If you ever get any "stuck" notes, use the All Notes Off button to turn them 
  296. off.  If you really get into big trouble with stuck notes, and odd controller 
  297. settings, click on the Reset button. 
  298.  
  299. By default, MIDI Note On messages are sent with a velocity of 127 (ie, the 
  300. highest possible velocity).  Generally, velocity is used to set the volume on a 
  301. per note basis, although some modules can use velocity for other effects such 
  302. as adjust attack time of a voltage controlled generator (VCA).  Your computer 
  303. keyboard does not generate velocity information (which is how fast you press 
  304. and release the keys).  Piano allows you to set the QWERTY keyboard to one of 
  305. 12 preset velocity ranges.  The 12 Function keys represent those 12 levels, 
  306. with function key 12 being full velocity (ie, 127).  So, you can change the 
  307. velocity while you're playing by pressing the function keys. 
  308.  
  309.  
  310. ΓòÉΓòÉΓòÉ 6.2. MIDI (Mouse) Buttons and Effect Slider ΓòÉΓòÉΓòÉ
  311.  
  312. Mouse button 1 is always used to play the graphical piano, or manipulate 
  313. Piano's window and controls. 
  314.  
  315. By default, mouse button 2 simulates a Hold Pedal, and sends MIDI Hold Pedal 
  316. Controller messages.  When you push the button down (and hold it down), the 
  317. hold pedal is on.  When you release the button, the hold pedal is also 
  318. released.  In other words, this is a "momentary pedal" because it's only on 
  319. while you hold the button down.  You can specify a different controller for 
  320. mouse button 2 to emulate by using the Mouse 2 control.  See the Mouse 2 
  321. section for details. 
  322.  
  323. By default, mouse button 3 simulates a Portamento On/Off switch, and sends MIDI 
  324. Portamento On/Off Controller messages.  When you push the button down, 
  325. Portamento is toggled on or off (ie, if it was previously off, it's now on, and 
  326. vice versa).  This is not a momentary pedal because, when you toggle it on, it 
  327. stays on until you press mouse button 3 again (at which time it is toggled 
  328. off).  When the switch is "on", an asterisk appears next to the controller name 
  329. selected for Mouse 3.  If the switch is off, there is no asterisk.  You can 
  330. specify a different controller for mouse button 3 to emulate by using the Mouse 
  331. 3 control.  See the Mouse 3 section for details. 
  332.  
  333. By default, the "Effect" slider (ie, 2nd slider from the top of the window) 
  334. sends MIDI Effects Level Controller (#91).  Various MIDI devices may interpret 
  335. this in different ways (if at all).  For example, Roland devices that have a 
  336. built-in reverb unit often use this for the reverb level.  You can specify a 
  337. different controller for this slider by typing the desired Controller number 
  338. (in decimal) or Controller name into the entry field next to the slider, or 
  339. dropping down the list of defined Controller names and selecting one. 
  340.  
  341. Mouse button 2 is good for emulating controllers that normally are associated 
  342. with momentary Pedals, such as Hold, Hold2, Soft, and Sustenuto pedals, whereas 
  343. button 3 is good for controllers normally associated with Foot Switches, such 
  344. as Data +/-, Portamento On/Off, Local keyboard On/Off, etc.  The "Effect" 
  345. slider is suited for continuous MIDI controllers; controllers that have more 
  346. than just an "on" and "off" state, such as Breath controller, Mod wheel, Foot 
  347. pedal, PTme (Portamento time), etc. 
  348.  
  349. Any continuous controller has both a coarse and fine controller number.  For 
  350. example, there is a controller number (10) that adjusts the Pan Position in 
  351. coarse amounts.  It offers 128 "coarse" Pan positions.  There is another 
  352. controller number (42) that adjusts Pan in fine increments.  It offers 128 
  353. "fine" increments in between two, consecutive coarse settings.  So, you could 
  354. use the Pan coarse controller to set a sound to one of the 128 coarse 
  355. positions, and then use the Pan fine controller to adjust the Pan to one of the 
  356. 128 fine increments that fall between the current coarse position and the next 
  357. coarse position.  Some MIDI devices only respond to the coarse controllers and 
  358. do not implement the fine controllers (ie, for example, a device may only 
  359. implement the 128 coarse pan positions, and allow no fine adjustments to 
  360. those).  In Piano's drop down list of defined controllers, an H at the end of 
  361. the name refers to coarse (ie, high resolution) controller, and an L refers to 
  362. fine (ie, low resolution) controller. 
  363.  
  364.  
  365. ΓòÉΓòÉΓòÉ 6.3. MIDI Sliders ΓòÉΓòÉΓòÉ
  366.  
  367. As mentioned, Piano generates MIDI Note On and Note Off messages on the 
  368. selected MIDI channels when you play the QWERTY keyboard.  Virtually all MIDI 
  369. modules respond to these messages.  But, there are many more types of MIDI 
  370. messages that Piano can generate and send to your MIDI module.  The sliders on 
  371. the left side of the window generate some of these different types of MIDI 
  372. messages. 
  373.  
  374. Note:  Not all MIDI sound modules respond to all of these types of MIDI 
  375.        messages.  In particular, old and very cheap equipment may not respond 
  376.        to any of these messages.  If you get a response to the QWERTY keyboard 
  377.        (ie, the MIDI module makes some sound), but a particular slider doesn't 
  378.        seem to be having any effect, then you're probably dealing with such 
  379.        limited equipment.  On the other hand, sophisticated gear often allows 
  380.        you to turn on/off the module's response to these types of messages, so 
  381.        check your unit's setup.
  382.  
  383. You operate a slider by "grabbing" its knob with mouse button 1 and moving it 
  384. to a new position.  You have to "let go" (ie, release the mouse button) before 
  385. Piano sends out any MIDI message (and you perhaps hear the result on your MIDI 
  386. sound module).  Alternately, if you want to increment/decrement the knob's 
  387. position, move the mouse pointer inside of the slider's shaft, but not on top 
  388. of the knob itself (ie, to either side of the knob), and click the mouse button 
  389. 1 once.  If you're to the left of the knob, it will decrement by 1 position, 
  390. and a MIDI message will be sent.  If you're to the right of the knob, it will 
  391. increment by 1 position, and a MIDI message will be sent. 
  392.  
  393. Note:  Each slider has a small arrow above it.  (The arrow may be in different 
  394.        positions on different sliders).  This arrow marks the default position 
  395.        of the slider.  If you want to quickly set the slider to this default 
  396.        position, click on that arrow, and the knob will move to that position, 
  397.        and send out an appropriate MIDI message.  This is very handy for such 
  398.        things as Pan and Pitch since the default is to center the Pan and Pitch 
  399.        wheel.  Note that when Piano is first started or when you change the 
  400.        MIDI channel checkboxes, the settings shown for the sliders may not 
  401.        reflect the actual state of your external MIDI modules.  You could click 
  402.        on a default arrow in order to send a slider's setting to your module, 
  403.        or use the Reset button.
  404.  
  405. You can hold down a key on the QWERTY keyboard to sound a note on your external 
  406. module.  Then, without releasing the key (ie, so that the note on the external 
  407. module is still sounding), you can operate a slider.  If your external unit 
  408. responds to such a MIDI message while sounding a note, then you will hear the 
  409. result on the currently sounding note.  In fact, that's really how AfterTouch 
  410. and Channel Pressure are meant to be applied.  Some modules won't make changes 
  411. to any already sounding notes, so you'll have to release the note and play it 
  412. again in order to hear the results of moving a slider.  You don't have to be 
  413. playing a note when you move a slider.  You can simply move the slider, and 
  414. then play a note to hear the result.  It's just that moving a slider while 
  415. listening to a note sounding can give you a much clearer sonic idea of what 
  416. that slider is doing to the sound (assuming that your module responds to the 
  417. slider's MIDI messages). 
  418.  
  419. Note:  Remember that if you "grab and move" the slider's knob with the mouse, 
  420.        you must eventually "let go" of the knob in order for Piano to send any 
  421.        MIDI message.
  422.  
  423. Some modules use AfterTouch and Channel Pressure to affect the Brightness of 
  424. the sound (ie, Filter cutoff), or Volume, or some other such parameter. 
  425. Normally, AfterTouch and Channel Pressure are generated by pressing harder and 
  426. softer on the piano keyboard while you're holding down a note.  Obviously, your 
  427. computer's keyboard doesn't generate AfterTouch and Channel Pressure.  If you 
  428. press down harder, you'll only break it.  So, when you release notes after 
  429. having adjusted the AfterTouch or Pressure sliders, you may wish to click on 
  430. the respective default arrow to turn the effect off (which is what would happen 
  431. as you released the keys on a real controller).  If you're adjusting the 
  432. AfterTouch slider, you should only play one note at a time, and reset 
  433. AfterTouch to default upon releasing each note, since AfterTouch only works on 
  434. the last key that you've played (ie, Piano doesn't fully implement Aftertouch). 
  435. The Reset button also resets AfterTouch and Channel Pressure (as well as the 
  436. other sliders). 
  437.  
  438.  
  439. ΓòÉΓòÉΓòÉ 6.4. Controls ΓòÉΓòÉΓòÉ
  440.  
  441. What follows is a description of the controls in the Piano window; what they 
  442. control, and additional notes about any MIDI information that they send. 
  443.  
  444.  
  445. ΓòÉΓòÉΓòÉ 6.4.1. Program ΓòÉΓòÉΓòÉ
  446.  
  447. Affects        Which one of its Patches, Presets, or Instruments the MIDI 
  448.                module will play.  If the module is a MultiTimbral unit, then it 
  449.                usually can play 16 "Parts" at once, each receiving data upon 
  450.                its own MIDI channel.  This changes all Parts (which are set to 
  451.                one of the selected MIDI channels) to use that one chosen GM 
  452.                Patch. 
  453.  
  454.                Note:  If a module's Part receives a Program Change message on 
  455.                       the channel to which it is assigned, then its Patch will 
  456.                       change to the program number embedded in that message. 
  457.                       For example, assume that a Part is set to MIDI channel 1, 
  458.                       and its Patch is set to Grand Piano.  If a Program Change 
  459.                       message with a program number of 41 is sent on MIDI 
  460.                       channel 1, then the Part will switch to the Violin (ie, 
  461.                       which is GM Patch #41).  A Program Change can be sent 
  462.                       while the Part is playing -- even while the Part is 
  463.                       playing some Grand Piano notes.  The Part will simply 
  464.                       play subsequent MIDI notes using the new Patch. 
  465.  
  466. Range          One of the 128 GM Patches.  You pick out which one from the list 
  467.                box (by clicking on it), or type in the desired Patch name and 
  468.                press the ENTER key.  If you prefer to deal with numbers, 
  469.                especially if you're dealing with a non-GM MIDI device, you can 
  470.                instead type in the desired Patch number (where 1 is the first 
  471.                Patch) and press the ENTER key.  In this case, Piano will always 
  472.                display the respective GM Patch name.  If you type in the Patch 
  473.                name, you may enter only as many characters as are needed for 
  474.                Piano to find a matching name.  For example, if you type "Gran" 
  475.                (or "Piano") and press ENTER, then Piano will match this as 
  476.                "Grand Piano".  If you type "harp" and press ENTER, Piano will 
  477.                match this with "Harpsichord" (since that comes before "Harp"). 
  478.  
  479.                Note:  It doesn't matter whether you type the name in upper or 
  480.                       lower case.
  481.  
  482.  
  483. ΓòÉΓòÉΓòÉ 6.4.2. Pan ΓòÉΓòÉΓòÉ
  484.  
  485. Affects        Where within the stereo field the module will be placed.  If the 
  486.                module is a MultiTimbral unit, then each one of its Parts 
  487.                usually has its own pan position.  This changes the pan of all 
  488.                Parts assigned to one of the selected MIDI channels. 
  489.  
  490.                Note:  If the Part receives a Pan Controller message on the 
  491.                       channel to which it is assigned, then its pan will change 
  492.                       to the value embedded in that message.  For example, 
  493.                       assume that a Part is set to MIDI channel 1, and is 
  494.                       panned hard left.  If a Pan Controller message with a 
  495.                       value of 64 (ie, center) is sent on MIDI channel 1, then 
  496.                       the Part's sound will switch to center position.  A Pan 
  497.                       Controller can be sent while the Part is playing -- even 
  498.                       while the Part is playing some notes.  The Part will 
  499.                       simply play with a new pan position. 
  500.  
  501. Range          128 possible positions, with 0 being hard left, 64 being center, 
  502.                and 127 being hard right.  You must center the slider's knob for 
  503.                center pan (ie, where the default arrow is), and moving the knob 
  504.                to the left or right pans in those directions respectively. 
  505.                (This is the coarse controller for Pan). 
  506.  
  507.  
  508. ΓòÉΓòÉΓòÉ 6.4.3. Chorus ΓòÉΓòÉΓòÉ
  509.  
  510. Affects        The chorus effect amount (ie, level) for the module.  If the 
  511.                module is a MultiTimbral unit, then each one of its Parts 
  512.                usually has its own chorus level.  This changes the chorus level 
  513.                of all Parts assigned to one of the selected MIDI channels. 
  514.  
  515.                Note:  If the Part receives a Chorus Controller message on the 
  516.                       channel to which it is assigned, then its Chorus Level 
  517.                       will change to the value embedded in that message.  For 
  518.                       example, assume that a Part is set to MIDI channel 1, and 
  519.                       has a Chorus Level of 64.  If a Chorus Controller message 
  520.                       with a value of 0 is sent on MIDI channel 1, then the 
  521.                       Part will switch to having no chorus (ie, chorus 
  522.                       level=0).  A Chorus Controller can be sent while the Part 
  523.                       is playing -- even while the Part is playing some notes. 
  524.                       The Part will simply play with a new chorus effect level. 
  525.  
  526. Range          0 to 127, with 0 being no chorus effect applied at all.  Moving 
  527.                the fader all the way to the left gives a chorus level of 0. 
  528.  
  529.  
  530. ΓòÉΓòÉΓòÉ 6.4.4. Volume ΓòÉΓòÉΓòÉ
  531.  
  532. Affects        The MIDI module's volume.  If the module is a MultiTimbral unit, 
  533.                then each one of its Parts usually has its own volume.  This 
  534.                changes the volumes of all Parts assigned to one of the selected 
  535.                MIDI channels. 
  536.  
  537.                Note:  If a Part receives a Volume Controller message on the 
  538.                       channel to which it is assigned, then its Volume will 
  539.                       change to the value embedded in that message.  For 
  540.                       example, assume that a Part is set to MIDI channel 1, and 
  541.                       has a Volume of 127.  If a Volume Controller message with 
  542.                       a value of 64 is sent on MIDI channel 1, then the Part's 
  543.                       volume will drop by half.  A Volume Controller can be 
  544.                       sent while the Part is playing -- even while the Part is 
  545.                       playing some notes.  The Part will simply play with a new 
  546.                       Volume. 
  547.  
  548. Range          0 to 127, with 0 being no volume at all.  Moving the fader all 
  549.                the way to the left gives a volume of 0.  (This is the coarse 
  550.                controller for volume). 
  551.  
  552.  
  553. ΓòÉΓòÉΓòÉ 6.4.5. MOD Wheel ΓòÉΓòÉΓòÉ
  554.  
  555. Affects        Sends MOD Wheel messages to the MIDI module.  If the module is a 
  556.                MultiTimbral unit, then each one of its Parts may respond 
  557.                differently (or not at all) to MOD Wheel.  This sends a MOD 
  558.                Wheel message to all Parts assigned to one of the selected MIDI 
  559.                channels. 
  560.  
  561.                Note:  If a Part receives a MOD Wheel Controller message on the 
  562.                       channel to which it is assigned, then it may or may not 
  563.                       do something depending upon how the Part is set to 
  564.                       respond to this message.  Usually, MOD Wheel introduces 
  565.                       some sort of vibrato effect.  For example, assume that a 
  566.                       Part is set to MIDI channel 1.  If a MOD Wheel Controller 
  567.                       message with a value of 64 is sent on MIDI channel 1, 
  568.                       then a medium vibrato effect may be applied to the Part's 
  569.                       sound.  A MOD Wheel Controller can be sent while the Part 
  570.                       is playing -- even while the Part is playing some notes. 
  571.                       A vibrato effect will simply be applied to any sounding 
  572.                       notes. 
  573.  
  574. Range          0 to 127, with 0 being no modulation.  (This is the coarse 
  575.                controller for MOD wheel). 
  576.  
  577.  
  578. ΓòÉΓòÉΓòÉ 6.4.6. Pitch Wheel ΓòÉΓòÉΓòÉ
  579.  
  580. Affects        Sends Pitch Wheel messages to the MIDI module.  If the module is 
  581.                a MultiTimbral unit, then each one of its Parts may or may not 
  582.                respond to Pitch Wheel.  This sends a Pitch Wheel message to all 
  583.                Parts assigned to one of the selected MIDI channels. 
  584.  
  585.                Note:  If a Part receives a Pitch Wheel message on the channel 
  586.                       to which it is assigned, then it may or may shift its 
  587.                       pitch up/down depending upon whether the Part is set to 
  588.                       respond to this message.  A value of 64 (MSB only) is 
  589.                       centered pitch, and values below that shift the pitch 
  590.                       downward, whereas values above shift the pitch upward. 
  591.                       For example, assume that a Part is set to MIDI channel 1. 
  592.                       If a Pitch Wheel message with a value of 95 (MSB only) is 
  593.                       sent on MIDI channel 1, then the pitch shifts upward.  A 
  594.                       Pitch Wheel can be sent while the Part is playing -- even 
  595.                       while the Part is playing some notes.  The pitch will 
  596.                       simply shift accordingly. 
  597.  
  598. Range          0 to 127, with 64 being no pitch shift (ie, center position). 
  599.  
  600.                Note:  Piano only sends the MSB of Pitch Wheel.  In other words, 
  601.                       its a coarse adjustment only. 
  602.  
  603.  
  604. ΓòÉΓòÉΓòÉ 6.4.7. Pressure ΓòÉΓòÉΓòÉ
  605.  
  606. Affects        Sends Channel Pressure messages to the MIDI module.  If the 
  607.                module is a MultiTimbral unit, then each one of its Parts may 
  608.                respond differently (or not at all) to Channel Pressure.  This 
  609.                sends a Channel Pressure message to all Parts assigned to one of 
  610.                the selected MIDI channels. 
  611.  
  612.                Note:  If a Part receives a Channel Pressure message on the 
  613.                       channel to which it is assigned, then it may or may not 
  614.                       do something depending upon how the Part is set to 
  615.                       respond to this message.  Usually, Channel Pressure 
  616.                       adjusts the brightness (ie, filter cutoff), the volume, 
  617.                       and/or introduces some sort of vibrato effect.  For 
  618.                       example, assume that a Part is set to MIDI channel 1.  If 
  619.                       a Channel Pressure message with a value of 64 is sent on 
  620.                       MIDI channel 1, then a medium vibrato effect may be 
  621.                       applied to the Part's sound.  Channel Pressure can be 
  622.                       sent while the Part is playing -- even while the Part is 
  623.                       playing some notes.  Some effect will simply be applied 
  624.                       to any sounding notes.  Indeed, Channel Pressure is 
  625.                       usually generated by pressing harder or softer on the 
  626.                       keys while holding them down (ie, so you are playing some 
  627.                       notes).  So, Channel Pressure is meant to affect sounding 
  628.                       notes in some way. 
  629.  
  630. Range          0 to 127, with 0 being no channel pressure (ie, off). 
  631.  
  632.  
  633. ΓòÉΓòÉΓòÉ 6.4.8. AfterTouch ΓòÉΓòÉΓòÉ
  634.  
  635. Affects        Sends AfterTouch messages (sometimes referred to as Key 
  636.                Pressure) to the MIDI module.  If the module is a MultiTimbral 
  637.                unit, then each one of its Parts may respond differently (or not 
  638.                at all) to these messages.  This sends an AfterTouch message to 
  639.                all Parts assigned to one of the selected MIDI channels. 
  640.  
  641.                Note:  If a Part receives an AfterTouch message on the channel 
  642.                       to which it is assigned, then it may or may not do 
  643.                       something depending upon how the Part is set to respond 
  644.                       to this message.  Usually, AfterTouch adjusts the 
  645.                       brightness (ie, filter cutoff), the volume, and/or 
  646.                       introduces some sort of vibrato effect.  For example, 
  647.                       assume that a Part is set to MIDI channel 1.  If an 
  648.                       AfterTouch message with a value of 64 is sent on MIDI 
  649.                       channel 1, then a medium vibrato effect may be applied 
  650.                       one of the Part's sounding notes.  AfterTouch can be sent 
  651.                       while the Part is playing -- even while the Part is 
  652.                       playing some notes.  Some effect will simply be applied 
  653.                       to the note corresponding to the message.  Indeed, 
  654.                       AfterTouch is usually generated by pressing harder or 
  655.                       softer on a key while holding it down (ie, so you are 
  656.                       playing a note).  So, AfterTouch is meant to affect a 
  657.                       sounding note in some way.  What's the difference between 
  658.                       AfterTouch and Channel Pressure?  Well, AfterTouch 
  659.                       messages are for individual keys.  Every key that you 
  660.                       press down generates its own AfterTouch messages.  If you 
  661.                       press on one key harder than another, then the one key 
  662.                       will generate AfterTouch messages with higher values than 
  663.                       the other key.  The net result is that some effect will 
  664.                       be applied to the one key more than the other key.  You 
  665.                       have individual control over each key that you play. 
  666.                       With Channel Pressure, one message is sent out for the 
  667.                       entire keyboard.  So, if you press one key harder than 
  668.                       another, the module will average out the difference, and 
  669.                       then just pretend that you're pressing both keys with the 
  670.                       exact same pressure.  The net result is that some effect 
  671.                       gets applied to all sounding keys evenly.  You don't have 
  672.                       individual control per each key.  A controller would use 
  673.                       either Channel Pressure or AfterTouch, but usually not 
  674.                       both.  Most MIDI controllers don't generate AfterTouch 
  675.                       because the circuitry required is a bit too costly. 
  676.                       Piano's QWERTY keyboard is no exception.  (Hey, you got 
  677.                       it free.  What do you expect?).  It only generates 
  678.                       AfterTouch messages for the last key that you play.  If 
  679.                       you play a chord, only one of the notes gets the 
  680.                       AfterTouch effect when you move the slider (ie, the last 
  681.                       one that you pressed down).  Ideally, there should be 
  682.                       AfterTouch messages happening for each key being held 
  683.                       down, but that's irrelevant here because your computer 
  684.                       keyboard doesn't have some way of detecting pressure for 
  685.                       each key, and it would be impractical to be adjusting an 
  686.                       AfterTouch slider for every key that you hold down.  You 
  687.                       should avoid playing chords while adjusting the 
  688.                       AfterTouch slider.  If you do, you may need to Reset in 
  689.                       order to clear aftertouch from all of the keys that you 
  690.                       played. 
  691.  
  692. Range          0 to 127, with 0 being no aftertouch (ie, off). 
  693.  
  694.  
  695. ΓòÉΓòÉΓòÉ 6.4.9. Effect ΓòÉΓòÉΓòÉ
  696.  
  697. Affects        This slider can be set to emulate any one of the 128 possible 
  698.                MIDI controllers.  By default, it emulates the effects level for 
  699.                the module.  If the module is a MultiTimbral unit, then each one 
  700.                of its Parts usually has its own effects level.  This changes 
  701.                the effects level of all Parts assigned to one of the selected 
  702.                MIDI channels.  Various MIDI devices may respond to effects 
  703.                controller differently (if at all).  Some Roland devices with a 
  704.                built-in reverb unit, use Effects controller to set the reverb 
  705.                amount. 
  706.  
  707.                Note:  If the Part receives a MIDI Effects Controller message on 
  708.                       the channel to which it is assigned, and the device uses 
  709.                       that to adjust reverb amount, then its Reverb Level will 
  710.                       change to the value embedded in that message.  For 
  711.                       example, assume that a Part is set to MIDI channel 1, and 
  712.                       has a Reverb Level of 64.  If an Effects Controller 
  713.                       message with a value of 0 is sent on MIDI channel 1, then 
  714.                       the Part will switch to having no reverb (ie, reverb 
  715.                       level=0).  An Effects Controller can be sent while the 
  716.                       Part is playing -- even while the Part is playing some 
  717.                       notes.  The Part will simply play with a new reverb 
  718.                       level. 
  719.  
  720.                When you select a new controller for the Effect slider, this new 
  721.                controller is initially set to whatever value the slider is set 
  722.                to (ie, if the slider is all of the way to the right, then the 
  723.                controller's value is set to 127). 
  724.  
  725. Range          0 to 127, with 0 being no effects applied at all.  Moving the 
  726.                fader all the way to the left gives an effects level of 0. 
  727.  
  728.  
  729. ΓòÉΓòÉΓòÉ 6.4.10. All Notes Off ΓòÉΓòÉΓòÉ
  730.  
  731. Affects        This button sends Note Off messages to the MIDI module for any 
  732.                notes that Piano thinks are still "on".  Due to the way that 
  733.                Presentation Manager works, it's possible for Piano to not "see" 
  734.                a mouse button up message (ie, some other app may get it). 
  735.                Clicking on this button forces Piano to turn off all notes that 
  736.                it played and didn't turn off even though you may no longer be 
  737.                pressing the mouse button over the graphical piano, or holding 
  738.                down a key on the computer. 
  739.  
  740.                Piano also sends All Notes Off Controller and All Sound Off 
  741.                Controller messages on the MIDI channels that you have selected, 
  742.                as an extra precaution to turn off any "stuck notes".  See the 
  743.                remarks about such in the Reset description. 
  744.  
  745.  
  746. ΓòÉΓòÉΓòÉ 6.4.11. Reset ΓòÉΓòÉΓòÉ
  747.  
  748. Affects        This is a more drastic reset than the All Notes Off button.  The 
  749.                latter button only turns off notes.  This button also resets 
  750.                various controllers to default values, and resets the Program on 
  751.                the MIDI channels that you have selected. 
  752.  
  753.                This button sends All Notes Off Controller, All Sound Off 
  754.                Controller, and Reset Controllers messages on all 16 MIDI 
  755.                channels.  Note that some older or cheap MIDI gear does not 
  756.                implement some of these special controller messages.  (ie, On 
  757.                some gear, you have to send an individual MIDI Note Off message 
  758.                for each note that you wish turned off.  This is an archaic and 
  759.                slow way of turning off "stuck notes".  Piano doesn't bother 
  760.                with that.  Likewise, some gear doesn't implement Reset 
  761.                Controllers, and wants individual controller messages for each 
  762.                controller that you wish to reset.  Piano does initialize the 
  763.                MIDI parameters associated with the 8 sliders (ie, Volume, MOD, 
  764.                PITCH, etc) as well as the Mouse 2 and Mouse 3 controllers 
  765.                regardless of whether a device understands the Reset Controllers 
  766.                message, but other controllers may not be reset.  You'll have to 
  767.                reset those manually.  Piano resets the sliders to default 
  768.                values, and turns off the controllers for Mouse 2 and Mouse 3. 
  769.                Finally, this button causes the Program to be changed on all of 
  770.                the selected MIDI channels, to that program displayed in Piano's 
  771.                Program control. 
  772.  
  773.  
  774. ΓòÉΓòÉΓòÉ 6.4.12. Octave ΓòÉΓòÉΓòÉ
  775.  
  776. Affects        The note range that the QWERTY piano (and graphical piano) plays 
  777.                back.  In other words, this transposes Piano's note range an 
  778.                octave at a time. 
  779.  
  780.                Note:  The QWERTY keyboard counts its octaves from 1.  Most MIDI 
  781.                       devices count their octaves from -2.  What this means is 
  782.                       that, to play a middle C (MIDI note number 60), set 
  783.                       Octave to 4 and play the z key (ie, a C note) or click on 
  784.                       the leftmost C of the graphical piano.
  785.  
  786.  
  787. ΓòÉΓòÉΓòÉ 6.4.13. Mouse 2 ΓòÉΓòÉΓòÉ
  788.  
  789. Affects        The controller that is sent (on the selected MIDI channels) 
  790.                every time that you press and release mouse button 2.  You can 
  791.                choose any one of the possible 128 MIDI Controllers.  48 of 
  792.                these 128 Controllers are defined for specific purposes, and 
  793.                have "names".  If you drop down the list box for Mouse 2, you'll 
  794.                see those defined controller names.  You can choose one of these 
  795.                (by clicking on the name, or typing the name), or you can type 
  796.                in the desired controller number (from 0 to 127 decimal). 
  797.  
  798.                If you type in the Controller name, you may enter only as many 
  799.                characters as are needed for Piano to find a matching name.  For 
  800.                example, if you type "Por" and press ENTER, then Piano will 
  801.                match this as "Porta" (ie, Portamento On/Off).  If you type 
  802.                "Mod" and press ENTER, Piano will match this with "Mod H" (since 
  803.                that comes before "Mod L").  It doesn't matter whether you type 
  804.                the name in upper or lower case. 
  805.  
  806.                When you select a new controller for Mouse 2, this new 
  807.                controller is initially set to 0 (ie, turned off). 
  808.  
  809.                Note:  Consult my OS/2 online book, "The MIDI Book" for 
  810.                       descriptions of all the defined MIDI controllers.
  811.  
  812.  
  813. ΓòÉΓòÉΓòÉ 6.4.14. Mouse 3 ΓòÉΓòÉΓòÉ
  814.  
  815. Affects        The controller that is sent (on the selected MIDI channels) 
  816.                every time that you press mouse button 3.  You can choose any 
  817.                one of the possible 128 MIDI Controllers.  48 of these 128 
  818.                Controllers are defined for specific purposes, and have "names". 
  819.                If you drop down the list box for Mouse 3, you'll see those 
  820.                defined controller names.  You can choose one of these (by 
  821.                clicking on the name, or typing the name), or you can type in 
  822.                the desired controller number (from 0 to 127 decimal). 
  823.  
  824.                If you type in the Controller name, you may enter only as many 
  825.                characters as are needed for Piano to find a matching name.  For 
  826.                example, if you type "Por" and press ENTER, then Piano will 
  827.                match this as "Porta" (ie, Portamento On/Off).  If you type 
  828.                "Mod" and press ENTER, Piano will match this with "Mod H" (since 
  829.                that comes before "Mod L").  It doesn't matter whether you type 
  830.                the name in upper or lower case. 
  831.  
  832.                When you select a new controller for Mouse 3, this new 
  833.                controller is initially set to 0 (ie, turned off). 
  834.  
  835.                Note:  Consult my OS/2 online book, "The MIDI Book" for 
  836.                       descriptions of all the defined MIDI controllers.
  837.  
  838.  
  839.