-------------------------------
K2PDFOPT GUI v2.0.0
(c) 2012-2013 Jens Wallauer
Basic Information

15.06.2013
-------------------------------

Welcome to k2pdfopt GUI 2.0!
This release is a complete rewrite of the GUI. While it contains all of the functions of the previous versions it
features some additional improvements. All commands are now dynamically important from a profile file and can be
freely adjusted to suit your needs. The conversion process is still carried out by the standalone version of 
k2pdfopt but it is implemented much more transparent in this version of the GUI.

Furthermore I decided to include certain online functionality in this version. You can check for program updates and
updates to the default commands. The default commands can be downloaded and installed directly from the GUI,
without the need for you to download the file manually. The same goes for Tesseract training files. These can be
downloaded directly from Google and are installed automatically, so you don't have to worry about which folder to
select and what environment variable to set.

I also improved the feedback system drastically. You can now send me messages directly from the GUI and don't need to
use your E-Mail program or account. 

NOTE: Every online function is only executed are you gave your strict permission to do so. Prior to going online the
GUI will ask your permission. Automatic updates on program start are implemented but are disabled by default. You can
enable this function in the options menu.

--------------------------------
Getting started
--------------------------------

As before I did not include the main program, k2pdfopt, in my GUI. You need to download this file manually from
http://willus.com/k2pdfopt/download/ (or click the link in the About dialog in the GUI).
After you got k2pdfopt, place the file anywhere on your harddisk and go to the Options menu (Tools-->Options).
Enter the path to k2pdfopt.exe into the respective textbox (or select the file in the dialog, accesible with
the button next to the textbox). This color should change to green.

On the first program start the default profile is loaded. You can set the options to your liking. If you exit
the GUI, your last choices are loaded on the next program start automatically. You can save a profile with a 
specific name through the Tools-->Profile menu. Here you can furthermore reload the default options or merge
a profile with options in the default profile (this is helpful since you can add or delete every command by 
editing the profile's .ini file, see below).

To perform a conversion you need to add your .pdf or .djvu files to the GUI. You can either click the big button,
use the main menu or just drag-and-drop the files to the files list.

After you have set the options to your liking, start the conversion process by hitting F5 or selecting "Begin Convert"
from the Convert menu. A new window opens that informs you of the process. Close this window once the conversion is 
complete.

To use Tesseract OCR, you need to download training files. In the options menu you can select the language of your
choice and click "Download and install". The file is automatically downloaded, extracted and the correct path is entered
into the path-box. Check the option to automatically set the environment variable to complete the Tesseract installation.
If you now enable the Tesseract OCR option (OCR Tab) everything is set correctly.

This should get you started.
If you have any feedback, bug reports, feature requests... please let me know!

Please note: This is the initial release of a complete rewrite, so there will be bugs I haven't found yet. If you inform
me, I can fix them asap. :-)

Have fun with the program!

- Jens Wallauer
15.06.2013, Marburg (Germany)


--------------------------------
Format of the profile .ini files
--------------------------------

WARNING: If you experience problems with the special characters being displayed wrong in 
		 GUI try saving your files with ANSI encoding (use text editors like Notepad++ e.g.).
		 
It is possible to build you own profiles for k2pdfopt. A profile contains all information
about the commands you make visible to the user. A profile is represented in the form of
an .ini file.
Every profile must contain a [Description] section and a [GeneralOptions] section in the 
form:

[Description]
Name=Example name					Profile name
Description=Bla bla bla				A description of the profile
Version=1.0.0.0						Version number

[GeneralOptions]
AdditionalOptions=					What's being displayed in the additional options textbox
ValueGap=225						The distance in pixels of the leftmost value field from the left border of the Tabcontrol

Commands are then listed as further sections. Every command must contain the following
parts:

[CommandName]						The parameter name: Must not start with a number and must only contain letters and numbers
Caption=Test Caption				The text that is displayed on the checkbox in the GUI
Category=Test Category				The Tab page the command is being displayed in
Command=-test						The corresponding command line option: May be blank, must contain the "-" if you want to have it on the command line.
									There will always be a space character in before the command in the command line (see below).
Tooltip=Hello World.				The Tooltip displayed in the GUI
Checked=False						Wether the checkbox is ticked: Must be either "True" or "False"
AcceptBlankValues=False				This is an OPTIONAL property. If set to False (default) and the command has values (see below) the chosen values
									may not result in a blank expression. This is important for various reasons and should not be changed in most cases.
									If this property is not defined for a command, a value of False is assumed.

You can add line breaks in both the Caption as well as the Tooltip by adding <br> to the string.
Note: The string is NOT read as HTML, only this command is interpreted.


Apart from these basic definitions a command can also take values. Every value is added by an additional key in the commands section.
The key name must start with either TextBox, NumBox or ComboBox following by an increasing number for each specific valuetype.
As the key's value you need to define the properties of the value, delimited by ;

Textbox1=Value;Width;Command;DoPadding
NumBox1=Value;Width;Command;DoPadding;Decimals;Minimum;Maximum;Increment
ComboBox1=SelectedIndex;Width;Command;DoPadding;Item1;Interpretation1;Item2;Interpretation2;...

Value: The value that the corresponding control in the GUI has
Width: The width in pixels of the respective control: 55 (110,165..) is recommended
Command: The command line option. Can be left blank if you want. ATTENTION: If you want to seperate the previous value you have to write " -command" (note the space).
DoPadding: Can be True or False. If True a Space character will be inserted in the command line string BEFORE the value, otherwise it value will be placed directly after
		   the previous charater in the string (used for example in -j 1+ for the "+" char directly after the 1).

Decimals: Number of decimal places
Minimum: Minimum value of the control
Maximum: Maximum value of the control
Increment: By how much shall the value be changed if you use the control's arrows

SelectedIndex: The selected index of the combobox, 0-based
Item: What is displayed in the GUI
Interpretation: The corresponding command line option


If you make errors in the definition, the value or command will not be displayed in the GUI.