PalmPilot Image Viewer Copyright © 1997 Arthur J. Dahm III All Rights Reserved e-mail: adahm@cyberramp.net web page: members.aol.com/PilotApps Introduction ------------ Image Viewer is an application for the 3Com PalmPilot handheld organizer. Use it to view scrollable four-level grayscale or black and white images, pictures, maps or diagrams. Included with Image Viewer is a Windows 95 application for converting Windows graphic files to a format that can be hotsynced into the PalmPilot. Installing Image Viewer ----------------------- ************************************************************************ *** PLEASE READ THE SINGLE USER LICENSE AGREEMENT AT THE END OF THIS *** *** DOCUMENT BEFORE INSTALLING IMAGE VIEWER *** ************************************************************************ Install the Image Viewer (viewer.prc) as you would any other PalmPilot application using the 3Com Install Tool. Installing Images ----------------- Use the PalmPilot Image Converter (pimg.exe) to create image files compatible with Image Viewer. If you checked the auto-install option when creating images, your images will automatically be installed the next time you hotsync the PalmPilot. Otherwise, install the images on you PalmPilot using the 3Com Install Tool. Images will have a file name ending with .pdb Image List View --------------- The main screen of the Image Viewer presents a list of images which can be viewed and has a 'View Image' pushbutton and an 'Image Details' pushbutton at the bottom of the screen. Each entry in the image list contains the image's name, its size and a note icon if a note is attached to the image. Tap an image's name while the 'View Image' pushbutton is selected to view the image. Tap an image's name while the 'Image Details' pushbutton is selected to view information about the image and to access the option to delete the image. Tap an image's note icon to view or edit a note attached to the image. To create a note for an image which doesn't already have a note, tap the area to the right of the image's dimensions. The following Image Viewer menus are accessible from the main image list view: Info - Help ----------- General help information Info - Shareware Info --------------------- Information on how to register Image Viewer Info - About ------------ Copyright and version information Options - Preferences --------------------- Opens a dialog box with several preferences options. The first two options define the behavior of the PalmPilot hardware buttons. The third option is a checkbox to enable or disable the option to backup images to your PC. Options - Delete Images --------------------- Opens a dialog box where you can select the category to delete all images from. Select 'All' to delete all images on your PalmPilot. Hidden images are not deleted. Display - Adjust Colors ----------------------- This menu option brings up the Adjust Colors screen for adjusting the four grayscale levels for grayscale images. The colors adjustments do not affect the normal PalmPilot screen or black and white images. Display - Default Colors ------------------------ Use this menu option to restore the grayscale levels to their default values. Image View ---------- If an image is larger that the PalmPilot's screen (bigger than 160 by 160), drag the pen along the image to scroll it. To return to the Image List View, tap the silk-screened 'menu' button. To view, edit or create a note for the image, draw an 'N' in the Graffiti area. Image Details View ------------------ The Image Details dialog box presents information about the image such as the image width, height, size and type. You also have the option to change the image's category, set the image as private or delete an image from the Image Details dialog box. Image Notes View ---------------- The Image Notes view displays any text associated with an image. It functions in much the same way as the PalmPilot Memo Pad application. Tap the 'Done' button to return to the image list view. Tap the 'View' button to view the image. Tap the 'Delete' button to remove all text associated with the image. The text size can be switched between the small font and the larger font by tapping either the large 'A' pushbutton or the smaller 'A' pushbutton. Notes ----- Use the contrast dial on the left side of the PalmPilot to adjust the display. Whenever the PalmPilot needs to present a dialog box (such as an alarm, the "Find" dialog box, or the App Picker) while viewing an image, Image Viewer will return to the Image List View. Features -------- - View grayscale or black & white images up to approximately 460x460 - Scrolling virtual screen - One tap selection of images from a list of available images - Number of images limited only by the amount of memory available. - Add notes to an image Updates ------- v2.3 - Added grafitti shortcuts to Image View: 'S' - Set anchor scroll position 'G' - Go to anchor scroll position 'A' (looks like an up arrow) - Go to previous image in category 'V' (looks like a down arrow) - Go to next image in category 'N' - Go to image note 'D' - Go to image Detail view - Added 'Rename' and 'View' buttons to Details view. - Fixed potential Fatal Error when using the 'Find' button while viewing compressed images. - Updated e-mail and mailing addresses. v2.2 9/22/97 - Handles damaged compressed images in a more graceful manner. v2.1 8/11/97 Features - Support for compressed images. - Application buttons can be used to scroll images. - 'Up' and 'Down' buttons can skip to the previous/next image in a category. - Menu item to delete all images in a category or all images on your PalmPilot. v2.0 6/25/97 Features - Categories - Private records - 'Find' button support - Image notes - Black & white images - several UI enhancements v1.0 6/8/97 Features - Images remember their scroll position between viewings. - Hardware 'up' button sets an 'anchor' position. - Hardware 'down' button returns image to 'anchor' position. Bug Fixes - Display bug fix increases maximum image size by about 10% and fixes problem when scrolling near the bottom of very tall images. Register -------- Image Viewer is Shareware. To obtain a registered version of this application via e-mail, send $18.00 US and your e-mail address to: Art Dahm 923 Saw Mill River Rd. Box 241 Ardsley, NY 10502 USA or Register at PilotGear H.Q. http://www.pilotgear.com =========================================================================== Single User License Agreement READ BEFORE INSTALLING IMPORTANT: YOU SHOULD READ THIS AGREEMENT BEFORE INSTALLING THE SOFTWARE. DOWNLOADING THIS SOFTWARE AND/OR USING THE PROGRAM INDICATES YOUR ACCEPTANCE OF THE TERMS STATED BELOW. IF YOU DO NOT AGREE TO THESE TERMS AND CONDITIONS, PROMPTLY RETURN THE ENTIRE PACKAGE INCLUDING ALL DOCUMENTATION FOR A REFUND OF THE LICENSE FEE. 1. LICENSE. Arthur J. Dahm III grants you a non-exclusive license to install and use the software product defined below (the "Program") subject to the terms and conditions set forth in this Single User License Agreement. You are responsible for the selection of the Program to achieve your intended results, and for the installation, use and results obtained from the Program. 2. COPYRIGHT. This Program is owned by Arthur J. Dahm III and is protected by the United States copyright laws and international treaty provisions. You must treat the Program like other copyrighted material with the following exception: Under this Single User License Agreement, you may make archival copies of the Program for the sole purpose of having a backup copy. You may not copy the documentation which accompanies the Program. 3. RESTRICTIONS ON USE. You may install and use the Program on one stand-alone computer at one time. You may not install and/or use the Program on more than one computer at one time. You may not install the Program on a network file server. You may not use, copy or transfer copies of the Program except as provided in this Single User License Agreement. You may not reverse engineer, decompile or disassemble the Program. You may not sublicense, rent, lease, distribute or assign the Program. 4. TRANSFER. You may not transfer any of your rights to use the Program to another party. 5. LIMITED PROGRAM WARRANTY. Arthur J. Dahm III warrants that the Program, unless modified by you, will perform substantially in accordance with the accompanying documentation for a period of ninety (90) days from the date of delivery to the original licensee. If notified in writing during this warranty period that the Program is defective, Arthur J. Dahm III will attempt to make the Program operate as warranted by providing a correction. If Arthur J. Dahm III is unable to correct the defect within ninety days after notification, you may terminate your license and obtain a refund by returning all copies of the Program together with a copy of your license payment receipt. You assume all shipping and handling charges for return and replacement of the Program under this warranty. This limited warranty will apply only if the Program is licensed and located in the United States. Arthur J. Dahm III does not warrant that the performance of the Program will meet your requirements or that the operation of the Program will be error free, or that defects in the Program will be corrected. THIS WARRANTY IS IN LIEU OF ALL OTHER WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 6. LIMITED MEDIA WARRANTY. To the original licensee only, Arthur J. Dahm III warrants the magnetic diskettes on which the Program is recorded to be free from defects in materials and workmanship under normal use and service for a period of ninety (90) days from the date of delivery. Defective media under warranty will be replaced when returned, postage prepaid, together with a copy of your receipt. 7. LIMITATION OF REMEDIES AND LIABILITY. The remedies described in this Single User License Agreement are your exclusive remedies and Arthur J. Dahm III's entire liability. IN NO EVENT WILL ARTHUR J. DAHM III BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING LOST PROFITS, LOST BENEFITS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES, RESULTING FROM THE USE OF OR INABILITY TO USE THE PROGRAM OR ANY BREACH OF WARRANTY. ARTHUR J. DAHM III'S LIABILITY TO YOU FOR ACTUAL DAMAGES FOR ANY CAUSE WHATSOEVER, AND REGARDLESS OF THE FORM OF ACTION, WILL BE LIMITED TO THE MONEY PAID FOR THE PROGRAM OBTAINED FROM ARTHUR J. DAHM III THAT CAUSED THE DAMAGES OR THAT IS THE SUBJECT MATTER OF, OR IS DIRECTLY RELATED TO, THE CAUSE OF ACTION. 8. TERM. This Single User License Agreement is effective until terminated. You may terminate at any time by destroying all copies of the Program in any form. It will terminate automatically if you fail to comply with any term or condition of the Single User License Agreement. Upon such termination, you agree to destroy all copies of Program. 9. GOVERNMENT LICENSEES. RESTRICTED RIGHTS LEGEND. This Program and documentation are provided with Restricted Rights. Use, duplication, or disclosure by the U.S. Government or any agency or instrumentality thereof is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 52.227-7013 and FAR 52.227-19. Contractor is Arthur J. Dahm III, 923 Saw Mill River Road, Box 241, Ardsley, NY 10502.