home *** CD-ROM | disk | FTP | other *** search
- README 3/11/91
- Image Tool
-
- _______________________________________________________________________________
- BEFORE YOU BEGIN
-
- Please read the README.FIRST file - found at the root level of this server -
- for general information and instructions on unarchiving and uncompressing
- files.
-
- The README.BROCHURE also contains helpful descriptions of this and other
- software offered on the ftp server.
-
- _______________________________________________________________________________
- IMAGE TOOL
-
- This REDAME file is in the anonymous ftp directory for Version 1.1 of
- ImageTool for the Sun Workstation.
-
- PLEASE NOTE: If a (?) appears below the data is in question! In other words
- don't tell us that it is wrong because it is!
-
- _______________________________________________________________________________
- NEW FEATURES
-
- 1. Support for the full line of Sun Architectures. This includes
- the Sun-3, Sun-4, and Sun386i.
- 2. Support ONLY for SunOS 4.x. Please let us know if 3.x support on
- the Sun-3 is critical. ImageTool 1.1 has NOT been tested under
- SunOS 3.x. We guarantee that it will not work completely
- reliably under 3.x because of changes in the OS!
- 3. ImageTool 1.1 has a lot similarities to ImageTool 1.0 but is
- not fully upward compatiable.
- 4. Includes full NCSA HDF (Hierarchical Data Format) support. The
- HDF routines are included as part of the distribution.
- 5. There are no embedded parameters in the source distribution. They
- are now handled through Sun User Defaults database mechanism.
- 6. A number of cosmetic changes have been made. In particular,
- panel fonts are selected from the user defaults database so that
- one can now run ImageTool in a SunView Environment with
- different fonts outside of ImageTool. You still don't have
- control over the font of the frame labels because that remains a
- limitation of SunView.
- 7. Great care has been made to simplify the installation. There is
- one Makefile with two targets: personal and system. Run personal
- to produce a working local version first and then run system as
- root for the system wide version once you are satisified that the
- local version works out. READ THE MAKEFILE BEFORE DOING ANYTHING!
- It will save you some grief especially on the Sun-4. The
- instructions are relatively painless. Please do not be intimidated
- by the actual details of the script.
- 8. Testing:
- Sun-3/160, Sun-3/110 SunOS 4.0.0
- Sun386i/250 SunOS 4.0.1
- Sun-4/150 SunOS 4.0.3 (?)
- 9. Claim:
- Should work fine on the new SparcStations and the new
- 68030 based workstations without change. Let us know
- if it does or does not!
-
- _______________________________________________________________________________
- INSTALATION NOTES
-
- File: ImageTool1.1.src.tar.Z
- Contents:
-
- ImageTool.d - Master Defaults Database file for ImageTool. This
- is modified during system installation and copied
- to the directory /usr/lib/defaults.
- HDF/ - NCSA HDF (Hierarchical Data Format) directory
- containing all the source and makefile to create
- the libdf.a library.
- Makefile - Makefile for installing ImageTool.
- headers/ - Directory containing global .h files for ImageTool
- 1.1beta source.
- imagetool.help/ - Directory containing the online ASCII help files.
- src+obj/ - Directory containing the ImageTool 1.1 source.
- imagetool.pal - A 256-color initital raw palette.
- samples/ - Directory of samples.
-
-
- 1. Put copy of dist.tar.Z in your current directory.
- 2. Space required in this directory to continue:
-
- 2.1 Extracted files from compressed tar file
- ~ 3.6 MB
- 2.2 Personal installation - additional
- ~ .8 MB Sun-3
- ~ .8 MB Sun386i
- ~ .8 MB Sun-4
- 2.3 System installation - no space is used in this
- directory unless you so designate it in the Makefile.
-
- PLEASE NOTE THAT TEMPORARY SPACE IS REQUIRED TO DO EITHER
- INSTALLATION. Consult the Makefile in the distribution for
- approximate sizes.
-
- 3. Execute:
-
- zcat dist.tar.Z | tar xvfB -
-
- to extract the directory ./v1.1beta.dist
- and place it in your current directory.
-
- 4. Execute:
-
- cd v1.1beta.dist
-
- and read the documentation in the Makefile carefully.
-
- 5. For a personal installation:
-
- 5.1 Change any required macros (only one at most) in the
- Makefile.
- 5.2 Execute:
-
- make personal
-
- . . . messages . . .
-
- The executable, imagetool, is now ready to execute
- in SunView IN THIS DIRECTORY! If you move out of this
- directory you will have to change some personal defaults
- by either editing $HOME/.defaults or executing
-
- defaultsedit
-
- in SunView and changing them.
-
- 6. For a system installation:
-
- 6.1 Change any required macros (only at most three) in the
- Makefile.
- 6.2 Become superuser by executing:
-
- su root
- password: <fill in>
-
- 6.3 Execute:
-
- make system
-
- . . . messages . . .
-
- 6.4 Execute in SunView:
-
- defaultsedit
-
- and install the ImageTool master database values in
- your personal database. The values created by the
- personal installation will have to be replaced by the
- master ones. This involves erasing the current values
- and saving the defaults.
-
- 6.5 Add the system directory where imagetool and
- associated files were installed to your search path
- by editing either your .login/.cshrc file or .profile
- file.
-
- _______________________________________________________________________________
- INSTALLATION 4/30/91
-
- There are several subdirectories under the Imagetool base directory.
-
- src The source for Imagetool
- help The help files for Imagetool
- doc The troff form of the Imagetool manual.
- images Some sample images. "xx" is an animation sequence.
- pals Some sample palettes.
-
- There is also a sample .imagetool_defaults file.
-
- =========================================================================
-
- Building Imagetool
-
- To build Imagetool, first go to the src directory. Edit the file
- "config.h" and modify its contents as directed by the comments in the
- file. There are four symbols to be concerned with.
-
- SUN4 if you are compiling for a Sun 4
- FPA if your Sun 3 has a Floating Point Accellerator
- BIN_DIR the directory for the imagetool binary
- HELP_DIR the directory for the help files in quotes
-
- After editing config.h, run "make". It should build the imagetool binary.
- Then, to install the binary and help files, you may need to become
- superuser (or find one). Then run "make install".
-
- You should be able to run Imagetool with the command "imagetool &".
-