Kurzweil SMP20ADD User Manual

ADDENDUM TO

KURZWEIL 150 FOURIER SYNTHESIZER

SOUND MODELING PROGRAM

VERSION 1.0 USER’S GUIDE

FOR

VERSION 2.0 RUNNING ON:

APPLE IIe, APPLE IIc, APPLE II+, COMPATIBLE CLONES, and

APPLE MACINTOSH (via II-IN-A-MAC tm)

KMSI P/N: 91010702

TABLE OF CONTENTS

1.SUMMARY OF IMPROVEMENTS OVER VERSION 1.0

2.INSTALLATION

2.1Apple IIe

2.2Apple IIc

2.3Apple II

2.4Changing the MIDI Interface Slot

2.5Installing a Screen Print Program

3.SUMMARY OF NEW MENU ORGANIZATION

4.SPECIAL POWER KEYS

5.FILENAME HANDLING

6.LOAD LIBRARY-FUNCTION

7.VOICE MENU AND FUNCTIONS

8.K150FS PROGRAM LIBRARIAN FUNCTIONS

9.MODEL READBACK FROM THE K150FS

10.AMPLITUDE ADJUST FUNCTIONS

11.TIME ADJUST FUNCTIONS

12.CONTOUR SHAPE COPY FUNCTIONS

13.GRAPHIC FREQUENCY DISPLAY/EDIT

14.PARTIAL SELECTION

15.ADDITIONAL NOTES AND TECHNIQUES

15.1Sizes of Things

15.2Disk File Maintenance

15.3Multiple Shape Copy Using Overlap

16.SOUND LIBRARY 2.0

17.Amendment to .S.M.P. Version 2.0 Installation Procedure

18.Notes for II-in-a-Mac Version of K150FS .S.M.P.

19.II-In-a-Mac .S.M.P. Quick Startup Procedure

.S.M.P Version 2.0

1

1.0SUMMARY OF IMPROVEMENTS OVER VERSION 1.0

Version 2.0 of the Kurzweil 150 Fourier Synthesizer Sound Modeling Program has been greatly expanded and improved over version 1.0. Besides many additional fundamental and macro functions designed to make sound creation quicker and easier,

.S.M.P. 2.0 is more intuitive in its operation, and the distribution disk has many more usable sounds created entirely with the program. In addition, several modifications of .S.M.P. Are included for optimum operation on other Apple II models.

SUMMARY OF NEW FEATURES

1.In situations that require entry of a filename, the name may be selected by moving a cursor around the disk file catalog listing.

2.The catalog listing can now page-flip to show up to 250 files.

3.Disk file names may now be 9 characters long to facilitate identification of multiple versions of the same model or voice.

4.The catalog display is updated after a save, copy, delete, or rename operation if it was showing.

5.A macro Time Adjust function has been implemented.

6.A macro Amplitude Adjust function has been implemented.

7.Multiple models may be linked together into a complete voice.

8.Some menus have been reorganized and many often needed functions appear in formerly empty menu boxes.

9.It is now possible to save K150FS programs on disk and then reload them.

10.The "Sign on Screen" will now only be shown once after the program has been loaded. Subsequently, EXITing to the top level will display a highlighted menu labeled TOP LEVEL and leave the rest of the screen display intact.

11.It is now possible to print a graphic "screen dump" on a dot matrix printer at any time.

12.A number of functions can now be executed any time with a single keystroke even if they are not part of the current menu.

13.Graphic display of partial frequencies has been improved and it is now possible to directly edit the display with the cross-hair.

14.The partial selection functions have been improved.

15.A loop may be removed from a contour by selecting "Loop" on the "Contours" menu and entering 0 for the loop-from time.

16.A "patch program" is included for modifying the slot .S.M.P. uses for MIDI communication.

Additionally, some bugs and arithmetic round-off error that were found in Version 1.0 have been fixed. Sound files created by version 1.0 are fully compatible with 2.0 and vice-versa except that 9-character files saved by version 2.0 cannot be retrieved by version 1.0.

