home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / varia / brush2icon / brush2icon.doc < prev    next >
Text File  |  1997-03-09  |  5KB  |  131 lines
  1.  
  2.                                BRUSH_2_ICON
  3.  
  4.                                Documentation
  5.  
  6.  
  7. Author: Achim Siebert, Nobileweg 67, D-7000 Stuttgart 40
  8.  
  9. Copyright: Public Domain ( or Gift Ware - see bottom!)
  10.  
  11. Compiler: Amiga Oberon V3.00d
  12.  
  13. Requirements: Kickstart V 37.x or higher.
  14.  
  15. Credits: Thanks for the IFF-conversion code to Christian Stiens
  16.          (BrushToOberon on AMOK50)
  17.  
  18. CLI-Usage: Brush2Icon BrushOrIcon/A, BrushOrFile/A, FilesOrWildCards/M,
  19.                       T=DefaultTool/K, REPLACE/S, DIRS/S
  20.  
  21.  
  22.                                What is this?
  23.  
  24. Brush2Icon  takes  one  or  two brushes or an existing icon and produces an
  25. icon  for  the  named files, drawers or disks.  Only the images of existing
  26. icons will be altered, tooltypes etc.  will be left as they are.
  27.  
  28. If  only  the  first  argument  is  an  brush, the produced icon(s) will be
  29. complemented  when you click on them.  If two brushes are given, the second
  30. brush will be used as alternate image.
  31.  
  32. If  the  first  argument is an icon, then its imagery will be copied to the
  33. icons of the given files.  If those files don't have an icon yet, they will
  34. get one.
  35.  
  36. You  may  also  change  the  default  tool  of  existing project icons with
  37. Brush2Icon via a workbench tooltype or CLI argument.
  38.  
  39.  
  40.                            Start from Workbench:
  41.  
  42. Click  on  Brush2Icon, click on a brush, optionally shift-click on a second
  43. brush  and then shift-click on all the files you wish to give the new icon,
  44. doubleclick  on  the  last  one.  If the given files don't have an icon yet
  45. (i.e.,  you  only may click them because you selected "Show all files" from
  46. the  Workbench  menu  before),  they  will  get  one  -  a  tool  icon  for
  47. executables,  a  disk  icon for disks, a drawer icon for drawers, a project
  48. icon else.
  49.  
  50. Second possibility:  Click on a file with an existing icon, then on all the
  51. files to get the imagery of that icon (like IIToI from AMOK50).
  52.  
  53. Workbench Tooltypes:
  54.  
  55. 1. DEFTOOL :  If this tooltype  is filled in, then  Brush2Icon will put the
  56. given  string  in  the  default  tool  field  of  a  produced project icon.
  57. If  DEFTOOL is not given, then if the fist argument is an icon, the default
  58. tool   of   that   icon   will   be   used  for  the  new  icon.   Example:
  59. DEFTOOL=:c/MuchMore
  60.  
  61. 2.   REPLACE  :   If  BrushToIcon  finds  this  tooltype, then also already
  62. existing  project icon will get the default tool given with DEFTOOL.  I.E.,
  63. you may change the default tool of an arbitrary number of icons by this.
  64.  
  65.  
  66.                               Start from CLI:
  67.  
  68. The corresponding CLI-arguments to the workbench tooltypes are:
  69.  
  70. 1. T=DefaultTool
  71. 2. Replace
  72.  
  73. There's one more argument:  DIRS.  If you use wildcards, icons are produced
  74. only for files.  If DIRS is given, the icon will be put to drawers only.
  75.  
  76. Examples:
  77.  
  78. 1> Brush2Icon Brush1 Brush2 file1 file2 file3
  79. will  produce  an  icon for the three given files with the images of Brush1
  80. and  Brush2.   If  the files already have an icon, only the imagery will be
  81. altered.
  82.  
  83. 2> Brush2Icon Brush1 file1 file2 file3
  84. -  same  as above, only one brush will be used, highlighting method for the
  85. produced icons will be "complement".
  86.  
  87. 3> Brush2Icon Brush1 Brush2 Oberon:Module/#?.mod
  88. will  give an icon made of Brush1 and Brush2 to every file in the directory
  89. Oberon:Module/ ending with ".mod".
  90.  
  91. 4> Brush2Icon Icon.info file1.info file2.info
  92. the  imagery  of the given icon will be used for file1.info and file2.info.
  93. You may as well leave out the trailing ".info", so that
  94.  
  95. 5> Brush2Icon Icon file1 file2
  96. has  the  same  result as Example 4, if "Icon" doesn't happen to be a brush
  97. file - in that case the brush would be used for the icon image.
  98.  
  99. 6> Brush2Icon ENV:SYS/def_drawer RAM:#? dirs
  100. all  drawers  residing  in  RAM:   will  get  the  default drawer icon.  Be
  101. careful:  if you left the keyword "dirs" away, all files in RAM:  would get
  102. that icon!
  103.  
  104. 7> Brush2Icon MyDoc.info DH0:Docs/#?.doc T=:c/MuchMore replace
  105. will  give  all  files in the directory DH0:Docs/ ending with .doc the icon
  106. MyDoc.info and the default tool ":c/MuchMore", even if they had a different
  107. default tool before.
  108.  
  109. If you want to change a disk icon, you may type
  110.  
  111. 8> Brush2Icon firstBrush secondBrush RAM:
  112.  
  113. or
  114.  
  115. 9> Brush2Icon DF0:Disk RAM:Disk.info RAD:Disk DF2:
  116. - as you see, you may always leave away the ".info"
  117.  
  118.  
  119. I  think  this  program is easiest to use from workbench and you won't need
  120. the  CLI-features  very  often.  If you want an "appicon", so that you only
  121. have  to drop the icons on Brush2Icon, then try ToolManager (Fish 551) like
  122. I do - or keep on double-clicking.
  123.  
  124. Best wishes,                         _
  125. nice workbench                      /
  126.                                    /\
  127.    Achim.                        _/  \_
  128.  
  129. PS:   If  you  like  this  proggy, what about sending me a disk full of the
  130. nicest icons you got (preferably for an interlaced Workbench screen)!?!
  131.