README.TXT

(15 KB) Pobierz
                WIDI Recognition System 

Software for Automated Music Transcription (WAVE->MIDI) (version 2.7 SHAREWARE)


      Contents:
        0.What's new
        1.Introduction
        2.Features
        3.Description
        4.WIDI for Windows GUI version (WIDI.exe)
          4.1.System Requirements
          4.2.Installation

        5.DOS,OS/2 and Console versions (recogn.exe, recogno.exe, recogn32.exe)
          5.1.System Requirements
          5.2.Usage
        6.How does it work
        7.Parameters
        8.License
        9.Registration
       10.Other things

     Copyright                 Music Recognition Team, 1998-2001
_____________________________________________________________________________

        0.What's new

Version 2.7 :
+ New method named "Advanced Sensors" added. This method includes auto tuning
  algorithm. It allows to reduce amount of non-harmonic notes greatly. 
+ ACM (Audio Compression Manager) support added - you can open and transcribe
  any type of audio file if you have installed an appropriate ACM codec. 
  ADPCM, A-Law, u-Law and some other codecs are usually present by default. 
  (Win GUI and Windows console)
+ CD support added -  you can work directly with CD-tracks by simply opening 
  *.cda files from your CD-ROM.
+ You expand CD-tracks and compressed files to temporary files, thus greatly 
  improving the speed of consecutive transcribing attempts.
+ You can record sound files with WIDI now. (Win GUI only)
* Fixed a bug in "Peak" method, it should significantly increase this method's
  quality.
* Parameter names in INI file were changed to more friendly form.
* Now all output files are written to current directory by console versions - 
  to support CD grabbing in WIN32 console.

Version 2.6 :

+ MP3 support added! Now you can recognize MP3 files directly, without first 
  converting them to WAV!
+ Intermediate GS file support added.
+ Full Windows NT & Windows 2000 support.
* Fixed minor bug with MIDI file writing.

Version 2.51 :

+ A bug related to FFT transform fixed, and quality of "FFT" method improved 
  greatly. Try it !
* A bug related to 44100Hz WAVE buffering fixed. No more "Unknown Error" when 
  recognizing such waves.

Version 2.5 :

+ Completely new algorithms of pitch recognition and note determination made.
  They are many times faster and almost always give better results.
  Older ones present as well.
+ Ability to playback MIDI files added (Win GUI)
+ Parameters to specify MIDI file output added (Win GUI)
+ Help file included for Win GUI version
* Unregistered Win GUI version does not allow saving of MIDI files.
* Shareware protection was changed. All registered users 
  should contact us for a new key for free.
- "Output Window" disappeared (Win GUI)         
- Because of problems with MIDI playback under Windows NT,
  unregistered Win GUI version may be useless under NT, although
  registered version can save MIDI files under NT as well.

Version 2.31 :

+ added recognition of some non-standard wave files

Version 2.3 :

+ enabled "equalizer"
+ algorithm slightly improved
+ added "time shift of bass notes" parameter
+ improved interface

Version 2.21:

* WAVE fragment selection bug fixed (wrong selection display for large WAVES)
* "minduration" INI parameter bug fixed (it was not recognized by v.2.2)
 
Version 2.0 :
 
+ significantly improved conversion quality
+ more friendly user interface
+ selectable number of voices
+ selectable musical instrument for playing notes
+ selectable record fragment for recognition
+ memory requirements several times as low
* different meaning of "minnotedur" parameter
- conversion time increased 
- disabled "equalizer" (to be corrected soon)

- disabled "economy memory" mode

        1.Introduction
  The Program tries to convert musical piece to score, i.e.  Sound source file 
(WAVE, MPEG, CD-tracks) to MIDI file, containing notes. Composing the necessary
sophisticated algorithm is a difficult task, hence rather unperfect work of the
Program.

  This file covers mainly usage of console versions, most of information on 
Windows GUI version is contained in the help file.

        2.Features
- the Program gets as input both compressed and uncompressed WAVE, MPEG Layer 1,
  2 and 3 and CD tracks.
- produces multi-track volume differentiated MIDI files.
- uses simple harmonic model to eliminate wrong notes.
- allows automatic fine tuning to the key of source file.
- does not differentiate instruments in source file, but allows you to use any
  instrument in the output MIDI file.
