home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / MM1 / SOUNDUTILS / mplay102.lzh / mplay.doc_v1.02 < prev    next >
Text File  |  1993-02-06  |  12KB  |  450 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.     MMPPLLAAYY Version 1.02 
  7.     CT-VOC, WAV, IFF and MAC NON-AIFF Sound Tool
  8.     Copyright 1992, 1993
  9.     Farside Systems
  10.  
  11.  
  12.  
  13.  
  14.  
  15.            SSHHAARREEWWAARREE               SSHHAARREEWWAARREE               SSHHAARREEWWAARREE
  16.  
  17.     MMPPLLAAYY  is  a  shareware  program.  Please  feel free to distribute it by
  18.     giving  copies  to  your  friends,  uploaing it to bullentin boards, and
  19.     trading  it.  You  must distribute it unaltered including this document.
  20.     You  may  not  sell  these files for more than a $$77..0000 media duplication
  21.     cost.  
  22.  
  23.     You  may  use  MMPPLLAAYY on a trial basis for two weeks; after that you must
  24.     register  by  sending  us  $$1155..0000,,  OR MORE, for MPLAY and sample sounds
  25.     plus  $$22..5500  for  discs, mailer and shipping, or SSTTOOPP using it. The last
  26.     page  of  this  document  is  an  order form which you may use. When you
  27.     register  you will be shipped a copy of the latest version of MPLAY (if,
  28.     according  to  your  order form, you already have the latest version, we
  29.     will  ship you the first update when it is available).  The registration
  30.     fee for MPlay is deductable from the price of SoundWorks ($TBA).  
  31.  
  32.            SSHHAARREEWWAARREE               SSHHAARREEWWAARREE               SSHHAARREEWWAARREE
  33.  
  34.  
  35.  
  36.                                  UUPPGGRRAADDEE PPOOLLIICCYY
  37.  
  38.     If  you  are  a  registered  user and wish to receive upgrades when they
  39.     become  available  a  fee  of  $3.25 is required to cover media, mailer,
  40.     postage    and    duplication.    Or   you   can   call   on   weekends,
  41.     Friday(6:00PM-10:00PM)   and  Saturday(12:00PM-11:00PM),  and   download
  42.     upgrades,  serial number and prior registration required.  The number is
  43.     615-577-0188.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.     MPLAY Version 1.02          Farside Systems                       Page 2
  68.  
  69.  
  70.     MPLAY has two modes of operation, interactive and silent.  SSIILLEENNTT MMooddee 
  71.  
  72.     Use  silent  mode from a shell or procedure file. Frequency is specified
  73.     in  Hertz.   Frequency  must  be  specified for Mac files, otherwise the
  74.     default  of  11000  Hz  is used. If an amplification factor is specified
  75.     the sound will begin playing after it is altered.  
  76.  
  77.  
  78.     PPAARRAAMMEETTEERRSS 
  79.  
  80.          Parameters  may  be in either uppercase or lowercase, or both.
  81.          The '=' is optional where applicable.  
  82.  
  83.  
  84.          -?                Quick Help
  85.  
  86.          -f=<frequency>    Alter playback sample frequency
  87.  
  88.          -s                Silent mode/command line
  89.  
  90.          -a=<factor>       Amplification Factor: -10 to -2 and 2 to 10
  91.  
  92.          -d                Play from disc
  93.  
  94.          -b=<multiple>     Buffer multiple of sample frequency for disc play buffers
  95.  
  96.          -m                Move Window on startup for Interactive mode
  97.  
  98.  
  99.     EExxaammppllee::
  100.  
  101.               mplay -s [filename] -f=12000  -a=2
  102.                      |             |         |
  103.                      |             |         |____ Amplification Factor
  104.                      |             |
  105.                      |             |______________ Alter Frequency
  106.                      |
  107.                      |____________________________ Silent Mode
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.     Shareware                   February 6, 1993                   Shareware
  129.  
  130.  
  131.     MPLAY Version 1.02          Farside Systems                       Page 3
  132.  
  133.  
  134.     IINNTTEERRAACCTTIIVVEE MMooddee 
  135.  
  136.     Interactive  mode  requires a mouse, uses function buttons, and displays
  137.     a  graph  of  the  sound waveform. If the environment variable SNDDIR is
  138.     defined  MPLAY  will  use  this  as  the  startup data directory. If not
  139.     present  the  current  data  directory  is  used.  If a startup  file is
  140.     specifed on the command line, SNDDIR will be ignored.  
  141.  
  142.     The  gadgets  across  the  top  from  left  to  right have the following
  143.     functions.   Move  Window,  Quit,  About - program information, and Move
  144.     Window to Back.  
  145.  
  146.     Interactive mode is invoke as follows: mplay& or mplay -m & 
  147.  
  148.  
  149.     Button functions are: 
  150.  
  151.          Play    - Play current sound in memory
  152.  
  153.          File    - Load, Save, Convert, Drive and DPlay
  154.  
  155.          Edit    - Edit sound
  156.  
  157.          Freq    - Alter sample playback frequency
  158.  
  159.          Effects - Special effects, Echo, Vibrato,... Next Version(V1.03)
  160.  
  161.  
  162.     PPLLAAYY 
  163.  
  164.     Plays  the  current  sound  in  memory.  While playing a scroll bar will
  165.     appear  indicating  the  play  position  if  the sound is 2.5 seconds in
  166.     length  or  longer.   Due  the the sample rate and length of some sounds
  167.     the scroll bar will not be 100% accurate.  
  168.  
  169.  
  170.     FFIILLEE 
  171.  
  172.     MPLAY  does  not rely on filename extensions, such as .wav, to recognize
  173.     file  format.   Instead it opens  the file and looks for format specific
  174.     information.   This  allows  you to use any extenstion, if any, desired.
  175.     Though, IFF files should have the extenstion ".iff".  
  176.  
  177.          LLOOAADD  allows  you to select a sound file to be loaded with the
  178.          mouse.   If  the  enviroment  variable  SNDDIR is defined this
  179.          will  be the default.  If you change directories with the file
  180.          picker the new directory will become the default.  
  181.  
  182.          SSAAVVEE  allows  you  to  save the current sound.  The format the
  183.          sound  is  to be saved as is indicated by the depressed fomrat
  184.          button.   The  save  format  may be changed by clicking on the
  185.          desired  format.   The  MAC  format  is not supported.  Select
  186.          SAVE  to save using the current filename, or SAVE AS to create
  187.          a new file.  
  188.  
  189.          CCOONNVVEERRTT  allows  conversion of MAC, VOC, WAV, IFF to VOC, WAV,
  190.  
  191.  
  192.     Shareware                   February 6, 1993                   Shareware
  193.  
  194.  
  195.     MPLAY Version 1.02          Farside Systems                       Page 4
  196.  
  197.  
  198.          and  IFF  formats.   Convert will convert any size file IF you
  199.          have  the  disc  space.  First you will be asked to select the
  200.          format  to  convert to, convert will abort if the source is in
  201.          the  same  format.   The  default format to convert to is IFF,
  202.          its  button is depressed.  Selecting another format will raise
  203.          it(unselect)   and   select  your  choice.   Click  on  OK  to
  204.          continue.   Next  you  will  be  prompted to select the source
  205.          file  with the mouse.  If you click on the file selector close
  206.          box  the conversion will be  aborted else you will be asked to
  207.          enter the destintation path/filename.  
  208.  
  209.          DDRRIIVVEE  allows  you  to change drives.  The current drives icon
  210.          will  be  depressed  and  its L.E.D.  indicator lit(except for
  211.          RAM  %-)).  To select another drive click on its icon with the
  212.          mouse  and then click on OK.  The environment variable RBFDEVS
  213.          must  be  defined  for this function.  Example: setenv RBFDEVS
  214.          /DD:/D0:/R0  This should be placed in you .login file.  
  215.  
  216.          DDPPLLAAYY allows playing from disc sound samples. (UNREGISTERED) 
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.     Shareware                   February 6, 1993                   Shareware
  257.  
  258.  
  259.     MPLAY Version 1.02          Farside Systems                       Page 5
  260.  
  261.  
  262.                                    EEDDIITT MMEENNUU
  263.  
  264.  
  265.  
  266.     Button functions are: 
  267.  
  268.          Select  - Select segment defined by offset(s)
  269.  
  270.          Reverse - Reverse order of sample
  271.  
  272.          FadeIn  - Fade In
  273.  
  274.          FadeOut - Fade Out
  275.  
  276.          Amplify - Amplify or Attenuate sample
  277.  
  278.          Freq    - Alter playback frequency
  279.  
  280.          Play    - Play sample
  281.  
  282.          Clear   - Clear sound or segment defined by offet(s)
  283.  
  284.          Arrows  - Move Start and End offsets
  285.  
  286.  
  287.     SSEELLEECCTT 
  288.  
  289.     Selects  the  sound  segment  between the offset bars if offsets are defined.
  290.     Only a start or end offset is required, or both.  
  291.  
  292.  
  293.     RREEVVEERRSSEE 
  294.  
  295.     Reverses the sound so that is may be played backwards.  
  296.  
  297.  
  298.     FFAADDEEIINN//FFAADDEEOOUUTT 
  299.  
  300.     Allows  fading  in or out of a sound or sound segment(s).  Time is the length
  301.     to fade.  Rate is the rate at which fading occurs.  
  302.  
  303.  
  304.     AAMMPPLLIIFFYY 
  305.  
  306.     Use  Amplify  with  caution,  noticable  distortion may be introduced.  Valid
  307.     factors   are  2  through  10  for  amplification,  and  -2  though  -10  for
  308.     attenuation.   A factor of 2 amplifies the most and 10 the least. The same is
  309.     true  for  attenuation.  Amplify may be applied successively to acheive lower
  310.     or higher volume levels.  
  311.  
  312.  
  313.     FFRREEQQ 
  314.  
  315.     Alter  frequency  sample  is played at.  This also affects the edit funtions.
  316.     Valid frequencies presently are 1117 Hz to 30720 Hz.  
  317.  
  318.  
  319.  
  320.     Shareware                   February 6, 1993                   Shareware
  321.  
  322.  
  323.     MPLAY Version 1.02          Farside Systems                       Page 6
  324.  
  325.  
  326.     PPLLAAYY 
  327.  
  328.     Plays the sound.  Same as main.  
  329.  
  330.  
  331.     CCLLEEAARR 
  332.  
  333.     Clears  the segment defined by the start and end offsets.  If offsets are not
  334.     defined it will clear the entire sound.  
  335.  
  336.  
  337.     AARRRROOWWSS 
  338.  
  339.     The  arrows  on  the  left  move  the start offset, whereas the arrows on the
  340.     right  more  the end offset.  The value between the arrows indicates in 10ths
  341.     of  a  seconds  the  start  and  end  offset.   The  double arrows will reset
  342.     respectively  the  start or end offset, or set the start or end offset to the
  343.     maximum.   The  start offset is display on the graph as a yellow bar, and the
  344.     end offset as white bar.  
  345.  
  346.  
  347.  
  348.                             ------------ MMoouussee PPrroobblleemm --------------
  349.  
  350.     The  lose  of mouse is due to DMA activity. If lost, MPLAY recognizes the 'Q'
  351.     key  as  quit.  The Quit box recognizes 'O' OK Quit or 'C' Cancel, or use the
  352.     Keyboard  Mouse.  Or use the Keyboard Mouse, CTRL-(arrow keys) and CTRL-ENTER
  353.     for mouse button.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.     Shareware                   February 6, 1993                   Shareware
  385.  
  386.  
  387.  
  388.  
  389.  
  390.                                      ORDER FORM
  391.  
  392.  
  393.       Send to:       Farside Systems
  394.                      Stephen Seneker
  395.                      4809 Joe Lewis Road
  396.                      Knoxville TN 37920
  397.  
  398.        Qty    Description                                       Price     Total
  399.  
  400.  
  401.  
  402.        _____  ________________________________________________  ______  _______
  403.  
  404.  
  405.        _____  ________________________________________________  ______  _______
  406.  
  407.  
  408.        _____  ________________________________________________  ______  _______
  409.  
  410.  
  411.               Sub-Total:                                                _______
  412.  
  413.  
  414.               Total                                                     _______
  415.  
  416.  
  417.  
  418.  
  419.        Circle Payment form:       Check    Money Order
  420.  
  421.  
  422.  
  423.        Signature: ______________________________________________________
  424.  
  425.        Name: ___________________________________________________________
  426.  
  427.        Address: ________________________________________________________
  428.  
  429.                 ________________________________________________________
  430.  
  431.        City: ___________________________ State: _________ Zip: _________
  432.  
  433.        Phone: (______) ________________   Fax: (______) ________________
  434.  
  435.  
  436.  
  437.        Phone number of BBS you got this program from: __________________
  438.  
  439.  
  440.        Name of BBS: ____________________________________________________
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.