home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / astronom / starchrt / patch / readme.2 < prev    next >
Encoding:
Text File  |  1989-03-23  |  7.2 KB  |  155 lines
  1. README1 ==================================================================
  2.  
  3. STARCHART (rev 2)
  4. ----------------------------------------------------------------------------
  5. Note: This version is upward compatable with the original "starchart" software
  6. family, both in user interface and in continued support of the original
  7. reduced Yale catalog. Thus, it may supplant old copies of the software without
  8. fear that either shell scripts or file formats will become invalid.
  9.  
  10. However, both the new user interface and the extended catalog are
  11. superior, as are extensions for additional labelling (Greek characters,
  12. double star indicators, Messier objects), plus a mnemonic "finder" facility.
  13. ----------------------------------------------------------------------------
  14.  
  15. INSTALLATION INSTRUCTIONS:
  16.  
  17. [1]
  18. Save the new posting of the reduced Yale Star Catalog under the name
  19. "yale.star" (or use a copy of the old version). If the save directory is other
  20. than the one in which the program lives, then check out the Makefile, which
  21. allows path names to be specified for compilation.
  22.  
  23. Sites without much disk space may truncate the file yale.star at any point,
  24. as the data is sorted in order of increasing magnitude (dimming).
  25.  
  26. Additonally, the optional files "messier.star" and "con.locs" should be
  27. placed in the chosen directory. Entries in these files are unsorted. The
  28. optional file "planet.star" is created on an as-needed basis by the softwaare
  29. "planet.c", and might want a home in some less permanent (writable) location.
  30.  
  31. [2]
  32. Do a "make all" to compile all software. They are described in the man pages
  33. "starchart.1" and "planet.1" . All compile using starchart.c as the mainline,
  34. with device driver specifics in modules of appropriate name.
  35.  
  36. [3]
  37. You may now try "man test" to make an Orion pic file similar to the one
  38. posted to the net. Or you may test by outputting to the tty display, using the
  39. version "stardsp". This is described in the EXAMPLE section of the man page.
  40.  
  41. VERSION NOTES:
  42.  
  43. Tty display users (*sigh*) may which to alter "stardsp" to output
  44. to the display using an appropriate number of of rows and columns
  45. on the screen. (Presently 31x79 for a 32x80 display. 23x79 is a
  46. bit sparse).  Find the ROWS and COLS #defines in stardsp.c
  47. and update. Or be really ambitious and recode them as run time
  48. variables.
  49.  
  50. Tektronix emulator users may wish to alter scaling parameters based on the
  51. actual physical dimensions of the display raster, to get the cleanest possible
  52. star glyphs on output. This is described at length in the beginning of the
  53. driver "startek.c".
  54.  
  55. Pic file users: the #define PICFRAG can be adjusted downward
  56. (presently 8) should your pic input overflow pic's buffers. This
  57. happens when a long move,draw,draw,...,draw sequence happens.
  58. Smaller  PICFRAGs make larger files, by forming fragmented
  59. move,draw commands.
  60.  
  61. PostScript users: you may wish to play with the boiler-plate macros which
  62. define star shapes (e.g. 's1' does first magnitude stars). This is mentioned
  63. at the end of starchart.c
  64.  
  65. Laserjet users: the output of starlaser must be directed to
  66. laserjet via raw connection, because it is largely sent in binary
  67. 8-bit format. The graphics memory might overflow if you use the
  68. standard (oldest) 59k buffer laserjet (*sigh*). Anyway, I haven't
  69. ever lost any relevant data on the sheet: the overflow has occurred on
  70. the last few blank pixel rows of the graphics area. If you use
  71. laserjet plus, you shouldn't have any problems.
  72.  
  73. Other devices: don't expect the authors to write a new driver for you :-)
  74. Look through the sources - it's not so difficult after all... The module
  75. "starimages.c" provides support for bitmap devices; the PostScript driver
  76. is a good example of generating output in some graphics language.
  77.  
  78. More ambitious programmers may wish to extend the usefulness of these programs.
  79. Be our guest, but carefully consider the proposed list of suggestions which
  80. intentionally accompanies the main source code body "starchart.c". It is hoped
  81. that future changes and major revisions and their subsequent integration will
  82. be kept relatively simple by coordinating efforts and by not duplicating work.
  83.  
  84. awpaeth@watcgl (original author and revisions editor)
  85. inp@amber.berkeley.EDU (revisionist for user interface)
  86. pl@sibelius.intrin.FI (support for mini-Yale, Messier and finder catalogs)
  87.  
  88. README2 ==================================================================
  89.  
  90. [ from awpaeth: ]
  91. This is the SOFTWARE update kit for StarChart version #2
  92. which was released in Nov/Dec 1987. The kit performs an upgrade to ver #2.1
  93. No upgrades to yale.star or other .star files occurs.
  94.  
  95. This kit updates StarChart version #2 software as it appeared in that release -
  96. no other patches should already be in place. Virgin copies of version #2 are
  97. available from the moderator of comp.sources.unix.
  98.  
  99.  
  100. Overview of Changes
  101.  
  102. More portability across sysV and IRIS UNIX installations.
  103. A particularly nasty bug in planet.c was removed.
  104. Two new device drivers were added (Unix Plot(5) and Iris).
  105. StarChart now performs full clipping of vectors.
  106. Additional flags for creating stylized output and larger displays.
  107. PostScript now has nicer symbols for non-stellar objects.
  108. More detailed patch and upgrade notes appear in the source code.
  109.  
  110. FILES
  111.  
  112. Name            Description/Instructions
  113. ----            ------------------------
  114. README            this file
  115. patch-*            patches for moonphase.c, planet.c, drivers, yaleformat
  116. patchall        runs the above patches on the originals
  117. starchart.1        new man page
  118. starchart.c        rewritten main driver (easier to reinstall then patch)
  119. starchart.h        accompanying new .h file for above (ditto)
  120. stariris.c        new IRIS driver        
  121. staruplot.c        new UNIX Plot(5) driver
  122.  
  123. README3 ==================================================================
  124.  
  125. Over the last few weeks I have generated a database of constellation 
  126. boundaries.  This database does NOT include the constellation figures, just
  127. the boundaries defining the area of the sky the constellation contains.
  128. This database is in the 'old starchart' format, thus it will work for the
  129. recently posted starchart version 2.0 and the original starchart 1.0.
  130.  
  131. This data was hand compiled from the Sky_Atlas_2000.0.  Each constellation 
  132. has it's entire boundary defined, thus each adjacent constellation will define 
  133. the same vector (it will exist twice in the database).
  134.  
  135. To make this work for the starchart program, a modification is needed in the
  136. 'chartobjects' procedure.  I have included the entire procedure in the
  137. shar file following this message.  The only changes were at the top where
  138. I added some simple window clipping checks for the vectors and a couple
  139. of new variables.  Any vector outside the defined window will be converted 
  140. to a 'move' command and placed at the window edge.  You can either replace
  141. the entire procedure or just make the necessary changes.
  142.  
  143. If you wish the boundaries to always be charted, you should modify the 
  144. starchart.c module to read in and chart the boundary.star file just like 
  145. the other databases.  If you only rarely chart them, then just use the
  146. '-f' option in starchart version 2.0
  147.  
  148. Have fun.
  149. Dave
  150.  
  151. UUCP: {decvax,ucbvax,ihnp4,hplabs,sun,ames,prls}!decwrl!mips!vanthof
  152. or    vanthof@mips.com     (really Dave Van't Hof)
  153. USPS: MIPS Computer Systems, 930 Arques, Sunnyvale, CA 94086, (408) 991-0242
  154. "Always? No. Never question authority."  What I say is mine.
  155.