ScreenShot Hack 1.2 

ScreenShot Hack is the easy way to capture b/w and grayscale PalmPilot
screens to bitmaps anywhere, anytime. 

Of course, you can use the Palm OS Emulator (POSE) to create images of
PalmPilot applications. But what if you want to  make a screenshot of
something that can't be run on POSE, like a localized ROM, an application
that requires a non-emulated hardware or a combination of application
and data only available on the real device? 

How about making screenshots directly on your PalmPilot? 

ScreenShot Hack captures the current screen of any application. To start
the screenshot, you enter one of three  rarely used graffiti strokes: 
-  the  Graffiti stroke for 'next field', the  down-up stroke (default) 
-  the  Graffiti stroke for 'previous field', the  up-down stroke  
-  the numeric keyboard popup (tap in the lower right corner of the
Graffiti area) 

When the stroke is entered, ScreenShot Hack will immediately capture
anything that's currently on the display.  Screenshot Hack puts itself
into the system event handler. This means you can capture screens from
almost all applications and games. Black/white, 2-bit, and (on Palm IIIx,
V, Vx...) 4-bit grayscale displays are supported.  

It is, however, possible, to write a program that behaves in a
non-standard way and  does not listen on the event queue. Screens from
such a program will not be captured.  If you find such a program, please
let us know and  we will list it here. 

As the name ScreenShot Hack suggests, it is a special kind of program
that requires Edward Keyes' Hackmaster to run. ScreenShot Hack will not
appear in the list of applications, but rather in the  Hackmaster's
list of system hacks. Don't be worried by the word Hack, it's a very
safe and well-behaving little tool. 

If you want to remove a Hack from your system, first disable it in
Hackmaster. Then choose  menu->App-&gt>Delete from the Launcher.  

Note that apparently due to a bug in PalmOS 1.2, you can't delete Hacks
on the Palm VII. You should use a special tool like Insider to remove
a Hack on a Palm VII. 

You can make multiple screenshots. ScreenShot Hack stores all  captured
images in a database ScreenShotDB.pdb that will be backed up to your
Desktop during the standard HotSync. Just make sure that you configured
your HotSync for System: Handheld overwrites Desktop. 

You can preview your captures, remove the last capture or all captures
from the database by going to Hackmaster and selecting the  ScreenShot
Hack control panel. 

On the desktop, you use the enclosed small ScreenShot2BMP.exe utility
to convert the PalmPilot database into a series of 160x160 16 color
Windows BMP files named Screen00.bmp, Screen01.bmp and so forth.  

If the program complains about missing DLLs or crashed weirdly, you
might also need to copy this set of Windows DLLs into your windows\system
(Windows 95/98) or winnt\system32  (Windows NT 4.0) directory. 

ScreenShot Hack is shareware and (C) LinkeSoft 1998. You can try out the
fully functional program. If you like it and use it regularly, please
register. Registration fee is just $10 and can be paid at PilotGearHQ,
www.pilotgear.com. Registered users are entitled to support and free
upgrades.





Version history


-  1.2 - new desktop converter program, display of captured screenshots
on handheld, settings now remembered after soft reset 
-  1.1 - support for grayscale mode 
-  1.0 - first public version 



(C) LinkeSoft  26-Oct-1998
Copyright (c) 1998, LinkeSoft Christian Linke, Berlin, Germany

License
-------

This license agreement settles the relation between LinkeSoft and the 
user concerning the use of the enclosed software product ("program") of
LinkeSoft in its Shareware version and its registered version.

 1
The user obtains through this license by LinkeSoft the non-exclusive 
right to install and use this program on his PalmPilot.
The program remains the sole property of LinkeSoft.
The user further obtains the right to make a back-up copy by means of 
the HotSync feature.

 2
The user may distribute the Shareware version of this program or copies 
thereof. The Shareware version may be published on the Inter- or 
Intranet or on software collections (on CDs etc.).
Each distribution must contain these provisions and the above copyright
notice. Except for publishing on software collections the distribution 
of this program has to be free of charge.
The program name or the name of LinkeSoft shall not be used for
promotional purposes without prior written consent of LinkeSoft.
The program may not be modified or tampered with in any way.

 3
THIS SOFTWARE IS PROVIDED BY LINKESOFT ''AS IS'' AND ANY EXPRESS OR 
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
DISCLAIMED. IN NO EVENT SHALL LINKESOFT BE LIABLE FOR ANY DIRECT, 
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
POSSIBILITY OF SUCH DAMAGE.

 4
For regular use the program has to be registered according to the 
general rules about Shareware. Registration is made by payment of the 
registration fee according to the program instructions. After 
registration the user receives a key that entitles him to unrestricted 
use of the program according to this license. Registration further 
entitles the user to get support by LinkeSoft via email and free 
upgrades of this program.

 5
The user shall in no way make copies of the registered version of this
program, except such as coming under  1. The user shall in no way 
resell or lend the registered program or copies thereof to third persons.
The registered program may not be made available to third persons.

 6
In the event that any provision of this Agreement should be or become 
invalid or if there is a gap in the Agreement, the validity of the other 
provisions shall not be affected. In lieu of the invalid provision or in 
order to complete the Agreement, a reasonable provision shall be 
effective approaching to what parties would have agreed upon if they had 
considered that issue.

 7
This Agreement shall be governed and construed in accordance with German 
law as it applies to German citizens and the parties hereby agree to 
submit to the exclusive jurisdiction of the courts of Germany. The place 
of proceeding will be Berlin.

 8
This software program is protected by international copyright law.

3Com, the 3Com logo and Graffiti are registered trademarks,
and HotSync, PalmPilot, Palm OS and the PalmPilot logo are trademarks of
3Com Corporation.
