File	Date	Author	Commit
DFV	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Debug	2013-03-25	Ben Zonneveld	[658b4a] Reboot phase 2
Doc	2013-03-25	Ben Zonneveld	[658b4a] Reboot phase 2
MidiWrapper	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
PianoKeys	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Release	2013-03-25	Ben Zonneveld	[658b4a] Reboot phase 2
RotaryFaderMFC	2013-03-25	Ben Zonneveld	[658b4a] Reboot phase 2
SndObj-2.6.6	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
SndObj-2.6.6-fftw2renamed	2013-03-25	Ben Zonneveld	[658b4a] Reboot phase 2
hlp	2014-05-01	Ben Zonneveld	[cabd70] Midi Buffer Cleanup after receiving sysex. Seem...
libfftw3	2010-02-04	Ben Zonneveld	[f01f96] Before changes to Displaytype B
libfftw3.ming	2013-03-25	Ben Zonneveld	[658b4a] Reboot phase 2
libsamplerate-0.1.7	2010-11-25	Ben Zonneveld	[6a854a] Added the resynthesis dialog
res	2010-11-09	Ben Zonneveld	[7f79cb] Removed Obsolete CSV Entries
.gitignore	2013-06-18	Ben Zonneveld	[00d8b8] Created a new parameter change routine for samp...
CMidiReceiver.cpp	2013-06-06	Ben Zonneveld	[0d4abc] Rewriting MIDI code (again)
CMidiReceiver.h	2013-06-06	Ben Zonneveld	[0d4abc] Rewriting MIDI code (again)
COMMITMESSAGE	2009-08-28	Ben Zonneveld	[c817c6] Initial Import GIT
CPasteMulti.cpp	2010-02-04	Ben Zonneveld	[f01f96] Before changes to Displaytype B
CPasteMulti.h	2010-02-04	Ben Zonneveld	[f01f96] Before changes to Displaytype B
ChildFrm.cpp	2009-09-20	Ben Zonneveld	[d93fef] Starting attempt at using swapchains
ChildFrm.h	2009-09-20	Ben Zonneveld	[d93fef] Starting attempt at using swapchains
CntrItem.cpp	2009-12-17	Ben Zonneveld	[c3ee0b] New develop machine
CntrItem.h	2009-12-17	Ben Zonneveld	[c3ee0b] New develop machine
Ctrl_RepeatButton.cpp	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Ctrl_RepeatButton.h	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Dialog_BankSelect.cpp	2011-01-11	Ben Zonneveld	[f6df8e] Working on a Memory map overview
Dialog_BankSelect.h	2011-01-11	Ben Zonneveld	[f6df8e] Working on a Memory map overview
Dialog_ConfigParams.cpp	2011-01-05	Ben Zonneveld	[ec9225] Bugfixes
Dialog_ConfigParams.h	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Dialog_KeyMapper.cpp	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
Dialog_KeyMapper.h	2013-06-10	Ben Zonneveld	[f89840] Changing the Original Key dialog to support Key...
Dialog_LoopEdit.cpp	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Dialog_LoopEdit.h	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Dialog_MemLayout.cpp	2011-01-18	Ben Zonneveld	[08111d] Working on resynthesis again
Dialog_MemLayout.h	2011-01-18	Ben Zonneveld	[08111d] Working on resynthesis again
Dialog_OrigKey.cpp	2013-06-11	Ben Zonneveld	[15edc0] Got the original key selection working.
Dialog_OrigKey.h	2013-06-11	Ben Zonneveld	[15edc0] Got the original key selection working.
Dialog_Preferences.cpp	2013-06-10	Ben Zonneveld	[f89840] Changing the Original Key dialog to support Key...
Dialog_Preferences.h	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Dialog_Program.cpp	2010-12-29	Ben Zonneveld	[1332de] Working on Mirage Configuration editing
Dialog_Program.h	2010-12-29	Ben Zonneveld	[1332de] Working on Mirage Configuration editing
Dialog_ProgressBar.cpp	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Dialog_ProgressBar.h	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Dialog_ReceiveSamples.cpp	2013-06-10	Ben Zonneveld	[f89840] Changing the Original Key dialog to support Key...
Dialog_ReceiveSamples.h	2013-06-06	Ben Zonneveld	[0d4abc] Rewriting MIDI code (again)
Dialog_Resample.cpp	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Dialog_Resample.h	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Dialog_Resynthesize.cpp	2011-02-19	Ben Zonneveld	[f2daa3] Got the resynthesis working. Getting sndobj to ...
Dialog_Resynthesize.h	2011-02-19	Ben Zonneveld	[f2daa3] Got the resynthesis working. Getting sndobj to ...
Dialog_TransmitSamples.cpp	2013-06-10	Ben Zonneveld	[f89840] Changing the Original Key dialog to support Key...
Dialog_TransmitSamples.h	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
Dialog_TxSamParms.cpp	2014-04-30	Ben Zonneveld	[84d5c8] Solving MIDI input problems
Dialog_TxSamParms.h	2014-04-30	Ben Zonneveld	[84d5c8] Solving MIDI input problems
DiskImage.cpp	2011-01-18	Ben Zonneveld	[b7ac46] Working on resynthesis again
DiskImage.h	2010-12-17	Ben Zonneveld	[69b134] Fixed a bug where the recent file list did not ...
Doxyfile.cfg	2013-03-25	Ben Zonneveld	[658b4a] Reboot phase 2
Fourier.cpp	2011-02-15	Ben Zonneveld	[fe554f] SndObj 8 bit playback fixed
Fourier.h	2011-02-15	Ben Zonneveld	[fe554f] SndObj 8 bit playback fixed
GeneralKeyboard.htm	2011-01-11	Ben Zonneveld	[f6df8e] Working on a Memory map overview
Globals.h	2014-04-30	Ben Zonneveld	[84d5c8] Solving MIDI input problems
LoopDoc.cpp	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
LoopDoc.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
LoopFrm.cpp	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
LoopFrm.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
LoopMove.cur	2009-08-28	Ben Zonneveld	[c817c6] Initial Import GIT
LoopView.cpp	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
LoopView.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
MainFrm.cpp	2014-04-30	Ben Zonneveld	[84d5c8] Solving MIDI input problems
MainFrm.h	2010-11-04	Ben Zonneveld	[d9de82] Started Implemtation of Reading Disk Images
Menu_Edit.cpp	2010-11-25	Ben Zonneveld	[6a854a] Added the resynthesis dialog
Menu_Tools.cpp	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
MidiReceive.cpp	2013-03-25	Ben Zonneveld	[e0e9e0] Merge branch 'master' of ssh://git.code.sf.net/...
MidiReceive.h	2013-03-25	Ben Zonneveld	[e0e9e0] Merge branch 'master' of ssh://git.code.sf.net/...
MirProgram.htm	2010-12-22	Ben Zonneveld	[9b127d] Started on a Dialog for editing of mirage programs
Mirage Dumper (static libsamplerate).vcproj	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
Mirage Dumper (static libsamplerate).vcproj.The_Finn.root.user	2014-04-30	Ben Zonneveld	[84d5c8] Solving MIDI input problems
Mirage Editor.aps	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
Mirage Editor.cpp	2014-05-01	Ben Zonneveld	[cabd70] Midi Buffer Cleanup after receiving sysex. Seem...
Mirage Editor.h	2014-04-30	Ben Zonneveld	[84d5c8] Solving MIDI input problems
Mirage Editor.rc	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
Mirage Editor.reg	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
Mirage EditorDoc.cpp	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
Mirage EditorDoc.h	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
Mirage EditorView.cpp	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
Mirage EditorView.h	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
Mirage Helpers.cpp	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
Mirage Helpers.h	2009-11-09	Ben Zonneveld	[a9cc6b] Got the parameter changing working in a new and...
Mirage Sysex_Strings.cpp	2013-06-12	Ben Zonneveld	[fcdcca] Fixed the transmitting of samples
Mirage Sysex_Strings.h	2013-06-12	Ben Zonneveld	[fcdcca] Fixed the transmitting of samples
MirageSysex.cpp	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
MirageSysex.h	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
Nybble.cpp	2010-02-04	Ben Zonneveld	[f01f96] Before changes to Displaytype B
Nybble.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
PitchTable.h	2010-11-04	Ben Zonneveld	[d9de82] Started Implemtation of Reading Disk Images
ReadMe.txt	2009-10-21	Ben Zonneveld	[15ba1c] New Resamper
Resynthesize.htm	2010-11-25	Ben Zonneveld	[6a854a] Added the resynthesis dialog
SendSysex.cpp	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
SendSysex.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
SndMem.cpp	2011-02-18	Ben Zonneveld	[9c991f] Got the sndobj based resynthesis more or less w...
SndMem.h	2011-02-18	Ben Zonneveld	[9c991f] Got the sndobj based resynthesis more or less w...
SoundDesignerDumpRequest.txt	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
SysexParser.cpp	2013-06-10	Ben Zonneveld	[f89840] Changing the Original Key dialog to support Key...
SysexParser.h	2013-03-25	Ben Zonneveld	[e0e9e0] Merge branch 'master' of ssh://git.code.sf.net/...
TabSeqConfig.htm	2013-03-25	Ben Zonneveld	[e0e9e0] Merge branch 'master' of ssh://git.code.sf.net/...
Tab_GeneralKeyboard.cpp	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Tab_GeneralKeyboard.h	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Tab_MidiConfig.cpp	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Tab_MidiConfig.h	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Tab_SamplingConfig.cpp	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Tab_SamplingConfig.h	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Tab_Sequencer.cpp	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Tab_Sequencer.h	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Tabby.cpp	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
Tabby.h	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
ThreadJob.cpp	2009-12-17	Ben Zonneveld	[c3ee0b] New develop machine
ThreadJob.h	2009-12-17	Ben Zonneveld	[c3ee0b] New develop machine
ThreadNames.cpp	2013-06-06	Ben Zonneveld	[0d4abc] Rewriting MIDI code (again)
ThreadNames.h	2013-06-06	Ben Zonneveld	[0d4abc] Rewriting MIDI code (again)
ToDo.txt	2013-06-11	Ben Zonneveld	[15edc0] Got the original key selection working.
Tuning.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
UIThread.cpp	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
UIThread.h	2010-11-19	Ben Zonneveld	[956d59] Beter renaming of dialogs and controls
UpdateCheck.cpp	2011-01-05	Ben Zonneveld	[ec9225] Bugfixes
UpdateCheck.h	2010-11-18	Ben Zonneveld	[94e56a] Implemented a check for updates of the program ...
Wavapi.cpp	2011-02-18	Ben Zonneveld	[9c991f] Got the sndobj based resynthesis more or less w...
Wavapi.h	2011-02-18	Ben Zonneveld	[9c991f] Got the sndobj based resynthesis more or less w...
common.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
config.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
dep.txt	2013-03-25	Ben Zonneveld	[e0e9e0] Merge branch 'master' of ssh://git.code.sf.net/...
fastest_coeffs.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
float_cast.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
high_qual_coeffs.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
libsamplerate.cpp	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
license.txt	2009-10-21	Ben Zonneveld	[15ba1c] New Resamper
macros.h	2011-01-03	Ben Zonneveld	[2ec741] Implemented the dialog for Mirage Configuration...
memdc.h	2009-11-09	Ben Zonneveld	[a9cc6b] Got the parameter changing working in a new and...
mid_qual_coeffs.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
mirage_midi_in.log	2013-06-14	Ben Zonneveld	[5c2960] Tried sending all parms in one go. Didn't work.
pitch to samplerate.txt	2010-02-04	Ben Zonneveld	[f01f96] Before changes to Displaytype B
resource.h	2014-04-30	Ben Zonneveld	[84d5c8] Solving MIDI input problems
resource.hm	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
ruler.h	2009-09-20	Ben Zonneveld	[d93fef] Starting attempt at using swapchains
samplerate.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
sndobj_dsp.cpp	2011-02-19	Ben Zonneveld	[f2daa3] Got the resynthesis working. Getting sndobj to ...
sndobj_dsp.h	2011-02-19	Ben Zonneveld	[f2daa3] Got the resynthesis working. Getting sndobj to ...
stdafx.cpp	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
stdafx.h	2014-05-06	Ben Zonneveld	[f7139f] Started using Autocorrelation for freq/pitch de...
sysexdebug.cpp	2013-03-25	Ben Zonneveld	[e0e9e0] Merge branch 'master' of ssh://git.code.sf.net/...
sysexdebug.h	2013-03-25	Ben Zonneveld	[e0e9e0] Merge branch 'master' of ssh://git.code.sf.net/...
undo.h	2009-12-17	Ben Zonneveld	[b4dedb] Commit of modified files
wavesamples.cpp	2010-11-09	Ben Zonneveld	[db6b10] Minor fixes in audio playback
wavesamples.h	2010-11-04	Ben Zonneveld	[d9de82] Started Implemtation of Reading Disk Images

