home *** CD-ROM | disk | FTP | other *** search
/ Media Share 13 / mediashare_13.zip / mediashare_13 / ZIPPED / MMEDIA / PMSNDX3D.ZIP / readme < prev   
Text File  |  1994-04-04  |  10KB  |  220 lines
  1.                 PMsndX version 0.2
  2.                         by
  3.                 William Scott Hiles
  4.  
  5. This is the fourth release of PMsndX.  Push the HELP button
  6. to get a short introduction to the purpose of this program.
  7. Basically, this program is intended to eventually provide
  8. all of the features of the SOX program and a bit more.
  9.  
  10. Sorry guys, but this is version 0.3 and with the addition of
  11. the MMPM stuff, the format of the .ini file has changed.  I
  12. was thinking of giving you a program to convert your old
  13. .ini to the new format, but then I figured that there are
  14. not that many windows to worry about.  Maybe in the next
  15. release?
  16.  
  17. Of all the potential things that PMsndX could do, the one
  18. that people seem to want the most is to be able to play a
  19. sample of any format without having to save it to disk in
  20. the native .WAV format and then start the digital audio
  21. player.  Well, here it is.  The only difference between
  22. version 0.2 and 0.3 is the additions to the Settings box and
  23. the new MMPM button (with corresponding playback functions
  24. too).  I have not implemented recording yet and a couple of
  25. the options for the settings have not been implemented
  26. either.
  27.  
  28. Programming for the MMPM was definitely not a breeze.  It
  29. took me a week to figure out how to use the Playlists.
  30. Frankly, since there is almost no documentation out there on
  31. accessing the MMPM device, I am amazed that I got this much
  32. working.  In any case, you will find buttons that look very
  33. much like the buttons on the digital audio device provided
  34. by IBM.  As you will find, I have not fully mastered
  35. programming under MMPM so there will probably be a number of
  36. quirky things that pop up.  Just have patience and point
  37. them out to me and I will fix them as best I can.
  38.  
  39. As always, all comments are welcomed as well as bug
  40. reports.
  41.  
  42. What is in the future?  Well, I am planning on adding other
  43. sound formats.  Feedback has indiacated that .VOC, and .SND
  44. are the most important ones, so I will start on them first.
  45.  
  46.  
  47. Revision history:
  48. Version 0.0 (initial release)
  49. 1.  6 buttons and associated dialog boxes created
  50. 1.  Ability to load and save .au files
  51. 2.  Ability to load and save .wav files
  52. 3.  Tool for changing the sampling rate (0.0a)
  53. 4.  Display of information about the current sample
  54.  
  55. 0.0a - SOX appears to use linear approximation to create the
  56.        new sample.  PMsndX provides for quality which allows the
  57.        approximation to be adjusted.
  58.  
  59. Version 0.1
  60. 1.  Added Channel Averaging (0.1a)
  61. 2.  Added Vibro effect
  62. 3.  The .ini file are automatically located in the same directory
  63.     as the executable.
  64. 4.  Individual tool pages no longer have separate HELP buttons
  65. 5.  A HELP button has been added to the tool box for all pages.
  66.     When pressed, the help page for the page shown in the tools
  67.     dialog box will be displayed.
  68. 6.  A DISMISS button has been added to the tools dialog box for
  69.     a more consistent approach to dismissing.  The user can still
  70.     depress the tools button on the main control panel to dismiss
  71.     any tool dialog.
  72. 7.  Rearranged the buttons on the main control panel and added
  73.     two new buttons for Playing and Recording samples (not implemented
  74.     in this release...just placeholders)
  75. 8.  Changed the memory storage requirements so that data takes
  76.     half as much memory.  Each sample is stored as a signed SHORT
  77.     regardless of the sound type.
  78. 9.  Corrected major memory bug which resulted in a memory leak.
  79. 10. The echo effect presents an interesting challenge to the
  80.     user interface.  How do you provide the user with an
  81.     intuitive method to set the echo locations and the
  82.     strength of the echo from a dialog box?  My first
  83.     attempt was to try to display the waveform in a window
  84.     and then to let the user set the echo points, but the
  85.     problem of setting the echo strength is still difficult.
  86.     This operation may have to wait for another revision
  87.     after I have had some time to "sleep" on it.  The effect
  88.     itself is very simple, but the interface is much more
  89.     difficult.
  90.  
  91. 0.1a - SOX can averages 4 channels to 1 by putting all four
  92.        channels into 1.  4 channels to 2 is done by
  93.        averaging the left channels and the right channels
  94.        together.  PMsndX allows the user to select any
  95.        combination of the source channels.
  96.  
  97. Version 0.2
  98. 1.  Fixed error with memory settings.  In version 0.1 if you
  99.     opened the Settings box and then applied it by pressing
  100.     the DOIT button it sould clear the data samples even if
  101.     the memory configuration had not changed.
  102. 2.  Fixed bug in version 0 in which the data was cleared
  103.     when the memory configuration was changed, but the
  104.     sample header was not cleared.  This led to th dialogs
  105.     trying to access data that had been released causing a
  106.     protection violation.
  107. 3.  Added the Bandpass notebook page.  This is probably one
  108.     of the most complex user interfaces in the notebook.
  109. 4.  Added the Echo effect.  This is the most complex
  110.     programming challenge for a useable user interface.
  111.     (Note, the echo only works for single channel samples).
  112. 5.  Fixed bug.  In version 0.1, the lowpass function did not
  113.     take into account the number of channels.  This has a
  114.     significant impact on the FFT operation.  This is fixed
  115.     in 0.2.
  116. 6.  Fixed bug.  In version 0.1, the Vibro effect did not
  117.     take into account multiple channels in a sample.  As a
  118.     result, the vibro was not continuous on individual
  119.     channels.
  120.  
  121. Version 0.3
  122. 1.  Removed the RECORD button (now just a blank button until
  123.     I can think of something)
  124. 2.  Changed PLAY button to MMPM and added basic play
  125.     capabilities (i.e. Play, Stop, Rewind, Pause).
  126. 3.  Updated Settings dialog to reflect options for the MMPM
  127.     stuff.
  128.  
  129. Version 0.3a
  130. 1.  Fixed the Play button so that it is animated when the
  131.     sample is played as it is loaded.  (What is the longest
  132.     record for staring at a code before you realize that it
  133.     is so late that you have been staring at the bug all
  134.     night and just did not recognize it?...What a dumb error
  135.     on my part!!!)
  136. 2.  Fixed the dynamic linking so that DosLoadModule is used
  137.     rather than linking with the dynamic libraries.  Version
  138.     0.3 would refuse to run on machines without MMPM
  139.     installed because the libraries were loaded even if the
  140.     MMPM support was not enabled.
  141. 3.  Changed to using SW.DLL for the buttons of the MMPM
  142.     dialog box.  This guarantees that the program will use
  143.     the latest formats for the buttons.
  144. 4.  Added command line playing.  I the PLAY_ON_LOAD option
  145.     is selected, any filenames which appear on the command
  146.     line will be played.  If a file is not found, the
  147.     program will signal an error and continue to the next
  148.     command line file.  If EXIT_AFTER_PLAY is not selected,
  149.     the last file that was successfully loaded will be
  150.     the current file in memory.
  151. 5.  Enabled the EXIT_AFTER_PLAY feature and modified the
  152.     behaviour such that the MMPM dialog is not displayed
  153.     during the playback.
  154.  
  155. Version 0.3b
  156. 1.  Fixed a big bug in the Bandpass filter.  If a sample
  157.     had multiple channels, it would only bandpass on the
  158.     first channel.
  159. 2.  Fixed a big bug in the Lowpass filter.  If a sample
  160.     had multiple channels, it would only lowpass on the
  161.     first channel.
  162. 3.  Added the little clock pointer to indicate how much
  163.     work has been completed.
  164. 4.  Removed the requirement for the audio device to be a
  165.     form of WaveAudio??.  Any string will work as long as
  166.     the device really exists.
  167. 5.  Multi-threaded all of the effects so that the program
  168.     is not a system hog.  The file read/write functions
  169.     are not multi-threaded.  Should they be?
  170.  
  171. Verstion 0.3c
  172. 1.  Added Speed Effect
  173. 2.  Reorganized the Tools notebook.  There were too many
  174.     tools to display the tabs on the notebook so major and
  175.     minor pages were created to group the tools.
  176. 3.  Modified the MMPM support to use a separate region of
  177.     memory than the samples are stored in.  Previously, the
  178.     memory for storing the playlist was taken out of the
  179.     pool for storing the samples for the effects.  As a
  180.     result, if you started the MMPM box an performed a
  181.     effect that took up more memory, a hole would be left
  182.     such that another block of memory could not be
  183.     allocated.  This method prevents creating the holes.
  184. 4.  Added Reverse Effect.
  185.  
  186. Version 0.3d
  187. 1.  Added use of the second mouse button (usually the right
  188.     mouse button) for the reverse effect and removed the
  189.     dynamic sorting of the start and end so that the numbers
  190.     don't jump back and forth when the user is entering
  191.     the endpoints.
  192. 2.  Added support for .VOC file formats.
  193.     Note:  I don't know what the hell SOX is doing, but it does
  194.            not seem to produce a useable file.
  195.     I always add an Extended data block to the file.  I don't
  196.       know if this will cause problems, but the extended part
  197.       contains the number of channels.
  198.     I don't know what to do with Repeat/End Repeat information
  199.       so I am currently ignoring it.  Any ideas?
  200.     I currently dump (on the floor) any ASCII text.  Anyone want
  201.       me to keep the stuff in the info field?
  202.     I currently only load 8 bit data.  I cannot deal with packed
  203.       data right now.  It is 1:00am and I am tired.
  204.     Some programs seem to expect the first block to be the
  205.       DATA block so I write this first always.
  206.  
  207. For now, just play with it and let me know what you think.
  208.  
  209. You should have three files from the compressed .zip file.
  210.  
  211. README          This file
  212. pmsndx.exe      Executable PMsndX
  213. pmsndx.hlp      Help file
  214.  
  215. I can be contacted using email at whiles@relay.nswc.navy.mil.
  216.  
  217. Thanks for your time.
  218. Scott
  219.  
  220.