Because of the different computer options, provisions for alternate slot usage, and screen printing, installation of .S.M.P. Version 2.0 is more complex than 1.0. Be sure to read the next section before attempting to use the program with other than an Apple IIe computer.

2.0INSTALLATION

The .S.M.P. Version 2.0 distribution disk is double-sided. On the normal side with the label is a pre-installed version for an Apple IIe computer along with the sound library and two utility programs for copying disks. If you have been using Version 1.0 successfully in the past, then this installed version of 2.0 should be suitable as is. If you have an Apple IIe (or equivalent "clone"), or an Apple II+ with language card, modifications designed specifically for your machine may be found on the back side of the distribution disk. The II-in-a-Mac version for use on Apple Macintosh computers is supplied already installed on a 3-1/4" disk. A separate document describes how to run the II-in-a-Mac version and the differences between it and the Apple II versions.

The first step, regardless of what Apple-II computer you have, is to make a copy of the label side of the distribution disk. First "boot" the .S.M.P. distribution disk with the label in the normal position. In just a few seconds the display should show a menu of 3 possibilities. Press the 3 key (Copy Whole Disk). Now follow the steps outlined below:

TWO DISK DRIVES:

1.Enter slot 6 drive 1 for the source and slot 6, drive 2 for the copy.

2.Insert a blank disk (need not be formatted) into drive 2.

.S.M.P Version 2.0

2

3.Press Return again and wait for about a minute. The copy in drive 2 will become your "working master".

4.Answer N to the "Another copy?" question. The program exits to BASIC.

ONE DISK DRIVE:

1.Enter slot 6 drive 1 for both the source and the copy.

2.Get a blank disk (need not be formatted) and hold it.

3.Press Return again and wait for a few seconds until the program asks for you to insert the copy disk.

4.Insert the copy disk and press return. The program will ask for about 10 swaps between the source and the copy disk.

5.When it is done, answer N to the "Another copy?" question. The copy will become your "working master". The copy program exits to BASIC.

Once the label side of the distribution disk has been copied, skip to the section below which applies to your machine.’

2.1APPLE IIe

The correct modification of .S.M.P. is already on the working copy you have just made. If your MIDI interface is not in slot #2, then go to section 2.4 named "Changing the MIDI Interface Slot". If you wish to be able to print the screen on a dot-- matrix printer, go to section 2.5 named "Installing a Print Screen Program". Otherwise installation is complete and you may immediately begin using your working master. If changes were made to accommodate a different MIDI interface slot or a screen print program was installed, you may wish to make a copy of your Working Master and use that so the installation procedure won’t ever have to be repeated.

2.2APPLE IIc

An Apple IIc requires a different modification of .S.M.P. because it must use a MIDI interface connected to a serial port rather than plugged into a slot. A Passport MIDIPRO interface (or equivalent) is required and it must be plugged into the "modem" port. The modified program files for an Apple IIc are found on the backside of the distribution disk. Use the following procedure to delete the Apple IIe modification of .S.M.P. from your working master and replace it with the Apple IIc modification. The procedure uses just drive 1 so it is the same whether you have one or two disk drives.

1.Boot your working master and then press 9 to exit to BASIC.

2.	Enter:	DELETE SMP_IIE_2.0L
3.	Enter:	DELETE SMP_IIE_2.0H
4.	Insert the distribution disk upside down and enter:	LOAD HELLO_IIC
5.	Insert your working master and enter:	SAVE SMP_HELLO

6.Enter: CALL -151 This enters the machine language monitor (.S.M.P. is written in machine language so that it will fit into memory and run fast).

7.Insert the distribution disk upside down again and enter: BLOAD SMP_IIC_2.0L

8. Insert the working-.master and enter:

BSAVE SMP_IIC_2.0L,A$800,L$37FF

