SMUS Utilities Copyrights (C) 1990 by The Other Guys and Bob Dayley All Rights Reserved. SMUS Utilities are a set of CLI-only SMUS tools written by The Other Guys. They were written to manipulate demo songs for our products Synthia II, Synthia Professional, and EZ FM. These products are synthesizers and special effects processors which synthesize musical instruments. The disk which normally contains these utilities has a demo of Synthia II, a very nice SMUS player, and several example songs. If you recieved the utilities on a download and did not recieve the disk, the entire disk may be obtained from The Other Guys at 800 942-9402 for a media cost of $5.00. Complete disk demos each of Synthia II, Synthia Professional, and EZ FM Synth are also available for the same cost (the demo included with SMUS Utilities does not have all modules available, the other disks contain all modules, except MIDI). The disk is freely distributal and will also be available from several sources specializing in PD and ShareWare software. The utilities are extremely useful in manipulating SMUS files created by Deluxe Music, Instant Music, Sonix, and several other score editors. There are utilities for optimizing instruments, changing instruments, note transposition and ranging, and Instant Music file conversion. These utilities are also handy for customization for various SMUS players such as the ones published by The Other Guys. The format for each available utility is described later. Catalogs, Information, and Submissions The Other Guys publish several commercial programs. We have synthesizer/effects packages which work with Amiga as well as MIDI sounds. We also have several educational products as well as a proofreading system. Information may be obtained about these products, as well as others by writing: The Other Guys 55 N Main Suite 301-D PO Box H Logan,UT 84321 USA or call toll free: (800) 942-9402 The Other Guys is accepting software submissions for commercial release. If you have a program you would like to market please contact us at the above address or telephone. Distribution These utilities are freely distributable under the following conditions: 1. All the utilities must be bundled together with this document unchanged. The required list of files which should be present in distribution are: ReadMe (this file) ShowInst SetInst FixInst RangeInst ConvertIMSMUS 2. These utilities may distributed on disk ONLY if they are present with the Synthia II demo, SynthiaPlay SMUS player and the songs and instruments on that disk. These utilities may be uploaded to a BBS as long all files present in (1) above are arced and uploaded together. In other words, you may upload the utilities as a package without the player and the demo, but you may only distribute copies by disk if the whole disk is copied, not just part. 3. The Other Guys reserves all commercial rights to these utilities. These utilities may not be published in or for a commercial gain or disk magazine without express written consent from The Other Guys. For information on commercial licensing please contact The Other Guys. 4. No profit may be charged for the distribution of this program. Exceptions are cost of media for PD disk distribution and cost of maintaining memberships on a BBS. Here is a list of the utilities available and how to use them. ShowInst NAME ShowInst - shows required instruments in a SMUS IFF file. SYNOPSIS ShowInst scorefile DESCRIPTION This command lists the instruments used in a SMUS file (scorefile). Each instrument is listed with the corresponding register number. The register numbers are used with commands such as TransposeInst and RangeInst. EXAMPLE To view the instruments used in a song called BlueSky on a disk in drive DF0: in a directory called Music use: ShowInst DF0:Music/BlueSky The results may look like: To play BlueSky you need the following instruments: 0 - NutMeg 1 - EPBells 2 - FlangeGuitar 3 - ChiffOrgan FixInst NAME FixInst - Check and optimize instrument assignments in a SMUS IFF file. SYNOPSIS FixInst smusfile ... DESCRIPTION FixInst checks the instrument assignments in a SMUS file against the score in the SMUS file to find unused and missing instruments. All unused instruments are deleted from the SMUS file. This will prevent the unused instrument from loading resulting in a more compact and faster loading score. Any instruments which are used but not assigned are given an instrument assignment of "Default". These new instruments can be viewed with ShowInst and changed with SetInst. You should use FixInst on most SMUS files before performing any other operation on the file. Many SMUS files available in the public domain have missing instruments. FixInst will reveal these missing instruments. EXAMPLE FixInst ChristmasSong BirthdaySong will result in instrument assignment optimizations on ChristmasSong and BirthDaySong. You may now use ShowInst to view the results and SetInst to change the name of any "Default" instrument assignments. SPECIAL NOTES FixInst alters the specified files. If you need to keep a copy of the original file, you should work with a COPY of the score rather than the original. SetInst NAME SetInst - Change the name of the instruments in a SMUS IFF file. SYNOPSIS SetInst scorefile instrument0 instrument1 ... DESCRIPTION Changes the name of instruments in the SMUS scorefile. The instruments given in the command line are in the same order as listed by ShowInst. Instrument0 corresponds to the first instrument listed by ShowInst, Instrument1 corresponds to the second instrument, etc. If "." is given as the name for an instrument, the instrument is not changed. This command is very useful for adjusting scores from Sonix, Deluxe Music, and other editors for playback with various SMUS players, such as those available from The Other Guys, which can use a variety of different sampled instruments such as 8SVX IFF, Audio IFF (AIFF), and SoundScape. You could write the score on a standard score editor and then use SetInst to place high quality instruments in your song, playing back the results with a Synthia type SMUS player. EXAMPLE We might have a song called RowYourBoat which has the following instruments listed by ShowInst: 0. Guitar 1. Drums 4. Bells 5. Piano 7. Default If we wanted to change Piano to Organ and Default to Marimba we would use: SetInst RowYourBoat . . . Organ Marimba The "." listed above means no change for those instruments. The new listing by ShowInst would show: 0. Guitar 1. Drums 4. Bells 5. Organ 7. Marimba SPECIAL NOTES SetInst alters the specified files. If you need to keep a copy of the original file, you should work with a COPY of the score rather than the original. RangeInst NAME RangeInst - Adjusts all notes which use a particular instrument to only play within a specified range. SYNOPSIS RangeInst scorename instrument lownote highnote DESCRIPTION RangeInst adjusts all the notes for "instrument" so they play between "lownote" and "highnote". "instrument" is the number to the left of the name of the instrument as listed by ShowInst. "lownote" and "highnote" are MIDI note numbers 1 to 127 with 60 being middle C. RangeInst will first attempt to correct an out of range note by transposing the note up or down one or more octaves. If this fails, the note will be changed to "lownote" or "highnote" to keep the note within the specified range. RangeInst is useful when you have SetInst an instrument which may have a limited range. RangeInst is also nice when converting Sonix files to take Deluxe Music or AudioIFF drumsets. An example is given below which demonstrates this. EXAMPLE Say we have a song called SimpleSong which uses a Sonix SnareDrum and we would like to change it to take an AudioIFF instrument called drumset which has a snaredrum at the range 60 - 71. Originally the file might ShowInst as: 0. SnareDrum 3. Guitar We would first SetInst: SetInst SimpleSong DrumSet The file now ShowInst as: 0. DrumSet 3. Guitar We would then adjust the notes which played the Sonix SnareDrum to play in the snaredrum range of DrumSet by using: RangeInst ShowInst SimpleSong 0 60 71 where 0 corresponds to the ShowInst instrument number of DrumSet ; 60 and 71 correspond to the range of the snaredrum in DrumSet. SPECIAL NOTES RangeInst alters the specified files. If you need to keep a copy of the original file, you should work with a COPY of the score rather than the original. TransposeInst NAME TransposeInst - Transpose all notes which use a particular instrument up or down. SYNOPSIS TransposeInst score instrument transposevalue DESCRIPTION Transposes all notes within SMUS IFF file "score" which use "instrument" up or down "transposevalue" notes. If "transposevalue" is positive, the notes will be transposed up. If "transposevalue" is negative, the notes will be transposed down. "instrument" refers to the instrument number as listed by ShowInst. TransposeInst is useful when an instrument plays too high or to low. For instance an AudioIFF flute might play a couple of octaves lower than a Sonix flute. If you wanted to use the AudioIFF flute you would use TransposeInst with a value of 24 to transpose the notes in the score to play the same octave as the Sonix flute would normally. EXAMPLE We might have a score called TooLow which has a guitar which plays an octave lower than we desire. The listing from ShowInst might read as: 0. Drums 1. Piano 3. Guitar 4. Drums To transpose the notes for the guitar up an octave we would use: Transpose TooLow 3 12 "3" is the number of the guitar while "12" is the value we wish to raise the notes, in this case one octave. We could just as easily lower the guitar an octave by using: Transpose TooLow 3 -12 SPECIAL NOTES TransposeInst alters the specified files. If you need to keep a copy of the original file, you should work with a COPY of the score rather than the original. ConvertIMSMUS NAME ConvertIMSMUS - converts Instant Music SMUS files to normal (chorded) SMUS files. SYNOPSIS ConvertIMSMUS inscore outscore DESCRIPTION Converts an Instant Music score to a READABLE, chorded SMUS file. Instant Music writes out files using special reserved codes to code the chords in a song, rather than writing normal chords. As a result, when you load the song into Deluxe Music and many other score editors, you lose the chords. ConvertIMSMUS understands these special codes and will translate them into normal chords so you can load them into Deluxe Music and other score editors. However, Instant Music will not read the new file properly (sigh). So you should keep an Instant Music copy and a normal SMUS copy of the original score. You do NOT need to use this utility to play back using the standard, new SMUS players released by The Other Guys. Our players understand the special codes also and will play Instant Music Chords. Use ConvertIMSMUS if you would like to have a full printout of an Instant Music score from another score editor such as Deluxe Music. EXAMPLE We might have an Instant Music score called Jam1 which we would like to load into Deluxe Music and keep the chords which played on Instant Music. We would like to keep a copy of Jam1 so we can edit on Instant Music if we need to, so we will call the adjusted score Jam2. The command line for converting this score would be: ConvertIMSMUS Jam1 Jam2