Date: 08-May 1990 ****************************************************************************** Summary: ------- This readme.CompositeTool file is in the anonymous ftp directory for Version 1.1 of CompositeTool for the Sun Workstation. ****************************************************************************** Bugs and Comments: ----------------- Contact: Martin Knapp-Cordes E-mail: martink@ncsa.uiuc.edu Phone: (217) 244-0704 ****************************************************************************** Overview: -------- CompositeTool 1.1 is new release of CompositeTool. It has the following important 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. CompositeTool 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. Is upward compatiable with CompositeTool 1.0. All the features that worked under 1.0 should work under 1.1. 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 CompositeTool in a SunView Environment with different fonts outside of CompositeTool. 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. The Read_Defaults_Database false problem has been solved so as long as the CompositeTool master database has been installed a user need never have to worry about the state of her private database when trying to use CompositeTool at anytime. 9. When reading program settings from a file any file which does not exist is searched for in the directory of the settings file as a last resort. One now has the ability to move a composite around as a directory of files and not be tied to only absolute pathnames. 11. On Sun systems with a monochrome overlay plane the startup logo will only flash at best unless you run SunView with the -8bit_color_only option. 12. Testing: Sun-3/160, Sun-3/110 SunOS 4.0.3 Sun386i/250 SunOS 4.0.1 Sun-4/150 SunOS 4.0.3 13. 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! ****************************************************************************** Distribution: ------------ File: dist.tar.Z (binary) ---- Compressed tar file of the distribution except for the documentation. See below for details of the documentation. Contents: -------- ./v1.1.dist - Distribution directory with contents listed below. CompositeTool.d - Master Defaults Database file for CompositeTool. 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 CompositeTool. compositetool.c - Source of CompositeTool 1.1. samples/ - Directory of 6 sample composites, one per directory. demo.null/ - Settings file is file demo.null demo.session.a/ - Settings file is file demo.session.a demo.session.b/ - Settings file is file demo.session.b demo.session.c/ - Settings file is file demo.session.c logos/ - Settings file is file logos sinx_siny/ - Settings file is file sinx_siny logo.hdf - 308x219 logo image and palette in HDF format. pal_initial.raw - Initial 256-color raw palette loaded after the logo with its palette are displayed on startup. Installation: ------------ 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 ~ 1.2 MB 2.2 Personal installation - additional ~ .6 MB Sun-3 ~ .6 MB Sun386i ~ .6 MB Sun-4 Some of this is recovered because the compositetool.o is removed. 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.1.dist and place it in your current directory. 4. Execute: cd v1.1.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, compositetool, 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: 6.3 Execute: make system . . . messages . . . 6.4 Add the system directory where compositetool and associated files were installed to your search path by editing either your .login/.cshrc file or .profile file. ****************************************************************************** Documentation: ------------- File: adoc.tar.Z (binary) ---- Compressed tar file of the ASCII version of the documentation. This is the 1.1 ASCII documentation. Contents: -------- ./v1.1.adoc- ASCII documentation directory CompositeTool.ReadMe.a - Readme file CompositeTool.tp.a - Title page CompositeTool.toc.a - Table of contents CompositeTool.intro.a - Introduction CompositeTool.ch.1.a - Chapter 1 CompositeTool.ch.2.a - Chapter 2 CompositeTool.ch.3.a - Chapter 3 CompositeTool.Appendix.A.a - Appendix A CompositeTool.Appendix.B.a - Appendix B CompositeTool.bugs.a - Bugs Installation: ------------ 1. Put copy of adoc.tar.Z in your current directory. 2. Space required in this directory to continue: 2.1 Extracted files from compressed tar file ~.1 MB 3. Execute: zcat adoc.tar.Z | tar xvfB - to extract the directory ./v1.1.adoc and place it in your current directory. 4. Execute: cd v1.1.adoc and the read the content of the files. File: v1.1.doc.sit.hqx (ASCII) ---- BinHex StuffIt file of the MicroSoft Word 4.0 documentation for CompositeTool 1.1. This is the same as the hardcopy documentation. The file was stuffed and binhexed using StuffIt 1.5. Contents: (After decoding and destuffing) -------- cpt.ReadMe - Readme file cpt.tp - Title page cpt.toc - Table of contents cpt.intro - Introduction cpt.ch.1 - Chapter 1 cpt.ch.2 - Chapter 2 cpt.ch.3 - Chapter 3 cpt.Appendix A - Appendix A cpt.Appendix B - Appendix B cpt.bugs - Bugs Installation: ------------ 1. Transfer the file to a Macintosh. 2. Run the StuffIt application. If you don't have it a BinHexed version of StuffIt 1.5 can be found as file ./MAC/StuffIt_1.5.Hqx on the NCSA Anonymous FTP server and you MUST have the BinHex program 1.5 already on your machine to decode and create the StuffIt application. 3. In StuffIt: a. Select the menu item, "decode BinHex File...", on the "other" menu to decode the file to v1.1.doc.sit b. Select the menu item, "Open Archive...", on the "file" menu to open, select, and extract the files that are wanted from the file v1.1.doc.sit. ******************************************************************************