home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / software / unix / saoimage / sao1_07.tar / readme.txt < prev    next >
Text File  |  1991-06-04  |  6KB  |  121 lines
  1. readme.txt -- SAOimage information and installation instructions
  2.  
  3. User documentation:
  4.  
  5.     The main source is manual.tex, a LaTeX document in the doc
  6. subdirectory.
  7.     There is a UNIX man page which may be installed, but it is not
  8. as complete as the user manual.
  9.     There is also some obsolete user documentation organized by
  10. topic in ASCII text files in the doc subdirectory.  The cmdline.txt
  11. file describes switches used when bringing up saoimage at runtime,
  12. and useable in the command line pop-up window.
  13.  
  14. To build SAOimage under VMS:
  15.  
  16.     $ @make
  17.  
  18.     Refer to readme.vms in the vms subdirectory for details.
  19.  
  20. To build SAOimage under UNIX:
  21.  
  22.     % cp makefile.<machine> makefile    # copy machine-specific makefile
  23.     % make
  24.  
  25. Choosing a makefile:
  26.     There are several makefiles to choose from: .apo, .dec, .hp,
  27. .ibm, .mips, .sgi, and .sun.  makefile.sun expects the most in terms of
  28. system utilities and up-to date libraries.  These are unlikely to be
  29. available on non-Sun machines.  makefile.hp expects the least, and should
  30. work on machines as diverse as Apple, Convex, Cray, and Masscomp; it is an
  31. example of a makefile for a System V system.  makefile.dec is similar
  32. to makefile.hp, but for machines with LSB byte order (this only affects
  33. reading FITS files).
  34.  
  35. Editing the makefile:
  36.     After choosing a closest makefile and copying it to "makefile",
  37. you may wish to make further adjustments.  All changes are at the top,
  38. so don't be discouraged by the size of the makefile.  The switches are
  39. described at the top of the makefile.
  40.     If you do not use IRAF, delete the -DIMTOOL switch from IFLAGS.
  41. If you leave this switch in, but don't have IRAF installed, SAOimage
  42. will give a nasty warning message every time you bring it up.
  43.     If you don't have a PostScript printer, you may omit the
  44. -PSCRIPT switch.
  45.     If you have gcc, by all means use it!  It produces a much
  46. better executable than CC.  To use gcc, you must remove the "#"
  47. signs from the two gcc lines.  You may add further optimization
  48. switches to the gcc line if you wish.
  49.  
  50. A potentially editless alternative to selecting a makefile:
  51.     A driver makefile exists that sets architecture-dependent flags
  52. for an assortment of popular (and supported) architectures.  In a mixed-
  53. architecture environment, it is probably simpler to use the entries in
  54. the master makefile, and let this file select the appropriate machine-
  55. dependent makefile.
  56.  
  57.     % cp makefile.main makefile        # copy master makefile
  58.     % make                    # lists possible architectures
  59.     % make <architecture>            # do it
  60.  
  61. If you are making your own changes to the source code:
  62.     To add new image formats, just add appropriate calls in
  63. init_image() (to return dimensions) and load_image() (to load the
  64. passed buffer) in imgread.c.  You should add a commandline switch
  65. needed to recognize your image in parse_filetype() in cmdimage.c.
  66. If your image file names have a unique suffix, you may use that
  67. to recognize the file type in check_image() in imgcheck.c.
  68.     To add remote IO from other processes, use one of the
  69. connection records in hfiles/control.h (initialized defs/control.def)
  70. and follow the example in irafio.c.  It is very simple: you just put
  71. the pointer to your callback in the record and open the connection.
  72.     To add or change buttons, you must edit the ____.mnu files
  73. in the panel subdirectory.  You must look at the hfiles in btnlib
  74. and btnlib/tool to understand how the buttons are described.  You
  75. may use text strings and/or your own bitmaps.  To make new buttons,
  76. compile the library in btnlib/tool and then do the make in the panel
  77. subdirectory.  The button font is in the code, it does not use any
  78. runtime resources.
  79.  
  80. Acknowledgements:
  81.     SAOimage originated with showimg under X10.  Showimg was
  82. written by Bill Wyatt, and has continued to be extend under X11 by
  83. Doug Mink.  The user interface ideas for SAOimage were developed
  84. in collaboration with Richard Burg and Eric Mandell.  Jay
  85. Travisano did the VMS port and has continued to support it as
  86. SAOimage evolved.  John Roll has put work into the remote IO.
  87.     Rich Burg and Jay Travisano are both with the Space Telescope
  88. Science Institute.  The others mentioned are all with the Harvard
  89. Smithsonian Center for Astrophysics.
  90.     Numerous others have contributed bug fixes, porting information,
  91. and helpful suggestions.  They are credited in the source files where
  92. their contributions appear.  
  93.  
  94. Copyright:
  95.     SAOimage is copyrighted by the Smithsonian Institution.  It
  96. is available without charge, as is, to anyone who wishes to use it.
  97. The Smithsonian takes no responsibility for the appropriateness of
  98. the code for any application, the timeliness of bug fixes, or the
  99. continued compatablility of future versions with any code linked to
  100. this program.
  101.     Others are free to use, distribute, add to, or change the code.
  102. In fact fixes, extensions, and improvements are encouraged.  We would
  103. appreciate donations of such code for inclusion in the generally
  104. available version.
  105.     You may identify yourself with your added code and offer it
  106. under whatever arrangement you choose.   But you must keep the
  107. Smithsonian's copyright on original source code.  You may not
  108. represent this program as anything other than freely available code
  109. made available by the Smithsonian Astrophysical Observatory.
  110.     Developers should identify themselves to SAO so they can be
  111. notified in advance of impending changes, receive advance copies of
  112. development code, and be informed of others doing similar work for
  113. possible collaboration.
  114.  
  115. email address:
  116. vanhilst@cs.washington.edu (INTERNET)
  117. mvh@cfa.harvard.edu (INTERNET)
  118. mvh@cfa (BITNET)
  119. 6699::VANHILST (SPAN)
  120.  
  121.