Copyright: FMJ Software Copyright (c) 1993,1994,1995


Contents
Copyright, © 1993, 1995, [image] FMJ-Software, All rights reserved

Audio & Wavetable Instrument
Converter & Player
v2.0

1.	Terms of use

2.	Step-by-step instructions

3.	File formats

4.	Audio player mode

5.	Revision history

6.	Adds

Note! This software is Shareware

written by:
F. Markus Jönsson
mail: Svedjevägen 7,  147 52  Tumba,  Sweden
internet email: f93-maj@nada.kth.se

phone: +46-8-530 390 81
www site: http://www.nada.kth.se/~f93-maj/fmjsoft.html


Terms of Use

Licensing agreement:

This piece of software is distributed as Shareware.
This means that you may try out the program a few times for free, but if you decide to use it, you must register it and pay a fee to obtain a license.The license will cover all versions of 2PAT, past present and future, and so is a once per lifetime expence.

The unregistered version has the full functionality of the registered version, except that you can only save three times before having to restart the program. If you register this program you will obtain a personal key that will remove the registration prompt at program startup as well as the imposed save limit.

See the enclosed registration form REGISTER.TXT for details on how to register.

Disclaimer of Warranty:

FMJ-Software exclude any and all implied warranties, including warranties of merchantability and fitness for a particular purpose.
Nor does FMJ-Software make any warranty of representation, either express or implied, with respect to this product,its quality, performance, functionality or fitness for a particular purpose.
Nor shall FMJ-Software have any liability for special, incidental, or consequental damages arising out of or resulting from any use of this product.
Nor shall FMJ-Software have any responsibilities, nor any obligations whatsoever to provide support for this product.
Nor shall FMJ-Software have any responsibilities whatsoever to provide upgrades or bugfixes of any kind.

Trademarks:

All trademarks and servicemarks mentioned in this text are the property of their respective owners.

Distribution:

See REGISTER.TXT for terms.

The following files must always be supplied:
FILE_ID.DIZ	BBS info file.
2PAT.EXE	Program executable.
2PAT.HLP	Program documentation in WinHelp hypertext format.
WFSLOAD.EXE	Loader for the Turtle Beach Maui / Tropez.
AWELOAD.EXE	Loader for the Creative Labs SB AWE 32-
README.TXT	Installation instructions.
REGISTER.TXT	Registration form.


Step-by-Step Instructions

1)	Installation & Configuration:

First read the 'README.TXT' file; Run the program file, 2PAT.EXE.

Choose Program... from the Options menu.

If you have a Gravis Ultrasound, a Turtle Beach Maui or Tropez) or a Creative Labs SoundBlaster AWE32, you can use the auditioning feature of 2PAT to directly hear and play instruments and wavesamples before you save them. Just click the Enable checkbox and choose appropriate MIDI-Input and WaveSynth devices. If you cant get sound check this. If you don't have a midi-in device you can still use this feature by choosing the 'Dummy' midi input device and use any 'onscreen keyboard' program.

Under WaveOut, select the digital audio device to be used when saving to the DAC virtual export format as well as in Audio Player mode

Click OK.

3)	Loading a file:

Press the right mouse button, select Open New File and open a file using the standard dialog box. 2PAT will try to recognize the correct format of a file even though it may have no or even an incorrect extension.

A treeview list with an Bank file->Instrument->Wavesample hierarchy will be constructed from the file loaded and shown. A special 'folder' with a list of all wavesamples contained in the loaded file may sometimes also be appended at the bottom of the list (depending on if 2PAT decides it makes any sense to have such a folder).

4)	Selecting and auditioning an item:

Select an instrument or a wavesample from the list by clicking on it with the mouse.

You can now play it on your midi keyboard, provided that you have a midi-in device, you have turned midithru and you have a supported wavetable synth.

If you do not have one of the supported wavetable synths, but you do have an audio card capable of digital audio, press the right mouse button and choose the Audio Player... menu item to play a sound.

5)	Editing an item.

To edit the name, do a 'slow double click' on the name and edit the name as in a standard text edit control. This works exactly the same as when editing filenames in the Windows 95 shell.. Note also that a 'fast double click' executes the default action of the right mouse button menu.

To edit more parameters, select Properties in the right mouse button menu to bring up the currently selected items property sheet. Note! when using auditioning, any changes can be heard first after you click the OK button in the property sheet.

6)	Saving an item:

To save an item, press the right mouse button and select Save As...

A standard dialog box will appear and prompt you for the file name to save to.
Choose your export format in the Save as type:  box.
Enter a filename (no extension needed) and press OK.

Note! Many of the export formats only support saving Wavesamples and not Banks or Instruments.

Note! To achieve the highest quallity instruments for your wavetable synth, youll probably want to use an instrument editor to manually improve the output from 2PAT by editing amplitude envelopes and other synthesizer specific parameters.

7)	Commands:

Right mouse button:
Save As...,	saves the currently selected item,
Audio Player...,	launches the integrated 2PAT audio player with the selected item,
Properties...,	will pop up a dialog with mostly editable information on the selected item,
Open New File...,	clears the instrument list and prompts you for a new file,
Help,	bring up the contents page pf this file.

Keyboard:
<delete key>,	will remove an item from the list (doesnt delete anything on the disk).

File menu:
Open New File...,	clears the instrument list and prompt you for a new file,
Save Item As...,	saves the currently selected item,
Run Audio Player,	launches the integrated 2pat audio player with the selected item,
Copy To Clipboard,	copies a wavesample to the clipboard,
Item Properties...,	will pop up a dialog with mostly editable information on the selected item,
Exit,	closes the program.

