home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 144.lha / Leach_v1.3 / Leach.readme < prev    next >
Encoding:
Text File  |  1986-11-21  |  8.5 KB  |  210 lines
  1.  
  2. PROGRAM:    LEACH VERSION 1.3
  3. WRITTEN BY: DREW LUCY
  4. DATE:       5/88
  5.  
  6.  
  7. COPYRIGHT NOTICE
  8.  
  9. This program is copyrighted. However, it may be copied and distributed
  10. freely so long as this "readme" file is distributed with the executable.
  11.  
  12.  
  13. USER BEWARE
  14.  
  15. Leach does several things that no well behaved program would dream of doing
  16. in a multitasking environment. To date, it has never harmed any disk
  17. resident data. Version 1.3 is ALMOST impossible to crash when used with any
  18. of the Digi-View programs. However, there is always a chance that it may
  19. hang up the the Amiga. Leach also has some quirky interactions with the
  20. paint programs.
  21.  
  22. The author is is not responsible for any ill effects that result from the
  23. execution of this program.
  24.  
  25.  
  26. DESCRIPTION
  27.  
  28. Leach is potentially useful only if you own NewTek Inc's "Digi-View"
  29. system, Aegis Images or Graphicraft. It is intended for people whose
  30. interest in precision digitizing goes beyond "getting the color of her
  31. nipples to come out right". When run in parallel with a compatible Host
  32. program, Leach allows you to make fairly precise measurements of pixel
  33. distances and angles in a digitized image. The unusual feature of Leach is
  34. that you make these measurements while ALL of Host's functions are still
  35. available to you. Leach allows you to manipulate a "ruler" line that it
  36. draws directly onto the Host screen image. While all this is going on, the
  37. Host continues to function (more or less) normally. 
  38.  
  39.  
  40. CHANGES FROM VER 1.2 TO VER 1.3
  41.  
  42. * Heavily modified method of handling Intuition <--> Host message traffic.
  43.   Hopefully, this change has increased Leach's reliability.
  44.  
  45. * Ruler line no longer jumps to the mouse pointer when the Host window is
  46.   activated by a mouse click.
  47.  
  48. CHANGES FROM VER 1.1 TO VER 1.2
  49.  
  50. * An evolutionary deadend that was never distributed.
  51.  
  52. CHANGES FROM VER 1.0 TO VER 1.1
  53.  
  54. * Corrected rounding error in slope calculation.
  55.  
  56. * Leach no longer disturbs the drawing color of host paint programs.
  57.  
  58. * Ruler is drawn in a solid color instead of complementing the pixels of the 
  59.   underlying image. This has significantly slowed the ruler generation
  60.   rate, but I think the improved visibility is worth it. The ruler color
  61.   may be altered with the "<" & ">" gadgets at the far right of the status
  62.   screen.
  63.  
  64. CHANGES FROM VER 0.1 TO VER 1.0
  65.  
  66. * Leach has been run successfully against Graphicraft and Images, as well
  67.   as all Digi-View programs.
  68.  
  69. * New mouse pointer for easier end point placement.
  70.  
  71. * Degree read out in tenths of a degree so each slope is unique.
  72.  
  73. * Succesfully removes its menu from the Host's menu strip when Leach's
  74.   close window gadget is clicked. Leach's menu has become the last menu item
  75.   in the Host's first menu.
  76.  
  77. * Ver 1.0 does a MUCH better job of handling the message traffic between
  78.   Intuition and the Host, which means it won't crash nearly as often.
  79.  
  80.  
  81. OPERATING INSTRUCTIONS
  82.  
  83. This version of Leach can not be used from WorkBench. From CLI, the procedure
  84. for using Leach is as follows:
  85.  
  86. 1) "Run" the desired compatible Host program. I believe Leach will run
  87. against any of the Digi-View programs (LORES, MEDRES, INTERLACE, etc). 
  88. However, leach has not been tested with the hires (640x400 color) program. 
  89. Leach has also been used successfully against Graphicraft 1.1 and both Images
  90. Version 1.1 programs.
  91.  
  92. 2) After the Host screen appears, switch back to the WorkBench screen by
  93. entering the "Left_Amiga-N" key combination. Click on the CLI window to
  94. reactivate it.
  95.  
  96. IMAGES WARNING: Images is a tricky Host to work with. The Fast Menu window
  97.                 must be closed while you attach Leach to Images.
  98.                 
  99.  
  100. 3) To start Leach use the command appropreate for the Host:
  101.  
  102. Host               CLI Command  (quote marks are necessary)
  103. -----------------+----------------------------------------------------------
  104. Any Digi-View    | run leach    
  105. Graphicraft      | run leach "Graphicraft  Version 1.1"
  106. Images (320x200) | run leach "Aegis Images V1.1"
  107. Images (320x400) | run leach "IHR VERSION 1.1"
  108. -----------------+----------------------------------------------------------
  109.  
  110. Leach will automatically bring the Host screen back to the front. Leach will
  111. abort shortly after it is run, if it can't find the Host in memory.
  112.  
  113. 4) Once the Host screen has reappeared, you may opperate the Host exactly as
  114. you normally would, OR...
  115.  
  116. 5) Notice that a "LEACH" menu item now appears at the bottom of the Host's
  117. first menu. Select the "Scr On" subitem and the Leach status screen will
  118. appear at the bottom of the display.
  119.  
  120. 6) Click the "SHOW" gadget on the Leach status screen. The ruler line will
  121. appear on the Host screen and the "MOVE" gadget becomes enabled. At this
  122. point, you still can't move the ruler.
  123.  
  124. 7) Click Leach's "MOVE" gadget. Now, click once on the Host's screen to
  125. reactiveate it, then clicking anywhere on the Host image (except near the
  126. ruler's endpoints) will cause the ruler to jump to the position of the
  127. mouse pointer. The ruler can not be positioned so that it would be
  128. partially off screen. Pressing and holding the Select Button very near one
  129. of the ruler's endpoints will cause that endpoint to jump to the pointer
  130. and then follow it as long as the Select Button is held down.
  131.  
  132. 8) The "<" and ">" gadgets on the Leach status screen change the color
  133. register used to draw the ruler.
  134.  
  135. 9) You may terminate Leach by clicking the close gadget in its status window.
  136. In this case, the Host continues to execute. Leach will also terminate if you
  137. select the Host's "QUIT" menu item.
  138.  
  139.  
  140. RANDOM NOTES
  141.  
  142. Leach has one particularly un-nerving habit. The first time that you move a
  143. ruler endpoint, the internal disk drive may spin briefly. Leach is loading
  144. mathieeedoubbas.library from SYS:Libs, in order to perform its first trig
  145. calculation. By the way, the above mentioned library MUST be there.
  146.  
  147. The Leach gadget labels always reflect the action that will be taken when
  148. they are selected, not the current state of the program. Thus if the left
  149. gadget is labeled "SHOW", the ruler will be invisible, right?
  150.  
  151. If the ruler is made invisible for any reason, it will also be frozen and
  152. the move/freeze gadget will be disabled.
  153.  
  154. Selecting an item from any Host menu automatically hides and freezes the
  155. ruler and turns the status screen off. After making such a selection, you
  156. must repeat steps 5, 6 and 7 to reveal and mobilize the ruler line again.
  157.  
  158. Selecting the "Scr Off" submenu item turns the status screen off but does
  159. not affect the state of the ruler.
  160.  
  161. When used on HAM mode screens, the ruler causes the colors to "smear" in
  162. the pixels to its immediate right. This is an unavoidable side effect of
  163. HAM.
  164.  
  165. Drawing over the ruler in Graphicraft or Images will leave parts of the
  166. ruler etched into the Host image.
  167.  
  168. Things can get a little weird at quitting time, if the Host throws up a
  169. requester. If you get tossed back to the CLI window but it is ghosted, use
  170. Left_Amiga-M to see if the Host is still running and waiting for you to
  171. satisfy a requestor. Digi-View doesn't have this problem but Images and
  172. Graphicraft do.
  173.  
  174. Leach often spits out a "failure" message when it terminates. Don't worry
  175. about it.
  176.  
  177. The command line argument you give Leach is the Host screen title exactly
  178. as it appears in the Host's Screen structure. It is case sensitive.
  179. However, leading spaces may be omitted. Note that there are two spaces
  180. between "Graphicraft" and "Version" in Graphicraft's title.
  181.  
  182. IMAGES WARNING: Images makes use of the MENUVERIFY IDCMP flag.  Leach
  183. currently disables this feature because the Amiga was locking up whenever
  184. the menu button was pressed. When using Leach with Images, aviod pressing
  185. the right mouse button if Images is in the middle of rendering to the
  186. screen. I understand why MENUVERIFY can cause problems but, I haven't yet
  187. come up with a clean and effective way of solving the problem. Maybe for
  188. Version 1.4. Leach exibits some other strange behaviors when used with
  189. Images. It works but, expect to receive some funny error messages.
  190.  
  191. I find Leach useful for precision digitizing. Without it, even simple
  192. tasks, like making sure that horizontal lines are really horizontal, can be
  193. frustrating and time consuming.  However, Leach is a kludge at best. I hope
  194. that, along with other goodies, the next release of the Digi-View software
  195. will include features similar to but better than, the one that Leach breaks
  196. the rules to provide.
  197.  
  198.  
  199. Bug reports and enhancement suggestions would be welcomed. I can be contacted
  200. through...
  201.  
  202. CompuServe ID 76337,75  Please leave email rather than (or in addition to)
  203.                         Forum messages. Message life spans are shorter than
  204.                         the interval between my visits to the forum.
  205.  
  206. US Mail     Drew Lucy
  207.             6777 Upper York Road
  208.             Star Route Box 102C
  209.             New Hope, PA  18938
  210.