Introduction:
============

pbimageviewer.app relies on knowing the ereader's hardware and software
capabilities to work properly.  The capabilities of many device models
have been built into the program, but for newer models, the program
won't automatically know what the capabilities are.  It is now possible
to specify the capabilities within a configuration file, so that future
device models can be supported fully without needing a new version
of the pbimageviewer.app program.



Automatically Supported Devices:
===============================

The following devices are currently automatically supported within
the program, and don't need a configuration file:

301, 302
360, 360+
602, 603, 612, 902, 903, 912
515, 611, 613
622, 623
801

Other devices need configuration files created for them if they
don't use the default settings (described below).



Configuration settings:
======================

For settings that require a 'yes' or 'no' answer, use '1' for 'yes'
and '0' for 'no'.  The following device capability settings are available:

has_dpad_buttons:	has the up/down/left/right arrow keys with the OK
	button in the center.
	The default is '1'.

has_mag_buttons: has the two mag-plus and mag-minus buttons for zooming.
	The default is '0'.

has_volume_buttons: has the two audio volume-up and volume-down buttons.
	The default is '0'.

has_back_button: has the back/escape button.
	The default is '1'.

has_menu_button: has the menu button.
	The default is '1'.

has_touchscreen: has a touchscreen.
	The default is '1'.

lr_rotate: device is rotated for left/right-handed usage (i.e. the next/prev
	buttons are on one side of the device rather than at the bottom).
	The default is '0'

has_new_config_struct: uses the new configuration structure or the older
	structure.  The automatically configured devices that use the new
	structure are the 622 (with firmware version 4), 623 and 801.
	If the configuration menus don't work properly in newer devices, then
	this option should be changed to '1'.
	The default is '0'.

max_screen_depth: the display depth in bits.  Most devices will use a
	depth of '8' for greyscale viewing.  Devices that have colour screens
	should set this to '24' if they want to see the colours.
	The default is '8'.

pagemap_***: configure how the little page map looks in the toolbar
	at the bottom of the screen.  New high-resolution devices with the
	modern toolbar should use the following values:

	pagemap_margin=0
	pagemap_width=24
	pagemap_height=32
	pagemap_clear=255
	pagemap_back=85
	pagemap_fore=0

	Older devices with the previous style of toolbar use the following
	default values:

	pagemap_margin=4
	pagemap_width=12
	pagemap_height=18
	pagemap_clear=85
	pagemap_back=255
	pagemap_fore=0



Adding a configuration file:
==============================

To create a new configuration file, add the settings that are different
from the default values to a file named XXX.cfg, where XXX is replaced
by the device's model number.  For example, the Touch Lux 2
configuration file would be named "626.cfg".  Copy that file to the
folder "/system/share/pbiv/" (creating it if necessary).  Use the
following default values as a template for the file, changing the
values as necessary for the new device:

has_dpad_buttons=1
has_mag_buttons=0
has_volume_buttons=0
has_back_button=1
has_menu_button=1
has_touchscreen=1
lr_rotate=0
has_new_config_struct=0
max_screen_depth=8
pagemap_margin=4
pagemap_width=12
pagemap_height=18
pagemap_clear=85
pagemap_back=255
pagemap_fore=0