Read Me

==============================================================================

        Resampler - An audio resampling library in C++
        v1.02

        Copyright (c) 2003-2004 Laurent de Soras

==============================================================================



Contents:

1. Legal
2. What is Resampler ?
3. Using Resampler
4. Compilation
5. History
6. Contact



1. Legal
--------

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Check the file license.txt to get full information about the license.



2. What is Resampler ?
----------------------

Resampler is a library for digital audio resampling, aka "sampling rate
conversion". Its primary goals are the following ones:

    - Very high quality and low aliasing
    - Variable resampling rate
    - Easy integration into software samplers and synthesisers
    - Real-time, low-latency resampling of pre-calculated data
    - Low and predictible CPU load
    - Low memory requirement.

Of course CPU load is not as low as cheap polynomial interpolation, but the
algorithm remains CPU-friendly regarding the achieved sound quality. Moreover,
sampler performance limitations generally come from the computer's memory
bandwidth. So it's probably a good idea to spend those lost clock cycles in
high-quality resampling...

The specs:

    - Effective bandwidth up to 90 % of Nyquist frequency
    - Aliasing rejection below -85 dB
    - 0.1 dB ripples in the passband

It is an illustration of the method described in the article
"The Quest For The Perfect Resampler", Laurent de Soras, June 2003.

