The following folders contain sources and precompiled libraries
for building Palm Virtual Display Image Viewer and converter
Win32 application.

CONTENT
-------
ImageMagick-5.5.7 - Configured and compiled ImageMagic 5.5.7 distribution.
                    The package is configured for building static MT library.
                    The code was changed to allow reading VDIV PDB files
                    (see ./coders/pdb.c vs. ./coders/pdb_orig.c)

zlib-1.1.4 - ZLIB Palm port. Minor modifications were made for performance.

VDI - Palm viewer code 

vdivc - Win32 converter application code


COMMENTS
--------
The real idea behind the VDI is the "virtual display". The handheld devices
obviously have quite limited screen space. The "virtual display" is designed
to maintain a larger "virtual display" memory space that is viewable by the 
user through the small handheld screen with the convenience of scrolling and 
scaling the view. 

The VDI Viewer is built around the virtual display implementation. Essentially,
when opening an image it either creates and fills in or maps a virtual display 
to the image and then just lets the user view that virtual display. 

Note that if desired the content of the virtual display can be changed 
dynamically.


BUILDING
--------
The "vdivc" folder contains MS Visual Studio 6 project file for building
the converter application. The "prcfile.c" in the project is created
automatically during building of the Palm viewer "vdi.prc" file in the
"VDI" folder.

The Palm viewer ("VDI" folder) builds in Cygwin environment:
  CYGWIN_NT-5.1 1.5.6(0.108/3/2) 2004-01-19 00:43 i686 unknown Cygwin

It needs Cygwin Perl and GNU Make. I use:
  v5.8.2 built for cygwin-thread-multi-64int
  GNU Make 3.80

Palm SDK - PalmOS 5 SDK 68K R2:
  Note that I keep the "-palmos4.0" option in Makefile. 
  In my environment that just points to the above SDK location
  (never had time to do it right).

Palmos GCC suite (check the ./VDI/Makefile for the tools used).
Here are some versions numbers for the tools I have installed:
  $ m68k-palmos-gcc -v
  Reading specs from /usr/lib/gcc-lib/m68k-palmos/2.95.3-kgpd/specs
  Reading specs from /usr/lib/gcc-lib/m68k-palmos/specs
  gcc version 2.95.3-kgpd 20010315 (release)

  $ arm-palmos-gcc -v
  Reading specs from /usr/lib/gcc-lib/arm-palmos/3.3.1/specs
  Reading specs from /usr/lib/gcc-lib/arm-palmos/specs
  Configured with: ../.././gcc/configure --target=arm-palmos --disable-generic --enable-languages=c,c++ --disable-nls --prefix=/usr --cache-file=../config.cache --srcdir=../.././gcc
  Thread model: single
  gcc version 3.3.1 (prc-tools)

PilRc:
  PilRC v3.1
    Copyright 1997-1999 Wes Cherry   (wesc@ricochet.net)
    Copyright 2000-2003 Aaron Ardiri (aaron@ardiri.com)


LICENSE
-------
For ImageMagic and ZLIB please consult the readme files in the package
subfolders.

For the Virtual Display Image Viewer and converter copyrighted software the
permission is hereby granted, free of charge, to any person obtaining a
copy of this software to deal in it without restriction, including without 
limitation the rights to use, copy, modify, merge, publish, distribute, 
sublicense, and/or sell copies of the software, and to permit persons 
to whom the software is furnished to do so, subject to the following 
conditions: 
                                                                           
The author's copyright notice and this permission notice shall be included in 
all copies or substantial portions of the software.

The software is provided "as is", without warranty of any kind, express or 
implied, including but not limited to the warranties of merchantability,   
fitness for a particular purpose and noninfringement.  In no event shall   
the author be liable for any claim, damages or other liability, whether 
in an action of contract, tort or otherwise, arising from, out of  
or in connection with the software.                                                     