Options menu:
Program...,	is the program property sheet.

Help menu:
Help Topics,	brings up contents page of this help file,
About 2PAT,	brings some program info.


Instrument Editors

For the UltraSound there is the Patch Maker software.
For the Turtle Beach products there is the WavePatch software.
For the SB AWE32 there is the Vienna SF Studio software as well as the Esbeekay shareware editor. Note however that the Vienna editor may not be able to load the files written by 2PAT. This is because it can only edit its own very restricted flavour of .SBK files; use the Esbeekay editor instead.

Theese softwares (with the exception of Esbeekay) should be bundled with the latest revisions of the respective soundcards. New software versions are continuously made available from the respective manufacturers.


2PAT should handle downloading instruments to the Advanced Gravis UltraSound family of soundcards without any problems.
Note however, that the GUS cant handle individual 16bit wavesamples larger than 256KB and a total of 1MB in an instrument (for a card with a full 1MB of memory)


2PAT uses the WFSLOAD.EXE program, included with 2PAT, to download programs to Turtle Beach WaveFront based cards, however, since only the Maui and the Tropez cards is fast enought for this purpose (i.e. to give you a fast 'preview'), only the they will be detected and used. If you have any other WaveFront based card you can save .WFP files and load them with WavePatch instead.

Note! When clicking on an item it will take a little while loading it before you can audition it even though there may not be an hourglass icon.

Note! It doesnt clean up after itself very well, so after some time it will run out of sample memory,sample slots or patch slots and you will be asked if you want to reset the card and try again. Also due to this, the card is completely reset upon exiting 2PAT in order to restore the GM instrument set.


2PAT uses the AWELOAD.EXE program, included with 2PAT, to download programs to Sound Blaster AWE32 cards.

Note! When clicking on an item it will take a little while loading it before you can audition it even though there may not be an hourglass icon.

Note! It will use user bank no 127 to keep instruments in so that bank will be modify and and data previously in it will be lost. If you run out of memory on the card when trying to load an instrument, try removing any other user banks you may have previously loaded to card memory.


If you can't get midithru to work (in order to use the audition feature), check:
- Have you connected your midi in device properly?
- Are any other program using the input device?
- If you don't have a midi in device, there's several programs that emulates one with an on-screen keyboard.
- If you can't hear a specific instrument but it normally works, is it a one key only drum sound? (one key only!)
- Do you really have a supported card?


File Formats

When importing files, 2PAT tries to determine the file type, not only by looking at the filename extension, but also by looking at signatures within the file. Thus, even if it has an incorrect or no extension, it can in most cases be correctly identified. Not all formats are possible to detect in this way though, so you may still want to pay some small attention to using correct file extensions. If the file is not of a recognized format, it is treated as raw audio data and a dialog box pops up querying the user for additional info.

2PAT recognizes  the following import file formats:

669	669 tracker modules.
AIFC	Compressed Audio Interchange File Format.
AIFF	Audio Interchange File Format.
AU	Sun/NeXT/DEC Audio files.
AVR	Audio Visual Research sound files.
CDR	Raw Audio-CD data.
DEWF	Machintosh SoundCap/SoundEdit recorded instrument format
DMF	Delusion/XTracker Digital Music Fileformat.
DSF	Delusion/XTracker Digital Sample Fileformat.
DSM	Digital Sound Module tracker format.
EFE	Ensoniq EPS family intrument files.
EUI	Ensoniq EPS family compacted disk images.
F2R	Farandoyle Linear module 2. format.
FAR	Farandoyle tracker modules.
FSM	Farandoyle Sample format.
GKH	Ensoniq EPS family disk image files.
IFF	Interchange file format.
INS	Ensoniq EPS family intrument files.
KRZ	Kurzweil 2000 sample files (also split files: KR1, KR2).
MDL	Digitrakker Module File
MOD	Amiga and PC tracker modules.
MTM	MultiTracker Modules.
OKT	Oktalyzer tracker modules.
PAT	Advanced Gravis Ultrasound / Forte tech. Patch files.
PSM	Protracker Studio Module Format.
RAW	Raw signed PCM data.
SAM	Signed 8bit Sample data.
SBK	Emu SoundFont Bank files / Creative Labs SB AWE 32.
SDK	Roland S-550, S-50, S-330 disk images.
SDS	Raw Midi Sample Dump Standard files.
SDX	Midi Sample Dump Standard files as compacted by SDX.
SF	IRCAM SoundFile format
SMP	Samplevision files.
SND	Raw unsigned PCM data.
SND	AKAI MPC3000 sample files.
SNDR	Sounder sound file
SNDT	Sndtool sound file
SPL	Digitrakker Sample File
STM	Scream tracker v2 modules.
S3I	Scream tracker v3 instruments.
S3M	Scream tracker v3 modules.
SYW	Yamaha SY-series wave files (really named W??).
TXT	Text formatted audio data
TXW	Yamaha TX16W wave files (really named .W??).
UL	US telephony format audio.
ULT	UltraTracker modules.
UNI	MikMod 'UniMod' format
UWF	UltraTracker Wave Files.
VOC	Creative labs sound files.
WAV	Ms Windows PCM wave files.
WFB	Turtle Beach WavePatch Bank files (Maui/Rio/Monterey).
WFD	Turtle Beach WavePatch Drum set files (Maui/Rio/Monterey).
WFP	Turtle Beach WavePatch Program files (Maui/Rio/Monterey).
XM	Fast Tracker 2 extended modules.
XI	Fast Tracker 2 instrument files.
*	Unrecognized formats prompts user to supply basic info.

