* Distribution/Copyright

* Thanks & Acknowledgements

* Requirements

* Installation

* How to use the program

Wav2Krz gives you a quick and easy way of porting .wav-files from your PC to your K2x00.(Even if you have a K2000 with an old OS version that doesn't allow you to import .wav-files directly !!!)

As an additional bonus, Wav2Krz also allows you to split existing .krz-files into multi-disk files or join existing multi-disk files into a single .krz-file.

Wav2Krz takes 1 or more .wav files and generates a .krz file from it. The .krz-file contains a default program, keymap and sample-object for each .wav file. The resulting .krz-file can be loaded into the Kurzweil K2x00 series sampler/synth. If necessary the .krz-file can be split into several files (multi-disk file) for transferring to the K2x00.

Since V3.00 it is possible to construct a keymap with up to 3 velocity layers, with the samples from the .wav-files. There is also an ‘Automatic Mapping’ function to assist you during the mapping.

This program is mail-ware. You may freely use and distribute it. However if you use it you must mail me your reaction, the configuration (Kurz & PC) you use the program for & your E-mail address on a postcard of the place you live. This way I can get some idea of how much the program is used and whether it is worthwhile continuing to develop software for the K2x00 synth.

You may only distribute the original zip-file. If you want to distribute this program on a compilation disk/medium you must send me a copy of the complete medium for free.

The author:

Bart Lemaire E-Mail: w2khome@digibel.org

Hoveniersstraat 41

B-9050 Gent

Belgium.

The Wav2Krz software is Copyright (C) 1998/2000 by Bart Lemaire. All rights for this software are reserved by the author. You are not allowed to modify or reverse engineer the contents of the program and documentation files. This software may not be sold or used for commercial purposes without permission of the author.

All trademarks are property of their respective owners.

There is no warranty or claim of fitness or reliability. The program is distributed AS IS, and the author shall not be held liable for any loss of data, down time, loss of revenue or any other direct or indirect damage or claims caused by this software.

Thanks to Geoffrey Mayer of the "K2000 Mailing List" for sending me his information about the skeleton of the .krz file format and his ideas for improving the program. This has been a big help to me!

Thanks to Nick Halliwell & Geoffrey Mayer for their time, help & support, to Mike Clarke for the server-space & link.

Thanks to Nigel Spencer of "Synth Zone" http://www.synthzone.com/ and Tony Palermo of the "K2000-K2500 Launch Pad" http://home.sprynet.com/sprynet/palermo/k_main.htm for supporting this program on their (excellent) sites.

Thanks also to all the people that gave their support/opinion on Wav2Krz and, most of all, to the people that actually have sent me a postcard...

Win95 or higher

Kurzweil K2x00

Unzip the file Wav2Krz.zip into a directory of your choice. Warning: In order to work properly, the file 'W2ktemp.dat' must reside in the SAME directory as the 'Wav2krz.exe' file !

Start the program by clicking on the Wav2Krz.exe file. If you want, you can add the program to the windows 'start' menu.

(The original zip-file contains 3 files: Wav2Krz.exe,W2ktemp.dat and Wav2Krz.doc)

Before you can generate a .krz-file you must create a sample-pool. A sample-pool is a list of wav-files together with some K2x00 parameters that describe the .krz-file that will be generated.

Add the .wav files to the sample pool, using the [Add] button. You can add up to 100 .wav-files to the pool. If you select a sample in the sample-pool box, the Wav-info section shows some information about the selected .wav-file. The selected sample can be auditioned using the [Play] & [Stop] buttons. Use the [Del] button to remove a selected sample from the pool.

You can save a sample-pool for future editing/reference using the normal Windows File-menu functions. Sample-pools are saved with a .w2k extension. A sample-pool does NOT contain any sample data, only references to the path of the .wav files. Therefore, if you want to edit a saved sample-pool, you must make sure that the .wav files are still at the same locations on your HD! If the data is no longer available or if the file is of an unsupported type it will be skipped when generating the .krz-file. Remark: 4-bit & non-PCM wav-files are not currently supported.

After or during the creation of a sample pool, you can specify some parameters for the K2x00 objects. These parameters are: Sample, Keymap & Program names, the sample loopswitch and the sample root-key. You can edit the parameters after selecting the sample in the sample-pool. If you leave the Keymap & program-names blank, the program will automatically use the same name as the sample-name for these objects. By default the sample-name is taken from the .wav filename but can be changed if necessary.

If you check the LoopSwitch option, the sample will loop from end to start, when played on the K2x00 keyboard.

With the RootKey you can specify the key that plays back the sample at the original pitch. The first up/down arrows let you change the rootkey, the second let you change the octave.

If you 'uncheck' the enable button for the Keymap or Program-object, the object will not be saved in the .KRZ-file. Enable is always checked by default.

Once you have finished the creation of the sample-pool you can generate the .krz-file by clicking on the [Make File] button. If you have selected some very large samples, the generation may take some time... The resulting .krz file will contain all the valid samples from the pool and can be ported to your K2x00 by loading them in disk-mode. If the samples are too large to fit on a single disk, you might want to check the 'split files' option. If this option is checked, the saved .krz file will be split into multi-disk files.

The [Settings...] button leads to the Settings dialog-box which allows you to specify the first object ID-number for the krz-objects and the maximum file-size for muliti-disk files You can choose 1 of the 2 preset-sizes (for 720 Kb DD or 1.4Mb HD floppies) or you can specify whatever size you want by entering it in the numeric box & checking the 3rd option. The specified size is in Kb, with 1Kb being 1024 bytes.

The multi-disk files are named as: "filename.KRZxx" with xx indicating the disk number. To

transfer these files to your K2x00, format enough floppies and label them clearly as 1,2,...,x.Then copy each file to the corresponding floppy. (EG: filename.krz01 to disk 1; filename.krz02 to disk 2, etc.)

After copying, you will need to rename all the files identically before they can be loaded by the K2x00.(the easiest way is just to remove the xx number at the end of the files) Always start loading with the first disk. Your K will automatically ask for the next disk(s).

The Tools-menu contains 2 handy functions for using multi-disk files:

1] With the tools->split existing file... function you can split an already existing .krz file. Use the browse button to select the source file (file to be split). You can also enter an optional destination name. If you don't enter a name the program will use the same name as the source. The splitting is similar to the description above. Before splitting you can change the file-size with the [Settings] as described under 3].

