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 >
Wrap
Text File
|
1990-06-30
|
13KB
|
409 lines
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 <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