home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / CreativeComputers.iso / shareware / utilities / magicon_1.0 / magicon.doc < prev    next >
Text File  |  1994-11-17  |  7KB  |  318 lines
  1.  
  2.  
  3.  
  4.  
  5.                  MagIcon Version 1.0 by ╪ystein Larsen
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                       ⌐ 1992 Ultima Thule Software
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19. =======================================================================
  20.  
  21. =                           Distribution                              =
  22.  
  23. =======================================================================
  24.  
  25.  
  26.  
  27. This program is FREEWARE.  It may be freely distributed (for non-profit
  28. only!)  as long as all files in it remain unchanged and are included in
  29. the distribution.   This program cannot be used for commercial purposes
  30. without written permission from the author.
  31.  
  32.  
  33.  
  34.  
  35.  
  36. =======================================================================
  37.  
  38. =                            Information                              =
  39.  
  40. =======================================================================
  41.  
  42.  
  43.  
  44. What  this  program  does, is that it takes all the fake and real icons
  45. you "feed" the program with and turns them into real icons. At the same
  46. time it tries to determine what kind of file-type the files are.
  47.  
  48. If  that  file-type is  supported then the program will add the correct
  49. file-type-icon to the file.
  50.  
  51.  
  52.  
  53. This is done by checking a few of the first bytes of the file. The file
  54. must be over 20 bytes (but: the textfiles have to be over 380 bytes) or
  55. else it would not work properly.With the exception of the project-type,
  56. which will be explained later in this doc.
  57.  
  58.  
  59.  
  60. All  the  icons  supplied  should  be  copied  both  to the  ENVARC:Sys
  61. directory and the ENV:Sys directory.
  62.  
  63.  
  64. =======================================================================
  65.  
  66.  
  67. MagIcon supports some Tool Types.  I'll try to explain their functions.
  68.  
  69.  
  70.  
  71. APPMENU                 - Adds a  menuitem  in the Tools menu which can
  72.                           be used instead of the dropicon.    This tool
  73.                           type is selectable.
  74.  
  75. ICON_XPOS               - The dropicons X-position.
  76.  
  77. ICON_YPOS               - The dropicons Y-position.
  78.  
  79. ICON_NAME               - The name of the dropicon/menuitem.
  80.  
  81. DONOTWAIT               - Have  to  be  there  if you start the program
  82.                           from WBstartup. It's function is explained in
  83.                           the OS2.X manual.
  84.  
  85. STARTPRI                - Make  sure  MagIcon  is  executed as the last
  86.                           program. Should  be  set  to  -30 so that the
  87.                           menuitem will be at the  bottom  of the Tools
  88.                           menu.
  89.  
  90.  
  91. All the ICON_* tool types have default values/names in case you don't
  92. include them.
  93.  
  94.  
  95. =======================================================================
  96.  
  97.  
  98. So far MagIcon supports 38 different icons:
  99.  
  100.  
  101.  
  102. def_drawer              - You should already have these icons.
  103.  
  104. def_project             -
  105.  
  106. def_disk                -
  107.  
  108.  
  109.  
  110. - executable files -
  111.  
  112.  
  113. def_tool                - This is the default tool icon.  Which will be
  114.                           used if one executable file  doesn't have any
  115.                           of these extensions:
  116.  
  117. def_library             - .library
  118.  
  119. def_device              - .device
  120.  
  121. def_filesys             - .filesystem
  122.  
  123. def_handler             - .handler
  124.  
  125. def_lib                 - .lib
  126.  
  127.  
  128.  
  129. - text files -
  130.  
  131.  
  132. def_ascii               - This is the default text icon.  Which will be
  133.                           used  if  one  text  file doesn't have any of
  134.                           these extensions:
  135.  
  136. def_c                   - .c
  137.  
  138. def_asm                 - .s/.a/.asm
  139.  
  140. def_i                   - .i
  141.  
  142. def_h                   - .h
  143.  
  144. def_rexx                - .rexx/.arexx/.s2c/.ced/.dopus/.ttx/.adpro
  145.  
  146.  
  147.  
  148. - archive types -
  149.  
  150.  
  151. def_dms                 - The rest of the files are  checked by looking
  152.                           for some keywords inside the files.
  153.  
  154. def_lha                 -
  155.  
  156. def_lharc               -
  157.  
  158. def_zoo                 -
  159.  
  160. def_imploder            -
  161.  
  162. def_pkzip               -
  163.  
  164.  
  165.  
  166. - FORM types -
  167.  
  168.  
  169. def_ilbm                - ILBM format.
  170.  
  171. def_anim                - ANIM format.
  172.  
  173. def_8svx                - 8SVX sound format.
  174.  
  175. def_pref                - PREF format used by OS2.x.
  176.  
  177. def_ftxt                - FTXT format.
  178.  
  179. def_imgobj              - Imagine Object file.
  180.  
  181.  
  182.  
  183. - misc. types -
  184.  
  185.  
  186. def_ppacker             - Will  only  recognize  the packed data-files.
  187.                           Not the executable files.
  188.  
  189. def_b&psong             - Bars&Pipes song-format.
  190.  
  191. def_gif                 - GIF format.
  192.  
  193. def_medsound            - MED synth-sound format.
  194.  
  195. def_medsong             - MED song-format.
  196.  
  197. def_midi                - MIDI file (MThd type).
  198.  
  199. def_sascape             - Scenery Animator Scape format.
  200.  
  201. def_vistadem            - Vista Pro DEM format.
  202.  
  203. def_soundqbank          - SoundQuest bank format.
  204.  
  205. def_objectcode          - Object Code file.
  206.  
  207. def_amigaguide          - AmigaGuide file.
  208.  
  209.  
  210.  
  211. MagIcon requires Kickstart  and  Workbench 2.X to run, and can only be
  212. executed from Workbench.
  213.  
  214.  
  215.  
  216. I take no responsibility for any kind of damage to software or
  217. hardware. You use this program entirely at your own risk.
  218.  
  219.  
  220.  
  221. =======================================================================
  222.  
  223. =                            Usage                                    =
  224.  
  225. =======================================================================
  226.  
  227.  
  228.  
  229. Manual start:
  230.  
  231.   Just double-click the icon to start it.
  232.  
  233.  
  234.  
  235. From WBstartup:
  236.  
  237.   Copy MagIcon to the WBstartup drawer and it will be executed the next
  238.   time you reboot.  Remember to have the DONOTWAIT tool-type activated.
  239.  
  240.  
  241.  
  242.  
  243. If everything went ok,  you  will  (hopefully) see a very nice dropicon
  244. located somewhere on your Workbench screen.
  245.  
  246.  
  247.  
  248. To process a file,  just drop the icon on the dropicon or use 'MagIcon'
  249. from the Tools menu (if you have the APPMENU tool-type activated).
  250.  
  251.  
  252.  
  253. You  may  process  several icons at the same time by  holding  down the
  254. shift key while you're selecting icons before you drop them.
  255.  
  256.  
  257.  
  258. A small hint:
  259.  
  260.  
  261. If you have several icons spread over a large area, it's best to use
  262. the menuitem in the Tools menu. It's not very vice to use the dropicon
  263. in this case. You will soon find out why...
  264.  
  265.  
  266.  
  267.  
  268. Here is some info about the project-type file:
  269.  
  270.  
  271. If a file have the EXECUTABLE bit set, the program will process it and
  272. try to determine which kind of file it is.    If the EXECUTABLE bit is
  273. unset,   the program will just add the default def_project icon to the
  274. file without processing it.
  275.  
  276.  
  277.  
  278. Remember  that all icons with the  EXECUTABLE bit unset is a 'project'
  279. type and all icons with the EXECUTABLE bit unset is a 'tool' type.
  280.  
  281.  
  282.  
  283. So if you want a file to be a  project-type,  not  using  the  default
  284. 'def_project' icon, you have to make sure the file have the EXECUTABLE
  285. bit set before you process it.  When that is done you simply unset the
  286. EXECUTABLE bit.
  287.  
  288.  
  289.  
  290.  
  291.  
  292. If you have any  other  file-type(s) you  would  like  this program to
  293. support, just send me a copy of the file and I'll try to include it in
  294. the program. ( And a icon if you wish, but I  can't  promise that your
  295. icon will be included in this package. I m ight  make my own one(s). )
  296.  
  297.  
  298.  
  299.  
  300.  
  301. If you have any other suggestions or if you find any bugs in this
  302. program, I'd appreciate a small note.
  303.  
  304.  
  305.  
  306.  
  307. Here's my address:  ╪ystein Larsen
  308.                     Melandsgata 10
  309.                     9600 Hammerfest
  310.                     Norway
  311.  
  312.  
  313. Ultima Thule Software (and I) can be reached trought email at the
  314. following adress:
  315.  
  316. cbmehq!cbmnor!pnilsen!petter@cbmvax.commodore.com
  317.  
  318.