Both source code and article may be downloaded from this webpage:
http://ldesoras.free.fr/prod.html



3. Using Resampler
------------------

To avoid any collision, names have been encapsulated in the namespace "rspl".
So you have to prefix every name of this library with rspl:: or put a line
"using namespace rspl;" into your code.

The main object is ResamplerFlt. It handles the concept of monophonic sound
generation, or voice. Before functionning, it requires to be connected to two
other objects, instances of MipMapFlt and InterpPack. Both can be shared
between many ResamplerFlt instances.

MipMapFlt stores sample data and handles MIP-map precalculations. Total memory
occupation won't exceed about two times the original data amount. Once
ResamplerFlt is set up, you reconnect other MipMapFlt objects on the fly. It
allows you to change the sample associated to a given voice.

InterpPack handles internal stateless operations and precalculated filters.
Generally you'll need only one instance of it per program.

For more information, check main.cpp. It contains two complete example of
sample interpolation, generating 16-bit/mono/44.1 kHz raw sample files. Don't
hesitate to dig the code documentation.

The library processes only 32-bit floating point data. I have done experiments
with 16-bit MMX instruction set (not included), it becomes very fast but with
a small penalty on quality because data is quantified to ~14 bits at some
stages.

Resampler is intended to be portable, but has little architecture-dependant
pieces of code. So far, it has been built and tested on :
     - MS Windows / MS Visual C++ 6.0
     - MS Windows / MS Visual C++ Toolkit 2003
     - MS Windows / GCC 3.3
     - MacOS 10.3 / GCC 3.3
     - MacOS 10.3 / Code Warrior 8