2PAT can export to the following formats:

AU	Sun Audio format (wavesample level).
AIF	Audio Interchange File Format (wavesample level).
IFF	Interchange file format (wavesample level).
PAT	Advanced GravisUltrasound / Forte tech. patch files (wavesample and instrument levels).
RAW	Raw signed PCM data (wavesample level).
SBK	Emu SoundFont Bank files / SB AWE 32 (bankfile, wavesample and instrument levels).
SDS	Midi Sample dump standard files (wavesample level).
SND	Raw unsigned PCM data (wavesample level).
TXT	Ascii text description (bankfile, wavesample and instrument levels).
WAV	Ms Windows PCM wave files (wavesample level).
WFP	Turtle Beach WavePatch Program files (bankfile, wavesample and instrument levels).
'CLIP'	Copies audio data to the Windows clipboard (wavesample level).
'DAC'	Playback on any digital audio device. (bankfile, wavesample and instrument levels).


Unrecognized files
*:	Unrecognized file types

If.a file cant be determined to be one of the, by this program, supported file types, then the wavesample properties box will appear. Select the Advanced tab and supply information on the files data type.
Note! if you get it wrong, you can always use the wavesample properties dialog again and try some other settings.

Features:

8,16 bits, mono, stereo.


669 files
669 files:	669 tracker modules (PC)

Features:

8 bits, mono, loop, name.


Aif files
AIF/AIFF/AIFC-files:	Audio Interchange File Format (Amiga, Atari, SGI,Mac)

AIFC is an extension of the original AIFF format also supporting compressed sample data. Only the uncompressed (or 'NONE') subformat of AIFC is currently supported.

Features:

1..32bits, loop, keyrange, mono, stereo, name.

Unsupported features:

AIFC compressed subformats..

Internet source of samples:

ftp://ftp.reed.edu/eps/samples/aiff.


Au files
AU files:	Audio files (Sun/NeXT/DEC)

Features:

8,16,24,32 bits/sample. μ-law and A-law compression, mono, stereo.

Unsupported features:

> 2 channel files.
Floating point files
Other compression schemes.

Internet source of samples:

UNIX places, do an ARCHIE search for .au.


Avr files
AVR files:	Audio Visual Research sound files (Machintosh)

Features:

8,16bit, mono, stereo, name, loop.


Cdr files
CDR files:	Raw Audio-CD data

This is raw CD-format audio, and not raw CD-data wich also contains a lot of error correction and formatting information.

Features:

16 bits, stereo.


Dewf files
DEWF files:	SoundCap / SoundEdit recorded instrument format (Machintosh)

Features:

8bit, mono, loop.


Dmf files
DMF/DSF files:	Delusion/XTracker Digital Music/Sample Fileformat (PC)

Features:

8,16bits, mono, looping, name, multisamples.

Unsupported features:

Packed samples..


Dsm files
DSM files:	Digital Sound Module tracker format

Features:

8bit, mono, name, looping.


Far,Fsm files
FAR, FSM, F2R files:	Farandoyle tracker  module / wave files / Linear module2 (PC)

Features:

8, 16 bits, mono, loop, name.


Iff files
IFF files:	Interchange File Format: 8SVX or 16SV data (Amiga)

The 16SV flavour is rather uncommon and is, I think, only used by some PC trackers. Thus if you save 16 bit wavesamples as .IFF files, dont expect them to be readable by most .IFF readers.

Features:

8, 16 bits, looping, name, mono, stereo.


Gkh, Efe and Ins files
GKH, EUI, EFE and INS files:	Ensoniq EPS family instrument files (MIDI)

The Ensoniq EPS (and family) files are usually encountered in form of  .GKH disk image files (with an additional header) as well as in the slightly compected .EUI disk image format.
2PAT can only read contiguos subfiles in Ensoniq disk images. If 2PAT can't handle a certain file (because it's fragmented on the disk), you can exctract the individual instrument files to .INS or .EFE files with a utility called EPSDISK (not included with 2PAT). INS files are the same as an EFE files except the latter may also contain EPS sequenced songs, bank info or such, instead of an instrument.

Multilayered instruments will have each layer shown as a separate instrument (all have the same name tough).
Note! Sometimes there will be layers without wave-data; they will sound garbled or like static noise; just ignore those...

Features:

16 bits, mono, multisampled, loop, names, finetune.

Unsupported features:

A bunch of parameters et c.

Internet source of samples:

ftp://oak.oakland.edu/pub2/eps/samples
ftp://ftp.reed.edu/eps/samples


Krz files
KRZ files:	Kurtzweil K2000 instrument files (MIDI)

The K2000 file format are considered proprietary by Kurzweil; so any resemblance with the .KRZ file format this program reads are purely accidental :-/
If one, against better knowing should try to use this program to read the former file type, one shall find that they match fairly closely :-D, of course, sometimes things may go a bit wrong here and there...

Features:

16 bits, mono, multisamples, loop, names, finetune.

Unsupported features:

Envelopes, stereo, et c.

Internet source of samples:

ftp://ftp.uwp.edu/pub/music/lists/kurzweil/sounds
ftp://bach.nevada.edu/pub/K2000/sounds


Mdl, Spl files
MDL, SPL files:	Digitrakker Module/Sample File (PC)

Features:

8,16bits, mono, loop, name, huffpacking.


