Appsoft Image^ä 1.0  -  Release Notes

Thank you for purchasing a copy of the Appsoft Image application. This document contains last minute information about the Appsoft Image Release 1.0 program. The notes describe problems you might encounter and provide information not available in the Appsoft Image ªReference Guide.º The document is divided into three sections: Installation Notes, Known Problems, and Hints.

INSTALLATION NOTES

Program Installation
To install Appsoft Image for use on your NeXT computer:

1. 	Turn on your NeXT computer and log in.

	Note: If you are the only person using Image and your computer requires you to log in, you may log in with your own password. If you are installing Image for use by multiple users you will need to log in as "root." If you don't know the root password, contact your system administrator for help.
	
You will need 12 Megabytes of free hard disk space to properly install the 
Appsoft Image application. Once the application is installed, however, you can reduce the total disk space used by Image by deleting the sample files or the Image Help files. Since the help file is hidden in Image's application wrapper, refer to the Hints section for information on deleting the help file.
	
2. 	There are 2 diskettes containing the Appsoft Image program. Insert the disk labeled Disk 1.

3.	Locate the file named AppsoftImage.pkg in the File Viewer.  Double-click the icon to begin the installation process. A panel entitled Appsoft Image appears.

4.	Click the Install button in the upper left corner of the panel. A browser panel appears for you to select the directory in which you want to install the Appsoft Image program.

5.	Click on your ~/Apps directory if you will be the only person using the program; click on the ~/LocalApps directory if multiple users will be using the program on the same machine. Click OK. A panel appears indicating where the Appsoft Image program files will be installed.

6.	Click Install. All the files in the Appsoft package will be copied into your ~/Apps or your ~/LocalApps directory.

7.	A panel appears when the installation is complete. Choose Quit to exit the Installer application.
 
User Authorization
After you have followed the installation instructions provided in the section above, you will need to initialize the Appsoft Image application via the Image Registration panel.

Note: Because Appsoft Image allows multiple users to run from the same copy of the application, you will need to enter the authorization information that is provided as part of the Appsoft Image package. This information will automatically authorize the Image program for the total number of user copies you have licensed.

	If you installed the Appsoft Image application in the ~/LocalApps directory on your computer, you must enter the authorization information while logged in as the "root" user. Otherwise other users will only be able to run the Appsoft Image application in Demo Mode.

To initialize Appsoft Image:  

1. 	Use the File Viewer to display the contents of the folder containing your Appsoft Image application.

2.	In the application folder, select the file AppsoftImage.app so that it appears in the icon path.

3.	Choose Open from the Workspace File menu. Appsoft Image starts. Shortly, a panel asking you to register the Image application will appear on the screen. Click on the Register Now button.

4.	Once the Appsoft Image Registration panel appears on the screen enter the Registration Name and the Company Name in the appropriate fields. You will also need to enter the Serial Number and the Authorization Number in the appropriate fields. This information can be found on either the registration card or the authorization card included in the Appsoft
	Image packaging.

	IMPORTANT: In order to receive technical support and information on impending    Appsoft Image enhancements, it is very important that you return the postage paid Image registration card to Appsoft immediately. (Occasionally we will provide our mailing lists to carefully selected companies. If you do not wish to have your name included in these lists, you can check off the appropriate box on the back of the Image registration card). Please take a moment now to complete and return the registration card.
	
4.	After you have entered all the information into the Registration panel, click on the Register button. If for some reason the information is incorrect or you don't want to initialize the program at this time, click on the Cancel button and restart the application to begin the installation process again.

If you decided not to register your copy of Appsoft Image, you can still run the Image application in Demo Mode. However, you will not be able to save, print or copy to the clipboard anything you may create while working in Demo mode.

Note: If you only purchased a single user version of Appsoft Image and would like to upgrade your user license to include more than one user, please call our toll-free line for more information. We can provide you with a new authorization number that will automatically add more users to the original license over the phone. Our sales staff is available Monday thru Friday, 9:00am - 5:00pm pacific standard time. Call 1-800-428-2777 or (415) 802-2900 for more information.

HINTS

Freeing Up Hard Drive Space
The help file is hidden in Image's application wrapper. To delete the help file, click once on the Appsoft Image application icon. Select the Open As Folder command from the Workspace File menu. When the folder opens you will see a file called Documentation. Drag this file into the recycler to remove it from your hard drive.
	