9.Insert the distribution disk upside down again and enter: BLOAD SMP_IIC_2.0H

10. Insert the working master and enter:

BSAVE SMP_IIC_2.0H,A$4000,L$5851

Your working master disk has now been modified to run properly on an Apple IIc (or clone) with Passport MidiPro interface. If you wish to be able to print the screen on a dot-matrix printer, go to section 2.5 named "Installing a Print Screen Program". Otherwise installation is complete and you may immediately begin using your working master. However, you may wish to make a copy of your Working Master and use that so the installation procedure won’t ever have to be repeated.

2.3APPLE II+

An Apple II+ requires a different modification of .S.M.P. because its keyboard does not have the cursor arrow keys and the open and solid Apple keys that the Apple IIe and IIc versions make extensive use of. The Apple II+ uses the following keys instead for these functions (keyboard must be in uppercase mode):

U Block cursor up

D Block cursor down

L Block cursor left

.S.M.P Version 2.0

3

R Block cursor right

F Scroll time display forward 4/5 the screen width

B Scroll time display backward 4/5 the screen width

N Flip to next page on catalog, partial, or model listing

P Flip to previous page on catalog, partial, or model listing

Also the cross hair cursor is controlled by the game paddles rather than the cursor and Apple keys. They should be plugged in and in good operating condition before attempting to do any graphic editing with .S.M.P.

The modified program files for an Apple II+ are found on the backside of. the distribution disk. Use the following procedure to delete the Apple IIe modification of .S.M.P. from your working master and replace it with the Apple II+ modification. The procedure uses just drive 1 so it is the same whether you have one or two disk drives.

1.Boot your working master and then press 9 to exit to BASIC.

2.	Enter:	DELETE SMP_IIE_2.0L
3.	Enter:	DELETE SMP_IIE_2.0H
4.	Insert the distribution disk upside down and enter:	LOAD HELLO_IIPLS
5.	Insert your working master and enter:	SAVE SMP_HELLO

6.Enter CALL -151 This enters the machine language monitor (.S.M.P. is written in machine language so that it will fit into memory and run fast).

7.	Insert the distribution disk upside down and enter:	BLOAD SMP_IIPLS_2.0L
8.	Insert the working master and enter:	BSAVE SMP_IIPLS_2.0L,A$800,L$37FF
9.	Insert the distribution disk upside down and enter:	BLOAD SMP_IIPLS_2.0H
10.	Insert the working master and enter:	BSAVE SMP_IIPLS_2.0H,A$4000,L$5851

Your working master disk has now been modified to run properly on an Apple II+ with the MIDI interface in slot 2. If your MIDI interface is not in slot 2,

go to section 2.4 named "Changing the MIDI Interface Slot". If you wish to be able to print the screen on a dot-matrix printer, go to section 2.5 named "Installing a Print Screen Program". Otherwise installation is complete

and you may immediately begin using your working master. However, you may wish to make a copy of your Working Master and use that so the installation procedure won’t ever have to be repeated.

2.4CHANGING THE MIDI INTERFACE SLOT

If it is not possible to install your MIDI interface in slot #2 of an Apple II+ or IIe, then the following procedure can be used to "patch" .S.M.P. to address an alternate slot. The installation procedure described in the previous sections is assumed to already have been done if you have an Apple II+ and that you have a working master which is to be patched.

1.Boot the working master disk and press 0 to exit to BASIC. Then enter: CALL -151 to call up the machine language monitor.

2.Enter: BLOAD SMP_IIE_2.0H (Apple IIe) or: BLOAD SMP_IIPLS_2.0H (Apple II+)

3.Put the distribution disk upside down in the drive and enter: BRUN SLOTPATCH

4.Enter the number of the slot with the MIDI interface. It may be 1-7. Any other number will be ignored.

5.When the monitor prompt (*) appears again, enter:

BSAVE	SMP_IIE_2.0H,A$4000,L$5851	(Apple.IIe)
BSAVE	SMP_IIPLS_2.0H,A$4000,L$5851	(Apple-II+)