Med files
MED files:	OctaMED tracker modules:MMD0|MMD1|MMD2 (Amiga)

Note that the old MED tracker .MED format is not supported, if you have a description of this format, please send it to me.

Features:

8bit, loop, name.


Mod files
MOD files:	Module files (Amiga, PC)

Recognizes the following flavours:
M.K., M!K!, 4CHN,  6CHN, 8CHN, 10CH, 12CH, 14CH, 16CH, 24CH, 32CH, FLT4, FLT8, OCTA, CD81, EX08.

Features:

8 bits, mono, loop, name, finetune.


Mtm files
MTM files:	Mtm tracker modules (PC)

Features:

8, 16 bits, mono, loop, name.


Okt files
OKT files:	Oktalyzer tracker modules  (Amiga)

Features:

8 bits, mono, loop, name


Pat files
PAT files:	Advanced Gravis Ultrasound GF1 / Forte tech. patch files (PC)

Features:

8,16 bits, mono, multisamples, loop, envelopes, pitch scaling, names.

Internet source of samples:

ftp://wuarchive.wustl.edu/systems/ibmpc/ultrasound
ftp://archive.epas.utoronto.ca/pub/pc/ultrasound


Psm files
PSM files:	Protracker Studio Module Format

Features:

8,16bit, mono, loop, name.


Raw files
RAW files:	Raw signed PCM data files

Assumes 8 bits, 11khz mono when reading.
Use the wavesample properties dialog advanced tab´to change any parameters that are not correct.
Uses Intel byte ordering when writing 16bit.


Sam files
SAM files:	Raw signed PCM sample files

Features:

8 bits, mono.


Sndr files
SNDR files:	Sounder sound files

Features:

8 bits, mono.


Sndt files
SNDT files:	SndTools sound files

Features:

8 bits, mono.


Sbk files
SBK files:	EMU SoundFont Bank files / Creative Labs SB AWE 32 (PC)

Note! When saving whole bank files, all items in the bank will be saved, also unused wavesamples.
When saving at the wavesample level, there will automatically be created an instrument using that single wavesample.

Features:

16 bits, pitch, loop, name, multisamples.

Unsupported features:

A bunch of parameters.

Internet source of samples:

ftp://ftp.cyberworks.net/pub/AWE32


Sdk files
SDK files:	Roland S-550, S-50, S-330 disk image files (MIDI)

They might go under another extension but SDK seems to be most common.

Features:

12 bits, mono, loop name, finetune.

Unsupported features:

A zillion different parameters, stereo?.

Internet source of samples:

ftp://lotus.uwaterloo.ca/pub/sgroup/samples


Sds & Sdx files
SDS & SDX files:	Midi Sample Dump Standard files (MIDI)

SDS is a raw midi data dump of an SDS (Sample Dump Standard) transfer and can be up to twice as large as the actual wavesample. SDX is a 'compacted' form that the program SDX uses to save SDS samples in order to avoid this problem. It also contains a sample name wich SDS does not.

Features:

8..32 bits, mono, loop, (SDX only: name , note).

Internet source of samples:

ftp://sweaty.palm.cri.nz/sds/samples

ftp://alf.uib.no/pub/midi/sds/samples


Sf files
SF files:	IRCAM SoundFile format

Features:

16 bits, name, note, mono, stereo.

Unsupported features:

Other bits/sample.


Smp files
SMP files:	Samplevision files (PC)

Features:

16 bits, mono, loop, name, note.

Unsupported features:

Only the first of the 8 possible loop points are considered.

Internet source of samples:

ftp://ftp-ls7.informatik.uni-dortmund.de/pub/samplevision


Snd files
SND files:	Raw unsigned PCM data files

Assumes 8bits, 11khz mono when reding.
Use the wavesample properties dialog advanced tab´to change any parameters that are not correct.
Uses Intel byte ordering when writing 16bit.


Snd, AKAI sample files
SND files:	AKAI MPC3000 sample files

The AKAI program (.PGM) files defining multisamples (and refering to various .SND waves) are currently not supported. Any info on this format would be welcome.

Features:

16 bits, mono, loop, name.

Internet source of samples:

ftp://ftp.mfi.com/pub/keyboard/AKAI/


Stm files; screamtracker
STM files:	ScreamTracker module files (PC)

Features:

8 bits, mono, loop, name.


S3M files
S3M, S3I files:	ScreamTracker v3 module / instrument files (PC)

Features:

8 bits, stereo, loop, name, note.


Syw files
SYW files:	Yamaha SY-series wave files (MIDI)

The Yamaha SY-series (or at least the SY-85 and SY-99) wave sample files are really named .W??. There's also .t?? (All Data Files, often contains waves and are much more common than .w??; but aren't supported at the moment), .j?? (Patch parameters?) and  .k?? (Sequenced songs).

Features:

16 bits, mono, looping.

Internet source of samples:

ftp://louie.udel.edu/pub/midi/patches/SY99


Txt export files
TXT files:	Ascii text description files (export format)

Contains human readable information about items at bank file, instrument or wavesample levels. Usefull if 2PAT can't export directly to your destination format and you'll have to piece together instruments from, say, .WAV files.

Features:

Human readable information, no sample data.


Txt files
TXT files:	Ascii text formatted audio data (import format)

Ascii text file with integer sample values in base 10. Samples are deliminated by either , (no 44) or newline (no 10). Comments and lines not containing sample values must begin with a ;
For stereo file (with interleaved samples), you must manually set stereo in the wavesamples properties box advanced tab.