WARNING: If you delete the Documentation file without backing it up, you will need to reinstall the entire package to again gain access to the help file. If you installed the application in ~/LocalApps and you delete the Documentation file, none of the other users will be able to access the help file either.

Drag and Drop - Loading
Under the 3.0 NeXT Operating System, it is possible to load files directly into Image without needing to select the Open command from within Image. Once the application is running, select and drag the appropriate file from the File Viewer onto the applications icon while holding down the COMMAND key.

Object Linking
An important new feature of the 3.0 NeXT operating system allows different file formats to be linked for use between multiple applications. This functionality, however, requires that both applications support the object linking functionality. We are happy to report that, although Image works under the 2.0 operating system, it also supports object linking in the 3.0 operating system. Please refer to the ªImage Reference Manualº  for more information.

KNOWN PROBLEMS

Swap Files
You may find that you occasionally run out of hard drive space while working with large images. This is a function of the Mach operating system. Once an application runs out of internal memory it will set aside more memory on your computer's hard drive as it needs it. This extra memory is taken up on your hard drive in the form of a swap file. When you quit from Image the space used in the swap file will automatically be released for use by other applications. However, the space on the hard drive will now be reserved only for swap files and will not be available for other uses unless you restart your computer. While rebooting the swap file will automatically reset.

HSD Scanner Driver
Certain older model HSD scanners may import images that are flipped horizontally and vertically. This does not appear to happen on the newer model HSD scanners. The only way to fix this problem is to manually flip the image after it has been imported using the Transform / Flip menu commands.
	
Photoshop Files
If you plan to save Adobe Photoshopâ files, and then take them to the Macintoshâ on floppy disks, you should try to save your images directly to a floppy. Under NeXTSTEP 3.0, if you save a Photoshop file to your hard drive, and then try to copy it to a floppy, it may become corrupt.

To move a Photoshop file to a NeXT volume, the user should open Terminal and type the following:

cp /Macintosh Disk Name/foo.pshop /NeXT  Directory Name/foo.pshop
cp /Macintosh Disk Name/foo.pshop.#rsrc# /NeXT Directory Name/foo.pshop.#rsrc#

Where foo.pshop is the name of the Photoshop file.  Note that if you do an ls on the Mac disk, or you look at the Mac disk in Workspace, the #rsrc# file is not displayed because the resource file is a hidden file.  

There are two correct ways to safely copy a Photoshop data fork and its associated resource fork from a NeXT volume to a Mac volume.  The first way is to save the file in Image directly to a Mac volume.  The second way is to perform the transfer in a Terminal window by copying (using the cp command) both the data fork and the resource fork.  This process is the reverse of the above.  

Specifically, the reason that transferring files between NeXT/Mac file system stems from the fact that the resource fork is hidden when a Mac disk is opened from the File Viewer.  If the user just simply drags a file from a Mac disk to the NeXT, the NeXT file system simply leaves the resource fork behind.  Going from a NeXT to a Mac is also problematic.  If the user selects both the Mac data fork and its resource fork and copies them over to a Mac volume, the user gets an error message saying that foo.pshop.#rsrc# already exists on the Mac volume because the file system created it when it copied foo.pshop over.  If you select Replace in Processes panel, then the file system writes over foo.pshop as well.  Similarly, if you copy over the data fork first and then copy the resource fork (or vice-a-versa) the other file always gets replaced.  Hopefully this will be fixed in the 3.1 operating system.
	
Saving Paletted Images
Many of the file formats which Image supports are paletted images, that is they are not true color images, but images which contain only a very limited number of colors. When you save a true color image as one of these formats, you may notice that your image becomes very dark. This is the result of the limited number of colors which these formats support. You may encounter this problem when using the GIF, PCX, Photoshop, PICT, or TARGA file formats.

Appsoft, Appsoft Image and the Image logo are trademarks of Appsoft, Inc. NeXT is a trademark of NeXT Computer, Inc. Adobe Photoshop, PostScript and Display PostScript are registered trademarks of Adobe Systems Incorporated. Macintosh is a registered trademark of Apple Computer, Inc.