home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / plotting / imagetoo / imagetl1.lha / Imagetool / README < prev   
Encoding:
Text File  |  1991-07-25  |  6.3 KB  |  191 lines

  1. README 3/11/91
  2. Image Tool
  3.  
  4. _______________________________________________________________________________
  5. BEFORE YOU BEGIN
  6.  
  7. Please read the README.FIRST file - found at the root level of this server - 
  8. for general information and instructions on unarchiving and uncompressing
  9. files.
  10.  
  11. The README.BROCHURE also contains helpful descriptions of this and other
  12. software offered on the ftp server.
  13.  
  14. _______________________________________________________________________________
  15. IMAGE TOOL
  16.  
  17. This REDAME file is in the anonymous ftp directory for Version 1.1 of 
  18. ImageTool for the Sun Workstation.
  19.  
  20. PLEASE NOTE: If a (?) appears below the data is in question! In other words
  21.          don't tell us that it is wrong because it is!
  22.  
  23. _______________________________________________________________________________
  24. NEW FEATURES
  25.  
  26. 1. Support for the full line of Sun Architectures. This includes
  27.    the Sun-3, Sun-4, and Sun386i.
  28. 2. Support ONLY for SunOS 4.x. Please let us know if 3.x support on
  29.    the Sun-3 is critical. ImageTool 1.1 has NOT been tested under
  30.    SunOS 3.x. We guarantee that it will not work completely
  31.    reliably under 3.x because of changes in the OS!
  32. 3. ImageTool 1.1 has a lot similarities to ImageTool 1.0 but is
  33.    not fully upward compatiable.
  34. 4. Includes full NCSA HDF (Hierarchical Data Format) support. The
  35.    HDF routines are included as part of the distribution.
  36. 5. There are no embedded parameters in the source distribution. They
  37.    are now handled through Sun User Defaults database mechanism.
  38. 6. A number of cosmetic changes have been made. In particular,
  39.    panel fonts are selected from the user defaults database so that
  40.    one can now run ImageTool in a SunView Environment with
  41.    different fonts outside of ImageTool. You still don't have
  42.    control over the font of the frame labels because that remains a
  43.    limitation of SunView.
  44. 7. Great care has been made to simplify the installation.  There is
  45.    one Makefile with two targets: personal and system. Run personal
  46.    to produce a working local version first and then run system as
  47.    root for the system wide version once you are satisified that the
  48.    local version works out. READ THE MAKEFILE BEFORE DOING ANYTHING!
  49.    It will save you some grief especially on the Sun-4. The
  50.    instructions are relatively painless. Please do not be intimidated
  51.    by the actual details of the script.
  52. 8. Testing:
  53.     Sun-3/160, Sun-3/110    SunOS 4.0.0 
  54.     Sun386i/250        SunOS 4.0.1
  55.     Sun-4/150        SunOS 4.0.3 (?)
  56. 9. Claim:
  57.     Should work fine on the new SparcStations and the new 
  58.     68030 based workstations without change. Let us know
  59.     if it does or does not!
  60.  
  61. _______________________________________________________________________________
  62. INSTALATION NOTES
  63.  
  64. File:    ImageTool1.1.src.tar.Z
  65. Contents:
  66.  
  67. ImageTool.d        - Master Defaults Database file for ImageTool. This
  68.               is modified during system installation and copied
  69.               to the directory /usr/lib/defaults.
  70. HDF/            - NCSA HDF (Hierarchical Data Format) directory
  71.               containing all the source and makefile to create
  72.               the libdf.a library. 
  73. Makefile        - Makefile for installing ImageTool.
  74. headers/        - Directory containing global .h files for ImageTool
  75.               1.1beta source.
  76. imagetool.help/        - Directory containing the online ASCII help files.
  77. src+obj/        - Directory containing the ImageTool 1.1 source.
  78. imagetool.pal        - A 256-color initital raw palette.
  79. samples/        - Directory of samples.
  80.  
  81.  
  82. 1. Put copy of  dist.tar.Z  in your current directory.
  83. 2. Space required in this directory to continue:
  84.  
  85.     2.1 Extracted files from compressed tar file
  86.         ~ 3.6 MB
  87.     2.2 Personal installation - additional
  88.         ~ .8 MB         Sun-3
  89.         ~ .8 MB         Sun386i
  90.         ~ .8 MB     Sun-4
  91.     2.3 System installation - no space is used in this
  92.         directory unless you so designate it in the Makefile.
  93.  
  94.     PLEASE NOTE THAT TEMPORARY SPACE IS REQUIRED TO DO EITHER
  95.     INSTALLATION. Consult the Makefile in the distribution for
  96.     approximate sizes.
  97.  
  98. 3. Execute:
  99.  
  100.     zcat dist.tar.Z | tar xvfB - 
  101.  
  102.    to extract the directory    ./v1.1beta.dist
  103.    and place it in your current directory.
  104.  
  105. 4. Execute:
  106.  
  107.     cd v1.1beta.dist
  108.  
  109.    and read the documentation in the Makefile carefully.
  110.  
  111. 5. For a personal installation:
  112.  
  113.     5.1 Change any required macros (only one at most) in the
  114.         Makefile.
  115.     5.2 Execute:
  116.  
  117.         make personal
  118.  
  119.         . . . messages . . .
  120.             
  121.          The executable, imagetool, is now ready to execute
  122.          in SunView IN THIS DIRECTORY! If you move out of this
  123.          directory you will have to change some personal defaults
  124.          by either editing $HOME/.defaults or executing
  125.  
  126.         defaultsedit
  127.  
  128.          in SunView and changing them.
  129.  
  130. 6. For a system installation:
  131.  
  132.     6.1 Change any required macros (only at most three) in the
  133.         Makefile.
  134.     6.2 Become superuser by executing:
  135.  
  136.         su root
  137.         password: <fill in>
  138.  
  139.     6.3 Execute:
  140.  
  141.         make system
  142.  
  143.         . . . messages . . .
  144.  
  145.     6.4 Execute in SunView:
  146.  
  147.         defaultsedit
  148.  
  149.         and install the ImageTool master database values in
  150.         your personal database. The values created by the
  151.         personal installation will have to be replaced by the
  152.         master ones. This involves erasing the current values
  153.         and saving the defaults.
  154.  
  155.     6.5 Add the system directory where imagetool and
  156.         associated files were installed to your search path
  157.         by editing either your .login/.cshrc file or .profile
  158.         file.
  159.  
  160. _______________________________________________________________________________
  161. INSTALLATION 4/30/91
  162.  
  163. There are several subdirectories under the Imagetool base directory.
  164.  
  165.     src    The source for Imagetool
  166.     help    The help files for Imagetool
  167.     doc    The troff form of the Imagetool manual.
  168.     images    Some sample images.  "xx" is an animation sequence.
  169.     pals    Some sample palettes.
  170.  
  171. There is also a sample .imagetool_defaults file.
  172.  
  173. =========================================================================
  174.  
  175. Building Imagetool
  176.  
  177. To build Imagetool, first go to the src directory.  Edit the file
  178. "config.h" and modify its contents as directed by the comments in the
  179. file.  There are four symbols to be concerned with.
  180.  
  181.     SUN4        if you are compiling for a Sun 4
  182.     FPA        if your Sun 3 has a Floating Point Accellerator
  183.     BIN_DIR        the directory for the imagetool binary
  184.     HELP_DIR    the directory for the help files in quotes
  185.  
  186. After editing config.h, run "make".  It should build the imagetool binary.
  187. Then, to install the binary and help files, you may need to become
  188. superuser (or find one).  Then run "make install".
  189.  
  190. You should be able to run Imagetool with the command "imagetool &".
  191.