home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 500-599 / ff597.lzh / IconTools / README < prev    next >
Text File  |  1992-02-01  |  6KB  |  155 lines
  1.                                         January 19, 1992
  2.  
  3.                           << IconToolsII >>
  4.  
  5.                         by Richard Mazzarisi
  6.  
  7.         written in Jforth Professional 2.0 by Delta Research
  8.  
  9.  
  10. Introduction:
  11.  
  12.     These programs are two tools for managing icons under the
  13. Workbench.  The package consists of four programs, namely FloatIcon,
  14. ReplaceTool, SwapColors and ReplaceImage.  (FloatIcon and
  15. ReplaceImage are updates from the original set.)  They have been done
  16. before, but I have never seen such tools that worked totally as an
  17. Workbench based operation or allowed you to manipulate many icons in
  18. one operation.  So I decided to write them.
  19.  
  20.     They are self documenting; just double click the icon to see the
  21. instructions.
  22.  
  23.     These programs not public domain but are freely distributable as
  24. long as they are distributed with this notice and only a nominal fee
  25. is charged for the disks to cover the cost of distribution.  They may
  26. be included in Fred Fish's collection and in Delta Research's
  27. JGoodies disks.
  28.  
  29.     NOTE: The author assumes no responsibility for any damages
  30. resulting from the use of these programs.
  31.  
  32.  
  33. ReplaceTool 2.04:
  34.  
  35.     ReplaceTool allows you to change the default tool of any number
  36. of project icons all at once.  This is useful when installing a
  37. program and some projects created by it onto a disk which will have a
  38. different path from that of the distribution disk.  Usually double
  39. clicking the project icon would result in a program not found error.
  40. Then you had to type the new path into each icon using "info" from
  41. the Workbench menu, one by one!  Now instead you can just click on
  42. ReplaceTool and shift click on all the project icons and the tool to
  43. be used.  That tool's path and name will be placed in the DefaultTool
  44. slot of the icon.
  45.  
  46.     And how about all those README files whose icons all have some text
  47. file browser in a subdirectory of the original disk as their default tool;
  48. less has no icon, you say.  Well, there is a second way to use ReplaceTool.
  49. If you shift click ONLY on project icons, ReplaceTool will open the ARP file
  50. requester with which you can specify the tool and its path. The default
  51. directory will be SYS:, and of course you may click the buttons and names to
  52. get the path and tool you desire. Or you may type the path and name into the
  53. string requesters.  You may type ANY path or name into the requesters
  54. regardless of what is shown in the window; so that a relative path is
  55. possible such as "/" to use a tool one directory up from where the project
  56. lives, ":<path>" to indicate the current disk, or blank it out entirely to
  57. indicate the same directory.  You just type the appropriate path into the
  58. drawer string requester AFTER getting the correct file name to show in the
  59. file string requester with the gadgets, or just type in both path and file
  60. names. (With Workbench 2.0's ASL file requester you may get a 'Directory
  61. Error' if the directory name doesn't directly relate to the directory shown
  62. in the window. This may be safely ignored; the string typed in will be the
  63. one used.)
  64.  
  65.     If you are using Workbench 1.3 or earlier and want to use the
  66. second option, you must have the arp.library (version 39 or greater)
  67. installed in your LIBS: directory.  For Workbench 2.0 the ASL
  68. requester is used.
  69.  
  70.  
  71. FloatIcon 1.05:
  72.  
  73.     FloatIcon is a spinoff of Replacetool, basically it was practice
  74. at accessing the icon info and writing it back.  It simply lets you
  75. make an icon free floating again after it has been "Snapshot".  This
  76. means that the Workbench will decide where it should be placed when a
  77. drawer is opened rather than putting it at a fixed position.
  78.  
  79.     Having the icons free floating seems to work better with Dave
  80. Navas' JazzBench since it does a more intelligent job of icon
  81. placement than the Workbench, so that the names don't overlap.
  82. (AmigaDos 2.0 does a better job at this than 1.3)
  83.  
  84.     To use it just shift click on all the icons that you want to
  85. float after clicking first on SwapColors, double clicking on the last
  86. one.  This program is here only for Workbench 1.3 users since 2.0 has
  87. a menu item to accomplish the same end.
  88.  
  89.  
  90. SwapColors 1.01
  91.  
  92.     SwapColors is used to reverse the colors 1 and 2 in the icons.
  93. This is necessary for users of Workbench 2.0 to make icons which were
  94. used under 1.3 look better under the new version.  Only four color
  95. icons are altered by SwapColors.  If an icon has more than four
  96. colors it will be skipped over with a notification of that fact.  If
  97. an icon has a separate image for the selected state, swapcolors will
  98. do the color swap on both images.
  99.  
  100.     This program is used in the same way as FloatIcon; just click on
  101. SwapColors followed by shift clicking on all the icons that you wish
  102. to change the colors on.
  103.  
  104.  
  105. ReplaceImage 1.01
  106.  
  107.     ReplaceImage will change the image of a number of icons to be
  108. the same as the first one clicked.  This can be used, for example, to
  109. transform all your 1.3 drawer icons into the 2.0 style.  This program
  110. replaces only the gadget structure of an icon and will leave the
  111. DefaultTool and ToolTypes as they were.
  112.  
  113.     To use ReplaceImage you MUST shift click on the icon whose image
  114. you want to use right after clicking on ReplaceImage, then shift
  115. click on all the icons which are to receive this image, double
  116. clicking on the last one.
  117.  
  118.   JAZZBENCH USERS NOTE!!
  119.     Jazzbench 0.8 passes arguments in reverse order from Workbench,
  120. so you MUST click on the icon whose image is to be used LAST!
  121.  
  122.  
  123. Compiling the programs:
  124.  
  125.     In order to recompile these programs you need the Jforth
  126. Professional 2.0 Amiga developement package from Delta research.
  127. Assign JARP: to the directory where the arp header file and support
  128. file may be found. The other standard assigns for JForth are assumed
  129. to be set.  The asl_support file should be put into ju:.  And you
  130. will need the following include files in ji: libraries/asl.j,
  131. utility/hooks.j and utility/tagitem.j:, and the asl_lib.fd file in
  132. the JForth:fd.files drawer.
  133.  
  134.  
  135.  
  136. NOTE:
  137.     Under Workbench 1.3 the changes effected by these programs do
  138. not take effect until the icons are reread from the disk.  So it is
  139. necessary to close the drawers involved and to reopen them before
  140. using the modified icons.  Under version 2.0 the changes take
  141. effect immediately.
  142.  
  143.  
  144. Richard Mazzarisi
  145. 891 Post St. #207
  146. San Francisco, CA  94109
  147.  
  148.  
  149.  
  150. email:
  151. rich@californium.cchem.berkeley.edu
  152. rich@bloch.cchem.berkeley.edu
  153. rmazz@hydrogen.cchem.berkeley.edu
  154.  
  155.