//---------------------------------------------------------------------------
/**
 ** mp3gen's gui 1.0b / Star Trek Elite Force II Utility
 ** >>> Documentation <<<
 ** Copyright  2004 Yannick "Bluehair" Leon <bluehair@wanadoo.fr>
 **
 ** $File:	./mp3gen-gui.txt$
 ** $Designer:	Bluehair$
 ** $Date (US):	03-28-2k4$
 ** $Revision:	04-04-2k4$
 **
 **/
//---------------------------------------------------------------------------


[---- OVERVIEW ----]

When mp3gen first came out, captain_BOS (EFFiles staff) suggested me to make
a GUI for it; he even designed a sketch for it. Today, this is 6of1 to make
a similar suggestion ;) Then, there it is guys :) No more DOS boxes to open.

It "only" handles mp3gen's batch feature but all options available for this
mode can be triggered through it.


[---- CHANGES ----]

Fixes:
- "High" radio button behaved like the "Low" one
- mp3gen failed when the input directory was "c:\", "d:\"; precisely, the
  ending backslash was the problem, annoying
- Cancelling a directory selection reset the previous path to "n/a"

Enhancements:
- "Low", "Default" and "High" quality presets can be redefined through the
  config file and are displayed on the GUI
- New settings:
	* Silent mode: prevents mp3gen's DOS box from opening; however, the
	  "Final stats" message box will still show up
	* Click sound fixer: mp3gen sometimes appends a "click" sound to the
	  end of produced *mono* MP3s. This is not a generality. However, if
	  you were to experience this trouble, isolate the WAVs affected by
	  this symptom in the same directory and encode them using this
	  setting. Because using this "medicine" on unaffected WAVs would
	  likely slightly shorten their length (small cut at the end) ..
	* Configuration reset: delete the config file so you can define a new
	  location for mp3gen the next time this application runs. Can be
	  useful sometimes ;)


[---- INSTALLATION ----]

Where you want :) When first run, the program will ask you for mp3gen's
folder, then it will generate a config file (mp3gen-gui.ini) to retain
various settings.


[---- USAGE ----]

Straightforward. Refer to mp3gen's built-in help if you need.

The "Go!" button will get enabled once you have selected an input directory
featuring WAV files.

The program lets you specify a custom encoding bit rate; enter a wrong value
such as 4 so a message box will pop up to tell you what are the valid values;
you can use the chart included in this archive (mp3_bitrate_chart.png) if you
wish but this is not mandatory.


[---- BOTTOM LINE ----]

I hope you will enjoy this EF2 tool. This is probably the best one I have
released so far. The good about it is that it also can be used outside the
context of EF2: if you have multiple WAVs you wish to upload on a mp3 portable
device, you can use it to do the conversion, in just a few clicks.

Otherwise, I am happy to sign my return into the EF2 community through this
program. I hadn't left it but I was less active, as I have problems to be
centered on multiple fields of interest at a time.

See you.

Bluehair.

//---------------------------------------------------------------------------