Ex 1:
;signed 8bit, 3 samples
127
-3
15
Ex 2:
;this will be detected as unsigned 15bit, 5 samples
9,0,32767,1000,20001

Features:

1..32 bits, signed or unsigned (auodetect).


Txw files
TXW files:	Yamaha TX16W wave files (MIDI)

The Yamaha TX16W wave sample files are really named .W?? (where ?? is a number). There's also .F?? (Filter), .V?? (Voice to midi no asign?),.U?? (Performance settings) and.S?? (System setup?) files which are of no use to you.

Features:

12 bits, mono, loop.

Internet source of samples:

ftp://ftp-ls7.informatik.uni-dortmund.de/pub/tx16w/samples


Ul files
UL files:	US Telephone format audio

This is also the format used by the MIME mail encoding standards audio/basic attachments..

Features:

8 bits, mono, μ-Law, 8kHz.


Ult files; Uwf files; ultrastracker
ULT, UWF files:	UltraTracker module / wave files (PC)

Features:

8,16 bits, mono, loop, name.


Uni files
UNI files:	MikMod 'UniMod' tracker format (PC)

Features:

8,16bit, mono, name, loop, multisamples.


Voc files; creative labs
VOC files:	Creative Labs sample files (PC)

Features:

8 bits, mono, name.


Wav files
WAV files:	Microsoft Wave files (PC, Windows, OS/2, NT)

Supports the Sample (smpl) chunk (used by Turtle Beach Wave SE, WavePatch, Gravis PatchMaker and others), the Instrument (inst) chunk (used by IBM?) as well as cue +labl chunks to support looping.
Also supports some info chunks (INAM, ICMT, ISFT).

Features:

PCM, μ-Law, A-Law, MS ADPCM (4bit), Intel DVI/IMA ADPCM (2,3,4bit), mono, stereo, note, loop, rootkey, finetune.

Unsupported features:

Other compression schemes.

Internet source of samples:

ftp://ftp.funet.fi/pub/sounds/wav/samples
ftp://doc.ntu.ac.uk/pub/sounds/samples


WFB, WFP, WFD files
WFB, WFP, WFD files:	Turtle Beach WaveFront synthesizers / WavePatch files (PC)

WaveFront based synthesizers are currently the Maui, Tropez, Rio and Monterey.
.WFB files contains a whole Midi Bank, .WFP a single Program and .WFD a complete drum set.
Instruments using ROM samples, of course, cant be converted.
If the files doesnt use embedded wavesamples, but external .WAV files instead, you must have the .WAV files in either the exact path they where when the .WFx file was created, or, in the same directory as the WFx file.
Currently 2PAT only saves files with embedded wavesamples.

Features:

8,16 bits, name, note, multisamples, loop.

Unsupported features:

Everything is read on patch level and not on Program/Drumkit level, i.e. multilayered instruments and drumkits appear as multiple instruments.
Pre v1.2 files.

Internet source of samples:

ftp://ftp.hawaii.edu/outgoing/Maui/


XM,XI files
XM and XI files:	FastTracker 2 eXtende Module/Instrument (PC)

Features:

8,16 bits, mono, loop, name, multisamples, panning.

Unsupported features:

A bunch of ramping parameters (envelope, pan, vibrato...).


CLIP export format
'CLIP' virtual export format:	Copy the audio data to the Windows clipboard.

The data will be copied as a RIFF WaveFile, the standard clipboard audio format.

Features:

Same as for .WAV files.


DAC export format
'DAC' virtual export format:	Plays the sound on a digital (waveform)  audio playback device.

If you have a basic soundcard capable of playing digital audio, you can use this 'export' format to play the sounds contained in a wavesample, instrument or bank file.
Set the output device to be used for playback in the Options->Properties dialog. If you have more than one digital audio card installed in your system, choose the most capable one; some cards can only playback at a few fixed sample rates (wich can cause waves to be played at a too high or too low pitch) while better cards can play at any rate.

Features:

8,16 bits, mono, stereo.


Audio Player mode

If you start 2PAT with -AP as the first option on the command line and follows this with one or more filenames, the Audio Player mode will be entered.
In this mode 2PAT acts as a simple digital audio player that can play all the import formats supported by 2PAT.

Files will be consecutively loaded and all the sounds contained within them played before the program terminates. You must press the >>Next>> button to advance from one wavesample to the next, closing the Audio Player after the last one.

With the Audio Player option, you can use 2PAT for example as a helper app to your favourite Web-browser!
The output device is the same as for the 'DAC' virtual export format.

Example: 2PAT -AP QUADRA.AU POPCORN.MOD


Click to save any changes made and close this dialog.


Click to discard any changes made and close this dialog.


Click to bring up dialog help.


Source file (import type) description.


Source file name and path.


Place comment, copyright, or creator name here.


Relative volume setting.

Range is 0..127.


Root key.

This is the midi-key number at wich the wavesample is played back at its original sampling frequency.
Range is 0..127, with 60 beeing C4.


Panning.

This specifies the positioning of the wavesample in the stereo field.
Range: 0..127, 0 = far left, 127 = far right.


Loop start point.

Also called repeat from point.
Note that 2PAT supports fractional loop points. This is used by synthesizers that can interpolate between samples.
The point is expressed in number of samples from the beginning of the wavesample, starting at zero.


Loop end point.

Also called repeat point.
Note that 2PAT supports fractional loop points. This is used by synthesizers that can interpolate between samples.
The point is expressed in number of samples from the beginning of the wavesample, starting at zero. It may not be less than the loop start point.


