/*************************
*         GPBook         *
*************************/

Code & Gfx by WhiteFalcon
Testing & Ideas by THB



Version: 1.2	- added auto-scroll function for the lazier ones among us ;)
(28.1.05)	- fixed (?) support for larger files, 1MB+ files should read ok
		- added blank lines limit - no empty screens anymore
		- drawing functions are now in asm and one or two more
		  optimizations should make things work a bit faster
		- text formatting ON is now default

History: 1.1	- now supports texts in Czech, German, French, Spanish,
		  Italian and probably some others as a side effect :)
		- fixed several bugs in the word-wrapping routine
		- slight change of the font
		- new splash screen

	 1.0	- first public release 



Installation
=============

Place GPBook.fxe in the GPMM folder on your SMC.
Place any ASCI text file, source code or whatever in any folder on your SMC,
default location is gp:\\GPETC.


Controls
========

First, choose a file to view. TXT files are highlighted, but you can view
any file on your SMC. Keep in mind though, that GPBook will not show any
special characters, control codes etc.
The scrolling might be faster, but as GPBook is now running at 21MHz,
I suppose it is good as it is. Long live the batteries! ;)

When in the viewer mode, use the following controls:

	UP/DOWN		- scroll up/down by one line 
	L/R		- scroll up/down by one screen
	SELECT+L/R	- scroll up/down quickly
	A (hold)	- show file info
	B		- auto-scroll on/off
				- then UP/DOWN changes between 3 speed levels 
	START		- go to the main menu

When in the main menu, move around using the joystick, press A to choose
an item. To get out of the menu press either START or choose "back to text".


Multilanguage support
=====================

As you may notice, files in some of the supported languages appear to be correct
even when a different language it set. This is because there are basically only
two sets of characters, which I found to be enough. However, it is advised
to choose the language of the viewed file, just to be on the safe side.
Apparently, English and Italian text files should show properly with any
of the languages selected.


Bookmarks
=========

For one text file you can have one bookmark. When you choose "save bookmark"
from the menu, the bookmark will be immediately saved in GPBOOK.CFG file
in the GPETC folder on your SMC. If you delete this file, your bookmarks
will be lost.
Files are identified by sort of CRC, which means that if anyone of the text
files is changed, the corresponding bookmark becomes useless. You can use
bookmarks in 500 files and there is no way to delete a bookmark (yet?)
	

Text formatting
===============

As there are various kinds of text files out there, I have added this text
formatting feature. When it is off, all invisible characters are skipped
and more text will fit on the screen. When it is on, the text will processed
so that the ENTER control code will break a line. Also, leading spaces
when a TAB control code is found will be visible. Comes in handy when wieving
source code or many e-books.


Contact
=======

Should you have any comment or questions, send me a mail to schimi@post.cz,
drop me a private message on the GP32x.com boards or on ICQ.


Greetings
=========

I would like to thank George "THB" Tava especially for moral support, ideas and
real-time testing. So....thanks THB! :)
My thanks go also to Eddie from the #france channel on EFNet, who helped me with
collecting all the special characters that French uses.

My greetings go to all the GP32 scene, namely to Mr. Spiv, Skeezix, Rlyeh, foft,
and many others.


WhiteFalcon

18. 1. 2005, Prague, Czech Republic