home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 719.dms / 719.adf / SMUSUtilities / SMUSDocs < prev    next >
Text File  |  1990-06-30  |  13KB  |  409 lines
  1.  
  2.     SMUS Utilities
  3.  
  4.     Copyrights (C) 1990 by The Other Guys and Bob Dayley
  5.     All Rights Reserved.
  6.  
  7.     SMUS Utilities are a set of CLI-only SMUS tools written by The Other
  8.     Guys. They were written to manipulate demo songs for our products
  9.     Synthia II, Synthia Professional, and EZ FM.  These products are
  10.     synthesizers and special effects processors which synthesize musical
  11.     instruments. The disk which normally contains these utilities has a
  12.     demo of Synthia II, a very nice SMUS player, and several example songs.
  13.     If you recieved the utilities on a download and did not recieve the
  14.     disk, the entire disk may be obtained from The Other Guys at
  15.  
  16.             800 942-9402
  17.  
  18.     for a media cost of $5.00. Complete disk demos each of Synthia II,
  19.     Synthia Professional, and EZ FM Synth are also available for the same
  20.     cost (the demo included with SMUS Utilities does not have all modules
  21.     available, the other disks contain all modules, except MIDI).
  22.  
  23.  
  24.     The disk is freely distributal and will also be available from several
  25.     sources specializing in PD and ShareWare software.
  26.  
  27.     The utilities are extremely useful in manipulating SMUS files created
  28.     by Deluxe Music, Instant Music, Sonix, and several other score editors.
  29.     There are utilities for optimizing instruments, changing instruments,
  30.     note transposition and ranging, and Instant Music file conversion.
  31.     These utilities are also handy for customization for various SMUS
  32.     players such as the ones published by The Other Guys. The format for
  33.     each available utility is described later.
  34.  
  35.     Catalogs, Information, and Submissions
  36.  
  37.     The Other Guys publish several commercial programs. We have
  38.     synthesizer/effects packages which work with Amiga as well as MIDI
  39.     sounds. We also have several educational products as well as a
  40.     proofreading system. Information may be obtained about these products,
  41.     as well as others by writing:
  42.  
  43.         The Other Guys
  44.         55 N Main Suite 301-D
  45.         PO Box H
  46.         Logan,UT
  47.         84321
  48.         USA
  49.  
  50.     or call toll free:
  51.  
  52.         (800) 942-9402
  53.  
  54.     The Other Guys is accepting software submissions for commercial
  55.     release. If you have a program you would like to market please contact
  56.     us at the above address or telephone.
  57.  
  58.  
  59.     Distribution
  60.  
  61.     These utilities are freely distributable under the following
  62.     conditions:
  63.  
  64.         1.  All the utilities must be bundled together with this document
  65.         unchanged. The  required list of files which should be present in
  66.         distribution are:
  67.  
  68.             ReadMe (this file)
  69.             ShowInst
  70.             SetInst
  71.             FixInst
  72.             RangeInst
  73.             ConvertIMSMUS
  74.  
  75.         2. These utilities may distributed on disk ONLY if they are present
  76.         with the Synthia II demo, SynthiaPlay SMUS player and the songs
  77.         and instruments on that disk. These utilities may be uploaded to a
  78.         BBS as long all files present in (1) above are arced and uploaded
  79.         together. In other words, you may upload the utilities as a package
  80.         without the player and the demo, but you may only distribute copies
  81.         by disk if the whole disk is copied, not just part.
  82.  
  83.         3. The Other Guys reserves all commercial rights to these
  84.         utilities. These utilities may not be published in or for a
  85.         commercial gain or disk magazine without express written consent
  86.         from The Other Guys. For information on commercial licensing please
  87.         contact The Other Guys.
  88.  
  89.         4. No profit may be charged for the distribution of this program.
  90.         Exceptions are cost of media for PD disk distribution and cost of
  91.         maintaining memberships on a BBS.
  92.  
  93.     Here is a list of the utilities available and how to use them.
  94.  
  95.     ShowInst
  96.  
  97.     NAME
  98.  
  99.         ShowInst - shows required instruments in a SMUS IFF file.
  100.  
  101.     SYNOPSIS
  102.  
  103.         ShowInst scorefile
  104.  
  105.     DESCRIPTION
  106.  
  107.         This command lists the instruments used in a SMUS file (scorefile).
  108.         Each instrument is listed with the corresponding register number.
  109.         The register numbers are used with commands such as TransposeInst
  110.         and RangeInst.
  111.  
  112.     EXAMPLE
  113.  
  114.         To view the instruments used in a song called BlueSky on a disk in
  115.         drive DF0: in a directory called Music use:
  116.  
  117.         ShowInst DF0:Music/BlueSky
  118.  
  119.        The results may look like:
  120.  
  121.           To play BlueSky you need the following instruments:
  122.              0 - NutMeg
  123.              1 - EPBells
  124.              2 - FlangeGuitar
  125.              3 - ChiffOrgan
  126.  
  127.  
  128.  
  129.  
  130.  
  131.    FixInst
  132.  
  133.  
  134.     NAME
  135.  
  136.         FixInst - Check and optimize instrument assignments in a SMUS IFF
  137.         file.
  138.  
  139.     SYNOPSIS
  140.  
  141.         FixInst smusfile <smusfile> ...
  142.  
  143.     DESCRIPTION
  144.  
  145.         FixInst checks the instrument assignments in a SMUS file against
  146.         the score in the SMUS file to find unused and missing instruments.
  147.         All unused instruments are deleted from the SMUS file. This will
  148.         prevent the unused instrument from loading resulting in a more
  149.         compact and faster loading score. Any instruments which are used
  150.         but not assigned are given an instrument assignment of "Default".
  151.         These new instruments can be viewed with ShowInst and changed with
  152.         SetInst. You should use FixInst on most SMUS files before
  153.         performing any other operation on the file. Many SMUS files
  154.         available in the public domain have missing instruments. FixInst
  155.         will reveal these missing instruments.
  156.  
  157.  
  158.  
  159.     EXAMPLE
  160.  
  161.         FixInst ChristmasSong BirthdaySong
  162.  
  163.         will result in instrument assignment optimizations on ChristmasSong
  164.         and BirthDaySong. You may now use ShowInst to view the results and
  165.         SetInst to change the name of any "Default" instrument assignments.
  166.  
  167.     SPECIAL NOTES
  168.  
  169.         FixInst alters the specified files. If you need to keep a copy of
  170.         the original file, you should work with a COPY of the score rather
  171.         than the original.
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.     SetInst
  179.  
  180.     NAME
  181.  
  182.         SetInst - Change the name of the instruments in a SMUS IFF file.
  183.  
  184.     SYNOPSIS
  185.  
  186.         SetInst scorefile instrument0 instrument1 ...
  187.  
  188.     DESCRIPTION
  189.  
  190.         Changes the name of instruments in the SMUS scorefile. The
  191.         instruments given in the command line are in the same order as
  192.         listed by ShowInst. Instrument0 corresponds to the first instrument
  193.         listed by ShowInst, Instrument1 corresponds to the second
  194.         instrument, etc. If "." is given as the name for an instrument, the
  195.         instrument is not changed.
  196.  
  197.         This command is very useful for adjusting scores from Sonix, Deluxe
  198.         Music, and other editors for playback with various SMUS players,
  199.         such as those available from The Other Guys, which can use a
  200.         variety of different sampled instruments such as 8SVX IFF, Audio
  201.         IFF (AIFF), and SoundScape. You could write the score on a standard
  202.         score editor and then use SetInst to place high quality instruments
  203.         in your song, playing back the results with a Synthia type SMUS
  204.         player.
  205.  
  206.  
  207.     EXAMPLE
  208.  
  209.         We might have a song called RowYourBoat  which has the following
  210.         instruments listed by ShowInst:
  211.  
  212.             0. Guitar
  213.             1. Drums
  214.             4. Bells
  215.             5. Piano
  216.             7. Default
  217.  
  218.         If we wanted to change Piano to Organ and Default to Marimba we
  219.         would use:
  220.  
  221.             SetInst RowYourBoat . . . Organ Marimba
  222.  
  223.         The "." listed above means no change for those instruments. The new
  224.         listing by ShowInst would show:
  225.  
  226.             0. Guitar
  227.             1. Drums
  228.             4. Bells
  229.             5. Organ
  230.             7. Marimba
  231.  
  232.  
  233.     SPECIAL NOTES
  234.  
  235.         SetInst alters the specified files. If you need to keep a copy of
  236.         the original file, you should work with a COPY of the score rather
  237.         than the original.
  238.  
  239.  
  240.  
  241.  
  242.     RangeInst
  243.  
  244.     NAME
  245.  
  246.         RangeInst - Adjusts all notes which use a particular instrument to
  247.         only play within a specified range.
  248.  
  249.     SYNOPSIS
  250.  
  251.         RangeInst  scorename instrument lownote highnote
  252.  
  253.     DESCRIPTION
  254.  
  255.         RangeInst adjusts all the notes for "instrument" so they play
  256.         between "lownote" and "highnote". "instrument" is the number to the
  257.         left of the name of the instrument as listed by ShowInst. "lownote"
  258.         and "highnote" are MIDI note numbers 1 to 127 with 60 being middle
  259.         C.
  260.  
  261.         RangeInst will first attempt to correct an out of range note by
  262.         transposing the note up or down one or more octaves. If this fails,
  263.         the note will be changed to "lownote" or "highnote" to keep the
  264.         note within the specified range.
  265.  
  266.         RangeInst is useful when you have SetInst an instrument which may
  267.         have a limited range. RangeInst is also nice when converting Sonix
  268.         files to take Deluxe Music or AudioIFF drumsets. An example is
  269.         given below which demonstrates this.
  270.  
  271.     EXAMPLE
  272.  
  273.         Say we have a song called SimpleSong which uses a Sonix SnareDrum
  274.         and we would like to change it to take an AudioIFF instrument
  275.         called drumset which has a snaredrum at the range 60 - 71.
  276.         Originally the file might ShowInst as:
  277.  
  278.             0.  SnareDrum
  279.             3.  Guitar
  280.  
  281.         We would first SetInst:
  282.  
  283.             SetInst SimpleSong DrumSet
  284.  
  285.         The file now ShowInst as:
  286.  
  287.             0. DrumSet
  288.             3. Guitar
  289.  
  290.         We would then adjust the notes which played the Sonix SnareDrum to
  291.         play in the snaredrum range of DrumSet by using:
  292.  
  293.             RangeInst ShowInst SimpleSong 0 60 71
  294.  
  295.         where 0 corresponds to the ShowInst instrument number of DrumSet
  296.         ; 60 and 71 correspond to the range of the snaredrum in DrumSet.
  297.  
  298.     SPECIAL NOTES
  299.  
  300.         RangeInst alters the specified files. If you need to keep a copy of
  301.         the original file, you should work with a COPY of the score rather
  302.         than the original.
  303.  
  304.  
  305.  
  306.     TransposeInst
  307.  
  308.     NAME
  309.  
  310.         TransposeInst - Transpose all notes which use a particular
  311.         instrument up or down.
  312.  
  313.     SYNOPSIS
  314.  
  315.         TransposeInst score instrument transposevalue
  316.  
  317.     DESCRIPTION
  318.  
  319.         Transposes all notes within SMUS IFF file "score" which use
  320.         "instrument" up or down "transposevalue" notes. If "transposevalue"
  321.         is positive, the notes will be transposed up. If "transposevalue"
  322.         is negative, the notes will be transposed down. "instrument" refers
  323.         to the instrument number as listed by ShowInst.
  324.  
  325.         TransposeInst is useful when an instrument plays too high or to
  326.         low. For instance an AudioIFF flute might play a couple of octaves
  327.         lower than a Sonix flute. If you wanted to use the AudioIFF flute
  328.         you would use TransposeInst with a value of 24 to transpose the
  329.         notes in the score to play the same octave as the Sonix flute would
  330.         normally.
  331.  
  332.     EXAMPLE
  333.  
  334.         We might have a score called TooLow which has a guitar which plays
  335.         an octave lower than we desire. The listing from ShowInst might
  336.         read as:
  337.  
  338.             0. Drums
  339.             1. Piano
  340.             3. Guitar
  341.             4. Drums
  342.  
  343.         To transpose the notes for the guitar up an octave we would use:
  344.  
  345.             Transpose TooLow 3 12
  346.  
  347.         "3" is the number of the guitar while "12" is the value we wish to
  348.         raise the notes, in this case one octave. We could just as easily
  349.         lower the guitar an octave by using:
  350.  
  351.             Transpose TooLow 3 -12
  352.  
  353.     SPECIAL NOTES
  354.  
  355.         TransposeInst alters the specified files. If you need to keep a
  356.         copy of the original file, you should work with a COPY of the score
  357.         rather than the original.
  358.  
  359.  
  360.  
  361.  
  362.  
  363.     ConvertIMSMUS
  364.  
  365.     NAME
  366.  
  367.         ConvertIMSMUS - converts Instant Music SMUS files to normal
  368.         (chorded) SMUS files.
  369.  
  370.     SYNOPSIS
  371.  
  372.         ConvertIMSMUS inscore outscore
  373.  
  374.     DESCRIPTION
  375.  
  376.         Converts an Instant Music score to a READABLE, chorded SMUS file.
  377.         Instant Music writes out files using special reserved codes to code
  378.         the chords in a song, rather than writing normal chords. As a
  379.         result, when you load the song into Deluxe Music and many other
  380.         score editors, you lose the chords. ConvertIMSMUS understands these
  381.         special codes and will translate them into normal chords so you can
  382.         load them into Deluxe Music and other score editors. However,
  383.         Instant Music will not read the new file properly (sigh). So you
  384.         should keep an Instant Music copy and a normal SMUS copy of the
  385.         original score.
  386.  
  387.         You do NOT need to use this utility to play back using the
  388.         standard, new SMUS players released by The Other Guys. Our players
  389.         understand the special codes also and will play Instant Music
  390.         Chords. Use ConvertIMSMUS if you would like to have a full printout
  391.         of an Instant Music score from another score editor such as Deluxe
  392.         Music.
  393.  
  394.     EXAMPLE
  395.  
  396.         We might have an Instant Music score called Jam1 which we would
  397.         like to load into Deluxe Music and keep the chords which played on
  398.         Instant Music. We would like to keep a copy of Jam1 so we can edit
  399.         on Instant Music if we need to, so we will call the adjusted score
  400.         Jam2. The command line for converting this score would be:
  401.  
  402.             ConvertIMSMUS Jam1 Jam2
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.