Check to enable sampled release.

This means that the wavesample loops while the key is pressed down, but stops looping and plays to the end of the sample (remember there may be sample data pas the loop end point) when it is released. When this is not checked, it loops until it the amplitude envelope has faded it out upon key realese.


Check to enable reverse looping.

This makes the wavesample to loop backwards instead of forwards.


Check to enable looping.

When looping is on, the wavesample is looped between the loop start and loop end points.


Check to enable bidirectional looping.

Bidirectional looping means the wavesamples loops alternatingly forwards and backwards.


Additional info.


Click button to uninstall this program.

This will clean up the registry entries for the program.


Select the digital audio (WaveAudio) device you wish to use for the virtual .DAC export format as well as for the 2PAT Audio Player.


Click button to locate your personal registration keycode and remove all imposed limitations of the unregistered version of 2PAT.


Check if signed wavesample data.


Check if stereo wavesample data.


Check if 8 bit linear PCM wavesample data.


Check if 16 bit linear PCM wavesample data.


Check if μ-Law format wavesample data.


Check if A-Law format wavesample data.


Enter the size of the file header (the number of Bytes preceeding the actual sample data).


Enter the sample frequency  in Hz (number of recorded samples per second).


Check to perform a byteswap when reading 16bit data.

Use this if your reading data with little-endian byte ordering.


Enter wavesample length (number of Bytes of sample data).

The value is automatically truncated if it extends beyond the file length.
If all data, after the (optional) file header, is sample data, then you need not change this.


Check to enable auditioning.

Auditioning works by routing midi messages from a keyboard or other midi-in device to a wavetable synth, combined with automatic creation and loading of instruments and samples to the same wavetable synth.


Select the wavetable synth you want to use for the auditioning feature.

Currently the Advanced Gravis Ultasound / MAX / ACE, the Turtle Beach Maui / Tropez and the Creative Labs SoundBlaster AWE 32 are supported.


Select the midi input device you want to use for the auditioning feature.
Data from this device will be routed to your selected wavetable synth, and automatically translated to use the correct bank, program and channel.

Selecting the Dummy Device will let you use any on-screen virtual midi keyboard program if you do not have a midikeyboard. If you do, set it to ouput to channel 1 and program 1 on your wavetable synth. AWE32 users must also set bank no 127 (consult your soundcard manual on how to change user bank).


Shows if the program is registered or unregistered.


Name of the wavesample.


Length of wavesample in number of samples and in seconds respectively.


Press to play the wavesample.


Go to the next wavesample in a sequence. Closes the audio player if this is the last wavesample.


FMJ-Software!

My superb software publishing label.
If you enjoy this program, please
support my efforts by registering it.


Revision History

A big thanx should go to thoose people who have supported me with information and beta testing;
An honourable mention also must go to Fred Warren, who donated a Maui card.

Future versions,

Things that may appear in future versions of 2PAT are: More import formats (just send me any format descriptions you can find), adpcm (read) support, WFP and SBK stereo by 'dual-layering', more editing functions (an instrument keymap editor...), improved audio player (oscilloscope, FFT spectrum analyzer...), multilayered instrument support...
What else? Send me a note!
Remember, the regsitration fee is the key to further development of this program!

Revisions:

version 2.0,	<95-08-xx>

version 1.5,	<95-04-14>

version 1.4,	<94-10-14>

version 1.3,	<94-08-02>

version 1.2,	<94-07-28>

version 1.1,	<94-06-08>

version 1.0,	<94-04-27>

version 0.9ß,	<94-03-30>

version 0.8ß,	<94-03-08>

version 0.7ß,	<94-01-07>

version 0.6ß,	<94-01-05>

version 0.5ß,	<93-12-23>

version 0.4ß,	<93-12-20>

version 0.3ß,	<93-11-26>

version 0.2ß,	<93-11-21>

version 0.1ß,	<93-11-13>


version 2.0,	<95-09-09>

User interface enhanced based on the Windows 95 UI guidelines. Runs under Windows 95, Windows NT 3.51 or Windows 3.1 + Win32s v1.3.

The really stupid couldn't register app class bug fixed (occured on many Win32s systems).

Now writes converted stuff to disk first when you actually saves or auditions anything, instead of doing everything in one sweep when opening a file, as was done in previous versions. This change has made possible a number of the enhancements below.

Tree list view with nodes and leaves for bank file, instrument and wavesample levels. You can now save stuff from any of the 'levels' (Note only a few of the export formats support all levels). There's also Property sheets for the items of the various levels. Most stuff is editable!

You no longer have to decide on export format before you load a file. Just select from a list in the Save dialog.

Auditioning now works regardless of what youre going to export to.

SoundBlaster AWE32 auditioning support added.

A virtual '.DAC' export format added. Saving to this format will simply play the item on a digital audio output device. So users that doesn't have a GUS, Maui or AWE32 can now play sounds as well, provided you have some sort of basic audio card. An 'Audio Player' item in the right mouse button menu acts as a shortcut for saving to this format.
Audio Player mode and -AP command line switch added. Lets 2PAT be used as a multiformat digital audio player. Great as a helper app for your favourite Web-browser.

A virtual '.CLIP' export format added. Saving to this format will simply copy a wavesample to the Windows clipboard.

.AU export format added.
.IFF export format added.
.SBK export format added as well as improved import support..

Smart file format recognition, Tries to recognize the format of a file correctly, even if it has no, or even an incorrect, file type extension.