The working master is now ready to use.

2.5INSTALLING A SCREEN PRINT PROGRAM

.S.M.P. 2.0 has a provision for printing the high-resolution graphic screen at any time a menu selection is expected. Pressing CONTROL and P together will trigger an attempt to print the screen. However, due to the very wide variety of printers

.S.M.P Version 2.0

4

commonly used with Apple II systems, a program separate from .S.M.P. is used to do the actual printing. Thus "installing" a print screen program amounts to ensuring that an appropriate screen print program is loaded into memory along with .S.M.P.

Loading of the print program into memory is accomplished by the "1" option of the HELLO program that runs when you boot an .S.M.P. disk. The default print program supplied on the label side of the .S.M.P. distribution disk actually just displays a message to the effect that a print program needs to be installed. The back side of the distribution disk contains a print program configured for an Apple Imagewriter connected to the printer port of an Apple IIc which is similar to a Super Serial card installed into slot 2 of an Apple II+ or IIe. If either case applies to you, you may replace the default print program on your working master by doing the following (same for one and two drive systems):

1.Boot your working master disk and select option 9 to exit to BASIC.

2.Enter: CALL -151 to enter the machine language monitor.

3.Enter: DELETE SMP_SCREENPRINT to delete the default print program.

4.Insert the S.M.P. distribution disk upside down and enter: BLOAD SMP_SCREENPRINT_IMGWRTR_SLT2

5.Insert your working master disk and enter: BSAVE SMP_SCREENPRINT,A$300,L$CF

6.The supplied print program for an Apple Imagewriter connected to the printer port (Apple IIc or clone) or a Super Serial card in slot 2 (Apple IIe or II+) has now been installed. Be sure the printer is connected, powered up, and ready, before using the CNTL/P function of .S.M.P.

If you have a different printer or a different interface to it, you will have to obtain or write a high-res screen dump program for it. .S.M.P. imposes the following restrictions on the screen dump program:

1.It must reside in memory at addresses $300-$3CF and have its entry point at $300.

2.It must print page 1 of the high resolution screen at $2000-$3FFF.

3.It may freely use page zero memory addresses $56-$65. Other locations are usable if they are saved and restored (use the text screen area or part of itself for temporary storage).

4.It must make balanced use of the stack and return to the caller with an RTS instruction after the printout is complete. The machine registers A, X, and Y may be freely used, and the decimal mode should remain off. Interrupts should be enabled on return.

3.0SUMMARY OF NEW MENU ORGANIZATION

.S.M.P. Version 2.0 has had its menus rearranged to provide room for new functions, better organize all functions, and conserve memory. Most menus have either not been changed or are similar to the descriptions in Version 1.0 manual. There are enough differences however that a number sequence for reaching a certain place in the menu tree, such as given in Section VI of the Version 1.0 manual should not be followed blindly, instead the name of each selection should be verified before continuing. A foldout chart at the rear of this addendum outlines the Version 2.0 menu tree in terms of the menu name that appears at the top of the menu column along the left edge of the screen.

Perhaps the biggest menu difference is that the sign on screen with the Kurzweil logo and the top level menu selections will only appear once. Once the first top-level selection is made, the standard menu column will be used for all menus including the top-level menu. When exiting from the top level (and thus from .S.M.P.), it is not always necessary to remove the

.S.M.P. disk because the boot program now requires further user action to begin reloading .S.M.P. rather than always reloading automatically as before.

One major menu change is that the K150FS voice and model readback functions have been moved from the top level Voicemenu to the Model Load/Save submenu under Create Model. This is appropriate since the ultimate result of the voice and model readback functions is to load a model into memory from the K150FS (the voice readback is just an intermediate step). In that respect it’s similar to loading a model from the disk or creating the default model.