If you happen to have another system and tweak it
to make it run successfully, pleeeeease send me your modification so I can
include it to the main distribution. Run main.cpp in Debug mode before then
in Release mode, in order to be sure that everything is fine.



4. Compilation
--------------

Drop all the .h, .cpp and .hpp files into your project or makefile.

main.cpp and StopWatch.* are for testing purpose only, do not include them if
you just need to use the library.

Resampler may be compiled in two versions: release and debug. Debug version
has checks that could slow down the code. Define NDEBUG to set the release
mode. For example, the command line for GCC would look like:

Debug mode:
g++ -Wall -o resampler_debug.exe *.cpp

Release mode:
g++ -Wall -o resampler_release.exe -DNDEBUG -O3 *.cpp



5. History
----------

v1.02 (2004.08.25)
    - Fixed multiple definition error with GCC 3.3 and above

v1.01 (2003.06.23)
    - Support for GCC 3 / Cygwin.
    - Support for Code Warrior / MacOS.
    - Fixed std::runtime_error problem in the test suite.
    - Fixed private member problem for ResamplerFlt::_fir_mip_map_coef_arr.

v1.00 (2003.06.21)
    - Initial release, MS Windows port.



6. Contact
----------

Please address any comment, bug report or flame to:

Laurent de Soras
laurent@ohmforce.com
http://ldesoras.free.fr

Thanks to:
- Raphael Dinge for porting Resampler to MacOS.
- Richard Dobson for spotting some problems with GCC