FastTracker 2 .XM (module) and .XI (instrument) files read supported.
Farandoyle .FAR tracker modules read support.
Oktalyzer .OKT tracker module read support.
Sndtool sound file, .SNDT read support.
Sounder sound file, .SNDR read support.
IRCAM SoundFile format, .SF read support.
Raw Audio-CD format data, .CDR read support
MikMod 'UniMod' format, .UNI read support
Digital Sound Module tracker format, .DSM read support
Text formatted audio data, .TXT read support
Delusion/XTracker Digital Music/Sample Fileformat, .DMF, .DSF read support
Digitrakker Module/Sample File, .MDL, .SPL read support.
Signed 8bit Sample data,.SAM read support.
Farandoyle Linear module (2.0) format, .F2R read support.
Machintosh SoundCap/SoundEdit recorded instrument format, .DEWF read support.
Protracker Studio Module Format, -PSM read support.
OctaMED tracker modules (MMD0|MMD1|MMD2), .MED read support.
Machintosh Audio Visual Research sound files, .AVR read support.
Ensoniq, .EUI disk images read support, somewhat like .GKH, wich now also reads subdirectories.
US telephony audio format, .UL read support.
AKAI MPC3000 sample files, .SND, read support

Stereo support for a number of formats (WAV,SND,RAW,S3M,S3I,IFF,AU,AIFF)
A-law and μ-law encoded .AU files now supported.
A-law, μ-law, MS ADPCM and DVI/IMA ADPCM encoded .WAV files now supported (read).
16bit 'SV16' flavour of IFF files now supported (read/write).
A bunch of additional .MOD flavours now recognized.
Added cue-points support for looping in .WAV files (read/write).
Fixed ugly bug with .SDS import and export.
Reads and writes 'inst' chunks in .WAV files.

A 'Dummy' midi in device now added so people without a midi-keyboard can use the audition feature of 2PAT by using any onscreen keyboard program.

Added 'Unistall' button to the program properties box that can be used to clean up the registry.

Imposed a somewhat annoying save times limit. Registered users receive a personal keycode that removes this.

version 1.5,	<95-04-14>

Reworked user interface for Windows 95. 'Right mouse button' based, uses the registry, associates file types, uses long filenames, new icons, resizable window frame et c. No longer uses CTL3D32.DLL since thats no longer necessary for the 3D look. Will still run under Windows 3.11 with Win32s v1.1 and up but will probably not look very good; Win32s v1.3 will probably fix that when its out.

Instrument info box with info corresponding to a .DES file.

Improved Kurzweil KRZ support; fixed the sample rate and a few other things. Now creates instruments from both the sample and the keymap level, since the keymap, i.e. instrument, level doesnt always work....

Added AIF as export format.
Added SND as export format.
Added RAW as export format.

Fixed problem with not beeing able to launch WinHelp from arbitrary directories.
Assignes unique names for 'unnamed' samples and instruments (fixes problem with WaveFront based cards).
Fixed problem with unnamed instruments in .PAT files.

version 1.4,	<94-10-14>

Improved support for Turtle Beach WaveFront based cards! (Maui / Rio / Monterey);
Reads .WavePatchs.WFB, WFP and WFP files (v1.2 or later only).
Exports .WFP files.
Supports downloading instruments to the Maui card, using the WF GateKeeper (WFGATE.DLL).

Reads ScreamTracker 3 instruments (S3I).

version 1.3,	<94-08-02>

Now a Win32s (v1.1 or later) program.
CTL3D32.DLL replaces CTL3DV2.DLL.
FMJMTHRU.DLL no longer needed.
Saves config in the Win32 registry instead of in an .INI file.

Now reads the GKH disk image files in addition to INS/EFE for Ensoniq EPS.

Barebone .SBK import support (EMU SoundFonts Banks / SB AWE32); at wavesample level.

version 1.2,	<94-07-28>

Restructured for multiple export formats, currently:
- Ultrasound patches (.PAT)
- Turtle Beach Maui (.WAV+.WFS+.DES)
- Ms Windows wave files (.WAV+-DES)
- Midi Sample Dump Standard files (.SDS+.DES)

Config dialog window where you can choose export type and midi in device.
Saves config in 2PAT.INI.

You can start 2PAT with a filename on the command line and that file will be loaded at once; so now you can associate various file extensions with 2PAT in the File Manager and launch 2PAT by double clicking on a file.

Reads and writes .WAV files with the (new Ms standard) smpl (root key, finetune, loop points) and ICMT (name) chunks.

version 1.1,	<94-06-08>

Uses Microsofts 3D controls extensions, CTL3DV2.DLL instead of Borlands BWCC.DLL as earlier.

Improved Ensoniq EPS support (.INS, .EFE, .GKH).
Now treats the sample rate correctly as well a doing a coarse decay rate conversion.

Now supports finetune for a few formats.

Better at cleaning up temporary files after itself...

version 1.0,	<94-04-27>

Now also able to write WAV files in addition to PATches. Typing in an extension of '.wav' instead of '.pat'  in the Save dialog box, will save a .DES text file with into about loop points and such, as well as .WAV files with the samples in the patch.

Converted the manual into WinHelp Hypertext format.

Reads INS and EFE files (Ensoniq EPS instrument files). These can extracted from GKH files with a utility called EPSDISK.

Reads SDS files (raw Midi Sample Dump Standard files).

Reads SDX files ('compacted' Sds file + sample name, as saved by the program SDX).

Reads TXW (Yamaha TX16W wave files). Really named .W??.

