home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsm / pstuner2 / README.TXT < prev    next >
Text File  |  1995-07-14  |  6KB  |  151 lines
  1. PSTuner v2.0, © 1995, bruce linde/really desperate records
  2.  
  3.  
  4. OVERVIEW
  5.  
  6.      PSTuner is a Psion 3a 'strobetuner' that determines pitch by
  7. grabbing quarter-second samples and counting cycles/second, using
  8. a couple of creative algorithms tailored to the Psion 3a's
  9. sampling environment.
  10.      It is extremely accurate (at a cost of some speed) and will
  11. yield best results when fed clean, consistent notes (a note struck
  12. too hard will ring sharp before settling in). Or, you can use
  13. harmonics.
  14.  
  15.  
  16. FILES
  17.  
  18. PSTuner requires three files, which MUST exist and be kept in
  19. these locations:
  20.         \APP\PSTuner.opa
  21.         \OPD\Tuner.pic
  22.         \Sys$samp.ldd   (must be at the root level)
  23. In addition, Psion has authorized distribution of Sys$samp.ldd on
  24. the condition that the docs and sample files (originally uploaded
  25. by Psion as TSMP10.ZIP) are kept together. They are included with
  26. PSTuner.
  27.  
  28.  
  29. THE DRIVER - Sys$samp.ldd"
  30.  
  31.      PSTuner makes use of a driver provided by Psion. The docs
  32. that come with the driver include the following disclaimers, which
  33. are not as dire as they might sound at first read:
  34.  
  35.     "Psion will not be held responsible for any loss of data as a
  36. result of use of Sys$samp.ldd, which is still to some extent in an
  37. experimental phase. It has not been exhaustively tested, and can
  38. not be relied upon, i.e., not to reset your 3a occasionally. It is
  39. not an official Psion product."
  40.  
  41.     The worst thing that I've experienced is that it took a little
  42. trial and error to ensure that PSTuner wouldn't leave the driver
  43. loaded in memory. I was extremely careful about making sure the
  44. driver cleans up after itself, but if this happens to you, you can
  45. easily recover the 6k of memory the driver grabs for itself by
  46. running the program and simply quitting before going into LISTEN
  47. mode.
  48.      As far as stability goes, I've actually left the thing
  49. running for days with no problems. If you DO experience
  50. weirdnesses, please let me know a.s.a.p.
  51.  
  52.  
  53. SHAREWARE NOTIFICATION
  54.  
  55.      PSTuner came about as I was getting more and more into my 3a,
  56. trying to grok OPL, and playing more guitar (more about music in a
  57. minute). It occured to me that while I didn't always carry a
  58. tuner, I almost always had my 3a with me.
  59.      I wrote PSTuner to exploit the digital sampling and
  60. programming features of the 3a, and because it was something I
  61. could use. It is my hope that you, too, will find it useful. If
  62. you DO continue using PSTuner, it is shareware...
  63.  
  64.  
  65. SHAREWARE DETAILS
  66.  
  67.      All proceeds from PSTuner go to The Documentation of AIDS
  68. Issues and Research Foundation. D.A.I.R. is a 501(c)3 non-profit
  69. information archive used by Persons With AIDS and medical
  70. professionals world-wide.
  71.      Please send a tax-deductible donation of ANY size to:
  72.           D.A.I.R.
  73.           c/o bruce linde
  74.           2840 60th av
  75.           oakland, ca 94605
  76.  
  77.  
  78. STUFF
  79.  
  80.      The 'Esc' key will get you out of most PSTuner screens. Help
  81. is not available while in LISTEN mode. If you don't back up your
  82. 3a, either to a RAM card or another CPU, please re-read the help
  83. file called THE DRIVER (above), and give backups some thought...
  84. unless, of course, you have nothing to lose.
  85.      I am not responsible for out-of-tune performances or loss of
  86. data resulting from use or misuse of PSTuner or the Sys$samp.ldd
  87. driver. Oh, and don't forget that PSTuner is shareware. Thanks!
  88.  
  89.  
  90. HARMONICS
  91.  
  92.      Every note consists of a fundamental, and harmonic overtones
  93. (thirds, fifths, octaves, etc.). These 'harmonics' can be isolated
  94. on a guitar (or bass) by partially muting a string at the twelfth,
  95. fifth, or seventh frets, as you pluck the string. This dampens the
  96. grosser vibrations of the string, letting the higher-pitched
  97. components of the note (harmonics) ring through. 12th and 5th fret
  98. harmonics produce higher octaves of the fundamental; 7th fret
  99. harmonics yield fifths.
  100.  
  101.  
  102. MUSIC STUFF
  103.  
  104. Write or e-mail for more information about:
  105. "bruce linde: not like other men", an independent release on
  106. really desperate records, and "Beggars and Saints" and "Monkey",
  107. the most recent releases by Jai Uttal and the Pagan Love Orchestra,
  108. on Triloka Records (w/ bruce on bass):
  109.  
  110.      really desperate records
  111.      2840 60th av
  112.      oakland, ca 94605
  113.      
  114.      www.songwriter.com
  115.      brucelinde@aol.com
  116.  
  117. ----------------------------
  118. Credit Where Credit Is Due
  119.  
  120. PSTuner is my first program. It was written with considerable
  121. support and guidance from Master Programmer/Lode Runner Ron
  122. Hunsinger. Every novice diving into the deep end of the
  123. programming pool should be lucky enough to have a Ron as their
  124. lifeguard... thanks also to: Jamie Pyper@Psion S.F., for turning
  125. me into a 3a junkie, Jack McCrae, for kick-starting me by sharing
  126. his Blackjack source code, David Wood@Psion U.K., for uploading
  127. the Sys$samp.ldd driver and documentation, and, whoever wrote the
  128. 3a OPL Programming Manual!
  129.  
  130. bruce linde
  131. july 15, 1995
  132.  
  133. ----------------------------
  134. History
  135. 2.0            thanks to John Woodthorpe i found out what was
  136.             causing soft resets on some 3a's. somewhere along
  137.             the way the driver got corrupted in the v1.1 upload,
  138.             going from 6080 bytes (correct) to 6095 bytes (wrong!).
  139.  
  140.             apologies to anyone who got the corrupted driver!
  141.  
  142.             i also made the main window a little more user friendly 
  143.             and fixed some minor bugs/dumbnesses.
  144.             
  145.             
  146. 1.1            minor bug fix to allow running app from any drive 
  147.             (all files must still be on the same drive)
  148.             
  149. 1.0            6 months ago i couldn't even spell 'programmer',
  150.             and now i r one!
  151.