A fourth function has been added to the top-level menu: Load/Save Programs. This is a convenience function that has been added that allows .S.M.P. to serve as a K150FS program librarian. .S.M.P. cannot do any editing or even detailed display of K150FS programs but it can save and retrieve them by name from disk very quickly. Section 8 describes this menu in detail.

.S.M.P Version 2.0

5

4.0SPECIAL "POWER-KEYS"

For experienced users, .S.M.P. Version 2.0 offers a number of "power-keys" which are control key combinations that perform often needed functions. While all of the power-key functions may be accessed through the menu structure and other operations, using the power-keys executes the function immediately without running through alot of menus and possibly redrawing the screen unnecessarily. Many of the power-keys are active only at certain times. For examples those that deal with scrolling the contour display are not active when a contour is not showing.

To execute a power-key function, press and hold the CONTROL key while striking the indicated letter key. The keyboard should be in uppercase mode. The available power-keys are as follows (these are in addition to the special control keys that substitute for the cursor and Apple keys in the Apple II+ and II-in-a-Mac modification):

CNTL/A Re-audit - Send model buffer to K150FS using last used Audit options.

CNTL/M Move - Scroll contour display so time at cross hair is near left edge.

CNTL/B Beginning - Scroll contour display to beginning (time=0).

CNTL/E End - Scroll contour display to latest endpoint on any contour.

CNTL/S Stretch - Redraw contour using next shorter time scale.

CNTL/C Compress - Redraw contour using next longer time scale.

CNTL/I Increase - Increase amplitude dynamic range displayed.

CNTL/D Decrease - Decrease amplitude dynamic range displayed.

5.0FILENAME HANDLING

Version 2.0 attempts to minimize the need for typing filenames. If the disk catalog display is showing, then any function that requires entry of an existing filename (Load, Delete, source of Copy or Rename, etc.) will first copy the filename the cursor is on into the entry area. This name may then be accepted as is by simply pressing Return or edited with left/right cursor, overstrike, or ctrl/X and then accepted. Blanking the field with the spacebar or ctrl/X followed by Return will abort the function.

For functions that require entry of a new filename (Save, destination of Copy or Rename), a default name is placed in the entry area. For example, for model save, the K150FS model name is copied for editing. For Copy or Rename, the source filename is re-presented for editing.

With the addition of Voice Files and Program Files, there is now an implicit file type associated with every .S.M.P. filename. Files with the same name but of different types are permitted. For functions like Load Model, Load Voice, or Load Program, the file type is handled automatically since the function only deals with a particular tile type. For functions like Delete, Copy, or Rename, which can handle any type of file, Type=Model is assumed. To use these functions with Type=Voice or Type=Program files, the name MUST be entered by cursor selection from the catalog rather than typing in the name.

Page flipping in the file catalog is performed by holding the Open-Apple key down and pressing cursor-down to go to higher catalog entries or cursor-up to go to lower numbered entries (for Apple II+ and II-in-a-Mac, use the N and P keys). Changing the Drive Slot selection while the catalog is displayed will automatically display the catalog of the newly selected disk. Also, any file operation such as Save, Delete, Rename, etc. that changes the catalog will update the catalog display if it is showing. Loading a model or a voice while the catalog is showing will leave the catalog displayed. To display the newly loaded model or voice, it is necessary to select an editing function.

6.0LOAD LIBRARY FUNCTION

This is a new convenience function that will automatically load a consecutive list of Model, Voice, and Program files to the K150FS. For example, with just a few keystrokes, it is possible to have every sound in the library supplied with .S.M.P. 2.0 loaded in just a couple of minutes.

Load Library is in the top level File Manipulate menu. However, a disk catalog must be showing on the screen for the function key to be active. When Load Library is pressed, the dialog box will ask for the first file number of the "library". This corresponds to the sequence number displayed to the left of filenames on the catalog display. To load the whole disk, you would enter 1. Following this, a second dialog box will similarly ask for the last file number in the sequence to be loaded.

.S.M.P Version 2.0

6