Reads SYW (Yamaha SY-series wave files). Really named .W??.
Has not been tested (Please send me some files!)
Note! The much more common all-data format, .T?? are not supported (yet).

Reads SDK (Roland S-550, S-50, S-330 disk images).

Reads AIF files (Audio Interchange File Format).

Reads IFF: 8SVX files (Interchange File Format).

Reads UWF files (UltraTracker Wave files).

Reads PAT files (Ultrasound patch files).

Reads SMP files (Samplevision).

Reads VOC (Creative labs) files.

Reads AU files (Sun/NeXT); only uncompressed mono files supported.

Reads RAW signed data files; assumed 8bit, 11khz.

KRZ files now get their loop point. Now also supports split files (KR1 + KR2). No longer throws out samples if the instrument is too big but rather lets you do it yourself in the patch editor of your choice.

Correctly reads 16bit WAV files now.

Correctly reads ULT's with 16bit samples now.

Looped samples with the end loop point at or near the sample end now get the sample at the loop start point duplicated at the loop end point + 1, in order to keep the GUS interpolation happy (can cause clicks otherwise).

The envelopes now corresponds to the ones Patchmaker  use for looped and unlooped waves, except that looped samples have a quite long decay but not at all as long as the long decay setting in Patchmaker.

Now using FMJULTRA.DLL to provide ULTRASND.INI manipulation for loading custom patches; email me if you'd like to use it in your own programs and I'll send you FMJULTRA.H.

Renamed MIDITHRU.DLL into FMJMTHRU.DLL. In order to avoid possible conflicts with other programs.

Various minor changes and improvements.

version 0.9ß,	<94-03-30>

Changed program name to 2PAT (from MOD2PAT, after all it reads  a lot more stuff than just MOD files).

Reads Kurzweil K2000 sample files (.KRZ); multisampled supported. Since the spec. is 'secret' I have only been able to find out where the actual samples are stored, how long they are, what pitch and what keys they are assigned to and names and such, but haven't been able to determine loop points, envelopes et c.

Reads .SND, raw unsigned data files. Assumes they are 11KHz, 8bit.

Hopefully the problem with samples > 64KB is fixed.

Saves temporary patch-files in the directory specified by the TEMP= environment variable or, if not avaiable, in the program directory.

Faster updating of ULTRASND.INI.

Nicer look with BWCC.

version 0.8ß,	<94-03-08>

Now a Windows hosted program (Win16).
The user interface is naturally quite different in this incarnation...

The .INI extract feature is no longer implemented, nor is reading raw files.

Patch play feature.If you've got an Ultrasound card (and you have, haven't you?) and a midi in device, you can play the patches from within mod2pat.

version 0.7ß,	<94-01-07>

Removed the signed to unsigned conversion; Since we've now got Patch Maker Lite, wich hasn't got the bug of the old PATCH.EXE.

The .INI extract now looks a bit differently.

I've introduced the concept of "BankName=Whatever" to give the banks names; it will be set to the songname.

Added my bird logo to the text font.

version 0.6ß,	<94-01-05>

Fixed another embarrasing bug, when converting from signed to unsigned data I now add 80h and not 7Fh as previously (got a little noise...).

version 0.5ß,	<93-12-23>

Yes, now you can 'hear-out' the samples before you decide wether to save them. Of course, an ultrasound card is required for that!

Fixed a rather embarrasing bug with MOD loop points.

version 0.4ß,	<93-12-20>

Reads 669, STM and S3M.

Always saves as unsigned, 'this because Gravis PATCH.EXE always uses unsigned data and it's convert command doesn't convert the last byte...

Converted source code into C.

version 0.3ß,	<93-11-26>

Reads MTM, ULT, WAV, FSM and raw files.

Ability to edit internal patch names (Use TAB to toggle between DOS-name and Patch-name edit).

Added GUSPATCH.TXT; Ultrasound patch format description.

Any MOD that isn't a M.K., 4CHN, 6CHN, 8CHN, FLT4 or FLT8 are now treated as beeing of the older 15 (versus 31) sample format.

version 0.2ß,	<93-11-21>

Reads 4,6,8 ch MOD's 'M.K.', '4CHN', '8CHN'.

Basic user interface.

Smart 'auto filename'.

version 0.1ß,	<93-11-13>

Nothing fancy, reads 4ch MOD's, writes PAT's, ULTRASND.INI extract.


Adds
Other Software

Also available at my Internet WWW-site @: http://www.nada.kth.se/~f93-maj/fmjsoft.html

Image Eye (v3.0)

A very, very fast and powerfull image viewer :-). Seriously though, see if you can find a faster one (with the same image quality, and running under the same OS (some routines can sometimes run 50% faster under pure DOS than under Windows with no concurrent tasks)).
Handles: BBM, BMP, CUR, CUT, DIB, GIF, ICO, IFF, JPG, LBM, MAC, NEO, PCX, PGM, PIC, PPM, RAS, RID, RLE, SUN, TGA, TIF.
The new version, v3.0, is currently under developement (altough I grew tired of it and havent done anything on it for a half year now, Ill probably pick it up again sooner or later).

Windows interface requires Windows 95.
DOS/DPMI interface requires min.DOS3.3, i386, XMS, VESA.
[IEYE30A?.ZIP]

Ultrasound Patch Librarian: (v0.2)

Load patches from disk to Gravis UltraSound (GUS)-memory; let's you load and save lists of patches, patches may reside any any directories, not just one as with the Gravis BankManager.
Designed to be used as a companion to the sequencer of your choice.
[UPL02.ZIP]