///////////////////////////////////////
//          Readme file for           //
//              EasyPLX               //
///////////////////////////////////////

THE PROGRAM
===========
EasyPLX
beta version, third version

The exact version number is aviable in the "Properties" dialog for the executable file. 

CONTACT ME
==========
www.olle.tk
e-mail: olle dot bergvist at yahoo dot se

TERMS OF USAGE
==============

     This program is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     the Free Software Foundation; either version 2 of the License, or
     (at your option) any later version.
     
     This program 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 General Public License for more details.
     
     You should have received a copy of the GNU General Public License along
     with this program; if not, write to the Free Software Foundation, Inc.,
     51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Copyright (C) Olle Bergkvist 2007
You can read the license in the file "COPYING.TXT". 

WHAT CAN IT DO?
===============
EasyPLX is a GUI tool for adding pictures to your iriver, 
so you can access the pictures from the "Pictures" menu in your iriver. 
To do that, the program
* copies your pictures to a JFU (full screen) and JTH (thumb nail) file,
* and creates a picture playlist (a PLX file). 

For technical details, see the file "README_PLX.TXT". 

HOW TO USE
==========
My intention is that this program will be very easy to use. 
All you have to do is to click on the "Browse..." button in the upper part of the main window. 
Choose your pictures and click on OK. 
If you want more pictures, repeat this step. 
When you are done, write a name for the picture playlist in the empty textbox. 
This name will appear in the Pictures menu in you MP3. 
Then click on "Continue!". 

That is the basic. There are more advanced options too. 
Like the M3U part. You can choose a text file with a list of pictures. 

And the settings. 
You will propably never need to change the settings, but if you for some reason want to, you can change them. 
Just click on the "Settings..." button. 
The settings are stored in a .INI file in the same folder as the executable file. 

KNOWN ISSUES
============
This program is not perfect yet. 

* The file paths in the M3U file must be relative. 
  "holiday.jpg" or "subfolder\holiday,jpg", or even "..\subfolder\holiday.jpg" is okay, 
  BUT NOT an absolute path (with a drive letter) like "F:\Photos\holiday,jpg". 
  And neither a remote file, like "http:\\www.mysite.com\pics\holiday.jpg"
  That is because each file path in the M3U file is added to the folder where the M3u file is located, 
  and that requires a relative path. From this merged file paths are the path of the source picture file computed. 
  == This rule only affects you if you want to copy pictures and have checked the checkbox. ==

* Some M3U files has the "..\" in the file names. Because it's not possible to have a directory called "..\", 
  EasyPLX will place the pictures in a folder called "_.._\" instead. 

* You may choose pictures which are located in the root of a drive, like "C:\picture.jpg". 
  But it's not possible to create a folder with a colon in its name. 
  Instead, EasyPLX will place pictures from "C:\" in a folder called "C_root_folder_", and equivalent for D:\ and E:\ etcetera. 

* EasyPLX does not accept any file names in the last line of an M3U file (a line where the EOF (-1) value is present). 
  Such file names are simply ignored. 

* If you have file paths which dont have any folder name inside, only a file name, in a PLX file: 
  Then, when the MP3 reads this PLX file, it wont display the names of the pictures correct. 
  The first letter of the picture's name wont appear on the screen. "my pictures" becomes "y pictures". 
  This is a bug in the MP3 player's firmware, and NOT a bug in EasyPLX. 
  And this should not happen with EasyPLX in the first place, as i'm really trying to avoid it. 
  Note that you WILL be able to view the pictures with your MP3, this bug only affects the LOOK of the NAMES of the pictures. 

EOF (end of file)