home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 097.lha / leach.readme < prev    next >
Text File  |  1986-11-20  |  7KB  |  176 lines
  1.  
  2. PROGRAM:    LEACH VERSION 1.0
  3. WRITTEN BY:    DREW LUCY
  4. DATE:        12/9/87
  5.  
  6.  
  7. COPYRIGHT NOTICE
  8.  
  9. This program is copyrighted. However, it may be copied and distributed freely
  10. in disk form, as long as this "readme" file is distributed with the program.
  11.  
  12. VERSION 1.0 OF LEACH MAY NOT BE DISTRIBUTED VIA ANY ELECTRONIC BULLETIN BOARD
  13. SYSTEM, COMMERCIAL OR OTHERWISE, EXCEPT COMPUSERVE. I'd like to do one more 
  14. rev of the program before it's turned loose on the world.
  15.  
  16. USER BEWARE
  17.  
  18. This hack is still in the early stages of development. To date, it has never
  19. harmed any disk resident data. Version 1.0 is much harder to crash than 
  20. Version 0.1 was. However, Ver 0.1 was a pushover and, Leach will probably 
  21. still crash the Amiga occationally. Leach does several things that no well 
  22. behaved program would dream of doing in a multitasking environment. Some ill 
  23. defined situations can still blow it out of the water.
  24.  
  25. The author is is not responsible for any ill effects that result from the
  26. execution of this program.
  27.  
  28.  
  29. CHANGES FROM VER 0.1 TO VER 1.0
  30.  
  31. * Ver 1.0 can be run against Graphicraft and Images, as well as all
  32.   Digi-view programs.
  33.  
  34. * New mouse pointer for easier end point placement.
  35.  
  36. * Degree read out in tenths of a degree so each slope is unique
  37.  
  38. * Ver 1.0 succesfully removes its menu from the Host's menu strip when
  39.   Leach's close window gadget is clicked. Leach's menu has become the 
  40.   last menu item in the Host's first menu.
  41.  
  42. * Ver 1.0 does a much better job of handling the message traffic between
  43.   Intuition and the Host, which means it won't crash nearly as often.
  44.  
  45.  
  46. DESCRIPTION
  47.  
  48. Leach is potentially useful only if you own NewTek Inc's "Digi-View" system,
  49. Aegis Images or Graphicraft. It is intended for people whoes interest in 
  50. precision digitizing goes beyond "getting the color of her nipples to come 
  51. out right". When run in parallel with a compatible Host program, Leach 
  52. allows you to make fairly precise measurements of distances and angles in a 
  53. digitized image. The unusual feature of Leach is that you make these 
  54. measurements while ALL of Host's functions are still available to you. Leach 
  55. allows you to manipulate a "ruler" line that it draws directly onto the Host 
  56. screen image. While all this is going on, the Host continues to function 
  57. (more or less) normally. 
  58.  
  59.  
  60. OPERATING INSTRUCTIONS
  61.  
  62. This version of Leach can not be used from WorkBench. From CLI, the 
  63. procedure for using Leach is as follows:
  64.  
  65. 1) "Run" the desired compatible Host program. I believe Leach will run 
  66. against any of the Digi-View programs (LORES, MEDRES, INTERLACE, etc). 
  67. However, leach has not been tested with the hires (640x400 color) program. 
  68. Leach has also been used successfully against Graphicraft 1.1 and both 
  69. Images programs.
  70.  
  71. 2) After the Host screen appears, switch back to the WorkBench screen
  72. by entering the "Left_Amiga-N" key combination. Click on the CLI window to
  73. reactivate it.
  74.  
  75. IMAGES WARNING: The Fast Menu window must be closed while you attach Leach
  76.         to Images.
  77.  
  78. 3) To start Leach use the command appropreate for the Host:
  79.  
  80. Host           CLI Command  (Note the quote marks)
  81. -----------------+----------------------------------------------------------
  82. Any Digi-View     | run leach    
  83. Graphicraft     | run leach "Graphicraft  Version 1.1"
  84. Images (320x200) | run leach "Aegis Images V1.1"
  85. Images (320x400) | run leach "IHR VERSION 1.1"
  86. -----------------+----------------------------------------------------------
  87.  
  88. Leach will automatically bring the Host screen back to the front. Leach will 
  89. abort shortly after it is run, if it can't find the Host in memory.
  90.  
  91. 4) Once the Host screen has reappeared, you may opperate the Host
  92. exactly as you normally would. OR...
  93.  
  94. 5) Notice that a "LEACH" menu item now appears at the bottom of the Host's
  95. first menu. Select the "Scr On" subitem and the Leach status display screen 
  96. will appear at the bottom of the display.
  97.  
  98. 6) Click the left gadget on the Leach status screen. The ruler will appear
  99. on the Host screen and the right gadget (labeled "MOVE") becomes enabled. At 
  100. this point, you still can't move the ruler line.
  101.  
  102. 7) Click Leach's right gadget. Now, clicking anywhere on the Host image
  103. (except near the ruler's endpoints) will cause the ruler to jump to the 
  104. position of the mouse pointer. The ruler can not be positioned so that it 
  105. would be partially off screen. Pressing and holding the Select Button very 
  106. near one of the ruler's endpoints will cause that endpoint to jump to the
  107. pointer and then follow it as long as the Select Button is held down.
  108.  
  109. 8) You may terminate Leach by clicking the close gadget in its status
  110. window. In this case, the Host continues to execute. Leach will also
  111. terminate if you select the Host's "QUIT" menu item.
  112.  
  113.  
  114. RANDOM NOTES
  115.  
  116. Leach has one particularly un-nerving habit. The first time that you move 
  117. a ruler endpoint, the internal disk drive may spin briefly. Leach is 
  118. loading mathtrans.libibrary from SYS:Libs, in order to perform its first 
  119. trig calculations. By the way, the above mentioned library MUST be there.
  120.  
  121. The Leach gadget labels always reflect the action that will be taken
  122. when they are selected, not the current state of the program. Thus if the
  123. left gadget is labeled "SHOW", the ruler will be invisible, right?
  124.  
  125. If the ruler is made invisible for any reason, it will also be frozen and
  126. the move/freeze gadget will be disabled.
  127.  
  128. Selecting an item from any Host menu automatically hides and freezes 
  129. the ruler and turns the status screen off. After making such a selection, 
  130. you must repeat steps 5, 6 and 7 to reveal and mobilize the ruler line again.
  131.  
  132. Selecting the "Scr Off" menu item turns the status screen off but does not
  133. affect the state of the ruler.
  134.  
  135. When used on HAM mode screens, the ruler causes the colors to smear in the 
  136. pixels to its immediate right, just like menus do.
  137.  
  138. Drawing over the ruler in Graphicraft or Images will leave parts of the ruler
  139. etched into the Host image.
  140.  
  141. Things can get alittle weird at quitting time if the Host Throws up a 
  142. requester. If you get tossed back to the CLI window but it is ghosted, use 
  143. Amiga-M to see if the Host is still running and waiting for you to satisfy a 
  144. requestor.
  145.  
  146. Leach often spits a failure message when it terminates. Don't worry about it.
  147.  
  148. The command line argument you give Leach is the Host screen title exactly as 
  149. it appears in the Host's Screen structure. However, leading spaces may be 
  150. omitted. Note that there are two spaces between "Graphicraft" and "Version" 
  151. in Graphicraft's title.
  152.  
  153. I will be revising Leach at least one more time. The current ruler line is 
  154. too hard to see. I am also considering adding a real world coordinate 
  155. system as an alternative to the pixel coordinates.
  156.  
  157. In spite of infrequent trips to the Guru, I find Leach useful for precision 
  158. digitizing. Without it, even simple tasks, like making sure that horizontal 
  159. lines are really horizontal, can be frustrating and time consuming. However, 
  160. Leach is a kludge at best. I hope that, along with other goodies, the next 
  161. release of the Digi-View software will include features similar to but better
  162. than, the one that Leach struggles to provide.
  163.  
  164.  
  165. Bug reports and enhancement suggestions would be welcomed. I can be contacted
  166. through...
  167.  
  168. CompuServe ID 76337,75    Please leave email rather than (or in addition to)
  169.             Forum messages.    Message life spans are shorter than 
  170.             interval between my visits to the forum.
  171.  
  172. US Mail            Drew Lucy
  173.             6777 Upper York Road
  174.             Star Route Box 102C
  175.             New Hope, PA  18938
  176.