Contents Chapter 1 License 3 Chapter 2 Packaging 5 Chapter 3 Description 7 Chapter 4 Enhancements 9 Chapter 5 Errors 11 i Sunday, April 2nd, 1989 D10VOICE 1.0 18:23 D10VOICE and all documentation Copyright 1989 Peter Williams. I looked in the manual for my D10 and could find no Copyright, trade mark, etc. for either Roland or D-10. D10VOICE 1.0 1 2 D10VOICE 1.0 Chapter 1 License D10VOICE is a copyrighted program offered "as is" for personal use, testing, and evaluation. Anyone who uses D10VOICE agrees to the following provisions. D10VOICE is a "shareware program" and is provided at no charge to the user for evaluation. Feel free to share it with other users of Roland's D10 synthesizers. However, any copies made must include all files and no changes to these files may be made. D10VOICE may also not be distributed as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and wish to use D10VOICE beyond a 21 day trial period, you must make a registration payment to Peter Williams. 280 Leedom Way Newtown, PA 18940 The registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. At the end of the 21 day trial period if you elect not to register D10VOICE you must stop using it. You may keep a copy and pass D10VOICE along to others who wish to try it. The registration fee for Version 1.0 of D10VOICE is $20. Version 2.0 is expected to be available by the fourth quarter of 1989 (see the chapter on enhancements). The price for version 2 will be $50. However, anyone who registers version 1 before December 31 1989 for $25 will receive version 2. 3 4 D10VOICE 1.0 Chapter 2 Packaging The D10VOICE package should contain 5 files. D10VOICE.EXE is the program. D10VOICE.HLP contains the on-line help information for D10VOICE. This file is not required to run D10VOICE. However, it is the only place that most of D10VOICE is documented. D10VOICE.TXT the document you are reading now. D10VOICE.TIM a small timbre file that may be used to demo D10VOICE if you do not have a D10 or a MIDI interface. This file contains some factory timbres. D10VOICE.TON a small tone file that may be used to demo D10VOICE if you do not have a D10 or a MIDI interface. This file contains some factory timbres. If you are missing any of these files and want a diskette containing them please send $5 for a complete diskette to the registration address. If you decide to register D10VOICE the $5 will be credited to you. 5 6 D10VOICE 1.0 Chapter 3 Description Before you modify anything in your D10 PLEASE have a good backup just in case you want the factory settings back. D10VOICE is a tone and timbre editor for the Roland D10 synthesizer. It will read temporary tones and timbres from the D10. It will also read the internal tones and timbres. These tones and timbres are stored in two files, one for tones and one for timbres. Both of these files are keyed on a ten character name. For tones this is the same name as the D10 uses. When a tone is read and it has the same name as a tone already in the tone file you may elect to overwrite the existing tone, not read the new tone, or change the name of the new tone. When reading timbres a default name is made from the location the timbre is read from. When a new timbre has the same name as an already existing timbre you have the same choices as with the tones. Once a tone or timbre is read into D10VOICE it may be edited and loaded back to the D10. In order to create a new timbre or tone just select an existing one and while editing it change the name. The original timbre or tone will be left in the file and a new one added. There is an additional option for timbres in D10VOICE. You may select a tone from D10VOICE to associate with the timbre. When loading the timbre to the temporary area of the D10 the tone will also be loaded. While editing a tone or timbre a picture of the keyboard appears on the bottom of the screen. If you point at this with the mouse the tone or timbre you are working on will be loaded into the D10 as temporary number 1. If you press the left mouse button while pointing to a key that note will be played by the D10. To change a value for a tone or timbre just point at it with the mouse and press the left button. In most cases moving the mouse left or right will lower or raise the value. When the correct value appears press the left button again. 7 More complete instructions about how to make D10VOICE work may be obtained at most points by pressing F1. This will put you into an on-line help system. About the only thing not discussed in the on-line help are the error messages. They may be found in the Errors chapter. Now you should be ready to try D10VOICE. Make sure you have a backup of your D10 and have fun. 8 D10VOICE 1.0 Chapter 4 Enhancements It is now the end of the first quarter 1989. I expect to have version 2 of D10VOICE available in the last quarter of 1989. I have several enhancements in mind and I hope that after using D10VOICE you might have a few ideas. I WELCOME ALL comments about D10VOICE. If there is something you want added or changed drop me a line when you register. Also feel free to drop me a line at any time. I prefer Compuserve, but I can also be reached by the U.S. mail. If you don't register drop me a line and tell me what I can do to the program to make you a user. Finally, if you don't want version 1 but would like to try version 2 send $5 and I will ship version 2 when it becomes available. Now my planned enhancements for version 2 A real database structure for the files. This will include several index options, including some user fields that you may select on. A conversion program will be available to convert the files from version 1 to the database of version 2. Support for patches. The ability to store a text description (about 1k bytes long) along with anything. The ability to group tones, timbres, and patches for bulk loads to the D10. The ability to print data sheets for timbres, tones, and patches. I would like to offer some form of random tone generation. Most of all I would like to offer what you want so if you have any ideas please drop me a line. 9 10 D10VOICE 1.0 Chapter 5 Errors Error messages are one of the few areas of D10VOICE that do not have on-line help. Some errors allow you to continue processing and others do not. D10TONE 1 - Starting tone xx must be less than tone end yy When reading tones from the D10 you must specify a starting and ending tone. The ending tone must be greater than or, if you only want to read one tone, equal to the starting tone. D10COM 1 - read error for tone db: xxxxxxxxxxx While reading from the named tone database a read error occurred. Restore a backup copy of the indicated database. D10COM 2 - write error for tone db: xxxxxxxxxx While writing to the named tone database a write error occurred. Restore a backup copy of the indicated database. D10COM 3 - D10VOICE does not have any xxxxx to pick. You asked for a pick list of some sort and you do not have anything to pick from. Read some tones or timbres from the D10 and try again. D10COM 4 - Sort error D10VOICE was sorting something and probably ran out of memory. Give D10VOICE more memory, reduce the number of tones and timbres in the databases, or remove the help file (D10VOICE.HLP). D10COM 5 - write error for timbre db: xxxxxxxx While writing to the named tone database a write error occurred. Restore a backup copy of the indicated database. 11 D10COM 6 - read error for timbre db: xxxxxxxxxx While reading from the named timbre database a read error occurred. Restore a backup copy of the indicated database. D10INIT 1 - Read error for tone db: xxxxxxxxxxxx While reading from the named tone database a read error occurred. Restore a backup copy of the indicated database. D10INIT 2 - Read error for timbre db: xxxxxxxxxx While reading from the named timbre database a read error occurred. Restore a backup copy of the indicated database. D10INIT 3 - Open error for timbre db: xxxxxxxxx While opening the indicated timbre database an error occurred. Restore a backup copy of the indicated database. D10INIT 4 - Open error for tone db: xxxxxxxxxxxxx While opening the indicated tone database an error occurred. Restore a backup copy of the indicated database. D10INIT 5 - The following files must either all be present or absent: "xxxxxxx", and "xxxxxxxx" The Timbre and Tone databases must both exist or be absent. Either delete the one that exists or restore the other one. D10INIT 6 - Unsupported graphic mode D10VOICE only supports EGA and VGA graphic adapters. The program detected a non supported graphic adapter. D10INIT 7 - Mouse not installed D10VOICE requires a Microsoft compatible mouse and mouse driver be installed. Install the mouse driver and rerun. D10MISC 1 - 14 These messages all deal with errors during the release of unused space in the database files. Unless there is no free space on your disk these errors should never occur. If they do you should restore a backup of the files and rerun the release. Each message has the type of file with the error. 12 D10VOICE 1.0 To release the space a new file is created with a file type ending in X (TIX and TOX). The current records in the TIM and TON files are copied to these new files. Then the TIM and TON files are deleted. Finally the TIX and TOX files are renamed to TIM and TON. R10MISC - 1 Error opening xxx The new file could not be created. This is probably because of a lack of disk space. R10MISC - 2 seek error for xxx There was an error seeking to the TON or TIM database. Restore the indicated file. R10MISC - 3 copy error for xxx There was an error reading TON or TIM or writing to xxx. Restore the indicated file. R10MISC - 4 close error for xxx There was an error closing the indicated file. Restore the indicated file. R10MISC - 5 erase error for xxx The TIM or TON file could not be erased. Restore the indicated file. R10MISC - 6 rename error for xxx The new file could not be renamed to the correct file type. Restore the indicated file. R10MISC - 7 reopen error for xxx The indicated file could not be reopened. Restart D10VOICE. D10TIMBR - 1 Starting Timbre n must be less or equal Timbre end n. When reading timbres from the D10 D10VOICE will start at the first timbre you pick and read up to the second timbre you pick. The first must be lower than the second. 13 D10HELP 1 - Help is not initialized. When D10VOICE was initialized it could not find the help file (D10VOICE.HLP). You asked for help and none is available. D10HELP 2 - Help display error An error occurred when attempting to display a help panel. The help file (D10VOICE.HLP) may be corrupted. D10HELP 3 - Help file not found. During initialization the help file (D10VOICE.HLP) could not be found. D10VOICE may be run without on-line help. If help is desired move the help file to the current directory and restart D10VOICE. D10HELP 4 - Help file invalid. The help file (D10VOICE.HLP) is invalid. Restore it from the distribution diskette. D10HELP 5 - Insufficient memory for help. There is not enough memory available to load the on-line help system. D10VOICE may be run without help, but it will probably run out of storage later. Make more memory available. D10HELP 6 - Help error An undetermined help error occurred. D10INT - 1 Tone xxxxxx not found. While loading a Timbre it called for a tone from D10VOICE to also be loaded and the tone could not be found. Change the timbre to use a tone from the D10 or one that D10VOICE knows about. 14 D10VOICE 1.0