2] The tools->Join existing files... you can combine a multi-disk file into a single .krz file. Just select the first file of a multidisk-file with the browse button. The destination name is optional. If you don't specify a destination name the program will use the source-name with a 'J' added at the end of the file. The joining routine expects all the files to have their order number as the last character(s)

of the filename. This is compatible with both the output of the splitting-routine and the 'internet-standard' for naming multi-disk krz-files as: name.kr1, name.kr2, etc. If you have more than 9 files to be joined, you must use a 2 digit number (using leading 0's). EG: name.krz01, name.krz02, ... , name.krz09, name.krz10, etc. You can join a maximum of 100 files (00 to 99, usually you'll start with 01 so you can join up to 99 files); The program stops the joining process when it can't find any more files. If you don't supply all the files or if you mix up their order, the joined file won't work properly. Please note that all the files which are to be joined must be in the same directory.

You can construct your own keymap (spreading the different samples over the keyboard) with the samples in the pool. To enter the keymap editor, press the [Edit user Keymap] button. The table at the left-hand

side represents the keyboard. By default al keys are assigned to the first sample in the pool. You can change this by selecting the right ‘key’. To select a range, first click on the first ‘key’, hold down the shift

Key on your keyboard and click at the end ‘key’ of the range you want to select. By holding the control key you can select different keys that don’t make up a continuos range. Once you selected a range, you can assign a sample to it by selecting the desired sample in the ‘Edit selection’ area at the upper right corner. (press the small arrow next to the selection box to make all the samples pop up so you can pick the one that you want). If necessary, you can also change the root-key for the chosen sample to reflect the new situation on the keyboard.

By default the keymap is for one velocity range. By changing the number of ranges you build keymaps with up to 3 velocity ranges. The tabs at the top of the ‘keyboard’ table select the range to be edited. The crossover points determine the velocity at which the velocity switches to the next range.

The name of your custom keymap can be entered in the ‘User Keymap Name’ field at the right bottom.

If you have a lot of samples to map, it might be handy to use the ‘Auto Mapping’ function. First select a range on the ‘keyboard’-table and then press the ‘Auto Mapping’ button to show the dialog window.

The ‘Mapping Range’ shows the range of the keyboard that will be mapped. You can always alter this range if you like. If there was no range selected when you pressed the ‘Auto Mapping’ function, the range will default to the C2-C7 range. (=the normal K2000 keyboard range). You can set the number of repetitions for each sample. If the range is smaller than the range needed to map each sample for ‘the number of repetitions’ times, the mapping will stop at the end of the range, skipping the the leftover samples. In the reverse situation where the range is larger, the mapping will ‘roll-over’, starting again with the first sample. Whenever you change the range, the number of repetitions is set to the value that covers the whole range without rollover.

The automatic ‘Rootkey Adjust’ has 4 possibilities:

• Don’t adjust: The rootkeys won’t be changed.
• To First Note: The rootkey will be adjusted to match the first note in the repetition range.
• To Middle Note: The rootkey will be set to the middle note in the repetition range
• To Last Note: The rootkey will be set to the last note of the repetition range.

Further you have another three options:

• Treat white and black keys as a single key: will do just what it says, if there is a black key following the white key (e.g. C and C#) they will be counted as 1 single key. This can be useful when mapping drum-sounds that you want to ‘roll’.
• Map white keys only: Skips all black keys. (leaves the original assigned sample)
• Map black keys only: Skips all white keys…

• The latter 2 options are mutually exclusive (enabling one disables the other)
• You can use the auto-mapping function more than once for different ranges or with different options enabled. (e.g. first mapping the white keys only and the 2nd time mapping only the black keys)

If this explanation sounds a little ‘cryptic’, just try and see some times and you’ll soon get the hang of it.

V0.90 First release version for testing purposes.

V0.92 Added some small improvements & object naming.

V1.00 First release version.

V2.00 Re-design of the user interface; Wave-pool added for multiple-file conversion; Support for stereo-files; Loopswitch-bug solved; support for splitting files. into multi-disk files. Splitting & Joining of multi-disk files.

V2.02 Some minor optimisations - Improved documentation.

V2.05 Corrected the bug in the rootkey selection and the bug in the join-routine for >9 files. (Thanks Ron & Tony)

V3.00 Added the keymap-editor.

-------------

Last edit: 23 January 2000