- can produce intermediate GS files for quicker operation.
- pitches to recognize are selectable ("equalizer").
- subject to tuning:
  - algorithm selection 
  - minimal duration of notes (wrong short notes can be cut off)
  - number of voices (tracks)  1..9
  - time resolution (usually higher than minimal note duration)
  - bass note shifting 
- length of input source file is not limited.

        3.Description
  Source file of one of supported formats is a necessary condition for using
the Program. It can be recorded from microphone, external source or
grabbed from CD. WIDI GUI and WIN32 console versions can grab files from CD,
DOS and OS/2 versions do need WAVE or MP3 pre-recorded. MIDI file is obtained 
after corresponding parameter set up and subsequent conversion of source file.
It can then be played with Media Player or it can be loaded into MIDI Editor 
for note viewing or/and printing.
  Windows GUI version of WIDI contains simple MIDI player and Wave Recorder.

  There are several different versions of WIDI versions for different OSes:

     WIDI for Windows  (widi.exe) - operative under Win95/98/2000/NT.

  It has graphical user interface and easy parameter setting. INI file is not
supported. It also allows MIDI playback, Wave recording, and CD grabbing.

__
     DOS (recogn.exe)- operative under clean DOS, and Windows.

     OS/2 (recogno.exe)- operative under OS/2.
                    
     WIN Console (recogn32.exe) - operative under Win95/98/NT. It allows use
     of ACM and CD grabbing.        

  These three versions are almost identical in usage; they are driven from the 
Command Line, parameters are taken from the INI file. They can be also used in 
batch files or for intermediate file creation (.GS). The latter allows for the 
quick conversion with another set of all parameters related to Pitch->MIDI 
method (see Parameters). These versions are appropriate for experienced users.

_____________________________________________________________________________

        4.WIDI for Windows GUI version (widi.exe)

        4.1.System Requirements
  Processor:     Pentium 166 (recommended Celeron 333 MHz or higher).
  Memory:        16 Mb (the more the better -:).
  Hard Disk:     3 Mb + space for temporary files (recommended at least 100 Mb).
  OS       :     Win95/98/ME, Windows NT or  Windows 2000.
  Sound system:  Strongly recommended.

        4.2.Installation

  If you have a previous version installed, it is preferable to
uninstall it first.

  All keys for WIDI 2.5-2.6 are valid for WIDI 2.7 too.

  Start widi27in.exe to install (you may need to unpack widi27.zip if you have 
downloaded WIDI in zip form).

  To deinstall follow standard Windows Add/Remove
(Control Panel->Add/Remove Programs->WIDI version 2.x)


  Most of information on Windows GUI version is contained in the help file.

____________________________________________________________________________


        5.DOS, OS/2 and Console versions (recogn.exe, recogno.exe & 
          recogn32.exe)

        5.1.System Requirements
  Processor:     386 (Sufficient but slow in processing)
  Memory:        8Mb 
  Hard Disk:     500k
  OS       :     recogn32.exe - Win95, Win98,and NT
                 recogn.exe   - DOS
                 recogno.exe  - OS/2    

        5.2.Usage
  Program is driven from command line. A simple example is
"recogn <filename>" (or "recogn32 <filename>"). For instance,
"recogn mywav.WAV" will produce file mywav.MID in the current directory.
"recogn f:\song.mp3" will produce file song.mp3 in the current directory.
"recogn32 g:\track01.cda" will grab first track from CD and produce file
                          track01.cda in the current directory (WIN32
                          Console only !).
  Options:
   w - create a GS file
       ( GS file is used to store intermediate results. It can be then
       quickly converted to the MIDI file using another Pitch->MIDI
       parameter setting).

   r - convert a GS file, preliminary created with the "w" option, to the
       corresponding MIDI file with the same name and in the current 
       directory.


  During calculations every processed second of WAVE file is announced
by symbol "+".

  Change parameters in INI file, that is to be in the current directory 
for this purpose. A warning is generated and default parameters are used
if INI file is not found. See next section for description of parameters.
____________________________________________________________________________

        6.How it works

        WIDI performs music recognition in several steps.
        
  First it produces some kind of spectra-like data, this is called further 
the "WAVE->Pitch" conversion. Now there are several different algorithms 
implementing this step, each of them has its own advantages and disadvantages.

  Then  it multiplies that spectral data by coefficients of "Equalizer",
making some pitches louder and some pitches more quiet (This is only for 
Win GUI version...
Zgłoś jeśli naruszono regulamin