**************************************
    Universal Ringtone Converter
--------------------------------------
     (C) by Riza Purwo Nugroho
         <rizapn@yahoo.com>
         Jakarta - Indonesia
**************************************

What this software can do:
- convert MIDI file into ringtone text in any mobile phone format
- convert any ringtone text format into MIDI file or another format
- edit and play ringtone text in the PC using MIDI Sequencer function

What should be copy to run this tools:
- RPNTONE.EXE ... the executable software
- RPNTONE.INI ... INI files which contain all information needed

Ringtone format is defined in the RPNTONE.INI file as a text description.
Please feel enjoy to read that file, and add more type or format of mobile
phone ringtone. Currently, I just have a format description for Siemens,
NOKIA, and Ericsson mobile phone.

History:
- Nov.19 2001 : starting date, use Delphi as a mother
- Nov.22 2001 : the 1st fully function with some bugs (text to MIDI part
                is the most confusing thing for me)
- Nov.22 2001 : decide to use external INI file to give chance to add
                more format without EXE modification (previously it was
                defined inside the EXE file)
- Nov.23 2001 : <<<v1.10>>>
                the 1st ready to try, send it to the communities
- Nov.23 2001 : <<<v2.10>>>
                add function to support MIDI format 1 (multi-track), other
                than just for format 0 (single-track)
- Nov.23 2001 : <<<v2.25>>>
                add keypad sequence routine with just small predefined
                format (sorry, I do not have many example)
- Nov.24 2001 : <<<v3.14>>>
                add multiple file open capability
- Nov.30 2001 : <<<v4.01>>>
                support for MIDI file with multiple channel tones, each
                will be extract separately
- Dec.02 2001 : <<<v4.22>>>
              - add function to convert MIDI using instrument ID, each
                instrument will be convert separately.
              - add edit capability for multiple ringtone text
              - fix bugs when converting long duration MIDI tones, previously
                it was skipped if the duration is too large
              - add multiple MIDI file save (use _.mid as a filename
                will save all ringtone text as a MIDI file based on 
                ringtone title)

************************
  Usage (short help) :
************************

* Use [Load] button to load (one or more) file. If the file extension is MID then it will
  assume as a MIDI file, and it will automatically convert it into ringtone 
  text using selected format.
  It can also open ringtone text file. This text file could be a single 
  ringtone text or multiple ringtone text. Multiple ringtone text file 
  should be written using this format :

  [ringtone_title_1]
  ringtone_text_1
  [ringtone_title_2]
  ringtone_text_2

  If the number of file selected is more than one, than then output will
  have a title (same with the filename) for every file.

* Use [Save] button to save ringtone text as a normal text file or single
  track MIDI file (MIDI file should have MID extension).

* Use [New] button to start with blank text editor
* Use [Convert] button to convert ringtone text into another selected format

* Use [Play] button to hear the ringtone text result

* Ringtone Title can be selected if there is multiple ringtone text opened.
  Play button will be affected by this selection.

* Character [ inside ringtone text is used to indicate the end of the
  processed ringtone text (for play and convert). All text after this
  character will be ignored.

  for example [Ericsson format] :
    text cdef[gab+C will be played/converted as cdef only ...

* Use [Key] button to convert ringtone text into keypad sequence


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  Please send bugs report as soon as you have time to do that ...

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Hope this tools is usefull for everyone in the communities. I will be very
happy if you are happy. Nothing that I can share, but my little capability
to create a small tools.

It is dedicated to my parents, whose teach me how to be a good person,
my dear wife and son, Zaldy, whose show me what is the real happiness is,
my big family, my religion, and my country.

Please feel free to send your comment, feedback or everything to me.

Salam,
Riza Purwo Nugroho
rizapn@yahoo.com
Jakarta - Indonesia



