home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / shareware / share_39 / utilities / !STtoRhap / !Help < prev    next >
Text File  |  1991-03-18  |  7KB  |  165 lines

  1. !STtoRhap - SoundTracker to Rhapsody Conversion
  2. ===============================================
  3.  
  4. Version 1.00 - (C) 1991 M. D. George
  5.  
  6. This application takes a SoundTracker Module or Song and generates a
  7. Rhapsody format file. The conversion process is geared towards the
  8. use of the Rhapsody file via MIDI, and the current version is
  9. tailored for the requirements of my own MIDI equipment (Yamaha
  10. PSR-48). This primarily affects the handling of Percussion/Rhythm
  11. instruments. The Yamaha allocates a single MIDI channel for reception
  12. of all Rhythm data with the pitch of the received note determining
  13. the instrument.
  14.  
  15. The application is installed on the icon bar in the usual way. To
  16. perform a file conversion, drag the source Soundtracker file onto the
  17. icon bar Icon. A window will appear showing the title of the piece
  18. and listing each of the instruments. Against each instrument are
  19. three icons : Percussion, Clef and MIDI Channel/Note. At the top of
  20. the window are a further two icons defining the Percussion Channel
  21. and Accent Threshold. All these icons are described below :
  22.  
  23.   Percussion Channel
  24.   ------------------
  25.  
  26.   This defines the MIDI Channel to be used for those instruments marked
  27.   as Percussion. The MIDI Channel/Note icon for each such instrument
  28.   gives the MIDI note to be used for that instrument. This means that
  29.   whatever the pitch of the note in the SoundTracker file it will be
  30.   translated to the specified pitch in the Rhapsody file. Any MIDI
  31.   channel may be selected as the Percussion Channel provided that it is
  32.   not currently assigned to an instrument. Clicking with Select over
  33.   the icon will cycle upwards through the valid MIDI Channels, whilst
  34.   clicking withe Adjust will cycle downwards.
  35.  
  36.   Accent Threshold
  37.   ----------------
  38.  
  39.   Each SoundTracker note can have an individual volume, allowing a
  40.   great deal of 'expression' to be built in to the song. This is
  41.   difficult to reproduce in a musical score, so the only concession to
  42.   'expression' is the ability to Accent those notes which have a
  43.   SoundTracker volume greater than the specified Accent Threshold. The
  44.   Accent Threshold is specified as a value between 0 and 127. Clicking
  45.   with Select over the icon will increment the value, whilst clicking
  46.   with Adjust will decrement the value.
  47.  
  48.   Percussion
  49.   ----------
  50.  
  51.   This icon defines whether the corresponding instrument uses the
  52.   Percussion Channel or another MIDI channel. The value of this icon
  53.   toggles between a blank for a standard MIDI instrument and a tick for
  54.   a Percussion instrument. When a Percussion instrument is selected,
  55.   the clef is changed to a Bass clef and the MIDI Note is defaulted to
  56.   51, both of which can then be changed. The corresponding stave is
  57.   shown as a percussion stave within Rhapsody.
  58.  
  59.   Clef
  60.   ----
  61.  
  62.   This icon defines the clef to be used for the corresponding
  63.   instrument. The value of this icon toggles between a Treble clef and
  64.   a Bass clef. Selecting a Bass clef will result in the instrument
  65.   sounding an octave lower. For a Percussion instrument, changing the
  66.   clef may result in the MIDI Note changing if the note was outside the
  67.   valid range for the new clef.
  68.  
  69.   MIDI Channel/Note
  70.   -----------------
  71.  
  72.   This icon is interpreted differently according to the value of the
  73.   Percussion icon for the corresponding instrument. For a Percussion
  74.   instrument it gives the MIDI note to be used on the Percussion
  75.   Channel. For a non-Percussion instrument it gives the MIDI channel to
  76.   be used for that instrument.
  77.  
  78. Having selected the appropriate instrument data, a Menu can be
  79. obtained over the window with the following options :
  80.  
  81.   Convert
  82.   -------
  83.  
  84.   This leads to a 'Save' dialogue box which is used to define the
  85.   output file and to start the conversion process. Having started the
  86.   conversion, the hourglass records the progress - go and put the
  87.   kettle on !
  88.  
  89.   Quit
  90.   ----
  91.  
  92.   This is equivalent to the 'Close' icon at the top of the window and
  93.   causes the window to be removed.
  94.  
  95. During the conversion process, the 'Convert' option is replaced with :
  96.  
  97.   Abort
  98.   -----
  99.  
  100.   This terminates the conversion process but leaves the window open.
  101.  
  102. NOTES :
  103.  
  104.   1)  Rhapsody note lengths may vary from the SoundTracker note
  105.       lengths because it is difficult to determine accurately the
  106.       length of a SoundTracker note. This depends on pitch, whether
  107.       repeats are in use and when the next note occurs on the same
  108.       Soundtracker channel. In addition, it is possible to have
  109.       SoundTracker notes of different lengths running concurrently
  110.       for the same instrument, whereas Rhapsody will only allow two
  111.       different lengths in the same 'slot' by the use of up and down
  112.       stalks. In practise this is seldom a problem.
  113.  
  114.   2)  My MIDI equipment is multi-timbral and polyphonic. It can
  115.       only produce a maximum of eight notes at a time but these are
  116.       the most recent eight notes on any of the fifteen
  117.       non-percussion channels. As a result I have not had any need to
  118.       constrain the allocation of notes to channels in any way. Users
  119.       with monophonic equipment or fixed allocations of 'n' notes per
  120.       channel may prefer some constraints to be selectable - please
  121.       let me know if you have any requests.
  122.  
  123.   3)  The program will cope with both 15 and 31 instrument
  124.       format SoundTracker files but currently only allows the
  125.       allocation of 15 MIDI channels + 1 Percussion channel. If
  126.       Rhapsody is enhanced in the future to allow Voice Select
  127.       commands to be sent over MIDI then this program will be
  128.       enhanced accordingly. Until then if you have a song with
  129.       more than 15 instruments (let me have a copy !) you will
  130.       have to use some MIDI instruments for 2 or more
  131.       SoundTracker instruments.
  132.  
  133.   4)  Rhapsody does not accept input from other applications,
  134.       so it is no use trying to drag the output file directly into
  135.       Rhapsody. Save it first and then load it into Rhapsody (and
  136.       then complain to Clares).
  137.  
  138.   5)  MIDI notes are values in the range 0 - 127 with each
  139.       value representing one semitone. Middle C has the value 60, and
  140.       the Cs above and below middle C have the values 72 and 48
  141.       respectively.
  142.  
  143.   6)  Be prepared to do some manual adjustments to the Rhapsody
  144.       score particularly for the volumes for individual staves. The
  145.       relative volumes of the staves depend largely on the MIDI
  146.       instruments generating the sounds. It will also be necessary to
  147.       transpose some instruments down an octave (or two) even if you
  148.       have selected the Bass clef but beware of notes going too low -
  149.       Rhapsody 'wraps' them to the top of the stave.
  150.  
  151. 'Rhapsody' is a product of CLARES MICRO SUPPLIES.
  152.  
  153. This version of !STtoRhap has been compiled using DABS PRESS ABC
  154. BASIC Compiler.
  155.  
  156. If you have any comments, suggestions, requests or fault
  157. reports please contact me at the following address :
  158.  
  159.       Mark George
  160.       10 Ashbrook Road
  161.       Bollington
  162.       Cheshire
  163.       SK10 5LF
  164.  
  165.                                                         March 1991